feat: v3.4.12 ticket iteration

Refund rollback, winery T+3, multi withdraw, mini-user store detail, dev plan batch edit and WeCom dispatch, support ticket edit/attachments/batch status, package imageUrl.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-08-04 23:53:31 +08:00
parent 71f508e02b
commit 4372018c09
34 changed files with 1032 additions and 86 deletions
@@ -0,0 +1,44 @@
# 杜康好客 · 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 条