# 05: 真实联调基线与收口证据门槛

Type: grilling
Status: resolved
Labels: wayfinder:grilling
Blocked by: 01, 04

## Question

锁定每个真实接线切片进入和退出联调的可重复基线与证据门槛。

## Answer

### 一、范围与承载（Q1/Q2/Q3/Q7/Q8）

- 本票定**登记格式与门槛**，并实际完成第一张样板卡片（地图摘要 + 运行监测）。
- 卡片载体：`.scratch/cockpit-real-data-wayfinding/handoff/baselines/<切片名>.md`；本票正文只写规则与索引（子票存细节、上位票存索引）。
- 形式：纯 Markdown、字段固定、附**可复制命令**（复查者照命令可重跑）；本阶段不写自动采集脚本（需真实环境稳定后才值得做）。
- 版本漂移：后端/前端新提交 = **追加新卡片编号**，旧卡片标「已被 #N 取代」；同一环境以最新卡片为准。
- 责任分工：只记**角色与出处**（后端负责人 / 前端负责人 / 真人验收团队 + 对应票、文档、命令），不记个人姓名。

### 二、基线锚点与联调环境（Q13 修订）

- **基线锚点＝仓库提交**：后端与前端各自的仓库、分支、提交哈希，以及**已推送到 Gogs**（后端 `http://192.168.110.30:3000/shaoy/pipe-ner-server`、前端 `http://192.168.110.30:3000/ChenJZ/City-Lifeline-Cockpit`）。未提交或未推送即为未完成项。
- **联调判定环境＝本地 `http://192.168.110.96:8301` 可达**；本地联调通过后才提交 git（维护者 2026-10-08 确认）。
- **目标部署 `192.168.110.30:8301` 移出本阶段**，不再计入未完成项；可在后续阶段单独立项。

### 三、四种状态阶梯（Q4/Q5）

按证据强度递进，每级写明「允许缺什么、禁止宣称什么」：

| 状态 | 判据 | 禁止宣称 |
| --- | --- | --- |
| ① 接口 200 | 单次请求通（无凭据 HTTP 200、`readOnly: true`） | 「已接好」 |
| ② 契约已接 | 字段/结构与前端消费对齐，且**无伪造**（空态/缺字段如实呈现） | 「联调完成」 |
| ③ 真实数据联调完成 | 在锁定基线上（本地联调环境可达 + 代码已提交推送）前后端联通，含空/失败态验证 | 「模式收口」 |
| ④ 模式整体收口 | 该模式全部面板 + 地图 + 推送在真人验收下通过 | — |

**缺项即降级且明写原因**：卡片必须留「未完成项 + 原因 + 补齐条件」，状态最多到 ②；禁止用本机证据冒充目标环境结论、用未提交工作树冒充交付、用 mock 走查冒充真实联调。

### 四、卡片结构（Q9/Q10）

固定骨架：

1. **基线**：后端仓库/分支/提交哈希 + 推送状态；前端仓库/分支/提交哈希 + 推送状态；联调环境 baseUrl；访问控制范围；只读数据源/快照；记录时间与记录角色。
2. **收口条件五行**（逐项记「状态 + 证据 + 未完成项」）：
   ① 后端提交/编译/契约测试；② 状态筛选与 `MANHOLE` 跨端；③ `createdAt` 数据时间；④ real 生命周期；⑤ 真实环境/访问控制/数据快照 + 走查。
3. **真人验收小节**：场景、参与角色、时间、结论、可见结果（截图/录屏路径或现场确认说明）；**程序证据与人工结论分列、互不替代**；真实设备整体流程以人工结论为准。
4. **未完成项与补齐条件**。
5. **关联**：对应执行票 + 上位票（本地票 25 / 后端 Gogs #63）。

### 五、边界（Q6/Q11）

- 本票只给**闸门与格式**，不定义业务口径；决策票 06 的业务口径（异常统计、处置率 `5 / 0–6`、管理字段）作为对应模式收口的**证据项**被引用。
- 本票不改任何业务代码、不改后端实现。

### 六、第一张样板卡片（Q12）

切片＝**地图摘要 + 运行监测**，落于 `handoff/baselines/map-monitoring.md`，用 2026-10-08 的实测证据填写：本地联调环境可达、免鉴权实测通过、`map-snapshot` 忽略 `pointStatus`（#02 缺口实证）、三端点无 `createdAt`（#03 缺口实证）、前后端均有未提交改动（提交门槛未达）。状态判定不超过 ②。

## 状态

**已解决。** 登记格式、四态阶梯、缺项降级纪律、责任分工、卡片结构、版本漂移规则与联调环境锚点均已确认；第一张样板卡片已随本票产出。目标部署不在本阶段范围。后续每个切片进入联调时按其模板追加卡片。