jiapuapp/docs/superpowers/specs/2026-07-13-foundation-rebuild-design.md

家谱 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 通过。