jiapuapp/docs/规划.md

家谱 APP 总规划

电脑或 GPT 更换时，先阅读：项目交接记录。

当前阶段：Product Design 视觉精修已启动；59 页面第一版可浏览，只有 A01、G01 已获用户视觉验收，A02 正在作为认证样板重做。 适用端：Android uni-app（HBuilderX 打包） 页面总量：59 个规划页面／状态单元；当前已注册 59 条最终编号路由。

1. 本轮目标与边界

• 只做 Android 用户端；不做 iOS、H5、PC 管理端、后台管理端或官网。
• 本窗口以“全量覆盖后集中精修”为顺序推进：先让 59 页拥有统一视觉与本地可浏览入口，再按截图集中修改。
• 已由用户验收的 A01 启动／登录引导页与 G01 我的家谱页是冻结视觉基准。可重整其内部目录和复用方式，但 412 × 915 的可见效果不得改变。
• 59 条最终路由与文件清单由 tests/full-page-visual-contract.ps1 单一维护；代码覆盖不等同于用户视觉验收完成。
• 不新增业务接口、真实账号联调、Android 打包或设计清单以外的功能。

2. 唯一依据与完成口径

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

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

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

3. 已确认视觉地基

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

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

4.1 页面与路由

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

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 账户与首次使用

• A-01 启动／登录引导：登录、微信登录、注册入口、协议勾选。
• A-02 账号密码登录：账号密码／手机验证码双标签；卷轴认证样板已实现并完成四尺寸截图，等待用户视觉验收。
• A-03 手机验证码登录与微信授权回跳状态。
• A-04 注册与服务协议确认。
• A-05 忘记密码／重设密码。
• A-06 账号受限、登录失败、未完成注册、微信授权取消／失败。

5.2 家谱

• 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. 视觉基线审视（进行中）：已完成页面映射、资产迁移、公共组件中文注释和运行时零引用旧资源清理；A01 两张完整按钮已接入。2026-07-13 已通过 Chrome 调试端口捕获 A01、G01、A02 的 360 × 800 基线图，审视记录见 design/2026-07-13-A01-G01-A02-视觉审视.md；下一步先重做 A02 认证样板，不修改冻结的 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 通过。
• 规划、交接、设计记录和资产清单同步反映真实状态。