feat(store): 门店套餐 v3.4.10 全端实现

新增 StorePackage 与变更审核流，覆盖总部直存、合伙/门店提审、C 端展示与套餐异议工单；同步 PRD/开发文档与 REQ 索引。

Co-authored-by: Cursor <cursoragent@cursor.com>

杜康好客-v3-PRD.md

@@ -26,6 +26,12 @@
 | 核销码 TTL 3 分钟 | 编码手册写 5 分钟 | **以本 PRD 3 分钟为准** |
 | 订单 Tab 三态 | preV1 五 Tab | **以本 PRD 待付款/已付款/已完成为准** |
 
+### 0.2 变更：3.4.10 门店套餐
+
+| 版本 | 日期 | 说明 |
+|------|------|------|
+| **3.4.10** | 2026-08-03 | 新增 §3.9 门店套餐；REQ-P-027 / REQ-S-021 / REQ-H-025 / REQ-U-027；开发设计见 [`杜康好客-门店套餐功能开发文档-v3.4.10.md`](./杜康好客-门店套餐功能开发文档-v3.4.10.md) |
+
 ---
 
 ## 1. 背景与目标
@@ -234,13 +240,50 @@
 - Wave 3：连续**网络类**失败 5 次→拍照兜底→上传→总部 T+0 补核销
 - 业务错误（码过期、余额不足等）不计入 5 次；幂等防重复扣款
 
+### 3.9 门店套餐（引入于 **3.4.10**）
+
+> 实现设计见 [`杜康好客-门店套餐功能开发文档-v3.4.10.md`](./杜康好客-门店套餐功能开发文档-v3.4.10.md)
+
+门店可向 C 端展示餐饮套餐信息（与酒水 SKU 无关），用于核销前用户了解可核销内容；**套餐变更审核与整店入驻审核独立**。
+
+#### 3.9.1 套餐数据结构
+
+| 字段 | 说明 | 示例 |
+|------|------|------|
+| 套餐名称 | 必填（单条内） | 套餐A |
+| 价格 | 元 | 198 |
+| 菜品 | 文本 | 红烧肉、红烧鱼、油焖茄子 |
+| 使用时间 | 文本 | 节假日除外 |
+| 其他说明 | 文本 | 不可叠加 |
+
+- 可不填；可多条；**同一门店最多 10 条**
+- C 端仅展示**已审核通过（生效中）**的套餐，自上而下标题+内容形式
+
+#### 3.9.2 维护与审核
+
+| 端 | 能力 | 审核 |
+|----|------|------|
+| 合伙人拓店 | 新建流程增加「套餐」页（可跳过） | 随门店或独立提审（见开发文档） |
+| 合伙人门店详情 | 套餐列表 → 编辑 → **提交审核** | 是 |
+| 门店端 | 套餐列表 → 编辑 → **提交审核** | 是 |
+| 总部 | 门店详情新增「套餐」Tab | **直接保存生效，无需审核** |
+
+- 合伙/门店提交后 → 总部收到套餐变更审核 → **通过/驳回**
+- **通过**：自动替换该店生效套餐；**驳回**：保留上一版生效套餐
+- 提审中：C 端仍展示上一版已通过套餐（从未通过则不展示）
+
+#### 3.9.3 客服异议
+
+- 用户对核销过程中套餐内容有异议 → 可提交客服申诉
+- 工单/客服类型新增：**套餐异议**（`PACKAGE_DISPUTE`）
+
 ---
 
 ## 4. 功能需求（REQ 索引）
 
 > 完整 REQ 结论见 [`.cursor/skills/dukang-v3/reference-req-index.md`](./.cursor/skills/dukang-v3/reference-req-index.md)
 
-### 4.1 用户端（小程序）— REQ-U-001 ~ 026
+### 4.1 用户端（小程序）— REQ-U-001 ~ 027
 
 | 模块 | 要点 |
 |------|------|
@@ -248,7 +291,8 @@
 | 商品下单 | 4 款酒祖杜康 SKU；同城≥2瓶免运费；跨城≥1箱；现场提货隐藏；锁单30分钟 |
 | 权益核销 | 1:1 发放；出码 3 分钟；核销前规则弹窗（OPT-011）；附件一规则详情 |
 | 门店 | 列表/详情/搜索/省市区筛选；仅营业中展示；立即核销 |
-| 增长售后 | 四类型工单；发票四组合；成交问卷（无激励）；推广码；微信商品分享 |
+| **门店套餐（3.4.10）** | 门店详情展示生效套餐（标题+内容）；套餐异议申诉入口（REQ-U-027） |
+| 增长售后 | 四类型工单 + **套餐异议**；发票四组合；成交问卷（无激励）；推广码；微信商品分享 |
 | 评价 | 核销后门店评价 |
 
 **SKU 价格锚点**
