# 家谱 App 迭代进度记录（完成 70%）

日期：2026-07-31
当前分支：`main`

## 本轮已完成

- 完成全项目字体可读性与长文本换行治理，优先保证手机端、长辈用户的阅读体验。
- 调整公共页头：项目名称“代代相传”以“Logo + 名称”组合呈现，页面功能标题保持居中；认证页与“我的”页同步使用该品牌组合。
- 接入默认头像：男性使用男童国风头像，女性使用唐装女性头像；未选择性别时默认使用男性头像。
- 完善成员资料展示，隐藏不应面向普通用户展示的业务用户与内部人物编号信息。
- 修复“我的”、家谱、家族、人物录、通知等模块中已发现的文字截断、状态提示与空/错误态表达问题。
- 保留 T02 世系谱的参考项目结构，仅做兼容性和可读性处理，未改变其核心展示逻辑。
- 新增并通过默认头像、个人资料、消息中心等重点契约检查。

## 当前状态

- 整体功能与视觉治理进度：约 70%。
- 页面入口已完成全局品牌标识覆盖；业务页面仍可继续在真机/模拟器逐页复核细节。
- 相册图片是否能展示取决于接口是否返回可访问的图片地址；当前不伪造图片链接。

## 在另一台电脑运行

1. 拉取 `main` 分支的最新代码。
2. 使用 HBuilderX 导入项目根目录 `jiapuapp`。
3. 等待 HBuilderX 完成编译后，选择“运行到 Android App 基座”并连接 MuMu 或真机。
4. 项目所需头像和页面静态资源已随代码提交，不需要单独拷贝资源文件。

## 后续建议

- 在目标设备尺寸上复核页头品牌组合、表单按钮与底部导航的间距。
- 继续覆盖未登录、空数据、接口异常和超长文本等状态。
- 按接口返回能力补充相册图片的真实访问地址或签名 URL。