05-integration-baseline-and-evidence.md 4.4 KB
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）
固定骨架：
- 基线：后端仓库/分支/提交哈希 + 推送状态；前端仓库/分支/提交哈希 + 推送状态；联调环境 baseUrl；访问控制范围；只读数据源/快照；记录时间与记录角色。
- 收口条件五行（逐项记「状态 + 证据 + 未完成项」）：
① 后端提交/编译/契约测试；② 状态筛选与
MANHOLE跨端；③createdAt数据时间；④ real 生命周期；⑤ 真实环境/访问控制/数据快照 + 走查。 - 真人验收小节：场景、参与角色、时间、结论、可见结果（截图/录屏路径或现场确认说明）；程序证据与人工结论分列、互不替代；真实设备整体流程以人工结论为准。
- 未完成项与补齐条件。
- 关联：对应执行票 + 上位票（本地票 25 / 后端 Gogs #63）。
五、边界（Q6/Q11）
- 本票只给闸门与格式，不定义业务口径；决策票 06 的业务口径（异常统计、处置率
5 / 0–6、管理字段）作为对应模式收口的证据项被引用。 - 本票不改任何业务代码、不改后端实现。
六、第一张样板卡片（Q12）
切片＝地图摘要 + 运行监测，落于 handoff/baselines/map-monitoring.md，用 2026-10-08 的实测证据填写：本地联调环境可达、免鉴权实测通过、map-snapshot 忽略 pointStatus（#02 缺口实证）、三端点无 createdAt（#03 缺口实证）、前后端均有未提交改动（提交门槛未达）。状态判定不超过 ②。
状态
已解决。 登记格式、四态阶梯、缺项降级纪律、责任分工、卡片结构、版本漂移规则与联调环境锚点均已确认；第一张样板卡片已随本票产出。目标部署不在本阶段范围。后续每个切片进入联调时按其模板追加卡片。