BUG-0380project-07中已修复frontend-logic

管理后台数据映射四处手写适配器 —— 后端 RawStats schema 与前端假设各说各话

发现：2026-10-01验证：2026-10-09置信度：90%

症状

后端返回结构一变，四个后台页面各自渲染空白或字段错位；适配代码散落且形态互不相同（取 key / 包数组 / 全字段改名）。

前后端之间没有单一的数据契约层：响应结构只有后端单方面知道，前端各页面按『打开响应看一眼』的印象各写各的解析——契约知识被复制 N 份，漂移概率 ×N。

1) 每个后端资源一个 adapter 模块（Raw→View 全部集中），页面只消费 View 类型； 2) adapter 用后端真实响应样例做单测（快照测试），后端改结构先挂测试； 3) 长期方案：OpenAPI 生成 TS 类型，消灭手写映射。

grep -rn 'adapt\|\.data\.' <admin 页面> | 统计页面内手写结构解析的处数

UsersPage 取 res.users、OrdersPage 期望直接数组、AnalyticsPage 需 adaptAnalyticsStats 适配 RawStats——每个页面自己对齐后端响应结构

来源项目

project-07

标签

api-contract, adapter-pattern, admin, schema-drift, single-source