数据库分析和对应不同角色页面

pages/mall/delivery/doc/需求文档/README.md

@@ -3,12 +3,14 @@
 本目录聚焦“模拟三通一达后台（Mock 承运方 Server）”的联调与测试需求，用于在未签约真实承运方前验证平台侧的 Webhook 接收、验签、幂等、入库与前端时间线展示。
 
 ## 文档分层（先看什么、后看什么）
-- 需求（做什么）：`配送模块需求文档.md`
-- 页面（后台长什么样）：`后台页面设计说明.md`
-- 接口（怎么对接）：`接口规范.md`
-- 映射（状态怎么统一）：`状态映射表.md`
-- 前端契约（怎么展示）：`前端字段清单.md`
-- 补齐清单（还缺什么）：`缺口与待补充清单.md`
+- 需求（做什么）：[配送模块需求文档.md](配送模块需求文档.md)
+- 页面（后台长什么样）：[后台页面设计说明.md](后台页面设计说明.md)
+- 接口（怎么对接）：[接口规范.md](接口规范.md)
+- 映射（状态怎么统一）：[状态映射表.md](状态映射表.md)
+- 前端契约（怎么展示）：[前端字段清单.md](前端字段清单.md)
+- 补齐清单（还缺什么）：[缺口与待补充清单.md](缺口与待补充清单.md)
+- 数据库（旧表 vs 新表）：[数据库对比与修改建议.md](数据库对比与修改建议.md)
+- 数据库（生产表字段说明）：[生产表说明_platform_express.md](生产表说明_platform_express.md)
 
 ## 先读这个：这套文档在解决什么
 你现在要做的是一个“像三通一达一样会产生物流节点并回调的平台外部系统”。真实承运方接口通常需要签约与联调周期，因此先通过 Mock 承运方 Server 把平台侧能力跑通：
@@ -27,14 +29,14 @@
 - 故障注入必须：重复推送、乱序、延迟、签名错误、缺字段等是外部对接最常见问题，必须在联调阶段覆盖。
 
 ## 阅读顺序（推荐）
-1) 先看 `配送模块需求文档.md`：理解 Mock Server 要做什么、有哪些验收与故障注入。
-2) 再看 `后台页面设计说明.md`：明确平台后台/商家后台需要哪些页面与最小展示/权限要求。
-3) 再看 `接口规范.md`：
+1) 先看 [配送模块需求文档.md](配送模块需求文档.md)：理解 Mock Server 要做什么、有哪些验收与故障注入。
+2) 再看 [后台页面设计说明.md](后台页面设计说明.md)：明确平台后台/商家后台需要哪些页面与最小展示/权限要求。
+3) 再看 [接口规范.md](接口规范.md)：
 	- Mock Server -> 平台：Webhook 推送格式与验签
 	- 平台/测试工具 -> Mock Server：控制面 API（创建运单/追加事件/跑场景/触发推送）
-4) 看 `状态映射表.md`：明确 `event_code` 如何映射到平台统一 `status_code`。
-5) 看 `前端字段清单.md`：前端时间线组件到底需要哪些字段（以及 `source` 如何标注）。
-6) 最后看 `缺口与待补充清单.md`：把联调验收所需材料补齐，避免漏项。
+4) 看 [状态映射表.md](状态映射表.md)：明确 `event_code` 如何映射到平台统一 `status_code`。
+5) 看 [前端字段清单.md](前端字段清单.md)：前端时间线组件到底需要哪些字段（以及 `source` 如何标注）。
+6) 最后看 [缺口与待补充清单.md](缺口与待补充清单.md)：把联调验收所需材料补齐，避免漏项。
 
 ## 快速上手（联调路径）
 1) 平台准备一个 Webhook 接收地址：`/webhook/express/status`，并实现 `X-Signature` 验签与幂等去重（按 `event_id`）。
@@ -48,12 +50,19 @@
 - 为什么要状态映射？因为不同承运方文案与事件码不稳定，统一状态才能做稳定 UI 与统计。
 
 文件列表：
-- 配送模块需求文档.md：Mock 承运方 Server 的目标、范围、流程与验收。
-- 接口规范.md：Mock Server 控制面 API + Mock -> 平台 Webhook 推送规范。
-- 状态映射表.md：Mock 事件码到平台统一状态映射建议。
-- 前端字段清单.md：时间线组件所需字段契约与展示规则。
+- [配送模块需求文档.md](配送模块需求文档.md)：Mock 承运方 Server 的目标、范围、流程与验收。
+- [后台页面设计说明.md](后台页面设计说明.md)：后台页面结构、权限与最小交互。
+- [接口规范.md](接口规范.md)：Mock Server 控制面 API + Mock -> 平台 Webhook 推送规范。
+- [状态映射表.md](状态映射表.md)：Mock 事件码到平台统一状态映射建议。
+- [前端字段清单.md](前端字段清单.md)：时间线组件所需字段契约与展示规则。
+- [缺口与待补充清单.md](缺口与待补充清单.md)：联调/验收需要补齐的资料与决策项。
+- [数据库对比与修改建议.md](数据库对比与修改建议.md)：旧自营骑手表 vs 第三方快递表的改库建议。
+- [生产表说明_platform_express.md](生产表说明_platform_express.md)：生产环境 `platform_express_*` 三表用途、字段、约束/索引与写入查询建议。
 
 数据库：
-- `mall_sql/schemas/express_tracking_mock_platform.sql`：本体系建议的 Postgres 建表脚本（平台统一入库 + Mock 持久化）。
+- 生产环境（推荐执行）：[express_tracking_platform_upgrade.sql](express_tracking_platform_upgrade.sql)
+	- 仅包含平台侧 `platform_express_*` 三张表，供生产代码使用。
+- 联调/设计参考（不要用于生产直接落库）：[express_tracking_mock_platform.sql](express_tracking_mock_platform.sql)
+	- 包含平台侧表 + `mock_*` 测试表（故障注入/回放用），仅用于联调与文档说明。
 
 建议下一步：在平台侧实现一个可切换的“Mock 数据源”开关（仅测试环境），并在 QA 用例中覆盖重复/乱序/验签失败等注入场景。