feat(api): 补齐 /me/* 命名空间，恢复 17 个 404 调用 + 修 /me/status 过期桩
背景：小程序 services/*.js 按 REST 规范（§16 / §22-§40 / §80 / §83-§84）统一调用
/me/*，但后端从未注册 /me 基路径，个人资料、照片、择偶条件、隐私设置、关系状态、
我的举报/申诉等约 17 个调用全部 404。
后端
- 新增 me/controller/MeController：把既有 service 能力暴露到规范路径（纯委托，不复制
业务规则，AGENTS.md #26）。旧路径（/profile/*、/photos、/relationship/*、
/account/privacy-settings、/risk/reports/my、/appeals/my）全部保留。
- 响应形状按小程序 JSDoc 适配（小程序被 86 页引用，是权威契约）：
· /me/relationship-status 返回 status（旧 /relationship/status 返回 relationshipStatus，
字段名不同，前端读的是 result.status）
· /me/profile/review-status 返回 {status, items, submittedAt, reviewedAt}，时间统一 epoch 毫秒
· /me/profile/submit-review 返回 {reviewStatus, submittedAt}
- 小程序三条历史写法一并兼容：/me/privacy-settings、/me/photos/{id}/main、/me/appeals
修复
- AuthService.getMeStatus：verified / profileStatus / reviewStatus 三项写死为
false / not_started / not_submitted，注释标注"Phase 03/04/05 填充"，但那三个 Phase
早已交付，导致 /me/status 长期返回错误的实名与审核状态。改为 capabilityService
+ userProfileMapper + reviewTaskMapper 的真实来源（与首页聚合同一判定）。
- PhotoController.deletePhoto：原用 ((Map<?,?>) p).get("id") 强转 UserPhoto 实体，
必然抛 ClassCastException，删除照片恒定 500。改用实体主键比对。
- PhotoService.setMainAvatar（新增）：数据模型以 photo_type='avatar' 标识头像（见
UserPhotoMapper#findAvatar），无 is_main 字段，故"设主图"= 换类型并保证至多一张。
注意：插入该方法时曾把 deletePhoto 原有的 @Transactional 挤到新方法上，导致
"Transactional is not a repeatable annotation" 并引发 Lombok 全面停摆（满屏
找不到 getter/setter），已修正注解归属。
验证
- 后端全量：299 tests / 0 failures / 0 errors / 3 skipped / BUILD SUCCESS（+2 为新增契约测试）
- 新增 MeRouteContractTest（2 例）：同时断言 HTTP 方法，锁定 21 条 /me/* 与 13 条旧路径
- 小程序 tsc --noEmit 通过；UI 契约门禁 13/13
文档
- STATUS.md：/me/* 从"待裁决"改为"已完成"；核心待清债务 1 项 → 0 项
- API_INVENTORY.md：顶部"待收敛"警告改为"已收敛"，补全 /me/* 端点表
This commit is contained in:
Codex
@@ -8,27 +8,29 @@
|
||||
|
||||
| 页面/区域 | 路由 | 数据与权限 | 必备状态 | 当前状态 |
|
||||
|---|---|---|---|---|
|
||||
| 全局背景与系统容器 | 全部登录后路由 | 已登录 | 桌面两种目标分辨率 | 待开始 |
|
||||
| 深色侧栏与顶部栏 | 全部登录后路由 | 现有路由权限 | 展开、收起、搜索反馈、通知反馈、退出 | 待开始 |
|
||||
| 工作台 | `/dashboard` | 授权统计与活动 API | 加载、空、错误、无权限、重试 | 待开始 |
|
||||
| 全局背景与系统容器 | 全部登录后路由 | 已登录 | 桌面两种目标分辨率 | 已实现（待桌面端目视复验） |
|
||||
| 深色侧栏与顶部栏 | 全部登录后路由 | 现有路由权限 | 展开、收起、搜索反馈、通知反馈、退出 | 已实现（待桌面端目视复验） |
|
||||
| 工作台 | `/dashboard` | 授权统计与活动 API | 加载、空、错误、无权限、重试 | 已实现（待桌面端目视复验） |
|
||||
|
||||
管理端其他 18 条现有业务路由为后续批次。本批只要求它们继续在新框架中可进入且权限行为不退化。
|
||||
|
||||
## 小程序首批 11 个核心页面
|
||||
|
||||
> **2026-09-16：本批 11 页全部交付并通过用户验收（结论：基本达标）。** 11/11 页为 TS-only 单一运行源，`ui-tests/miniapp-reference-contracts.mjs` 与 `ui-tests/phase07-home-contracts.mjs` 锁定契约。
|
||||
|
||||
| 分组 | 页面 | 路由 | 权限/能力 | 必备状态 | 当前状态 |
|
||||
|---|---|---|---|---|---|
|
||||
| A | 首页 | `/pages/index/index` | Home Capability | 未登录、准入中、加载、空、错误、暂停、成功牵手 | 待重新实现 |
|
||||
| A | 找对象 | `/pages/discover/discover` | Match Capability | 加载、空、错误、筛选、Required、Blocked | 待重新实现 |
|
||||
| A | 消息 | `/pages/messages/messages` | Mutual Match | 加载、空、错误、未匹配、Blocked、未读 | 待开始 |
|
||||
| A | 公益活动 | `/pages/activity/activity` | Activity Capability | 加载、空、错误、可报名、已报名、截止 | 待开始 |
|
||||
| A | 我的 | `/pages/mine/mine` | 登录状态 | 未登录、加载、错误、资料状态 | 待开始 |
|
||||
| B | 公益红娘 | `/pages/matchmaker/matchmaker` | Matchmaker Capability | 加载、未申请、处理中、服务中、完成、错误 | 待开始 |
|
||||
| B | 婚恋咨询 | `/pages/counseling-intro/counseling-intro` | Counseling Capability | 加载、不可用、可预约、已有服务、错误 | 待开始 |
|
||||
| B | 婚前辅导 | `/pages/premarital-intro/premarital-intro` | Premarital Capability | 加载、不可用、可预约、已有服务、错误 | 待开始 |
|
||||
| C | 婚恋课堂 | `/pages/content/content` | Content Capability | 加载、空、错误、分类、加载更多 | 待开始 |
|
||||
| C | 婚恋反诈 | `/pages/anti-fraud/anti-fraud` | Anti-fraud Capability | 加载、空、错误、举报与求助 | 待开始 |
|
||||
| C | 善缘服务站 | `/pages/service-station/service-station` | Service Location Capability | 加载、空、错误、电话、定位、预约 | 待开始 |
|
||||
| A | 首页 | `/pages/index/index` | Home Capability | 未登录、准入中、加载、空、错误、暂停、成功牵手 | 已交付（2026-09-16 验收通过） |
|
||||
| A | 找对象 | `/pages/discover/discover` | Match Capability | 加载、空、错误、筛选、Required、Blocked | 已交付（2026-09-16 验收通过） |
|
||||
| A | 消息 | `/pages/messages/messages` | Mutual Match | 加载、空、错误、未匹配、Blocked、未读 | 已交付（2026-09-16 验收通过） |
|
||||
| A | 公益活动 | `/pages/activity/activity` | Activity Capability | 加载、空、错误、可报名、已报名、截止 | 已交付（2026-09-16 验收通过） |
|
||||
| A | 我的 | `/pages/mine/mine` | 登录状态 | 未登录、加载、错误、资料状态 | 已交付（2026-09-16 验收通过） |
|
||||
| B | 公益红娘 | `/pages/matchmaker/matchmaker` | Matchmaker Capability | 加载、未申请、处理中、服务中、完成、错误 | 已交付（2026-09-16 验收通过） |
|
||||
| B | 婚恋咨询 | `/pages/counseling-intro/counseling-intro` | Counseling Capability | 加载、不可用、可预约、已有服务、错误 | 已交付（2026-09-16 验收通过） |
|
||||
| B | 婚前辅导 | `/pages/premarital-intro/premarital-intro` | Premarital Capability | 加载、不可用、可预约、已有服务、错误 | 已交付（2026-09-16 验收通过） |
|
||||
| C | 婚恋课堂 | `/pages/content/content` | Content Capability | 加载、空、错误、分类、加载更多 | 已交付（2026-09-16 验收通过） |
|
||||
| C | 婚恋反诈 | `/pages/anti-fraud/anti-fraud` | Anti-fraud Capability | 加载、空、错误、举报与求助 | 已交付（2026-09-16 验收通过） |
|
||||
| C | 善缘服务站 | `/pages/service-station/service-station` | Service Location Capability | 加载、空、错误、电话、定位、预约 | 已交付（2026-09-16 验收通过） |
|
||||
|
||||
## 固定导航与首页入口
|
||||
|
||||
|
||||
Reference in New Issue
Block a user