← 交付目录查看原型

1.4 · CR-20260821-001

店铺运营管理（二级菜单与平台后台档案）· Build Notes

产品 PRD 版本：1.4
前端实施契约版本：1.6
来源变更：CR-20260821-001
原型等级：L3（本地可交互原型）

本次变更覆盖

变更编号用户修改产品 PRD 落点前端实施契约落点原型落点
CR-20260821-001单店档案补店铺头像，店铺名称明确为“后台店铺名称”；店铺类型收敛为普通店/Mall 店，且不得影响地址、地址角色和渠道操作；平台列表移除重复标题。§0、§3.3、F-012、§5.1、§8–§10：头像/ID/后台店铺名称取店铺管理主数据；店铺分类与平台履约标识和动作门控解耦。F-008、P-002、P-003、C-005/C-009、类型维护 Modal 与状态契约。P-002 删除重复卡片标题并改用“后台店铺名称”搜索/列名；P-003 基本信息增加头像，类型仅更新分类和审计。
CR-20260810-003地址行“设置角色”命名有歧义。产品 PRD 无需修改业务规则：仅补充当前变更追溯与明确的页面文案。§11 地址角色操作文案。P-003 地址行操作改为“设置地址角色”；Modal 既有标题与该操作一致。
CR-20260810-002移除物流渠道 Demo 的技术字段展示，确认弹窗使用业务操作文案。产品 PRD 无需修改：字段语义、平台写入限制与同步规则不变。§11 渠道技术字段、渠道变更确认文案；F-007 的技术字段仅保留在研发契约。P-003 删除 service_type_identifier 辅助说明；提示和确认弹窗改为“服务类型/渠道组”“同步最新状态”“确认”。
CR-20260810-001service_type_identifier 区分 Instant / Non-Instant；mask_channel_id 聚合同组子渠道；force_enable 必须标识并限制关闭。§1.2 F-009–F-011、§5.4、§8 FL-006、§9 AC-009–AC-011。F-007、P-003 渠道区域、C-007、渠道层级面板与状态/文案契约。P-003“物流渠道”由扁平表格改为服务类型 → 渠道组 → 子渠道面板；强制启用 Tag、禁用开关、提示和提交拦截已实现。

实现内容

  • 渠道页签使用 ProCard、Collapse、Tag、Tooltip、Switch 组成层级面板：先展示 Instant / Non-Instant 服务类型，再用同一 mask_channel_id 归类渠道组，最后展示组内子渠道。
  • 用示例展示 Standard 下的 Standard Delivery - ส่งธรรมดาในประเทศ 与 Standard Delivery Bulky - ส่งสินค้าขนาดใหญ่，不再用扁平渠道表掩盖子渠道关系。
  • force_enable=true 的渠道使用“平台强制启用”标签；渠道启用开关固定为开启且禁用，前端事件层也拒绝创建关闭确认。该限制不外推到 COD。
  • 对接说明直接落在 PRD §5.4：get_channel_list 记录服务类型、渠道组、强制启用等回参；update_channel 明确禁止发送强制启用渠道的 enabled=false，写后回读。
  • 本轮收口 Demo 与确认弹窗文案：技术字段名继续保留在接口映射和研发契约，业务界面只使用服务类型、渠道组、平台限制和同步结果等用户可理解表达。
  • 地址角色行操作不使用无对象的“设置角色”，改为“设置地址角色”，与弹窗标题及地址对象上下文一致。
  • 单店后台档案固定展示店铺头像、店铺 ID、后台店铺名称、所属平台、站点、店铺类型；头像、ID、名称仅取店铺管理主数据，不提供修改入口；缺少头像时显示店铺图标。
  • “编辑店铺类型”仅包含普通店/Mall 店的单字段选择；保存后更新当前档案和平台后台列表分类并追加操作记录，不重新判断 Shopee 地址编辑、地址角色或渠道设置。
  • P-002 不重复展示“平台后台管理”卡片标题，页面二级 Tab 是唯一页面定位；平台列表的名称列与搜索提示统一使用“后台店铺名称”。

不改项及原因

  • 迁移覆盖页面：P-003 单店后台档案（Shopee 物流渠道设置）。
  • P-001 运营归属管理、地址/仓库、地址角色交互保持既有设计，不改变既有列表、二级菜单或已确认的信息架构；P-002 仅移除重复标题并统一名称文案。
  • 不新增渠道、删除渠道、订单发货、多店批量配置或 3PF 编辑；不通过渠道名称推断平台层级。
  • force_enable 只限制渠道启用状态，未获得字段级依据前不将其解释为 COD 强制开启、关闭或禁用。
  • 未触碰 Lazada、TikTok Shop 能力边界与后台经营指标，仍维持已确认的冻结状态和中性空态。

检查

  • [x] PRD 准备度：prd:ready 已通过，产品 PRD v1.4、前端实施契约 v1.6、P-002/P-003 增量覆盖声明完整。
  • [x] TypeScript：prototype:pro:check -- --name 店铺物流配置 已通过。
  • [x] 生产构建：prototype:pro:build -- --name 店铺物流配置 已通过；仅保留构建工具对大体积单包的非阻断提示。
  • [x] antd lint（0 issues）、prototype:guard（0 errors，7 处既有 raw color 提示）、change:sync、project:check、交付刷新与一致性均已通过。
  • [x] 关键交互同视口走查：服务类型分区、渠道组展开、子渠道展示、强制启用禁用态、非强制渠道/COD 确认及更新后业务文案已由 Freddy 确认。
  • [x] 同视口视觉验收：Freddy 已确认；本轮变更已于 2026-08-26 发布。

剩余决策与知识影响