BUG-0389project-14中已修复frontend-logic

analytics 4 个接口前端路径凭想象写 —— 后端实际挂在 /users 下，404 挂了整块看板

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

症状

学习报表/统计看板整块无数据，接口 404；前端代码里找不到后端路由定义，两边各说各话没人对过账。

前端按『想象中的资源划分』写路径（analytics 应该有 analytics controller），后端按实现便利挂在 users 下——没有 API 契约单源（OpenAPI/生成 client），路径知识纯靠口口相传。

1) 后端补路由别名或前端改对齐（短期），长期以 OpenAPI 生成前端 client，路径字段全由契约出； 2) CI 加契约一致性检查：前端引用的路径集合 ⊆ OpenAPI paths； 3) 404 监控按路径聚合告警，新上线路径无人调用/调用全 404 两天内应被发现。

从前端抽全部 API 路径集合，与后端路由注册表 diff

前端调 /analytics/summary 等 4 个路径；后端 users.controller 里实际是 /users/analytics-* 形态

来源项目

project-14

标签

api-contract, 404, openapi, path-drift, frontend-backend