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` 做验证与任务拆解
- 不回退到旧草案正文做判断