jacy
4372018c09
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>
45 lines
1.8 KiB
Markdown
45 lines
1.8 KiB
Markdown
# 杜康好客 · 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 条
|