Files
jiapuapp/docs/superpowers/specs/2026-07-13-foundation-rebuild-design.md
T
2026-07-13 17:31:11 +08:00

28 lines
1.7 KiB
Markdown

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