@@ -260,7 +304,7 @@
 | 酒祖杜康（国标特级20）53° | ¥298 | ¥1788 |
 | 酒祖杜康（国标特级30）53° | ¥498 | ¥2988 |
 
-### 4.2 门店端（H5）— REQ-S-001 ~ 020
+### 4.2 门店端（H5）— REQ-S-001 ~ 021
 
 | 模块 | 要点 |
 |------|------|
@@ -269,26 +313,29 @@
 | 记录结算 | 筛今日/7日/1月/全部；到账金额×60%；T+1 出账 |
 | 提现 | 未出账可提（FIN 护栏）；提现记录；结算异议 3 工作日 |
 | 账号 | 主账号管理店员（Wave 2）；待处理核销单（Wave 3） |
+| **门店套餐（3.4.10）** | 套餐列表/编辑；提交审核（REQ-S-021） |
 
-### 4.3 合伙人端（H5）— REQ-P-001 ~ 026
+### 4.3 合伙人端（H5）— REQ-P-001 ~ 027
 
 | 模块 | 要点 |
 |------|------|
 | 权限 | 管理员 vs 推广员菜单裁剪 |
-| 拓店 | 三步录入；一号多店确认；负责人复核；试核销100元；附件一 |
+| 拓店 | 三步录入 + **套餐页（3.4.10，可跳过）**；一号多店确认；负责人复核；试核销100元；附件一 |
 | 经营 | 首页三卡；排行；订单/权益/工单；佣金快照下钻 |
 | 财务 | 本合伙人月账对账（Wave 2/3） |
 | 扩展 | 代下单（Wave 3）；管仓只读（Wave 3） |
+| **门店套餐（3.4.10）** | 拓店套餐页；门店详情套餐列表/编辑/提审（REQ-P-027） |
 
-### 4.4 总部端（H5）— REQ-H-001 ~ 024
+### 4.4 总部端（H5）— REQ-H-001 ~ 025
 
 | 模块 | 要点 |
 |------|------|
 | 基础 | 商品管理；营销规则 1:1 权益；签约主体：山西领势酒业有限责任公司 |
 | 城市合伙人 | 开通城市；创建合伙人（全城/区域+佣金）；仓库管理（Wave 3） |
-| 审核交易 | 门店审核；全量订单/权益/工单；发票 2 工作日；补核销 |
+| 审核交易 | 门店审核；**套餐变更审核（3.4.10）**；全量订单/权益/工单；发票 2 工作日；补核销 |
 | 结算 | 门店+合伙人双 Tab；提现审；白名单配置；**物流对账**（按承运商月结） |
 | 增长 | 推广码；问卷；评价；腾讯位置热力图 |
+| **门店套餐（3.4.10）** | 门店详情「套餐」Tab 直存；套餐变更审核通过/驳回（REQ-H-025） |
 
 ### 4.5 端职责矩阵
 
@@ -300,6 +347,7 @@
 | 工单 | ●发起 | 查看 | 查看 | ●决策 |
 | 结算提现 | | ● | 对账确认 | ●审打款 |
 | 推广码/问卷/评价 | ● | 被评价 | 看数据 | 配置/看板 |
+| **门店套餐（3.4.10）** | 看生效套餐 | 编辑提审 | 编辑提审 | ●直存/●审核 |
 
 ---
 
@@ -324,7 +372,7 @@
 
 ### 6.1 核心实体（TECH-001 ~ 019）
 
-用户、商品、订单（含佣金快照）、好客权益账本、门店（主账号/店员）、核销单、工单、结算/提现、合伙人（管辖+佣金）、推广码、仓库（W3）、待处理核销单（W3）、门店账号（W2）。
+用户、商品、订单（含佣金快照）、好客权益账本、门店（主账号/店员）、**门店套餐（3.4.10）**、核销单、工单、结算/提现、合伙人（管辖+佣金）、推广码、仓库（W3）、待处理核销单（W3）、门店账号（W2）。
 
 ### 6.2 外部对接
 
@@ -432,6 +480,7 @@
 
 | 版本 | 日期 | 说明 |
 |------|------|------|
+| **3.4.10** | 2026-08-03 | 新增 §3.9 门店套餐；REQ-P-027 / REQ-S-021 / REQ-H-025 / REQ-U-027；套餐异议工单类型 |
 | v3.0.2 | 2026-08-02 | OPT-002/SC-07：代下单改为在线支付（收款码/合伙人微信代付）；去掉线下已收款直完成；配送单总部履约、合伙人可看物流 |
 | v3.0.1 | 2026-07-27 | ACC-012/OPT-002/SC-07：明确合伙人代下单双短信、线下完成、来源 PARTNER_PROXY、C 端展示代下单人 |
 | v3.0 | 2026-07-11 | 由产品 PRD v1.3 整理为工程 V3.0 事实源；配套 `@dukang-v3` skill 与 `v3-delivery-lead` agent |