# 规划

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

> 状态：执行中  
> 建立日期：2026-07-11  
> 唯一适用端：Android `uni-app`（HBuilderX 打包）  
> 执行原则：**先完成全部页面设计，再开始逐页实现；每完成一项，立即在本文件勾选。**

## 1. 本轮边界

- 只做手机 Android 用户端；不做 iOS、H5、PC 管理端、后台管理端、官网。
- 范围覆盖思维导图中的 Android 用户端：登录、家谱、家族、消息、我的，以及必要的空白、加载、异常、权限状态。
- 现有 uni-app 页面与接口代码保留为临时功能骨架，但**不计入任何页面设计完成项**，也不再决定最终视觉样式。
- 在“设计验收”完成前，暂停新增业务接口、真实账号联调和打包工作。
- 接口暂未提供的视频、邀请码、多管理员分级等功能：本轮可完成其页面视觉和无数据状态；真实功能接入留到接口阶段。

## 2. 视觉方向（已确定）

### 2.1 风格名称

**家祠卷轴**：喜庆而庄重。以宣纸的温度承载家族记忆，以朱砂表达礼序和重要操作，以古金表达传承；避免网红化、过度卡片化和大面积高饱和红色。

### 2.2 颜色与材质

| 用途 | 色彩 | 规则 |
| --- | --- | --- |
| 页面底色 | 宣纸暖白 `#F6F0E5` | 不使用绿色背景。 |
| 主操作 / 选中 | 朱砂 `#A33B2B` | 仅用于主按钮、当前状态、关键提醒。 |
| 标题 / 主要文字 | 墨褐 `#342A24` | 不使用偏绿的深色。 |
| 细分隔 / 装饰 | 古金 `#B58A4B` | 只做细线、印记、等级，不做大色块。 |
| 容器 | 纸白 `#FFF9EE` | 用轻边线或极浅阴影分层。 |
| 次级文字 | 暖灰褐 `#7A6958` | 保持正文可读性。 |

### 2.3 固定组件规则

- 顶部为简洁的家祠题签式标题栏；可回退页面保留清晰返回区，不能让装饰挤压标题。
- 底部导航固定为“家谱 / 家族 / 我的”，通知作为右上角入口，不单独占 Tab。
- 家谱树中的人物使用竖式人物牌位；姓名、字辈、关系与在世状态层次清楚，不能用装饰遮挡信息。
- 所有功能图标均使用透明背景 PNG，统一由 `static/icons/` 管理；不用网络图标字体，不混用不同画风。
- 图片内容优先使用用户上传的真实照片；没有照片时使用统一的纸纹占位图，不使用 AI 人像。

## 3. Android 老机型与小屏兼容（必须验收）

### 3.1 尺寸与排版

- 以 `320 × 568`、`360 × 640` 为关键小屏；`360 × 800`、`412 × 915` 为常规屏进行核对。
- 布局使用流式纵向滚动；不以单一固定页面高度承载内容，不让底部按钮压住表单。
- 一行中可能出现长姓名、长家谱名、长地址时必须截断或换行，不允许文字重叠。
- 关键正文不小于 `24rpx`，主要按钮高度不小于 `88rpx`，所有可点击区域不小于约 `44dp`。
- 双列内容在 `320px` 宽度下自动折为单列；人物树、照片墙等横向内容提供明确的横向滚动区域与边缘提示。
- 顶部、底部均预留系统状态栏和 Android 三键/手势导航空间；无安全区能力的设备也要有保底内边距。

### 3.2 性能与技术限制

- 不使用全屏大尺寸背景图、视频背景、复杂滤镜、毛玻璃和持续动画。
- 不依赖 `flex gap`、复杂 CSS Grid 或只在新 WebView 支持的视觉效果；以 Flex、边距和基础圆角为主。
- 首屏图标为小尺寸透明 PNG；列表图片按缩略图加载，避免一次性渲染大量高清图。
- 家谱树按层级或视区呈现，不在低端机一次渲染无边界的全部成员节点。
- 表单、弹窗、图片预览都要可关闭、可返回，并在键盘弹起时保持提交按钮可见。

### 3.3 兼容验收方式

