docs: approve A01 login guide design

This commit is contained in:
rain
2026-07-13 12:23:10 +08:00
parent aacd503e2f
commit 040c2cb37e
8 changed files with 94 additions and 18 deletions
@@ -0,0 +1,41 @@
# A-01 启动 / 登录引导设计记录
> 状态:设计方案已确认,D2 / A-01 进行中;**尚未完成布局验收或页面实现**。
>
> 本页设计事实的唯一归档位置为本文件。旧的 `2026-07-13-a01-login-guide-design.md` 与 `2026-07-13-a01-login-guide.md` 仅保留为失效历史,不可作为实现或推进下一页的依据。
## 1. 已归档的美术锚点
- 文件:[`screens/A01-启动登录引导-效果稿-v1-显式协议.png`](screens/A01-启动登录引导-效果稿-v1-显式协议.png)
- 用途:保留本轮已确认的“家祠卷轴”欢迎页美术方向,不作为可直接还原的代码布局图,也不作为功能图标资产。
- 画面方向:朱砂家祠红头、暖宣纸主体、古金细线与云纹、墨褐标题、两侧淡墨建筑/竹影与底部山水。登录欢迎页后续必须使用独立的红头/宣纸背景组合,不复用 G01 的列表页大山水底图。
## 2. 已确认的页面结构与交互
- 标题区保留“家谱 / 为家族留存可传承的记忆”,使用美术锚点中的朱砂家祠红头、暖宣纸、古金云纹、墨褐文字与淡墨建筑/竹影层次。
- 操作区从上到下固定为四个独立入口:账号密码登录(朱砂主按钮)、手机验证码登录、微信登录、注册账号(古金描边按钮)。四个按钮均须单行显示。
- 入口顺序:账号密码登录为主入口;手机号验证码登录、微信登录与注册账号为次入口。
- 账号密码入口前往 `A-02`;手机号验证码入口前往 `A-03`;微信入口由 `A-03` 承接授权中、取消与失败回跳状态。
- 注册账号入口前往 `A-04`;忘记密码属于 `A-05`,不在 A-01 新增入口。
- 协议必须为用户主动勾选:初始未勾选,可分别打开《家谱用户协议》和《隐私政策》。不得使用“登录即表示同意”或任何默认同意文案;未勾选时登录操作应明确提示用户先确认协议。
## 3. 固定布局与状态边界
- 页面采用纵向滚动;`320 × 568` 下四个入口与协议行可以滚动,但任一按钮文字、协议行和底部内容不得被系统导航区遮挡。
- 登录、手机号、微信和注册的功能图标均需采用独立本地透明 PNG;微信标志只使用官方或许可来源的原色透明 PNG,不自行重绘或改色。
- A-01 只设计欢迎、入口与协议未勾选提示。账号密码表单归 `A-02`,验证码与微信授权结果归 `A-03`,注册归 `A-04`,忘记密码归 `A-05`
- A-01 正常态必须展示四个入口和未勾选协议;点击任一需要授权的入口但未勾选协议时,仅提示“请先阅读并同意相关协议”,不视为用户已同意。
## 4. 未完成项(因此不得标记为设计完成)
1. 按 Android 固定栅格确定 320 × 568、360 × 640、360 × 800、412 × 915 的真实布局与文字折行规则。
2. 生成并归档包含独立“注册账号”按钮的 A-01 效果稿 v2;现有 v1 仅保留为此前美术方向记录。
3. 补齐 A-01 的加载与协议未勾选提示;微信授权中/取消/失败仍归 A-03。
4. 生成并验收项目内的真实透明 PNG 功能资产;微信品牌标志必须采用本地官方或许可透明 PNG,并记录来源、用途、路径与 Alpha 验收。此处归档的整页效果图不能充当图标资产。
5. 标明协议页的最终去向、返回路径与小屏验收结果。
## 5. 推进约束
- 当前正式工作是 `D2 / A-01 启动登录引导` 的设计;A-02 保持冻结。
- 只有完成本文件第 4 节,并更新 `docs/规划.md``docs/交接记录.md` 后,A-01 才能进入“设计完成”状态。
- 本轮不修改 uni-app 页面、接口、真实登录或 Android 打包配置。
+8 -2
View File
@@ -1,12 +1,12 @@
# G-01:我的家谱设计记录 # G-01:我的家谱设计记录
> 状态:资产准备中 > 状态:设计验收完成(2026-07-13,用户确认)
> 美术锚点:[G01 我的家谱美术锚点](references/G01-我的家谱-美术锚点.png) > 美术锚点:[G01 我的家谱美术锚点](references/G01-我的家谱-美术锚点.png)
> 布局锚点:[D1 安卓视觉规范与页面壳](D1_安卓视觉规范与页面壳.md#62-g-01-固定设计栅格360--800dp) > 布局锚点:[D1 安卓视觉规范与页面壳](D1_安卓视觉规范与页面壳.md#62-g-01-固定设计栅格360--800dp)
## 页面目标 ## 页面目标
让已登录用户一眼查看当前家谱、进入四个高频入口、切换已创建 / 已加入家谱,并在无家谱创建或搜索加入。 让已登录用户一眼查看当前家谱、进入四个高频入口、切换已创建 / 已加入家谱无家谱创建或搜索加入状态归属 `G-02`
## 背景组合 ## 背景组合
@@ -126,3 +126,9 @@
- 根页头总高度改为可视导航高度加 `var(--status-bar-height, 0px)`,并以相同变量作为顶部内边距;状态栏不会压缩 Logo、标题和通知入口。 - 根页头总高度改为可视导航高度加 `var(--status-bar-height, 0px)`,并以相同变量作为顶部内边距;状态栏不会压缩 Logo、标题和通知入口。
- 宣纸纸纹起点使用同一计算高度,避免状态栏存在时红头结束处出现错层。 - 宣纸纸纹起点使用同一计算高度,避免状态栏存在时红头结束处出现错层。
- Android App 配置朱砂状态栏背景和浅色系统图标;仍需在有刘海、无刘海与三键导航 Android 真机复核。 - Android App 配置朱砂状态栏背景和浅色系统图标;仍需在有刘海、无刘海与三键导航 Android 真机复核。
## 2026-07-13 最终视觉验收
- 用户已提供 `360 × 800` 正常页、`320 × 568` 顶部与滚动到底部的响应式预览截图:顶部、题签、四个快捷入口、两条列表、新建按钮、山水与 Tabbar 均无重叠;`320 × 568` 下新建按钮可完整滚动至 Tabbar 上方。
- 用户已提供 HBuilderX Web 浏览器中 `Pixel 2 XL` 的常规屏预览:页面内容、山水和 Tabbar 均无裁切。
- 用户于 2026-07-13 明确确认“没事你标记吧可以了”,据此将 G-01 标记为设计验收完成。该确认不等同于 Android 原生包、真机刘海/三键导航或接口联调验收,以上工作仍按总规划暂停。
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 MiB

@@ -317,3 +317,6 @@ git commit -m "feat: connect A01 auth routes"
- **规格覆盖:** Task 1 和 Task 3 覆盖三入口、主次层级、本地资产、无接口和显式协议;Task 4 覆盖小屏视觉与两种协议状态;Task 5 覆盖 A-02/A-03 的跳转契约且被 D2 设计完成门槛锁住。 - **规格覆盖:** Task 1 和 Task 3 覆盖三入口、主次层级、本地资产、无接口和显式协议;Task 4 覆盖小屏视觉与两种协议状态;Task 5 覆盖 A-02/A-03 的跳转契约且被 D2 设计完成门槛锁住。
- **占位检查:** 没有未落实的实现步骤。Task 2 的来源 URL 是执行时取得的审计事实;没有可验证来源即停止该任务,不得提交资产。 - **占位检查:** 没有未落实的实现步骤。Task 2 的来源 URL 是执行时取得的审计事实;没有可验证来源即停止该任务,不得提交资产。
- **命名一致性:** 页面状态固定为 `consented`,守卫固定为 `enterLogin`,跨页唯一映射固定为 `entryRoutes`Task 1 与 Task 5 的测试和实现使用同一命名。 - **命名一致性:** 页面状态固定为 `consented`,守卫固定为 `enterLogin`,跨页唯一映射固定为 `entryRoutes`Task 1 与 Task 5 的测试和实现使用同一命名。
# 已失效历史记录(2026-07-13
> 本计划在未完成设计归档与验收前被错误建立,现禁止执行。唯一有效的 A-01 归档为 `docs/design/A01_启动登录引导_设计记录.md`;当前工作仍以 `docs/交接记录.md` 的 G-01 验收为准。
@@ -0,0 +1,20 @@
# A-01 启动 / 登录引导已确认设计
> 状态:设计方案已于 2026-07-13 获用户确认;尚未完成视觉验收或页面实现。
>
> 唯一需求所有者:[A01 启动登录引导设计记录](../../design/A01_启动登录引导_设计记录.md)。本文件只记录本次审批,不重复定义页面规则。
## 审批结论
- A-01 延续已归档的“家祠卷轴”欢迎页美术锚点。
- 账号密码登录为朱砂主按钮;手机验证码登录、微信登录和独立的注册账号按钮依次位于其下。
- 注册账号入口直达 A-04A-02、A-03、A-05 的职责边界不改变。
- 协议默认不勾选,禁止“登录即同意”。
- 本审批仅启动 A-01 的设计工作;不授权任何 uni-app 页面实现、接口联调、真实登录或 Android 打包。
## 后续关口
1. 生成并归档 A-01 效果稿 v2。
2. 以固定 Android 栅格补齐正常与协议未勾选提示状态。
3. 生成并验收本地透明 PNG 功能资产。
4.`320 × 568``360 × 640``360 × 800``412 × 915` 完成小屏视觉验收后,才可标记 A-01 设计完成。
@@ -50,3 +50,6 @@ A-01 是 Android 用户端首次进入应用时的登录方式选择页。它只
3. 初始画面没有“登录即同意”、没有预勾选协议、没有注册和忘记密码入口。 3. 初始画面没有“登录即同意”、没有预勾选协议、没有注册和忘记密码入口。
4. 未勾选协议点击任一登录入口不跳转;勾选后才按表格进入 A-02 或 A-03。 4. 未勾选协议点击任一登录入口不跳转;勾选后才按表格进入 A-02 或 A-03。
5. 页面没有底部 Tab、接口加载、真实授权、状态栏兼容处理或 Android 打包改动。 5. 页面没有底部 Tab、接口加载、真实授权、状态栏兼容处理或 Android 打包改动。
# 已失效历史记录(2026-07-13
> 本文件不再是 A-01 的设计或实现依据。唯一有效的 A-01 归档为 `docs/design/A01_启动登录引导_设计记录.md`;当前工作仍以 `docs/交接记录.md` 的 G-01 验收为准。
+15 -12
View File
@@ -11,7 +11,7 @@
1. 根目录 `AGENTS.md`:项目工作约束,要求先确认依据、最小修改、修改后验证。 1. 根目录 `AGENTS.md`:项目工作约束,要求先确认依据、最小修改、修改后验证。
2. `docs/规划.md`:全项目范围、完成状态与推进顺序。 2. `docs/规划.md`:全项目范围、完成状态与推进顺序。
3. `docs/design/D1_安卓视觉规范与页面壳.md`Android 视觉、兼容性、PNG 资产与背景规则。 3. `docs/design/D1_安卓视觉规范与页面壳.md`Android 视觉、兼容性、PNG 资产与背景规则。
4. `docs/design/G01_我的家谱_设计记录.md`G01 已完成的施工与尚未验收项 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 的已确认规格与执行记录。 5. `docs/superpowers/specs/2026-07-12-g01-reference-typography-design.md``docs/superpowers/plans/2026-07-12-g01-information-hierarchy.md`G01 的已确认规格与执行记录。
视觉唯一基准: 视觉唯一基准:
@@ -24,7 +24,7 @@
- 项目:uni-app,目标为 Android,使用 HBuilderX 打包。 - 项目:uni-app,目标为 Android,使用 HBuilderX 打包。
- 当前阶段:先完成全部页面视觉设计和小屏验收;**暂不恢复接口联调、真实账号联调或 Android 打包**。 - 当前阶段:先完成全部页面视觉设计和小屏验收;**暂不恢复接口联调、真实账号联调或 Android 打包**。
- 当前正在处理:`G-01 我的家谱` - 当前正在处理:`D2 / A-01 启动登录引导`设计;`G-01 我的家谱`已于 2026-07-13 验收完成。不得直接进入页面实现
- 当前不做:iOS、PC 管理端、官网,以及新增业务接口。 - 当前不做:iOS、PC 管理端、官网,以及新增业务接口。
- 本地展示数据的唯一来源:`data/mock.js`G01 当前不调用远程 API。 - 本地展示数据的唯一来源:`data/mock.js`G01 当前不调用远程 API。
- 本目录当前不是 Git 仓库;不要擅自初始化仓库、重置文件或删除既有用户文件。 - 本目录当前不是 Git 仓库;不要擅自初始化仓库、重置文件或删除既有用户文件。
@@ -49,16 +49,11 @@
- 已加入家谱:`汤氏宗谱 / 山东·济宁 / 286 位成员 / 成员` - 已加入家谱:`汤氏宗谱 / 山东·济宁 / 286 位成员 / 成员`
- 当前题签有标题/元信息分隔线;列表右侧角色和箭头应为同一水平基线;日期为“更新于”文字,不显示参考稿中没有的日历图标。 - 当前题签有标题/元信息分隔线;列表右侧角色和箭头应为同一水平基线;日期为“更新于”文字,不显示参考稿中没有的日历图标。
### 必须继续做的事 ### 2026-07-13 最终验收结论
1. HBuilderX 刷新 G01,并使用与参考稿相同的手机预览尺寸截屏 -户已提供 `360 × 800``320 × 568`(含滚动到底部)响应式预览,以及 HBuilderX Web 浏览器 `Pixel 2 XL` 常规屏预览
2. 将新截图与 v5 参考稿并排比对,重点检查: - 已确认:顶部、题签、快捷入口、两条列表、新建按钮、山水和 Tabbar 无重叠或裁切;`320 × 568` 下新建按钮可完整露出在 Tabbar 上方。
- 顶部家谱题签的字体、字段、分隔线和三组元信息是否同一行; - 用户明确确认可结项,故 G-01 已勾选完成。此结论不解除接口联调、真实账号联调或 Android 打包暂停。
- 四个快捷图标的实际可见面积与文字大小;
- 两条列表的谱印、标题、地点/成员、日期、右侧角色和箭头基线;
- 新建按钮的云纹、文字、底部山水和 Tabbar 安全区。
3. 有任何差异时,只改对应 G01 组件并重新截图;不要提前勾选 `G-01`
4. 最终还要按 `320 × 568``360 × 800` 做小屏检查,确认无重叠、无裁切、无底部遮挡。
## 5. G01 关键文件 ## 5. G01 关键文件
@@ -101,5 +96,13 @@ powershell -ExecutionPolicy Bypass -File tests\vue3-entry.ps1
1. 完整复制整个 `jiapuapp` 项目文件夹,保留 `docs/``static/``tests/``data/` 和所有 Vue/SCSS 文件。 1. 完整复制整个 `jiapuapp` 项目文件夹,保留 `docs/``static/``tests/``data/` 和所有 Vue/SCSS 文件。
2. 新电脑安装 HBuilderX 后,直接“打开目录”选择复制后的项目根目录。 2. 新电脑安装 HBuilderX 后,直接“打开目录”选择复制后的项目根目录。
3. 将本文件和新的 HBuilderX 截图一起发给新的 GPT,并说明:“先读 `docs/交接记录.md``AGENTS.md`继续 G01 的视觉验收,不要改接口。” 3. 将本文件和后续页面的新截图一起发给新的 GPT,并说明:“先读 `docs/交接记录.md``AGENTS.md`按规划继续页面设计,不要改接口。”
4. 新 GPT 修改后,先运行第 7 节命令,再由用户在 HBuilderX 提供同尺寸截图复核。 4. 新 GPT 修改后,先运行第 7 节命令,再由用户在 HBuilderX 提供同尺寸截图复核。
## 9. 2026-07-13 流程纠正记录
- A-01 的已确认效果稿已归档为 `docs/design/screens/A01-启动登录引导-效果稿-v1-显式协议.png`,对应说明见 `docs/design/A01_启动登录引导_设计记录.md`
- 该图只保留欢迎页的美术方向:它不是固定栅格、状态设计或小屏验收稿,不得据此标记 A-01 或 D2 完成。
- 先前误建的 A-01 规格和实现计划已降为失效历史;2026-07-13 已确认新的 A-01 设计方案,唯一需求所有者为 `docs/design/A01_启动登录引导_设计记录.md`。A-02 仍冻结,不允许开始任何 uni-app 实现。
- 所有后续页面效果图必须先保存到 `docs/design/screens/`,并在对应页面设计记录写明用途、状态和验收缺口;未完成归档不得展示为可推进的设计成果。
- G-01 已于 2026-07-13 经用户确认结项;当前进入 D2 / A-01 的设计工作,接口、真实登录和 Android 打包仍暂停。
+4 -4
View File
@@ -97,8 +97,8 @@
### 5.3 家谱:创建、加入与管理入口 ### 5.3 家谱:创建、加入与管理入口
- [x] G-01 信息层级与谱印施工:元信息图标、谱印框、快捷入口、当前题签两层结构、列表两行信息、页头屋檐、紧凑 Tabbar 与新建祥云 v2 已实现并通过资产/编译审计;待 HBuilderX 同尺寸截图验收,故完整 G-01 仍未勾选 - [x] G-01 信息层级与谱印施工:元信息图标、谱印框、快捷入口、当前题签两层结构、列表两行信息、页头屋檐、紧凑 Tabbar 与新建祥云 v2 已实现并通过资产/编译审计;2026-07-13 已由用户基于小屏与 HBuilderX 预览确认验收
- [ ] G-01 我的家谱列表(已创建、已加入、搜索入口、通知入口)。 - [x] G-01 我的家谱列表(已创建、已加入、通知入口)。公开家谱搜索入口由 G-06 / G-07 统一承接,避免与本页重复
- [ ] G-02 无家谱空状态(创建家谱 / 搜索加入)。 - [ ] G-02 无家谱空状态(创建家谱 / 搜索加入)。
- [ ] G-03 创建家谱表单(名称、地域、简介、公开范围)。 - [ ] G-03 创建家谱表单(名称、地域、简介、公开范围)。
- [ ] G-04 创建成功后的始祖录入页。 - [ ] G-04 创建成功后的始祖录入页。
@@ -169,8 +169,8 @@
| 阶段 | 交付内容 | 状态 | | 阶段 | 交付内容 | 状态 |
| --- | --- | --- | | --- | --- | --- |
| D1 | P-02 至 P-06:统一设计系统、Android 页面壳、公共图标与背景资产 | 进行中(P-02 至 P-04 已完成;P-05、P-06 资产生成中) | | D1 | P-02 至 P-06:统一设计系统、Android 页面壳、公共图标与背景资产 | 进行中(P-02 至 P-04 已完成;P-05、P-06 资产生成中) |
| D2 | A-01 至 A-06:账户与首次使用全套页面 | 未开始 | | D2 | A-01 至 A-06:账户与首次使用全套页面 | 进行中(A-01 设计方案已确认,待归档效果稿 v2、固定栅格、状态与小屏验收;A-02 至 A-06 未开始 |
| D3 | G-01 至 G-12:家谱创建、加入、总览与管理全套页面 | 进行中(G-01 视觉壳已施工,待 HBuilderX 小屏预览验收;其余页面未开始) | | D3 | G-01 至 G-12:家谱创建、加入、总览与管理全套页面 | 进行中(G-01 已于 2026-07-13 验收完成;G-02 至 G-12 未开始) |
| D4 | T-01 至 T-08:世系树、成员、关系编辑全套页面 | 未开始 | | D4 | T-01 至 T-08:世系树、成员、关系编辑全套页面 | 未开始 |
| D5 | F-01 至 F-10、R-01 至 R-11:家族内容全套页面 | 未开始 | | D5 | F-01 至 F-10、R-01 至 R-11:家族内容全套页面 | 未开始 |
| D6 | N-01 至 N-02、M-01 至 M-10:消息与个人中心全套页面 | 未开始 | | D6 | N-01 至 N-02、M-01 至 M-10:消息与个人中心全套页面 | 未开始 |