# 个人中心视觉与真实资料开发日志

操作时间：2026-09-11
操作类型：修改、扩展
影响模块：用户资料模型、个人中心、个人资料、视觉fixture与验收文档

## 操作前状态

图25的主要分组已经存在，但个人中心未读取服务端 `real_name`，实名认证始终缺失；紧急联系人没有真实数量。常用功能行高偏大，390×844只能显示部分入口，底部还有设计稿之外的重复维修和退出按钮。个人资料页即使接口已有实名也显示“认证状态尚未接入”。

## 具体操作

- `UserProfile` 增加向下兼容的 `realName` 字段并解析服务端 `real_name`。
- 个人中心在实名存在时显示绿色“已认证”，个人资料页同步显示实名，不再与接口事实矛盾。
- 并行读取紧急联系人数量；该辅助接口失败时不阻断资料、钱包和其他入口。
- 常用功能行高、资产区内边距和标题字号按图25收敛，使全部入口在390×844首屏显示。
- 删除设计稿外重复的“申请维修”和“退出登录”按钮；报修入口及设置页退出保持可用。
- 当前未接入的家庭共享、用气统计、电子发票、押金、客服和关于入口继续显示“暂未开放”，点击给出明确原因。

## 操作后状态

远程资料中的姓名、脱敏手机号、实名、钱包余额和联系人数量均按接口事实展示。当前测试账号头像为空、联系人数量为0，因此页面显示首字头像和“0人”；头像编辑页仍提供拍照和相册上传，不把设计稿头像当成用户头像。

## 代码变更

- `apps/user_app/lib/domain/models/client_models.dart`：增加实名字段解析。
- `apps/user_app/lib/ui/features/profile/profile_page.dart`：实名、联系人数量和图25布局密度。
- `apps/user_app/lib/ui/features/profile/profile_edit_page.dart`：同步显示真实认证状态。
- `apps/user_app/test/support/a1_fixture.dart`：增加认证与联系人视觉fixture。
- `apps/user_app/test/domain/client_models_test.dart`、`test/ui/profile_edit_page_test.dart`：实名解析和页面回归。

## 验证结果

- Flutter静态分析通过；全量166项测试通过。
- 图25在320、360、390、430宽及1.0/1.3文本比例共8组fixture生成通过；已查看390×844官方并排图。
- Flutter Web release构建通过。
- 内置浏览器读取远程数据，确认“已认证 陈示例”、联系人0人、全部入口、暂未开放弹层以及拍照/相册头像菜单。

## 风险评估

- 设计稿中的头像、200元可退押金、2张优惠券和2条消息属于示例或尚无接口数据，当前页面不伪造。
- 常用功能采用较紧凑行高以匹配图25；320宽和1.3倍文字已通过无溢出fixture，仍需Android/iOS真机复核系统字体差异。