为「思锐」——在坦桑尼亚、赞比亚两国运营跨境重卡车队的中资物流集团—— 建设一套运输管理系统（TMS），管住从客户下单 → 调度派车 → 司机在途 → 费用记账 → 月度报表的完整闭环。
docs/STATUS.md（驾驶舱，随时最新）
客户现有工具是"四张皮"：吉联（既有物流系统，老旧）、SAP（财务账）、 泛微 OA（审批）、Excel + 微信（实际日常运转的主力）。
docs/register/干系人动机.md（客户内部各岗位各自关心什么）、docs/meetings/（会议原始记录）
理解了这五条，就理解了整个系统的设计。
TATO 与赞比亚是同集团两法人：数据按组织隔离，但允许跨组织挂账（赞比亚应付↔TATO 应收）—— "哪个用户开的单就是哪个组织的"（客户 IT 负责人原话）。
货轴（财务视角）：客户订单 → 运单（每车一条）→ 段（跨境分段）； 车轴（车队视角）：Trip（一次出车从出场到回场，可拉多个订单、含空驶）。 「项目」这个词已由客户 CEO 书面收口＝客户订单。
每笔收入成本只录一次，报表层分别向"订单方向"（订单毛利）和"车辆方向"（趟盈亏）自动汇总， 两边合计强制对平，不平即阻断。
油耗定额（如重车 45L/空车 35L 每百公里，司机包干）、运价（按线路/货品/客户配置，开单自动带出可手改）、 费用科目、审批流、免堆期——全是可改的参数，不是写死的代码。
调度（派车）、司机（打卡与费用申报，手机网页）、财务（费用/开票/月报）、审批人（13 类流程）、 管理层（报表）——三个独立前端对应三类使用强度。
docs/specs/数据模型详设-v0.4.md（权威数据模型）、docs/specs/业务场景.md（12 个端到端场景）
方法：每条需求都能指到出处。客户的书面需求文档经过 AI 润色、与口头表述存在偏差， 所以本项目不拿任何单一文档当真相，而是把所有来源（会议逐字稿、微信、门户反馈、客户文件） 拆成 492 条带锚点的需求条目，冲突照实登记、不替客户裁定，再投影出当前需求基线。
| 类 | 含义 | 现状 |
|---|---|---|
| 客户已确认 | 有客户书面/会议/门户原话锚点 | 21 条硬规则（如：项目＝客户订单、多组织、13 类审批进 TMS、EFD 税控开票、三张月报样式、中英双语） |
| 我方断言 | 我方拍板并已告知、客户未反对，客户有否决权 | D01–D12（如：TS 全栈技术底座、Web 先行、统一共享链接+自报身份） |
| 我方假设 | 待答项按假设先做，客户可随时划叉，改动成本已控制 | ASM-01～14（如：临时汇率口径、吨数录入方式） |
docs/specs/需求确认状态总览.md（三分法全表）、docs/specs/假设台账.md、docs/specs/待客户确认清单.md、docs/baseline/当前需求基线.md
三端 + 一套 API + 一个数据库 + 适配层（TypeScript 全栈 Monorepo）。
| 端/层 | 是什么 | 给谁用 |
|---|---|---|
| 管理端 Web | 订单、调度、车辆、财务、报表、主数据、组织权限 | 调度员、财务、管理层（桌面优先） |
| 司机端 Web | 任务、节点打卡（GPS+时间戳+拍照）、费用申报与回看 | 司机（手机浏览器，默认英文，大按钮） |
| 审批端 Web | 13 类审批的待办与处理 | 各级审批人（轻量） |
| API 服务 | 10 个业务模块：主数据/订单/调度/执行/财务/审批/组织/报表/集成/反馈 | 三端共用 |
| 数据库 | PostgreSQL 系，70+ 张表，55 个共享业务实体 | — |
| 适配层 | GPS / SAP / EFD 税控 / 短信，全部经适配器隔离，换供应商不动业务代码 | — |
质量家底（2026-08-31）：198 项自动化检查全绿＝153 服务端逻辑 + 40 条真实浏览器全流程 + 5 条线上环境冒烟； 另有语法守卫与"已修 bug 必有回归测试"守卫；部署脚本内置线上冒烟卡点，不过即拒绝发布。
deliverables/2026-08-20-答复包/系统架构说明-客户版.md（v0.3，架构细节）、docs/specs/测试方案.md
从客户下单到月度关账，六个环节首尾相接。
deliverables/2026-08-31-会议材料/试用任务卡.pdf（调度/司机/财务三张）
三端已在线。首次访问需点一次带密钥的开通链接（微信里发过； 我方同事看运行手册的恢复路径，密钥不写在文档里）。
有意见随手提：每个页面右下角浮钮，或评审门户；两个入口都实时推送到我方飞书，提交后有记录、逐条有回音。
对客户透明、对接手同事必读的三条。
CLAUDE.md（AI 接手第一入口）、docs/specs/测试方案.md、docs/specs/AI原生交付质量体系-设计.md、tms-app/AGENTS.md（执行代理的规矩）
五个阶段，从试用到验收。每阶段的前置条件写清楚，卡住时知道在等谁。
| 阶段 | 内容 | 前置条件 |
|---|---|---|
| 现在～ | 客户三角色按任务卡试用演示系统，反馈滚动修 | 无（已可开始） |
| 试用期 | 客户真实客户/运价数据经 Excel 导入，用真数据跑单 | 客户填模板（系统逐行校验） |
| 对接期 | GPS 换真源、EFD 换真网关、SAP 中间表联调 | 第四节"还差什么"的三件事 |
| 口径收敛 | 月报"待口径"列补齐（汇率/折旧/收款源/吨数） | 客户财务答复（已备好给财务顾问的一页） |
| 验收 | 按 UAT 签字人机制走验收；演示库切生产 PostgreSQL | 口径收敛 + 试用反馈清零 |
按顺序读，每步都比上一步细一层。
docs/specs/需求确认状态总览.md → 追根溯源进 docs/register/；改代码先读 tms-app/AGENTS.md 与 docs/specs/测试方案.mdpython3 tools/session_selfcheck.py（开工体检）· python3 tools/check_stale.py（哪些结论依据已变）· LIVE_DEMO_KEY=<key> bash tools/deploy-demo.sh（部署+线上冒烟）