# 家谱 APP 地基重整设计

## 目标

在不改变用户已验收 A01、G01 视觉结果的前提下，建立唯一、可维护的页面目录、路由映射、图片资产包、公共组件和中文注释规范，为其余 57 个页面／状态单元提供稳定地基。

## 已确认约束

- Android `uni-app`；不增加依赖、不接新接口、不做额外功能。
- A01、G01 是冻结视觉锚点，必须在 412 × 915 回归验证。
- 可见装饰均使用图片：不透明图片承担完整底色和外观；透明 PNG 仅作为叠加元素；CSS 不绘制装饰。
- 禁止整页截图、局部切片、拼接背景、拼装按钮和保留重复／未引用资产。
- 页面文件采用页面编号和语义名；旧路径只有在所有引用更新并验证后才能删除。
- 所有非直观结构、逻辑、路由和资产图层使用中文注释；实现只覆盖确认需求。

## 架构

`docs/design/P00_页面结构与资产清单.md` 管理页面与资源的映射。`static/assets/foundation/opaque` 与 `transparent` 承载跨模块资源，模块专用资源放入 `modules/<module>/`。`pages.json` 是实际路由唯一来源，页面、跳转和测试与其同轮迁移。

公共组件只沉淀已被两页以上使用且视觉稳定的结构。页面内部无法确认复用的内容不抽象，避免万能组件和预留逻辑。

## 验收

1. 当前 15 个路由在 P00 中均有明确用途和目标文件名。
2. 每个保留图片可追溯用途、透明属性和代码引用；删除前后二次扫描均无引用。
3. A01、G01 在 412 × 915 下没有可见视觉回退。
4. 相关审计、编译检查与 `git diff --check` 通过。