City-Lifeline-Cockpit/.scratch/cockpit-real-data-wayfinding/issues/22-22.md

22: 前端执行票 —— 真实响应信封消费与业务错误映射修复

Type: task Status: ready-for-agent Label: ready-for-agent Category: frontend-execution

来源

票 18 真实联调实测（2026-10-10）。

现象

前端真实响应消费与后端事实不一致，两处都属误判：

1. 真实数据被读成空：fetchBaseArchives 对真实 /infrastructure/base-archives（facilityCount=1006）返回分区 state=empty；fetchMapSnapshot 对真实 /map-snapshot（total=13）返回 total=null、snapshotAt=''。业务载荷被外层信封结构挡住。

2. 业务错误被读成成功：/events/current?mode=ALARM 业务 code=500，前端分区判为 success。

3. 界面表现（真人走查第 2 项）：总体概览-预警设置、基础设施-应急保障、运行监测-运行概况、预警处置四个面板「数据加载失败」或空白，与真实响应事实不符。

范围

1. 定位信封解析层：真实响应为 {code, msg, data}，前端转换层必须按 data 取业务载荷，并按 code 判定成败；code≠200 一律失败分区。
2. 修正「真实有数据 → 显示无数据」与「业务失败 → 显示成功」两类误判，覆盖全部领域服务（地图、基础设施、监测、事件、预警处置、概览、详情、实时）。
3. 失败分区不得牵连其它分区（既有纪律保持）。
4. 补契约测试：信封正确解包、code=500 判失败、空态与失败态措辞可区分。

验收

用 .scratch/cockpit-real-data-wayfinding/verify/t18-real-audit.mjs 的前端适配器检查项全部通过（当前 frontend-envelope-archive、frontend-envelope-map、frontend-business-error-not-success 三项失败）；浏览器四模式面板与真实响应一致。

关联

发现于票 18；承接票 04 适配层纪律与票 05 分区状态词汇。

进度

Status: ready-for-agent Type: task Blocked by: Labels: ready-for-agent, frontend-execution, wayfinder:task

Comments

Answer