# 家谱 APP 总规划

> 电脑或 GPT 更换时，先阅读：[项目交接记录](交接记录.md)。

> 当前阶段：P-00 地基重整（结构与现有资产已迁移；A01 完整按钮候选已生成、待设计图复核与截图回归）
> 适用端：Android `uni-app`（HBuilderX 打包）
> 页面总量：59 个规划页面／状态单元；当前已注册 15 个路由，两者不是同一口径。

## 1. 本轮目标与边界

- 只做 Android 用户端；不做 iOS、H5、PC 管理端、后台管理端或官网。
- 先完成项目地基：页面目录、路由映射、资产包、公共组件、中文注释和验收规则；地基通过前不继续 A02。
- 已由用户验收的 A01 启动／登录引导页与 G01 我的家谱页是**冻结视觉基准**。可重整其内部目录和复用方式，但 412 × 915 的可见效果不得改变。
- 现有的 15 个路由只是临时功能骨架；它们不等于 59 个页面均已设计或完成。
- 不新增业务接口、真实账号联调、Android 打包或设计清单以外的功能。

## 2. 唯一依据与完成口径

1. 本文件管理全项目范围、页面状态和推进顺序。
2. [D1 安卓视觉地基规范](design/D1_安卓视觉规范与页面壳.md)管理视觉、资产、组件和代码约束。
3. [P00 页面结构与资产清单](design/P00_页面结构与资产清单.md)管理路由命名、资产去留和清理结果。
4. [项目交接记录](交接记录.md)记录换电脑后应从哪里继续。

页面只有同时满足以下条件才可标记完成：

- 页面编号、功能、正常态和必要异常态明确。
- 使用已验收资产包，没有临时图片、截图切片、CSS 装饰或无引用资源。
- 在 320 × 568、360 × 640、360 × 800、412 × 915 下完成对应检查。
- 用户确认视觉结果；对应设计记录、规划和交接记录同步更新。

## 3. 已确认视觉地基

- 风格：家祠卷轴——暖宣纸、朱砂、古金、墨褐、淡墨山水；禁止绿色页面背景和“差不多的国风”。
- 冻结锚点：
  - A01：[412 × 915 栅格验收图](design/screens/A01-启动登录引导-栅格验收-412x915.png)
  - G01：[紧凑版设计稿](design/screens/G01-我的家谱-紧凑版设计稿-v5-Tabbar安全区.png)
- 视觉资产全部使用图片文件：不透明图片负责自身底色／纹理，透明 PNG 负责叠加装饰、Logo 与图标。CSS 只负责布局、文字和状态，不绘制可见装饰。
- 主按钮、次按钮、卡片、页头等有完整边框和底色的元素必须使用完整不透明图片；禁止四角、边线和 CSS 底色拼接。
- 不把整页设计图或其局部裁切后直接塞进页面；复杂背景使用完整背景图片，不能断裂或拼接。

## 4. 目录、资产与代码硬规则

### 4.1 页面与路由

- 页面文件使用“`页面编号-语义名.vue`”，例如 `a01-entry.vue`、`g01-my-genealogies.vue`、`t01-tree-overview.vue`。
- `pages.json`、跳转 URL、测试与页面文件必须同轮更新；旧入口确认无引用后删除，不保留兼容副本。
- 当前路由到目标文件的映射只以 [P00 页面结构与资产清单](design/P00_页面结构与资产清单.md) 为准。

### 4.2 资产

- 资产目录按 `foundation|modules`、`opaque|transparent`、模块和语义名管理；不再使用含义不明的 `v1`、`v2`、`source`、重复文件名作为长期资产。
- 每项资产必须记录：路径、用途、所属组件、透明属性、显示尺寸、引用页面和去留状态。
- 删除前必须用代码引用扫描确认未被页面、组件、配置、测试或文档作为运行时资源引用；不能按文件名猜测。
- 所有新增可见资产先单独验收，再允许放入页面；资产未通过不能通过页面验收。

### 4.3 JavaScript、Vue 与中文注释

- 只实现已确认页面、交互和数据状态；不增加推测功能、预留接口、万能工具函数、无用变量或无关依赖。
- 组件只有在至少两个已确认页面共享同一结构和行为时才抽取；否则保留在页面内。
- 每个页面和组件文件开头注明编号／用途；模板按背景、页头、主体、操作和状态分段写中文注释。
- 非直观跳转、状态分支、资产图层和关键样式必须写中文注释，说明用途和约束；不为显而易见的单行属性堆无意义注释。
- 每轮改动后删除本轮产生的无用导入、变量、函数、路径和资产。

## 5. 59 个页面／状态单元

