rain
109 lines
7.3 KiB
Markdown
109 lines
7.3 KiB
Markdown
# 家谱 APP 交接记录
|
||
|
||
> 更新时间：2026-07-13
|
||
> 用途：更换电脑或更换 GPT 后，先读本文件即可恢复当前工作上下文。
|
||
> 保密说明：账号、密码、令牌和其他敏感信息不记录在本文件。
|
||
|
||
## 1. 新接手者先做什么
|
||
|
||
按以下顺序阅读，不要跳过：
|
||
|
||
1. 根目录 `AGENTS.md`：项目工作约束，要求先确认依据、最小修改、修改后验证。
|
||
2. `docs/规划.md`：全项目范围、完成状态与推进顺序。
|
||
3. `docs/design/D1_安卓视觉规范与页面壳.md`：Android 视觉、兼容性、PNG 资产与背景规则。
|
||
4. `docs/design/G01_我的家谱_设计记录.md`：G01 已完成的施工与最终验收结论。
|
||
5. `docs/superpowers/specs/2026-07-12-g01-reference-typography-design.md` 与 `docs/superpowers/plans/2026-07-12-g01-information-hierarchy.md`：G01 的已确认规格与执行记录。
|
||
|
||
视觉唯一基准：
|
||
|
||
- `docs/design/screens/G01-我的家谱-紧凑版设计稿-v5-Tabbar安全区.png`
|
||
|
||
不要把“红色中国风”当作完成标准；G01 需要按此图逐区、逐字段、逐比例比对。
|
||
|
||
## 2. 项目与范围
|
||
|
||
- 项目：uni-app，目标为 Android，使用 HBuilderX 打包。
|
||
- 当前阶段：先完成全部页面视觉设计和小屏验收；**暂不恢复接口联调、真实账号联调或 Android 打包**。
|
||
- 当前正在处理：`D2 / A-01 启动登录引导`设计；`G-01 我的家谱`已于 2026-07-13 验收完成。不得直接进入页面实现。
|
||
- 当前不做：iOS、PC 管理端、官网，以及新增业务接口。
|
||
- 本地展示数据的唯一来源：`data/mock.js`；G01 当前不调用远程 API。
|
||
- 本目录当前不是 Git 仓库；不要擅自初始化仓库、重置文件或删除既有用户文件。
|
||
|
||
## 3. 用户已确认的视觉规则
|
||
|
||
- 风格是“家祠卷轴”：朱砂页头、暖宣纸、古金细线、墨褐文字、淡墨山水/竹影；禁止绿色页面背景。
|
||
- 需要使用的图标、谱印框与云纹必须是项目内的透明 PNG；不能用文字、emoji、CSS 图形或网络图片替代可见图标。
|
||
- 参照图中的布局、字号、字段、图标可见面积和留白需要尽量一比一还原；不要只做“差不多”的国风页面。
|
||
- 要兼容老款 Android：用 rpx、Flex、边距与基础圆角；避免 CSS Grid、`flex gap`、`clip-path`、复杂滤镜和大面积动画。
|
||
- 每次完成一个可验收子项，更新 `docs/规划.md` 和对应设计记录；没有 HBuilderX 同尺寸截图确认时，不能勾选整个页面完成。
|
||
|
||
## 4. G01 当前实际状态
|
||
|
||
### 已施工并通过静态检查
|
||
|
||
- 朱砂顶部、项目 Logo、条件式通知红点、宣纸底纹、淡墨底图、底部 Tabbar。
|
||
- 当前家谱题签、四个快捷入口、分隔金线、创建/加入列表、新建按钮。
|
||
- 透明 PNG 资产已接入：快捷入口、Tab、通知、箭头、元信息图标、谱印框和新建云纹。
|
||
- 当前演示字段已统一为参考稿：
|
||
- 当前家谱：`汤氏家谱 / 河南·洛阳 / 158 位成员 / 管理员`
|
||
- 已加入家谱：`汤氏宗谱 / 山东·济宁 / 286 位成员 / 成员`
|
||
- 当前题签有标题/元信息分隔线；列表右侧角色和箭头应为同一水平基线；日期为“更新于”文字，不显示参考稿中没有的日历图标。
|
||
|
||
### 2026-07-13 最终验收结论
|
||
|
||
- 用户已提供 `360 × 800`、`320 × 568`（含滚动到底部）响应式预览，以及 HBuilderX Web 浏览器 `Pixel 2 XL` 常规屏预览。
|
||
- 已确认：顶部、题签、快捷入口、两条列表、新建按钮、山水和 Tabbar 无重叠或裁切；`320 × 568` 下新建按钮可完整露出在 Tabbar 上方。
|
||
- 用户明确确认可结项，故 G-01 已勾选完成。此结论不解除接口联调、真实账号联调或 Android 打包暂停。
|
||
|
||
## 5. G01 关键文件
|
||
|
||
| 作用 | 文件 |
|
||
| --- | --- |
|
||
| G01 页面与当前题签/快捷入口/新建按钮 | `pages/genealogy/index.vue` |
|
||
| G01 列表项 | `components/GenealogyCard.vue` |
|
||
| 顶部标题栏/Logo/通知点 | `components/PageHeader.vue` |
|
||
| 底部导航 | `components/AppTabbar.vue` |
|
||
| 展示数据 | `data/mock.js` |
|
||
| 视觉变量 | `styles/tokens.scss`、`styles/global.scss` |
|
||
| G01 图标 | `static/assets/icons/` |
|
||
| G01 背景 | `static/assets/backgrounds/` |
|
||
| G01 契约检查 | `tests/g01-visual-contract.ps1` |
|
||
| 新 PNG 透明检查 | `tests/g01-asset-alpha-audit.ps1` |
|
||
|
||
## 6. 已知技术注意项
|
||
|
||
- `tests/g01-visual-contract.ps1` 用 UTF-8 Base64 形式检查中文展示字段。这是为了避免 Windows PowerShell 5.1 将无 BOM UTF-8 脚本中的中文字符串误读为乱码；不要把该段直接改回裸中文字面量。
|
||
- `calendar-v1.png` 已因为参考稿没有该图标而删除；不要再次接入日期图标。
|
||
- G01 的背景资产应继续使用 `footer-mountain-bamboo.png`，不要换回实心灰山的 `footer-mountain-bamboo-v2.png`。
|
||
- 题签透明角已经过检查；若再次出现白角，优先检查题签容器是否重新加上不透明的矩形底色。
|
||
- 所有新 PNG 在接入前都要检查：RGBA、四角透明、主体没有大量空白、显示尺寸符合 24dp/设计稿。
|
||
|
||
## 7. 复核命令
|
||
|
||
在项目根目录的 PowerShell 中运行：
|
||
|
||
```powershell
|
||
powershell -ExecutionPolicy Bypass -File tests\g01-visual-contract.ps1
|
||
powershell -ExecutionPolicy Bypass -File tests\g01-asset-alpha-audit.ps1
|
||
powershell -ExecutionPolicy Bypass -File tests\compile-audit.ps1
|
||
powershell -ExecutionPolicy Bypass -File tests\uni-scss-injection.ps1
|
||
powershell -ExecutionPolicy Bypass -File tests\vue3-entry.ps1
|
||
```
|
||
|
||
最近一次结果：五项均为 `PASS`。这只证明代码和资产契约通过，**不替代 HBuilderX 视觉验收**。
|
||
|
||
## 8. 换电脑操作
|
||
|
||
1. 完整复制整个 `jiapuapp` 项目文件夹，保留 `docs/`、`static/`、`tests/`、`data/` 和所有 Vue/SCSS 文件。
|
||
2. 新电脑安装 HBuilderX 后，直接“打开目录”选择复制后的项目根目录。
|
||
3. 将本文件和后续页面的新截图一起发给新的 GPT，并说明：“先读 `docs/交接记录.md` 与 `AGENTS.md`，按规划继续页面设计，不要改接口。”
|
||
4. 新 GPT 修改后，先运行第 7 节命令，再由用户在 HBuilderX 提供同尺寸截图复核。
|
||
|
||
## 9. 2026-07-13 流程纠正记录
|
||
|
||
- A-01 的历史效果稿 v1、v2 与当前效果稿 v3 均已归档；当前入口依据为 `docs/design/screens/A01-启动登录引导-效果稿-v3-文字注册入口.png`，对应说明见 `docs/design/A01_启动登录引导_设计记录.md`。
|
||
- A-01 的固定栅格、状态、独立背景/图标及 320 × 568、360 × 640、360 × 800、412 × 915 静态效果稿已归档并经审计；它们仍不替代 uni-app 页面实现后的 Android 运行时验收。
|
||
- 先前误建的 A-01 规格和“四个独立按钮”执行计划已降为失效历史；2026-07-13 已确认文字注册入口方案，唯一需求所有者为 `docs/design/A01_启动登录引导_设计记录.md`。A-02 尚未开始设计，但负责账号密码与手机验证码双标签；不允许开始任何 uni-app 实现。
|
||
- 所有后续页面效果图必须先保存到 `docs/design/screens/`，并在对应页面设计记录写明用途、状态和验收缺口；未完成归档不得展示为可推进的设计成果。
|
||
- G-01 已于 2026-07-13 经用户确认结项；当前进入 D2 / A-01 的设计工作，接口、真实登录和 Android 打包仍暂停。
|