dukang/docs/杜康好客-门店套餐功能开发文档-v3.4.10.md

杜康好客 · 门店套餐 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 端仍见上一版；通过后替换
• 套餐异议工单可创建