rain
149 lines
9.9 KiB
Markdown
149 lines
9.9 KiB
Markdown
# 家谱 APP 总规划
|
||
|
||
> 电脑或 GPT 更换时，先阅读：[项目交接记录](交接记录.md)。
|
||
|
||
> 当前阶段：Product Design 视觉精修已启动；55 条路由第一版可浏览，A01、A02、A04、A05、A06、G01 两种状态与 G03 `create|ancestor` 双步骤均已获用户视觉验收；G07 已收敛到 G06 初始／结果／无结果状态。G06 最新朱砂题签候选只完成初始态截图，结果／无结果同版截图与用户审美确认待补。
|
||
> 适用端：Android `uni-app`（HBuilderX 打包）
|
||
> 页面总量：55 个独立页面／状态单元；当前已注册 55 条最终编号路由。
|
||
|
||
## 1. 本轮目标与边界
|
||
|
||
- 只做 Android 用户端；不做 iOS、H5、PC 管理端、后台管理端或官网。
|
||
- 本窗口以“全量覆盖后集中精修”为顺序推进：先让 55 条独立路由拥有统一视觉与本地可浏览入口，再按截图集中修改。
|
||
- 已由用户验收的 A01 启动／登录引导、A02 账号登录、A04 注册账号、A05 重置密码、A06 登录状态与 G01 默认有家谱态是**冻结视觉基准**。可重整其内部目录和复用方式，但已验收状态的 412 × 915 可见效果不得改变。
|
||
- 55 条最终路由与文件清单由 `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. 55 个独立页面／状态单元
|
||
|
||
| 模块 | 范围 | 数量 | 当前状态 |
|
||
| --- | --- | ---: | --- |
|
||
| 账户与首次使用 | 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 双步骤已验收；G06 当前候选只完成初始态新图，结果／无结果复核与用户确认待补；其余未完成 |
|
||
| 世系树与成员 | 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 | 未完成 |
|
||
| **合计** | | **55** | **已验收 7 个；G06 当前候选待补三态复核与确认** |
|
||
|
||
### 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 家谱总览。
|
||
- [ ] G-06 公开家谱搜索与筛选：已合并 G07 的初始、结果与无结果状态；用户选定朱砂题签候选，当前仅初始态新图，待补结果／无结果同版截图、审视与用户审美确认。
|
||
- [ ] 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 两张完整按钮已接入。A01、A02、A04、A05、A06、G01 两种状态与 G03 双步骤均已获用户视觉验收；A03 已删除；G02 已合并入 G01 `state=empty` 并通过验收；G04 已合并入 G03 `step=ancestor`；G07 已合并入 G06 三态。G06 当前的朱砂题签候选只有初始态新截图，必须补同版结果／无结果截图、审视并取得用户确认；不修改已冻结页面的可见效果。
|
||
2. A-04 至 A-06：在冻结的 A01/A02 认证资产包上完成注册、重设和登录状态页面。
|
||
3. G-03、G-05 至 G-12：在冻结的 G01 列表、题签、导航资产包上完成家谱模块；G07→G06 已完成，下一项为 T02→T01 的世系树状态收敛。
|
||
4. T、F、R、N、M 模块：每个模块先确认母版和完整资产包，再批量实现其页面／状态。
|
||
5. 全量四尺寸复核、真实接口接入与 Android 打包。
|
||
|
||
## 7. 本轮完成前的验收
|
||
|
||
- 页面路由、文件名与 P00 映射表一致；不存在不明 `index.vue`、`detail.vue`、`list.vue` 作为最终页面名。
|
||
- 所有保留资产都能说明用途；所有删除资产均通过未引用扫描。
|
||
- A01、G01 在 412 × 915 截图与当前用户验收基准无可见回退。
|
||
- 编译检查、页面／资产审计和 `git diff --check` 通过。
|
||
- 规划、交接、设计记录和资产清单同步反映真实状态。
|