From 134ae75c2b75f73348168283e1a7cf0ce4dc7a08 Mon Sep 17 00:00:00 2001 From: rain Date: Mon, 13 Jul 2026 14:31:19 +0800 Subject: [PATCH] feat: add static A01 A02 auth UI --- docs/design/A01_启动登录引导_设计记录.md | 18 +- docs/交接记录.md | 5 +- docs/规划.md | 6 +- pages.json | 4 + pages/auth/entry.vue | 304 +++++++++++++++++++ pages/auth/login.vue | 359 +++++++++++++++++++---- tests/a01-a02-ui-contract.ps1 | 87 ++++++ tests/core-flow-contract.ps1 | 9 +- 8 files changed, 708 insertions(+), 84 deletions(-) create mode 100644 pages/auth/entry.vue create mode 100644 tests/a01-a02-ui-contract.ps1 diff --git a/docs/design/A01_启动登录引导_设计记录.md b/docs/design/A01_启动登录引导_设计记录.md index 1456203..34dfc10 100644 --- a/docs/design/A01_启动登录引导_设计记录.md +++ b/docs/design/A01_启动登录引导_设计记录.md @@ -1,6 +1,6 @@ # A-01 启动 / 登录引导设计记录 -> 状态：文字注册入口方案已确认，D2 / A-01 进行中；**尚未完成新版效果稿、布局验收或页面实现**。 +> 状态：A-01 文字注册入口方案、四尺寸静态验收与本地 UI 已完成；A-02 双标签本地 UI 已完成。协议页去向、A-03 至 A-06 的设计、认证接口与 Android 运行时验收仍未完成，D2 继续进行中。 > > 本页设计事实的唯一归档位置为本文件。旧的 `2026-07-13-a01-login-guide-design.md` 与 `2026-07-13-a01-login-guide.md` 仅保留为失效历史，不可作为实现或推进下一页的依据。 @@ -15,10 +15,10 @@ ## 2. 已确认的页面结构与交互 - 标题区保留“家谱 / 为家族留存可传承的记忆”，使用美术锚点中的朱砂家祠红头、暖宣纸、古金云纹、墨褐文字与淡墨建筑/竹影层次。 -- 操作区只保留两个大按钮和一个文字入口：朱砂主按钮“登录”、古金描边按钮“微信登录”，以及其下方的“还没有账号？注册账号”。“注册账号”仅为朱砂红可点击文字，不再作为独立大按钮。 -- 入口顺序：登录为主入口；微信登录为次入口；注册账号为辅助文字入口。 -- “登录”前往 `A-02`，且 `A-02` 内固定使用“账号密码登录 / 手机验证码登录”双标签切换，默认显示账号密码登录。微信入口由 `A-03` 承接授权中、取消与失败回跳状态。 -- 注册账号入口前往 `A-04`；忘记密码属于 `A-05`，不在 A-01 新增入口。 +- 操作区只保留两个大按钮和一个文字入口：朱砂主按钮“账号密码登录”、古金描边按钮“微信登录”，以及其下方的“还没有账号？注册账号”。“注册账号”仅为朱砂红可点击文字，不再作为独立大按钮。 +- 入口顺序：账号密码登录为主入口；微信登录为次入口；注册账号为辅助文字入口。 +- 已勾选协议后，“账号密码登录”前往 `A-02`，且 `A-02` 内固定使用“账号密码登录 / 手机验证码登录”双标签切换，默认显示账号密码登录。微信授权中、取消与失败回跳状态仍归 `A-03`，在 A-03 设计完成前当前入口只提示“微信登录功能准备中”。 +- 注册账号入口仍归 `A-04`；忘记密码仍归 `A-05`。这两页完成设计前，当前入口只提示页面准备中，不伪造跳转。 - 协议必须为用户主动勾选：初始未勾选，可分别打开《家谱用户协议》和《隐私政策》。不得使用“登录即表示同意”或任何默认同意文案；未勾选时登录操作应明确提示用户先确认协议。 ## 3. 固定布局与状态边界 @@ -36,9 +36,9 @@ | --- | --- | --- | --- | | 初始未勾选 | 首次进入 | 两个按钮、注册文字与空复选框 | 留在 A-01 | | 未同意协议 | 点击登录、微信登录或注册账号 | 提示“请先阅读并同意相关协议”，不跳转、不改变勾选状态 | 留在 A-01 | -| 登录已确认协议 | 点击“登录” | 结束 A-01 引导 | A-02，默认账号密码登录标签 | -| 微信已确认协议 | 点击“微信登录” | 结束 A-01 引导 | A-03，显示授权中、取消或失败回跳 | -| 注册已确认协议 | 点击“注册账号”文字 | 结束 A-01 引导 | A-04 | +| 账号密码登录已确认协议 | 点击“账号密码登录” | 结束 A-01 引导 | A-02，默认账号密码登录标签 | +| 微信已确认协议 | 点击“微信登录” | 提示“微信登录功能准备中” | 留在 A-01，等待 A-03 设计完成 | +| 注册已确认协议 | 点击“注册账号”文字 | 提示“注册页面准备中” | 留在 A-01，等待 A-04 设计完成 | ### A-01 资产清单 @@ -60,6 +60,6 @@ ## 5. 推进约束 -- 当前正式工作是 `D2 / A-01 启动登录引导` 的设计；A-02 尚未开始设计，但其职责已明确为两种登录方式的双标签登录页。 +- `A-01` 与 `A-02` 的本地 UI 已按本记录及实现合同落地；A-02 的最终效果稿与 Android 运行时验收仍待补齐，不能据此推进 A-03。 - 只有确定协议页面的最终去向，并完成本文件第 4 节所述的运行时验收后，A-01 才能进入“设计完成”状态。 - 用户已于 2026-07-13 授权落地 A-01 欢迎入口与 A-02 双标签登录页的本地 UI；仍不接接口、不执行真实登录、不改 Android 打包配置。实现细节的唯一所有者见 `docs/superpowers/specs/2026-07-13-a01-a02-static-ui-implementation-design.md`。 diff --git a/docs/交接记录.md b/docs/交接记录.md index f5a3b08..d5560cd 100644 --- a/docs/交接记录.md +++ b/docs/交接记录.md @@ -24,10 +24,10 @@ - 项目：uni-app，目标为 Android，使用 HBuilderX 打包。 - 当前阶段：先完成全部页面视觉设计和小屏验收；**暂不恢复接口联调、真实账号联调或 Android 打包**。 -- 当前正在处理：`D2 / A-01 启动登录引导`设计；`G-01 我的家谱`已于 2026-07-13 验收完成。不得直接进入页面实现。 +- 当前正在处理：`D2 / A-01 至 A-06 账户与首次使用`设计；`A-01` 与 `A-02` 已于 2026-07-13 落地本地 UI 并等待运行时验收，`G-01 我的家谱`已验收完成。其余页面仍须先完成设计记录与效果稿归档再实现。 - 当前不做：iOS、PC 管理端、官网，以及新增业务接口。 - 本地展示数据的唯一来源：`data/mock.js`；G01 当前不调用远程 API。 -- 本目录当前不是 Git 仓库；不要擅自初始化仓库、重置文件或删除既有用户文件。 +- 本目录为 Git 仓库；不得重置文件或删除既有用户文件，提交时只暂存本轮受管文件。 ## 3. 用户已确认的视觉规则 @@ -106,3 +106,4 @@ powershell -ExecutionPolicy Bypass -File tests\vue3-entry.ps1 - 先前误建的 A-01 规格和“四个独立按钮”执行计划已降为失效历史；2026-07-13 已确认文字注册入口方案，唯一需求所有者为 `docs/design/A01_启动登录引导_设计记录.md`。用户随后授权 A-01 欢迎入口与 A-02 双标签登录页的本地 UI 落地；不得接接口、执行真实登录或替其他未设计页面造功能。 - 所有后续页面效果图必须先保存到 `docs/design/screens/`，并在对应页面设计记录写明用途、状态和验收缺口；未完成归档不得展示为可推进的设计成果。 - G-01 已于 2026-07-13 经用户确认结项；当前进入 D2 / A-01 的设计工作，接口、真实登录和 Android 打包仍暂停。 +- A-01 入口页与 A-02 双标签登录页已于 2026-07-13 落地本地 UI：路由入口为 `pages/auth/entry`；只有在 A-01 显式勾选协议后才可进入 A-02。页面不调用接口、不写登录态、不跳转家谱；微信、注册、协议、忘记密码和验证码仅提示待相应页面或能力完成。A-01/A-02 运行时四尺寸验收仍待执行。 diff --git a/docs/规划.md b/docs/规划.md index 6392f55..9d15390 100644 --- a/docs/规划.md +++ b/docs/规划.md @@ -88,8 +88,8 @@ ### 5.2 账户与首次使用 -- [ ] A-01 启动 / 登录引导页（账号密码、手机号验证码、微信登录入口）。 -- [ ] A-02 账号密码登录页。 +- [ ] A-01 启动 / 登录引导页（账号密码、手机号验证码、微信登录入口；本地 UI 已落地，协议页去向与 Android 运行时验收待完成）。 +- [ ] A-02 账号密码登录页（账号密码 / 手机验证码双标签本地 UI 已落地；最终效果稿、运行时验收与接口待完成）。 - [ ] A-03 手机验证码登录页与微信授权回跳状态。 - [ ] A-04 注册页与服务协议确认。 - [ ] A-05 忘记密码 / 重设密码页。 @@ -169,7 +169,7 @@ | 阶段 | 交付内容 | 状态 | | --- | --- | --- | | D1 | P-02 至 P-06：统一设计系统、Android 页面壳、公共图标与背景资产 | 进行中（P-02 至 P-04 已完成；P-05、P-06 资产生成中） | -| D2 | A-01 至 A-06：账户与首次使用全套页面 | 进行中（A-01 文字注册入口方案、独立资产、固定栅格与四尺寸静态验收已归档；协议页去向与运行时验收待完成；A-02 至 A-06 未开始） | +| D2 | A-01 至 A-06：账户与首次使用全套页面 | 进行中（A-01 已完成文字注册入口方案、独立资产、固定栅格、四尺寸静态验收与本地 UI；A-02 双标签本地 UI 已落地；协议页去向、最终效果稿、Android 运行时验收、A-03 至 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：家族内容全套页面 | 未开始 | diff --git a/pages.json b/pages.json index 3082bc9..b53e51d 100644 --- a/pages.json +++ b/pages.json @@ -1,5 +1,9 @@ { "pages": [ + { + "path": "pages/auth/entry", + "style": { "navigationStyle": "custom", "enablePullDownRefresh": false } + }, { "path": "pages/auth/login", "style": { "navigationStyle": "custom", "enablePullDownRefresh": false } diff --git a/pages/auth/entry.vue b/pages/auth/entry.vue new file mode 100644 index 0000000..f3a3b4a --- /dev/null +++ b/pages/auth/entry.vue @@ -0,0 +1,304 @@ + + + + + diff --git a/pages/auth/login.vue b/pages/auth/login.vue index 6e90236..4421481 100644 --- a/pages/auth/login.vue +++ b/pages/auth/login.vue @@ -1,84 +1,319 @@ diff --git a/tests/a01-a02-ui-contract.ps1 b/tests/a01-a02-ui-contract.ps1 new file mode 100644 index 0000000..4ed4252 --- /dev/null +++ b/tests/a01-a02-ui-contract.ps1 @@ -0,0 +1,87 @@ +$ErrorActionPreference = 'Stop' + +function ConvertFrom-Utf8Base64 { + param([string]$Value) + return [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($Value)) +} + +function Assert-Contains { + param( + [string]$Content, + [string]$Expected, + [string]$Message + ) + + if ($Content -notmatch [regex]::Escape($Expected)) { + throw $Message + } +} + +function Assert-NotContains { + param( + [string]$Content, + [string]$Unexpected, + [string]$Message + ) + + if ($Content -match [regex]::Escape($Unexpected)) { + throw $Message + } +} + +$root = Split-Path -Parent $PSScriptRoot +$entryPath = Join-Path $root 'pages/auth/entry.vue' +$loginPath = Join-Path $root 'pages/auth/login.vue' +$pagesPath = Join-Path $root 'pages.json' + +if (-not (Test-Path -LiteralPath $entryPath)) { + throw 'Missing A-01 entry page: pages/auth/entry.vue' +} + +$pages = Get-Content -LiteralPath $pagesPath -Raw -Encoding utf8 | ConvertFrom-Json +if ($pages.pages[0].path -ne 'pages/auth/entry') { + throw 'A-01 entry page must be the first route in pages.json' +} + +$entry = Get-Content -LiteralPath $entryPath -Raw -Encoding utf8 +$login = Get-Content -LiteralPath $loginPath -Raw -Encoding utf8 + +$accountPasswordLogin = ConvertFrom-Utf8Base64 '6LSm5Y+35a+G56CB55m75b2V' +$wechatLogin = ConvertFrom-Utf8Base64 '5b6u5L+h55m75b2V' +$registerLink = ConvertFrom-Utf8Base64 '6L+Y5rKh5pyJ6LSm5Y+377yf5rOo5YaM6LSm5Y+3' +$agreementRequired = ConvertFrom-Utf8Base64 '6K+35YWI6ZiF6K+75bm25ZCM5oSP55u45YWz5Y2P6K6u' +$wechatPending = ConvertFrom-Utf8Base64 '5b6u5L+h55m75b2V5Yqf6IO95YeG5aSH5Lit' +$registerPending = ConvertFrom-Utf8Base64 '5rOo5YaM6aG16Z2i5YeG5aSH5Lit' +$agreementPending = ConvertFrom-Utf8Base64 '5Y2P6K6u6aG16Z2i5YeG5aSH5Lit' +$smsLogin = ConvertFrom-Utf8Base64 '5omL5py66aqM6K+B56CB55m75b2V' +$forgotPassword = ConvertFrom-Utf8Base64 '5b+Y6K6w5a+G56CB' +$getCode = ConvertFrom-Utf8Base64 '6I635Y+W6aqM6K+B56CB' +$loginPending = ConvertFrom-Utf8Base64 '55m75b2V5o6l5Y+j5b6F5o6l5YWl' +$returnToEntry = ConvertFrom-Utf8Base64 '6K+35YWI6L+U5Zue55m75b2V5byV5a+856Gu6K6k5Y2P6K6u' +$forgotPasswordPending = ConvertFrom-Utf8Base64 '5b+Y6K6w5a+G56CB6aG16Z2i5YeG5aSH5Lit' +$getCodePending = ConvertFrom-Utf8Base64 '6I635Y+W6aqM6K+B56CB5Yqf6IO95b6F5o6l5YWl' +$implicitAgreement = ConvertFrom-Utf8Base64 '55m75b2V5Y2z6KGo56S65ZCM5oSP' + +foreach ($requiredEntryCopy in @($accountPasswordLogin, $wechatLogin, $registerLink, $agreementRequired, $wechatPending, $registerPending, $agreementPending)) { + Assert-Contains -Content $entry -Expected $requiredEntryCopy -Message "Missing A-01 copy: $requiredEntryCopy" +} + +Assert-Contains -Content $entry -Expected "url: '/pages/auth/login?agreed=1'" -Message 'A-01 account login must navigate with agreed=1' +if ($entry -match '(?s)\.auth-page\s*\{[^}]*overflow\s*:\s*hidden') { + throw 'A-01 must allow vertical scrolling on small screens' +} + +foreach ($requiredLoginCopy in @($accountPasswordLogin, $smsLogin, $forgotPassword, $getCode, $loginPending, $returnToEntry, $forgotPasswordPending, $getCodePending)) { + Assert-Contains -Content $login -Expected $requiredLoginCopy -Message "Missing A-02 copy: $requiredLoginCopy" +} + +if ($login -match '(?s)\.auth-page\s*\{[^}]*overflow\s*:\s*hidden') { + throw 'A-02 must allow vertical scrolling on small screens' +} + +foreach ($forbidden in @('appApi', 'calcMD5', 'loginWithPassword', 'uni.reLaunch', $implicitAgreement)) { + Assert-NotContains -Content $entry -Unexpected $forbidden -Message "A-01 must not contain legacy auth behavior: $forbidden" + Assert-NotContains -Content $login -Unexpected $forbidden -Message "A-02 must not contain legacy auth behavior: $forbidden" +} + +Write-Output 'A01-A02-UI-CONTRACT PASS' diff --git a/tests/core-flow-contract.ps1 b/tests/core-flow-contract.ps1 index 230c808..c11b189 100644 --- a/tests/core-flow-contract.ps1 +++ b/tests/core-flow-contract.ps1 @@ -1,7 +1,7 @@ $ErrorActionPreference = 'Stop' $root = Split-Path -Parent $PSScriptRoot -$requiredFiles = @('utils/config.js', 'utils/session.js', 'utils/genealogy-context.js', 'utils/api.js', 'utils/md5.js', 'pages/auth/login.vue', 'pages/lineage/first-person.vue', 'pages/content/list.vue', 'pages/content/editor.vue') +$requiredFiles = @('utils/config.js', 'utils/session.js', 'utils/genealogy-context.js', 'utils/api.js', 'pages/lineage/first-person.vue', 'pages/content/list.vue', 'pages/content/editor.vue') foreach ($file in $requiredFiles) { if (-not (Test-Path (Join-Path $root $file))) { throw "Missing core-flow file: $file" @@ -45,13 +45,6 @@ if ($api -notmatch 'getProfile') { throw 'Missing current-user profile API method' } -$login = Get-Content -Raw -Encoding UTF8 (Join-Path $root 'pages/auth/login.vue') -foreach ($token in @('calcMD5', 'loginWithPassword', 'password', 'isSubmitting')) { - if ($login -notmatch [regex]::Escape($token)) { - throw "Missing password login behavior: $token" - } -} - $pages = Get-Content -Raw -Encoding UTF8 (Join-Path $root 'pages.json') if ($pages -notmatch 'pages/lineage/first-person') { throw 'Missing first-person page route'