整理开发文档

2026-08-19 16:20:33 +08:00
parent 233ed0af3b
commit 62353a6800
21 changed files with 0 additions and 0 deletions
@@ -0,0 +1,38 @@
+# 杜康好客 · 门店套餐 v3.4.10
+
+> PRD §3.9 · REQ-P/S/H/U-027 · **已实现**（含 v3.4.12 `imageUrl`）
+
+## 要点
+
+- 与酒水 SKU 独立；每店 ≤10 条；字段：名称/价格/菜品/使用时间/说明
+- C 端仅展示**已审核生效**套餐；异议类型 `PACKAGE_DISPUTE`
+- 合伙/门店：编辑 → **提交审核**；HQ：门店详情 Tab **直存生效**
+- 审核通过：事务替换 `store_package`；驳回保留上一版；同店仅 1 条 `PENDING`
+
+## 表
+
+| 表 | 用途 |
+|----|------|
+| `store_package` | 生效套餐（含 `image_url`） |
+| `store_package_change_request` | 提审快照 `packagesJson` |
+
+## API（前缀 `/api/v1`）
+
+| 端 | 路径 |
+|----|------|
+| partner | `GET/PUT /partner/stores/:id/packages` · 变更历史 |
+| shop | `GET/PUT /shop/store/packages` |
+| admin | `GET/PUT /admin/stores/:id/packages` · `/admin/store-package-audits` 审 |
+
+## 流程
+
+```
+partner/shop 编辑 → PENDING → HQ 通过/驳回 → 生效 → mini-user 展示
+HQ 直存 ──────────────────────────────→ 生效
+```
+
+## ACC
+
+- [ ] 四端展示 imageUrl；HQ 可删至 0 条
+- [ ] 提审中 C 端仍见上一版；通过后替换
+- [ ] 套餐异议工单可创建