完成40%

docs/design/A06_登录状态_设计记录.md

@@ -0,0 +1,50 @@
+# A06 登录状态设计记录
+
+> 状态：用户已于 2026-07-14 视觉验收通过；A06 可见效果冻结。
+> 唯一路由：`pages/auth/a06-auth-status`；以 `?status=` 表示当前认证状态，不新建状态页面。
+
+## 1. 页面任务与边界
+
+A06 承接认证流程中不能继续进入家谱的结果：登录未完成、登录失败、账号暂时受限、注册尚未完成、微信授权取消和微信授权失败。
+
+没有接入真实账号状态、客服、申诉、微信授权或后端接口。账号受限的“查看帮助”只显示“账号申诉功能待接入”；注册未完成真实跳转 A04；其余主操作与次操作真实跳转 A02。绑定手机号仍属于后续个人中心安全设置页面，本页不承担该功能。
+
+## 2. 状态合同
+
+| `status` 值 | 标题 | 主操作 | 次操作 |
+| --- | --- | --- | --- |
+| `normal`（含未知值回退） | 登录未完成 | 返回登录 → A02 | 无 |
+| `failed` | 登录失败 | 返回登录 → A02 | 无 |
+| `restricted` | 账号暂时受限 | 查看帮助 → 本地提示 | 返回登录 → A02 |
+| `register-pending` | 注册尚未完成 | 继续注册 → A04 | 返回登录 → A02 |
+| `wechat-cancelled` | 微信授权已取消 | 返回登录 → A02 | 无 |
+| `wechat-failed` | 微信授权失败 | 返回登录 → A02 | 无 |
+
+H5 由 `location.hash` 的查询参数读取状态；uni-app 原生端读取当前页 `options`。两端对未知值统一回退 `normal`，避免状态壳无文案或失去下一步。
+
+## 3. 视觉结构与资产
+
+1. 删除通用白卡、CSS 红方徽章和压缩按钮，改为 A02/A04/A05 已验证的“朱砂祠堂头 → 卷轴面板 → 状态说明 → 朱砂操作”的认证节奏。
+2. 状态图形只使用已有透明 `auth-login-outline.png`，避免为每种异常绘制夸张警示符号；文案承担状态区别，朱砂只强调标签与主操作。
+3. 主操作保持完整 `a01-primary-button.png` 位图比例；受限与注册未完成的次操作为低权重朱砂文字，不与主按钮竞争。
+4. 页面壳、面板、按钮、边框、云纹和结饰均由既有位图提供；CSS 只处理布局、文字与点击态。现有资产已完整覆盖需求，因此未调用 ImageGen、未新增资产。
+
+## 4. 运行时审视与证据
+
+| 状态 | 截图 |
+| --- | --- |
+| 改造前通用壳，360×800 | `screens/runtime/2026-07-14/A06-before-360x800.png` |
+| 改造前通用壳，412×915 | `screens/runtime/2026-07-14/A06-before-412x915.png` |
+| `normal` 默认态，360×800 | `screens/runtime/2026-07-14/A06-after-360x800.png` |
+| `normal` 默认态，412×915 | `screens/runtime/2026-07-14/A06-after-412x915.png` |
+| `restricted` 受限态，360×800 | `screens/runtime/2026-07-14/A06-restricted-360x800.png` |
+
+截图审视结论：两个尺寸中，朱砂头图、卷轴框、状态图形、标题/说明、完整主按钮与底部淡墨山水均未被裁切；360×800 的面板底部在首屏内结束，412×915 保留呼吸留白；`restricted` 的次操作保持在主按钮下方且不抢主路径。当前未发现黑块、图片未加载、横向溢出或 CSS 伪造完整表面。
+
+## 5. 自动与交互检查
+
+- `tests/a06-auth-status-contract.ps1`：约束唯一路由、独立页面、六个状态键、状态动作、A02/A04 目标、既有位图资产与禁止 CSS 伪造。
+- `tests/a06-auth-status-runtime-smoke.js`：通过 Chrome DevTools 9222 真实验证默认主操作进入 A02、受限主操作展示本地帮助提示、注册未完成主操作进入 A04。脚本在每次 hash 跳转后刷新文档，以规避 H5 Vue 实例保留上一次状态。
+- `tests/compile-audit.ps1`：确认 A06 不再依赖已移除的目录临时项。
+
+用户已于 2026-07-14 确认本页通过视觉验收；后续可开始 G02，但不得改变 A01、A02、A04、A05、A06、G01 的可见效果。若用户后续指定调整 A06，仍须重新截图、运行上述检查和相关回归。