文档导航

docs/ 是本项目设计、合同、决策和验收事实的维护目录。以下入口以当前项目内隔离 Mock 合同为准；真实 SaaS/management、供应商、线路、ECS 和生产切换仍未签收。

首读顺序

plan-saas-dispatcher.md：P01–P08 当前实施进度、A01–A12/K01–K16 验收与未验证边界。
thirds/saas-dispatcher.md：唯一现行 SaaS↔Dispatcher 项目内通信说明，五类只读 HTTP、固定 v1 MQ、归属、控制、唯一结果与上传恢复。
../contracts/local/manifest.json 与 ../contracts/local/：唯一当前机器 Schema、拓扑、正反例和不可变来源/hash；内部 Agent RPC 见 ../proto/agent/agent.proto。Markdown 不代替机器校验。
evidence/saas-dispatcher-implementation.md：本地测试、故障/重启与未验证项的可核查证据；evidence/saas-dispatcher-p07-audit.md 逐项核查旧入口、历史例外与来源/hash。
../AGENTS.md：本独立项目开发、SIP、部署、真实呼叫与诊断约束。

architecture/ 保存产品方案、边界与阶段背景；decisions/ 保存设计决定；contracts/ 是原有合同和提案记录，当前机器约束以 ../contracts/local/ 为准；acceptance/ 保存跨阶段验收基线，须按本轮单节点/单 Cell/单租户范围核对。
plan-saas-dispatcher-v05-v0.1.md 是不可变历史来源：原文件路径和 SHA-256 被当前合同 manifest.json 引用，必须保持原字节，不是第二个当前运行计划。旧 plan-config-read-v0.1.md、plan-dispatcher-state-v0.1.md、plan-0926.md、thirds/v0.1–v0.4 和上游 MQ-only v1 只供追溯旧事实，不能覆盖当前项目内合同，也不能作为兼容回退。
archive/ 保存旧 W/F 工作包、旧部署样例、上一版 AGENTS 原文，以及 contracts-local-history/ 中 17 个逐字节保留的旧本地 Schema/示例；它们均不参与当前合同或运行校验。archive/plan-0918.md 是旧 W00–W16 原文，不是现在的执行入口。归档说明不能代签真实验收。
evidence/README.md 说明历史证据保留规则；旧本地结果仍按当时环境和版本解读，不能据此推断当前合同或真实供应商已通过。
../deploys/README.md 为 Mock-only 本地发布及物理环境要求，实际新主机/版本/Cell 诊断与拨号前受限抓包见 ../deploys/test/nonprod-call-evidence.sh。本地包检查不替代真实 Asterisk 加载或生产审批。