# 杜康好客 · v3.4.12 工单迭代开发文档

> 版本：**v3.4.12** · 日期：2026-08-04  
> 需求源：ST 工单 + 开发计划/技术支持批量能力补充

## 1. 范围

| 模块 | 内容 |
|------|------|
| P0 售后 | `initiateRefund` 微信失败回滚订单状态 |
| mini-user | 门店详情门头 preview、环境图双列 |
| 财务 | 酒厂账单 T+3；门店可多笔 pending 提现 |
| 开发计划 | 审批创建任务可选企微派发；任务批量改状态/关联版本 |
| 技术支持 | 单条编辑/附件；批量改状态（状态机） |
| 套餐 | `StorePackage.imageUrl` 四端；HQ 删除至 0 条 UX |

**不在本版**：ST1785812832352437（门店列表，已完成）

## 2. 后端 API

| 方法 | 路径 | 说明 |
|------|------|------|
| — | `trade.initiateRefund` | 失败时 `REFUNDING→原状态` + 事件 |
| — | `settlement.generateWineryBillForDay` | `wineryDayWindow(lag=3)` |
| — | `validateStoreWithdraw` | 移除 `hasPendingRequest` |
| POST | `/admin/dev-plan/tasks/batch-update` | `{ taskIds, status?, versionId? }` |
| POST | `/admin/support-tickets/:id/review` | 扩展 `dispatchToWecom`, `dispatchSupplement` |
| PATCH | `/admin/support-tickets/:id` | 待评审可编辑 |
| POST | `/admin/support-tickets/batch-update-status` | 批量改状态 |

## 3. 数据表

- `common_support_ticket.attachment_urls` JSON
- `store_package.image_url` VARCHAR(512)

## 4. 验收

- [ ] 售后 REFUND 审批后 Mock 退款成功
- [ ] mini-user 门头点击大图、环境图双列
- [ ] 酒厂账单滞后 3 天；门店第二笔提现可提交
- [ ] 审批勾选企微后开发群收到任务
- [ ] 任务多选批量改状态/关联版本
- [ ] 技术支持待评审可编辑附件；批量 TESTING→PASSED
- [ ] 套餐 imageUrl 四端展示；HQ 可删至 0 条