Files
danyang-match/docs/UI_REDESIGN_PAGE_MATRIX_V1.1.md
T
Codex bc4531a734 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/* 端点表
2026-09-16 12:54:39 +08:00

4.0 KiB

善缘丹阳 V1.1 当前 UI 重设计页面矩阵

基线:2026-09-13。唯一视觉规格:docs/superpowers/specs/2026-09-13-reference-driven-dual-client-ui-redesign-design.md。

本矩阵只跟踪当前已确认范围:管理端全局框架与工作台、小程序首批 11 个核心页面。其余现有业务页面继续保留,列入后续批次,不得据此删除路由或功能。

管理端第一批

页面/区域 路由 数据与权限 必备状态 当前状态
全局背景与系统容器 全部登录后路由 已登录 桌面两种目标分辨率 已实现(待桌面端目视复验)
深色侧栏与顶部栏 全部登录后路由 现有路由权限 展开、收起、搜索反馈、通知反馈、退出 已实现(待桌面端目视复验)
工作台 /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 未登录、准入中、加载、空、错误、暂停、成功牵手 已交付(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 验收通过)

固定导航与首页入口

  • Tab 顺序:首页、找对象、消息、活动、我的。
  • 首页入口第一行:找对象、公益红娘、公益活动、婚恋咨询。
  • 首页入口第二行:婚恋课堂、婚前辅导、婚恋反诈、善缘服务站。
  • 入口可用性由服务端 Capability 决定,前端不自行推导。

后续批次

  • 小程序其余 52 个已注册页面继续保留,当前不宣称完成视觉重构。
  • 管理端工作台以外的业务列表、详情、表单和弹窗继续保留,当前不宣称完成高保真重构。
  • 只有自动化门禁、微信开发者工具或浏览器截图以及用户人工验收同时通过后,状态才能改为“通过”。