diff --git a/docs/design/A01_启动登录引导_设计记录.md b/docs/design/A01_启动登录引导_设计记录.md new file mode 100644 index 0000000..8f7d352 --- /dev/null +++ b/docs/design/A01_启动登录引导_设计记录.md @@ -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 打包配置。 diff --git a/docs/design/G01_我的家谱_设计记录.md b/docs/design/G01_我的家谱_设计记录.md index 7557b6e..4e88b10 100644 --- a/docs/design/G01_我的家谱_设计记录.md +++ b/docs/design/G01_我的家谱_设计记录.md @@ -1,12 +1,12 @@ # G-01：我的家谱设计记录 -> 状态：资产准备中 +> 状态：设计验收完成（2026-07-13，用户确认） > 美术锚点：[G01 我的家谱美术锚点](references/G01-我的家谱-美术锚点.png) > 布局锚点：[D1 安卓视觉规范与页面壳](D1_安卓视觉规范与页面壳.md#62-g-01-固定设计栅格360--800dp) ## 页面目标 -让已登录用户一眼查看当前家谱、进入四个高频入口、切换已创建 / 已加入家谱，并在无家谱时创建或搜索加入。 +让已登录用户一眼查看当前家谱、进入四个高频入口、切换已创建 / 已加入家谱。无家谱的创建或搜索加入状态归属 `G-02`。 ## 背景组合 @@ -126,3 +126,9 @@ - 根页头总高度改为可视导航高度加 `var(--status-bar-height, 0px)`，并以相同变量作为顶部内边距；状态栏不会压缩 Logo、标题和通知入口。 - 宣纸纸纹起点使用同一计算高度，避免状态栏存在时红头结束处出现错层。 - 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 原生包、真机刘海/三键导航或接口联调验收，以上工作仍按总规划暂停。 diff --git a/docs/design/screens/A01-启动登录引导-效果稿-v1-显式协议.png b/docs/design/screens/A01-启动登录引导-效果稿-v1-显式协议.png new file mode 100644 index 0000000..f962747 Binary files /dev/null and b/docs/design/screens/A01-启动登录引导-效果稿-v1-显式协议.png differ diff --git a/docs/superpowers/plans/2026-07-13-a01-login-guide.md b/docs/superpowers/plans/2026-07-13-a01-login-guide.md index c1ff9de..2fb0e7c 100644 --- a/docs/superpowers/plans/2026-07-13-a01-login-guide.md +++ b/docs/superpowers/plans/2026-07-13-a01-login-guide.md @@ -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 2 的来源 URL 是执行时取得的审计事实；没有可验证来源即停止该任务，不得提交资产。 - **命名一致性：** 页面状态固定为 `consented`，守卫固定为 `enterLogin`，跨页唯一映射固定为 `entryRoutes`；Task 1 与 Task 5 的测试和实现使用同一命名。 +# 已失效历史记录（2026-07-13） + +> 本计划在未完成设计归档与验收前被错误建立，现禁止执行。唯一有效的 A-01 归档为 `docs/design/A01_启动登录引导_设计记录.md`；当前工作仍以 `docs/交接记录.md` 的 G-01 验收为准。 diff --git a/docs/superpowers/specs/2026-07-13-a01-login-guide-approved-design.md b/docs/superpowers/specs/2026-07-13-a01-login-guide-approved-design.md new file mode 100644 index 0000000..bc553b5 --- /dev/null +++ b/docs/superpowers/specs/2026-07-13-a01-login-guide-approved-design.md @@ -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 设计完成。 diff --git a/docs/superpowers/specs/2026-07-13-a01-login-guide-design.md b/docs/superpowers/specs/2026-07-13-a01-login-guide-design.md index b9d797b..92fd78a 100644 --- a/docs/superpowers/specs/2026-07-13-a01-login-guide-design.md +++ b/docs/superpowers/specs/2026-07-13-a01-login-guide-design.md @@ -50,3 +50,6 @@ A-01 是 Android 用户端首次进入应用时的登录方式选择页。它只 3. 初始画面没有“登录即同意”、没有预勾选协议、没有注册和忘记密码入口。 4. 未勾选协议点击任一登录入口不跳转；勾选后才按表格进入 A-02 或 A-03。 5. 页面没有底部 Tab、接口加载、真实授权、状态栏兼容处理或 Android 打包改动。 +# 已失效历史记录（2026-07-13） + +> 本文件不再是 A-01 的设计或实现依据。唯一有效的 A-01 归档为 `docs/design/A01_启动登录引导_设计记录.md`；当前工作仍以 `docs/交接记录.md` 的 G-01 验收为准。 diff --git a/docs/交接记录.md b/docs/交接记录.md index 6e3b312..cec3dcb 100644 --- a/docs/交接记录.md +++ b/docs/交接记录.md @@ -11,7 +11,7 @@ 1. 根目录 `AGENTS.md`：项目工作约束，要求先确认依据、最小修改、修改后验证。 2. `docs/规划.md`：全项目范围、完成状态与推进顺序。 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 的已确认规格与执行记录。 视觉唯一基准： @@ -24,7 +24,7 @@ - 项目：uni-app，目标为 Android，使用 HBuilderX 打包。 - 当前阶段：先完成全部页面视觉设计和小屏验收；**暂不恢复接口联调、真实账号联调或 Android 打包**。 -- 当前正在处理：`G-01 我的家谱`。 +- 当前正在处理：`D2 / A-01 启动登录引导`设计；`G-01 我的家谱`已于 2026-07-13 验收完成。不得直接进入页面实现。 - 当前不做：iOS、PC 管理端、官网，以及新增业务接口。 - 本地展示数据的唯一来源：`data/mock.js`；G01 当前不调用远程 API。 - 本目录当前不是 Git 仓库；不要擅自初始化仓库、重置文件或删除既有用户文件。 @@ -49,16 +49,11 @@ - 已加入家谱：`汤氏宗谱 / 山东·济宁 / 286 位成员 / 成员` - 当前题签有标题/元信息分隔线；列表右侧角色和箭头应为同一水平基线；日期为“更新于”文字，不显示参考稿中没有的日历图标。 -### 必须继续做的事 +### 2026-07-13 最终验收结论 -1. 用 HBuilderX 刷新 G01，并使用与参考稿相同的手机预览尺寸截屏。 -2. 将新截图与 v5 参考稿并排比对，重点检查： - - 顶部家谱题签的字体、字段、分隔线和三组元信息是否同一行； - - 四个快捷图标的实际可见面积与文字大小； - - 两条列表的谱印、标题、地点/成员、日期、右侧角色和箭头基线； - - 新建按钮的云纹、文字、底部山水和 Tabbar 安全区。 -3. 有任何差异时，只改对应 G01 组件并重新截图；不要提前勾选 `G-01`。 -4. 最终还要按 `320 × 568` 和 `360 × 800` 做小屏检查，确认无重叠、无裁切、无底部遮挡。 +- 用户已提供 `360 × 800`、`320 × 568`（含滚动到底部）响应式预览，以及 HBuilderX Web 浏览器 `Pixel 2 XL` 常规屏预览。 +- 已确认：顶部、题签、快捷入口、两条列表、新建按钮、山水和 Tabbar 无重叠或裁切；`320 × 568` 下新建按钮可完整露出在 Tabbar 上方。 +- 用户明确确认可结项，故 G-01 已勾选完成。此结论不解除接口联调、真实账号联调或 Android 打包暂停。 ## 5. G01 关键文件 @@ -101,5 +96,13 @@ powershell -ExecutionPolicy Bypass -File tests\vue3-entry.ps1 1. 完整复制整个 `jiapuapp` 项目文件夹，保留 `docs/`、`static/`、`tests/`、`data/` 和所有 Vue/SCSS 文件。 2. 新电脑安装 HBuilderX 后，直接“打开目录”选择复制后的项目根目录。 -3. 将本文件和新的 HBuilderX 截图一起发给新的 GPT，并说明：“先读 `docs/交接记录.md` 与 `AGENTS.md`，继续 G01 的视觉验收，不要改接口。” +3. 将本文件和后续页面的新截图一起发给新的 GPT，并说明：“先读 `docs/交接记录.md` 与 `AGENTS.md`，按规划继续页面设计，不要改接口。” 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 打包仍暂停。 diff --git a/docs/规划.md b/docs/规划.md index 4ace443..ca8af63 100644 --- a/docs/规划.md +++ b/docs/规划.md @@ -97,8 +97,8 @@ ### 5.3 家谱：创建、加入与管理入口 -- [x] G-01 信息层级与谱印施工：元信息图标、谱印框、快捷入口、当前题签两层结构、列表两行信息、页头屋檐、紧凑 Tabbar 与新建祥云 v2 已实现并通过资产/编译审计；待 HBuilderX 同尺寸截图验收，故完整 G-01 仍未勾选。 -- [ ] G-01 我的家谱列表（已创建、已加入、搜索入口、通知入口）。 +- [x] G-01 信息层级与谱印施工：元信息图标、谱印框、快捷入口、当前题签两层结构、列表两行信息、页头屋檐、紧凑 Tabbar 与新建祥云 v2 已实现并通过资产/编译审计；2026-07-13 已由用户基于小屏与 HBuilderX 预览确认验收。 +- [x] G-01 我的家谱列表（已创建、已加入、通知入口）。公开家谱搜索入口由 G-06 / G-07 统一承接，避免与本页重复。 - [ ] G-02 无家谱空状态（创建家谱 / 搜索加入）。 - [ ] G-03 创建家谱表单（名称、地域、简介、公开范围）。 - [ ] G-04 创建成功后的始祖录入页。 @@ -169,8 +169,8 @@ | 阶段 | 交付内容 | 状态 | | --- | --- | --- | | D1 | P-02 至 P-06：统一设计系统、Android 页面壳、公共图标与背景资产 | 进行中（P-02 至 P-04 已完成；P-05、P-06 资产生成中） | -| D2 | A-01 至 A-06：账户与首次使用全套页面 | 未开始 | -| D3 | G-01 至 G-12：家谱创建、加入、总览与管理全套页面 | 进行中（G-01 视觉壳已施工，待 HBuilderX 小屏预览验收；其余页面未开始） | +| 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：消息与个人中心全套页面 | 未开始 |