docs: approve A01 login guide design
This commit is contained in:
@@ -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 打包配置。
|
||||||
@@ -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-04;A-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
@@ -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
@@ -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:消息与个人中心全套页面 | 未开始 |
|
||||||
|
|||||||
Reference in New Issue
Block a user