supply-intelligence/tech/CURRENT_SOURCE_OF_TRUTH_2026-05.md

Supply-Intelligence 当前实现真源索引（2026-05）

状态：当前有效 目的：为 Engineer / QA / PM 提供单一阅读入口，避免继续误读历史草案。 适用范围：/home/long/project/立交桥/projects/supply-intelligence/

1. 当前结论

当前规划包已收敛到“可进入 Engineer 实现”状态。 当前总门控结论：APPROVED。

但 APPROVED 的前提是：实现、测试、评审都必须以本文件列出的“当前真源”解释，不得回退到旧 PRD/HLD/INTERFACE/DEPLOYMENT 的正文口径。

2. 当前真源文件（按优先级）

2.1 一级真源：必须优先遵循

1. /home/long/project/立交桥/projects/supply-intelligence/tech/BASELINE_TECHLEAD_V2.md

   • 作用：当前技术基线、状态机、模块边界、集成约束、最小生产闭环定义
   • 适用问题：实现边界、状态迁移、部署形态、首期能力范围、风险与验证要求

2. /home/long/project/立交桥/projects/supply-intelligence/tech/GATEWAY_CONSUMER_DECISION_2026-05.md

   • 作用：首期 package/account 消费闭环决议
   • 适用问题：published vs applied、gateway 是否默认消费方、package change + ack、真实调用链落点

2.2 二级真源：必须按一级真源解释

3. /home/long/project/立交桥/projects/supply-intelligence/tech/TEST_DESIGN.md

   • 作用：收敛后的测试门禁文档
   • 使用规则：
     • 只能按一级真源解释
     • 当前阶段门控结论以其中已更新的 APPROVED 段落为准
     • 若正文某处仍残留旧测试假设，以一级真源覆盖

4. /home/long/project/立交桥/projects/supply-intelligence/specs/功能清单.md

   • 作用：任务粒度参考清单
   • 使用规则：
     • 仅用于任务拆分、实现排程、UI/后端任务定位
     • 若与一级真源冲突，一律以一级真源为准
     • 不得把其中任何历史平台化/重基础设施/深自动注册项当作默认首期门槛

3. 历史参考文件（禁止作为当前实现真源）

以下文件只能用于理解历史上下文，不能再作为 Engineer/QA 的当前实现依据：

1. /home/long/project/立交桥/projects/supply-intelligence/prd/PRD.md
2. /home/long/project/立交桥/projects/supply-intelligence/tech/HLD.md
3. /home/long/project/立交桥/projects/supply-intelligence/tech/INTERFACE.md
4. /home/long/project/立交桥/projects/supply-intelligence/tech/DEPLOYMENT.md

原因：这些文件虽已加失效声明，但正文仍保留大量旧设计，例如：

• pricing / prediction / 向量检索 / 仪表盘扩张
• 独立 API/worker/重基础设施默认前提
• gateway 管理接口热更新主路径
• 深自动注册 / 浏览器自动化主路径
• published 与 gateway applied 语义混淆

4. Engineer 必须先建立的统一理解

4.1 首期能力边界

首期目标不是独立平台化大系统，而是“立交桥延伸项目 + 简洁集成架构 + 最小生产闭环”。

这意味着：

• 优先并入 supply-api 主仓
• 优先复用主仓已有配置、调度、审计、内部路由能力
• 不把 Redis / Temporal / 向量数据库 / WebSocket / MQ 作为首期硬前置
• 不做 pricing / prediction / recommendation / SFI 仪表盘扩张

4.2 探针判定边界

必须按 explicit_failure / inconclusive / success 三类解释，不能回退到旧的“timeout 直接惩罚性降级”口径。

4.3 自动补给边界

首期不是深自动注册主路径。 首期仅保留“受控自动补给最小边界”：

• 白名单供应商
• 阈值触发
• 任务化补给或受控补给受理接口
• pending_verify / pending_enable 等受控中间态
• fail-closed

不得默认实现：

• 浏览器自动化注册
• 短信验证码编排主路径
• 无审批直接自动激活

4.4 gateway 消费闭环边界

首期默认采用：

• package 发布链路：event + ack
• account 状态链路：查询型消费

必须明确：

• published != applied
• active package != gateway 已消费成功
• 没有真实 poll/apply/ack 入口，不得宣称 package 发布链路已完成

5. QA 审查必须卡的四条红线

1. 若实现重新引入 published/applied 混淆，直接打回
2. 若把深自动注册重新膨胀成首期硬门槛，直接打回
3. 若把旧独立平台化基础设施重新作为首期依赖，直接打回
4. 若 gateway 只有接口定义、没有真实消费方入口与 ack 回写，直接打回

6. 推荐阅读顺序

Engineer / QA / PM 开始工作前，按以下顺序阅读：

1. tech/CURRENT_SOURCE_OF_TRUTH_2026-05.md
2. tech/BASELINE_TECHLEAD_V2.md
3. tech/GATEWAY_CONSUMER_DECISION_2026-05.md
4. tech/TEST_DESIGN.md
5. specs/功能清单.md

禁止跳过前 3 份文件直接依据旧 PRD/HLD/INTERFACE/DEPLOYMENT 开始实现。

7. 一句话执行规则

如果某个设计点在文档间出现冲突：

• 先看 BASELINE_TECHLEAD_V2.md
• 再看 GATEWAY_CONSUMER_DECISION_2026-05.md
• 然后用 TEST_DESIGN.md 和 功能清单.md 做验证与任务拆解
• 不回退到旧草案正文做判断