| 模块 | 范围 | 数量 | 当前状态 |
| --- | --- | ---: | --- |
| 账户与首次使用 | A-01 至 A-06 | 6 | A01 已验收；其余未完成 |
| 家谱 | G-01 至 G-12 | 12 | G01 已验收；其余未完成 |
| 世系树与成员 | T-01 至 T-08 | 8 | 未完成 |
| 家族内容 | F-01 至 F-10 | 10 | 未完成 |
| 人物、礼仪与档案 | R-01 至 R-11 | 11 | 未完成 |
| 消息 | N-01 至 N-02 | 2 | 未完成 |
| 个人中心 | M-01 至 M-10 | 10 | 未完成 |
| **合计** |  | **59** | **已验收 2 个** |

### 5.1 账户与首次使用

- [x] A-01 启动／登录引导：登录、微信登录、注册入口、协议勾选。
- [ ] A-02 账号密码登录：账号密码／手机验证码双标签。
- [ ] A-03 手机验证码登录与微信授权回跳状态。
- [ ] A-04 注册与服务协议确认。
- [ ] A-05 忘记密码／重设密码。
- [ ] A-06 账号受限、登录失败、未完成注册、微信授权取消／失败。

### 5.2 家谱

- [x] G-01 我的家谱列表：已创建、已加入、通知入口。
- [ ] G-02 无家谱空状态。
- [ ] G-03 创建家谱表单。
- [ ] G-04 创建成功后的始祖录入。
- [ ] G-05 家谱总览。
- [ ] G-06 公开家谱搜索与筛选。
- [ ] G-07 搜索结果与家谱简介。
- [ ] G-08 申请加入、提交成功与审核中。
- [ ] G-09 我的申请记录。
- [ ] G-10 管理员申请审核与确认。
- [ ] G-11 家谱设置、公开范围与访问说明。
- [ ] G-12 字辈诗列表、详情与维护。

### 5.3 世系树与成员

- [ ] T-01 世系树总览。
- [ ] T-02 小屏提示、无成员与加载失败状态。
- [ ] T-03 成员档案详情。
- [ ] T-04 新增直系亲属。
- [ ] T-05 编辑成员资料。
- [ ] T-06 编辑亲属关系与冲突提示。
- [ ] T-07 成员目录与搜索。
- [ ] T-08 去世、隐私隐藏和无权限等状态。

### 5.4 家族内容

- [ ] F-01 家族首页／动态流。
- [ ] F-02 发布动态。
- [ ] F-03 动态详情、评论、点赞与删除确认。
- [ ] F-04 谱文分类与文章列表。
- [ ] F-05 谱文详情。
- [ ] F-06 新建／编辑谱文。
- [ ] F-07 相册列表。
- [ ] F-08 相册详情与照片墙。
- [ ] F-09 图片预览、上传与失败状态。
- [ ] F-10 视频列表、详情与接口未开放状态。

### 5.5 人物、礼仪与档案

- [ ] R-01 人物录列表；R-02 人物录详情与编辑。
- [ ] R-03 贺礼列表；R-04 贺礼新增、详情与删除确认。
- [ ] R-05 礼仪活动列表；R-06 礼仪详情；R-07 新建／编辑礼仪。
- [ ] R-08 成长日志；R-09 人生事；R-10 备忘录；R-11 功德记录。

### 5.6 消息与个人中心

- [ ] N-01 消息中心；N-02 消息详情、已读与空状态。
- [ ] M-01 我的首页；M-02 个人资料；M-03 安全设置；M-04 修改密码；M-05 修改手机号。
- [ ] M-06 帮助中心；M-07 意见反馈；M-08 应用推广；M-09 VIP 与订单；M-10 关于、协议、隐私与退出确认。

## 6. 推进顺序

1. **P-00 地基重整（当前）**：已完成页面映射、现有资产迁移、公共组件中文注释和运行时零引用旧资源清理；A01 两张完整按钮候选已保存但尚未接入。下次先按设计图复核候选比例和纹样，通过后才替换旧角标拼接实现，再回归 A01、G01。
2. A-02 至 A-06：在冻结的 A01 认证资产包上完成账户模块。
3. G-02 至 G-12：在冻结的 G01 列表、题签、导航资产包上完成家谱模块。
4. T、F、R、N、M 模块：每个模块先确认母版和完整资产包，再批量实现其页面／状态。
5. 全量四尺寸复核、真实接口接入与 Android 打包。

## 7. 本轮完成前的验收

- 页面路由、文件名与 P00 映射表一致；不存在不明 `index.vue`、`detail.vue`、`list.vue` 作为最终页面名。
- 所有保留资产都能说明用途；所有删除资产均通过未引用扫描。
- A01、G01 在 412 × 915 截图与当前用户验收基准无可见回退。
- 编译检查、页面／资产审计和 `git diff --check` 通过。
- 规划、交接、设计记录和资产清单同步反映真实状态。