# 家谱 APP 总规划

> **2026-07-16 状态覆盖说明：** 本文件保留旧阶段范围与历史记录，其中旧路由和验收数字已经失效。当前实际为 `pages.json` 52 条活动路由、`docs/验收规划.md` 中 52 页全部 `[~]` 待审核、0 页冻结；A06 已封存并保留实现。准确停点与下一步以 `docs/交接记录.md` 和 `docs/验收规划.md` 为准。

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

> 当前阶段：Product Design 视觉精修持续推进；54 条最终路由可浏览，A01、A02、A04、A05、A06、G01 两种状态与 G03 `create|ancestor` 双步骤已获用户视觉验收；G 模块与 T 模块候选稿已完成，统一等待全量设计完成后逐页审核。
> 适用端：Android `uni-app`（HBuilderX 打包）
> 页面总量：54 个独立页面／状态单元；当前已注册 54 条最终编号路由。

## 1. 本轮目标与边界

- 只做 Android 用户端；不做 iOS、H5、PC 管理端、后台管理端或官网。
- 本窗口以“全量覆盖后集中精修”为顺序推进：先让 54 条独立路由拥有统一视觉与本地可浏览入口，再按截图集中修改。
- 已由用户验收的 A01 启动／登录引导、A02 账号登录、A04 注册账号、A05 重置密码、A06 登录状态与 G01 默认有家谱态是**冻结视觉基准**。可重整其内部目录和复用方式，但已验收状态的 412 × 915 可见效果不得改变。
- 54 条最终路由与文件清单由 `tests/full-page-visual-contract.ps1` 单一维护；代码覆盖不等同于用户视觉验收完成。
- 不新增业务接口、真实账号联调、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. 54 个独立页面／状态单元

| 模块 | 范围 | 数量 | 当前状态 |
| --- | --- | ---: | --- |
| 账户与首次使用 | A-01、A-02、A-04 至 A-06 | 5 | A01、A02、A04、A05、A06 已验收 |
| 家谱 | G-01、G-03、G-05、G-06、G-08 至 G-12 | 9 | G01 两种状态与 G03 双步骤已验收；G05、G06、G08 至 G12 候选稿待用户逐页审核 |
| 世系树与成员 | T-01、T-03 至 T-08 | 7 | T02 已收敛为 T01 同页状态；7 个页面候选稿待用户逐页审核 |
| 家族内容 | F-01 至 F-10 | 10 | 10 个页面候选稿待用户逐页审核 |
| 人物、礼仪与档案 | R-01 至 R-11 | 11 | 11 个页面候选稿待用户逐页审核 |
| 消息 | N-01 至 N-02 | 2 | 2 个页面候选稿待用户逐页审核 |
| 个人中心 | M-01 至 M-10 | 10 | 10 个页面候选稿待用户逐页审核 |
| **合计** |  | **54** | **已验收 7 个；其余 47 个均已形成 `[~]` 候选，等待用户逐页审核** |

视觉审核标记由用户逐页确认：`[ ]` 待设计，`[~]` 候选稿已完成、待用户审核，`[x]` 用户已验收，`[!]` 用户要求返工。Codex 只能把页面推进到 `[~]`；只有用户明确确认后才能改为 `[x]`。每个候选页面必须保留关键状态截图目录，便于连续勾选直至 54 个页面全部验收。

### 5.1 账户与首次使用

- [x] A-01 启动／登录引导：登录、微信登录、注册入口、协议勾选。
- [x] A-02 账号密码登录：账号密码／手机验证码双标签、页内协议确认与注册入口；已获用户视觉验收，冻结可见效果。
- [x] A-04 注册与服务协议确认：用户已于 2026-07-14 视觉验收通过，冻结可见效果。
- [x] A-05 忘记密码／重设密码：用户已于 2026-07-14 视觉验收通过，冻结可见效果。
- [x] A-06 账号受限、登录失败、未完成注册、微信授权取消／失败：用户已于 2026-07-14 视觉验收通过，冻结可见效果。

### 5.2 家谱

- [x] G-01 我的家谱：已创建、已加入、通知入口与 `?state=empty` 无家谱状态均获用户视觉验收。
- [x] G-03 创建家谱：`step=create|ancestor` 管理创建表单与首代录入，已获用户视觉验收，冻结可见效果。
- [~] G-05 家谱总览：候选稿已完成，含正常、空、失败状态与 360 × 800／412 × 915 截图，待用户视觉审核。
- [~] G-06 公开家谱搜索与筛选：已合并 G07 的初始、结果与无结果状态；朱砂题签候选及三态运行截图已完成，待用户视觉审核。
- [~] G-08 申请加入与提交成功：候选稿已完成，使用页面内模拟交互，不对接接口，待用户视觉审核。
- [~] G-09 我的申请记录：候选稿已完成，含列表、空、失败状态，待用户视觉审核。
- [~] G-10 管理员申请审核与确认：候选稿已完成，含列表、空、失败与审核确认交互，待用户视觉审核。
- [~] G-11 家谱设置、公开范围与访问说明：候选稿已完成，含表单、成功、失败状态与双尺寸截图，待用户视觉审核。
- [~] G-12 字辈诗列表、空态与维护：候选稿已完成，含列表、空、编辑、失败状态与双尺寸截图，待用户视觉审核。

### 5.3 世系树与成员

- [~] T-01 世系树总览：已收敛 T02 的横向提示、空态与失败状态，含树态和双尺寸截图，待用户视觉审核。
- [~] 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. **视觉基线审视（进行中）**：已完成页面映射、资产迁移、公共组件中文注释和运行时零引用旧资源清理；A01 两张完整按钮已接入。A01、A02、A04、A05、A06、G01 两种状态与 G03 双步骤均已获用户视觉验收；A03 已删除；G02 已合并入 G01 `state=empty` 并通过验收；G04 已合并入 G03 `step=ancestor`；G07 已合并入 G06 三态。G05、G06、G08、G09、G10 已进入 `[~]` 候选待审；不修改已冻结页面的可见效果。
2. A-04 至 A-06：在冻结的 A01/A02 认证资产包上完成注册、重设和登录状态页面。
3. G-03、G-05 至 G-12：家谱模块候选稿已全部完成；G07→G06 已收敛，G05、G06、G08 至 G12 均为 `[~]` 待审，集中审核留到全量候选完成后进行。
4. T、F、R、N、M 模块：候选稿与 360 × 800 运行截图已全部完成；关键页面另有 412 × 915 截图和状态对比。
5. 当前进入用户逐页视觉审核；全部 `[x]` 后再安排四尺寸总复核、接口阶段与 Android 打包。

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

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