- 每个页面设计完成后，先按 `320 × 568` 检查：标题、长文案、表单、底部操作、横向内容五项均不得重叠。
- 全部页面实现后，以 Android 真机或模拟器覆盖上述四组尺寸，记录在本文件“最终验收”中。
- 这里的“兼容”指页面尺寸、性能和交互可用性；具体最低 Android 系统版本在最终 HBuilderX 打包配置阶段按实际 SDK 再确认。

## 4. 页面设计的完成标准

一页只有同时满足以下四项，才能标记为“设计完成”：

1. 有明确的正常态布局、字体层级、颜色、图标、间距与操作层级。
2. 有该页需要的空数据、加载、失败、无权限或审核中状态。
3. 标明每个主要点击入口的去向、返回路径和确认操作。
4. 已按 `320 × 568` 小屏规则检查，无重叠、无被底部导航遮挡的内容。

## 5. 全量页面清单与完成状态

### 5.1 设计基础与通用状态

- [x] P-00 锁定 Android 端范围、家祠卷轴视觉方向与透明 PNG 图标规则。
- [x] P-01 锁定老机型 / 小屏适配原则与验收尺寸。
- [x] P-02 设计系统：颜色、字号、间距、圆角、按钮、标签、列表、表单、弹窗、空状态。见 [D1 安卓视觉规范与页面壳](design/D1_安卓视觉规范与页面壳.md)。
- [x] P-03 公共页面壳：顶部题签、返回栏、三 Tab、右上角通知入口、安全区与底部操作栏。见 [D1 安卓视觉规范与页面壳](design/D1_安卓视觉规范与页面壳.md)。
- [x] P-04 通用状态：首次加载、列表加载、网络失败、空数据、无权限、审核中、删除确认、操作成功提示。见 [D1 安卓视觉规范与页面壳](design/D1_安卓视觉规范与页面壳.md)。
- [ ] P-05 生成并验收项目 Logo、导航、通知与公共操作的透明 PNG 图标资产。见 [D1 安卓视觉规范与页面壳](design/D1_安卓视觉规范与页面壳.md)。
- [ ] P-06 生成并验收祠堂红头、宣纸纸纹、山水 / 竹影等项目内背景资产。见 [D1 安卓视觉规范与页面壳](design/D1_安卓视觉规范与页面壳.md)。

### 5.2 账户与首次使用

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

### 5.3 家谱：创建、加入与管理入口

- [x] G-01 信息层级与谱印施工：元信息图标、谱印框、快捷入口、当前题签两层结构、列表两行信息、页头屋檐、紧凑 Tabbar 与新建祥云 v2 已实现并通过资产/编译审计；2026-07-13 已由用户基于小屏与 HBuilderX 预览确认验收。
- [x] G-01 我的家谱列表（已创建、已加入、通知入口）。公开家谱搜索入口由 G-06 / G-07 统一承接，避免与本页重复。
- [ ] G-02 无家谱空状态（创建家谱 / 搜索加入）。
- [ ] G-03 创建家谱表单（名称、地域、简介、公开范围）。
- [ ] G-04 创建成功后的始祖录入页。
- [ ] G-05 家谱总览（名称、编号、地域、成员数、管理员、公开状态、快捷入口）。
- [ ] G-06 公开家谱搜索与筛选页。
- [ ] G-07 家谱搜索结果与家谱简介页。
- [ ] G-08 申请加入表单、提交成功与审核中页。
- [ ] G-09 我的申请记录页。
- [ ] G-10 管理员申请审核列表与审核确认页。
- [ ] G-11 家谱设置、公开范围与成员访问说明页。
- [ ] G-12 字辈诗列表、详情与管理员维护页。

### 5.4 世系树、成员与亲属关系

- [ ] T-01 世系树总览（缩放、横向移动、分支切换、当前人物定位）。
- [ ] T-02 世系树小屏提示与无成员 / 数据加载失败状态。
- [ ] T-03 成员档案详情（基本资料、代际、关系、照片、人生记录入口）。
- [ ] T-04 新增直系亲属页（父母、配偶、子女的不同上下文）。
- [ ] T-05 编辑成员资料页。
- [ ] T-06 编辑亲属关系页与关系冲突提示。
- [ ] T-07 成员目录与搜索页。
- [ ] T-08 成员去世、隐私隐藏、无编辑权限等特殊状态。

### 5.5 家族：动态、谱文、相册与影像

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

### 5.6 家族：人物、礼仪与档案

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

### 5.7 消息与个人中心

