← 交付目录查看原型

1.1 · CR-20260805-014

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

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

实现内容

  • 本次新增“发布交付目录”试点：仅当本模块存在 delivery-publication.json 时，发布包在 prototype/店铺物流配置/delivery/ 生成交付首页及产品 PRD、前端实施契约、构建与验收记录、交付摘要四份可阅读 HTML；原型入口明确指向 ../index.html，在本地文件与发布地址均直接打开原型首页。
  • 交付首页新增“需求日志”：由当前模块清单维护，按时间倒序展示变更编号、修改概要与影响材料；构建提交和生成时间下沉至“发布信息”，不再占用变更说明位置。
  • 交付文档中的 text 结构树改为浅色、可换行的正文块；不再使用深色代码块，保证信息架构和流程骨架可读。
  • 完成原型—PRD 一致性复查：删除被二级菜单方案替代的店铺选择器、能力集合、店铺运营总览和详情 Drawer 规格；单店档案改由平台后台管理列表“查看”进入，服务端动作门控不作为页面字段或列表列。
  • 更正三平台能力表：Lazada 仓库读取/编辑、TikTok Shop 仓库读取及渠道读取均已确认接口入口；仍严格区分“接口已确认”和“字段级可实现”，未核验字段、权限、错误码不开放页面对象或写操作。
  • 本变更为外部 API 契约补齐：接口信息直接写入对应功能说明（同步 §5.1、地址 §5.3、渠道 §5.4），以表格逐项记录 API 名称、可点击文档 URL、生产 URL/方法、请求映射、回包留存、回读、错误与未核验门禁；不再维护脱离业务功能的独立接口文档。
  • 在“店铺运营管理”标题下增加“运营归属管理 / 平台后台管理”二级菜单，按内部归属治理和外部平台后台数据/设置分离。
  • “运营归属管理”保留既有左侧“店铺管理 / 店铺状态 / 未分配店铺 / 全部店铺”、原表列序、平台下拉、跨 BU 搜索、全部/待分配/缺销售/缺客服筛选，以及编辑/批量配置店铺归属的交互。
  • “平台后台管理”以“全部 / Shopee / Lazada / TikTok Shop”页签分组店铺；用户从此进入单店后台档案查看经营表现、平台后台设置和操作记录。
  • 移除“已接入后台能力”列表列；平台能力只用于单店后台档案内的动作门控。行操作统一为“查看”。
  • 在平台分组页签的名称左侧增加 18px 平台识别 Logo；“平台后台管理”二级菜单保持纯文字与默认 Tabs 选中态。
  • 归属配置弹窗与现有页面保持一致：目标 BU 必填，销售员/客服可选，并包含生效日期、长期有效与结束日期控制。
  • Shopee 普通店保留已确认的地址编辑、独立地址角色设置、渠道/COD 确认与回读；3PF 仓库不提供编辑。
  • 后台指标接口未核验时，单店档案使用“暂无已接入指标”的中性空态，不虚构评分、趋势或阈值。

不改项及原因

  • 不改动历史需求、历史原型、发布规范或 PRD 模板；本次交付目录只由当前模块的显式清单触发，未配置清单的原型不会生成目录或被发布流程阻断。
  • 本次只补齐研发/联调所需的外部接口规格，不改变已确认的信息架构、页面交互或原型源码；因此无需重新构建原型，但仍重新执行 PRD 与变更同步校验。
  • 不重画“运营归属管理”原列表为“店铺范围”“店铺运营总览”，不增加站点、评分、表现、归属治理列或漏配/配错筛选 Chip。
  • “配错”查询需要人员 BU 归属、人员有效性与归属有效期的真实数据源；当前未核验，不创建伪筛选。
  • 不创建“基础设置待完成/未配置/物流待确认”状态、筛选、待办、告警或完成度。
  • 不展示或操作新增店铺、店铺授权、密码、授权到期、账号同步状态；这些属于账号管理部。
  • 不新增或删除平台地址/仓库，不进入订单发货；不落地未核验的 Lazada/TikTok 读写表格或表单。

检查

  • [x] PRD 准备度：review-passed。
  • [x] TypeScript：prototype:pro:check 通过。
  • [x] 生产构建：prototype:pro:build 通过。
  • [x] antd lint：0 issues。
  • [x] prototype:guard：0 errors，1 warning。警告仅来自本次确认的 Shopee、Lazada、TikTok Shop 局部 Logo 品牌色；未扩散为页面主题，依据 PRD §0.5 与共享设计系统“平台识别与平台分组页签”规则保留。
  • [x] 产品变更同步检查：change:sync --base HEAD 通过。
  • [x] 关键交互：二级菜单切换、原筛选、批量/单店归属配置、平台后台管理进入单店后台档案、Shopee 地址编辑/角色设置/渠道确认与回读；Freddy 已确认本轮方案与原型交互。
  • [x] 同视口视觉验收：Freddy 已确认当前页面方案；本地 file:// 自动截图仍受安全策略限制，因此以用户在当前浏览器中的评审为验收证据。
  • [x] 本地发布包：prototype:package -- --source prototype/店铺物流配置 通过；生成 4 份交付材料、68 个本地引用检查通过，体积 8.67 MB / 10 MB。
  • [x] Cloudflare Pages 发布：已发布至 https://erp-prototypes.pages.dev/prototype/店铺物流配置/；交付目录为 https://erp-prototypes.pages.dev/prototype/店铺物流配置/delivery/。

剩余决策与知识影响

  • 已把“外部 API 信息必须内嵌在使用它的功能说明中，并以表格呈现”的通用规则写入 docs/prd-driven-workflow.md 与 PRD 模板；本模块已按该规则重排。
  • 平台后台经营指标的具体接口、字段、口径和刷新策略尚未核验；接入前保持中性空态。
  • 人员 BU 归属、停用状态、归属有效期的正式数据接口尚待核验；确认后另行设计“配错”查询入口，不改变现有筛选结构。
  • Lazada、TikTok Shop 的具体字段、适用店铺和写权限，在正式接入前按平台接口核验另建变更。
  • 本次新增项目级 UI 规则：真实平台分组页签可使用平台 Logo 辅助识别，名称和选中态不得省略；已同步至 references/ui-review/erp-ui-design-system.md。