- [ ] 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. 设计推进顺序（开发前必须全部完成）

| 阶段 | 交付内容 | 状态 |
| --- | --- | --- |
| D1 | P-02 至 P-06：统一设计系统、Android 页面壳、公共图标与背景资产 | 进行中（P-02 至 P-04 已完成；P-05、P-06 资产生成中） |
| D2 | A-01 至 A-06：账户与首次使用全套页面 | 进行中（A-01 设计方案已确认，待归档效果稿 v2、固定栅格、状态与小屏验收；A-02 至 A-06 未开始） |
| D3 | G-01 至 G-12：家谱创建、加入、总览与管理全套页面 | 进行中（G-01 已于 2026-07-13 验收完成；G-02 至 G-12 未开始） |
| D4 | T-01 至 T-08：世系树、成员、关系编辑全套页面 | 未开始 |
| D5 | F-01 至 F-10、R-01 至 R-11：家族内容全套页面 | 未开始 |
| D6 | N-01 至 N-02、M-01 至 M-10：消息与个人中心全套页面 | 未开始 |
| D7 | 全量小屏复核、视觉一致性复核、页面流程复核 | 未开始 |
| D8 | 逐页实现 uni-app、接入接口、Android 打包验证 | 未开始（D7 完成后才可开始） |

## 7. 页面流转主线（设计时必须保持一致）

1. 登录 → 我的家谱为空 → 创建家谱 → 录入始祖 → 家谱总览 → 世系树 → 成员档案 / 新增亲属。
2. 登录 → 搜索公开家谱 → 查看简介 → 申请加入 → 审核中 → 管理员审核 → 进入家谱总览。
3. 家族 Tab → 动态 / 谱文 / 相册 / 人物录 / 礼仪 / 档案 → 详情 → 发布或编辑（取决于权限）。
4. 任一页面的通知入口 → 消息中心 → 相应业务详情。
5. 我的 → 个人资料 / 安全 / 帮助 / 反馈 / VIP / 关于与协议。

## 8. 本轮执行纪律

- 每次只推进一个设计阶段；阶段内的每个页面完成后，更新本文件对应复选框。
- 未有高保真设计和小屏检查的页面，不得开始其业务开发。
- 已确认的视觉规范是代码还原依据；若实现与设计不一致，以设计为准修正实现。
- 参考图是视觉锚点；核心材质、层级、比例、选中效果必须逐项一比一核对，不能只保留“红色中国风”的笼统印象。
- 设计稿不得保留无业务意义的横线、破折号或模拟字符；颜色差异必须有可见且明确的业务含义。
- 后续每一个页面新增的功能图标，必须同步生成或从官方 / 许可来源获取、保存并验收透明 PNG 实体资产；未具备本地验收资产的页面不得标记为“设计完成”。
- 功能图标必须遵循线上成熟标准的 24dp 语义、留白、触控与选中规则，并导出为透明 PNG；项目可在此基础上保留已确认的古金双线、轻云纹收口等家祠风格。当前从大图裁切的试验资产不得引用，需按单图标标准重新导出后验收。
- 大部分按钮、顶部操作和快捷入口图标采用已确认的古金双线、轻云纹收口风格；底部 Tab 使用简洁同色系版本。每一页必须指定并使用已生成的背景资产组合，未完成背景设计的页面不得标记为“设计完成”。
- 全页 AI 生成图可作为页面的美术效果锚点，但不能单独作为布局验收依据；页面必须同时按固定 Android 栅格、真实数据、真实 PNG 资产制作。已生成的“我的家谱”效果图保留其朱砂、宣纸、题签、山水和庄重层级，留白、Logo、占位文案与图标标准问题按设计栅格修正后才可计入完成项。
- 新增需求先写入本文件，再决定是否纳入本轮，避免在页面开发中临时扩张范围。

## 9. 最终验收（暂未开始）

- [ ] 所有 P / A / G / T / F / R / N / M 页面均有设计完成标记。
- [ ] 全部设计在 `320 × 568` 下无内容重叠、无遮挡、无不可点操作。
- [ ] 所有图标均为透明背景 PNG，且无绿色页面背景。
- [ ] 页面风格与“家祠卷轴”设计一致，代码页面与确认设计逐屏比对通过。
- [ ] 全量页面设计确认后，才解锁 uni-app 实现、接口联调和 Android 打包。