jiapuapp/docs/superpowers/plans/2026-07-16-a04-register-auth-series.md

A04 认证系列注册页实施计划

For agentic workers: 本项目禁止子代理、worktree 和任何 Git 暂存／提交／推送操作；仅允许当前会话内联执行。

Goal: 将 A04 注册页统一到 A01 红色宗祠水墨认证视觉，并用项目自定义反馈完成协议校验与提交前行为验证外观。

Architecture: A04 复用 A01 的 a01-red-hall-ink-backdrop-v1.png 和 brand-seal.png，表单继续使用真实 uni-app 控件。字段错误和协议错误在页面就近显示；完整本地校验通过后打开 A04 自有的自定义行为验证层，不对接注册接口。

Tech Stack: uni-app、Vue 3 <script setup>、SCSS、PowerShell 契约测试、Chrome CDP 运行截图。

Global Constraints

• 只修改 A04、A04 测试、A04 证据和必要的认证截图工具，不修改相邻页面。
• 基础版本只实现浅色主题；320×568 允许自然纵向滚动。
• 禁止 uni.showToast、uni.showModal、uni.showLoading、uni.showActionSheet。
• 不对接接口；注册成功登录态与进入 G01 只记录为后续功能合同。
• 保留 A01 视觉冻结候选，不修改 A01 页面。

---

Task 1: 收紧 A04 页面合同

Files:

• Modify: tests/a04-registration-contract.ps1
• Modify later: pages/auth/a04-register.vue

Interfaces:

• Consumes: A01 认证视觉资产与验收规划 A04 合同。

• Produces: 新底板、页内错误、自定义反馈和自定义验证层的静态契约。

• Step 1: 新增失败断言

  要求页面引用 a01-red-hall-ink-backdrop-v1.png、brand-seal.png，包含 fieldErrors、agreementError、feedback-toast、verification-layer，并禁止四个原生 UniApp 提示 API。

• Step 2: 运行红灯

  powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/a04-registration-contract.ps1
  

  Expected: FAIL，首个原因为缺少新宗祠水墨底板。

Task 2: 实现 A04 注册候选

Files:

• Modify: pages/auth/a04-register.vue
• Test: tests/a04-registration-contract.ps1

Interfaces:

• Consumes: Task 1 契约。

• Produces: 手机号、密码、确认密码、协议、返回登录和提交前验证的可交互页面。

• Step 1: 替换旧宗祠与大面板结构

  使用与 A01 一致的页面底板、独立 Logo、宋体标题和宣纸表单，不保留 auth-design-scenery-v1.png 或旧大面板外框。

• Step 2: 实现页内校验

  validateForm() 返回布尔值并写入 fieldErrors.phone|password|confirmPassword；协议未勾选只设置 agreementError，勾选后立即清除。

• Step 3: 实现自定义反馈与行为验证层

  协议链接使用 showFeedback('协议页面准备中')；完整本地校验后设置 verificationVisible=true；验证确认后显示“注册服务待接入”。

• Step 4: 运行绿灯

  powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/a04-registration-contract.ps1
  

  Expected: A04-REGISTRATION-CONTRACT PASS。

Task 3: 真实运行检查与证据

Files:

• Create: tests/a04-registration-runtime-smoke.js
• Create: docs/design/screens/runtime/2026-07-16/A04-*.png
• Update later: docs/design/screens/handoff/2026-07-16/A04-*.png

Interfaces:

• Consumes: 运行中的 A04。

• Produces: 360×800 代表图、320×568 滚动检查、校验与验证层运行证据。

• Step 1: 验证 A01 注册入口可达 A04

• Step 2: 捕获 360×800 正常态并目视检查

• Step 3: smoke 检查字段错误、协议错误、验证层和返回登录

• Step 4: 运行 git diff --check，保持 A04 为 [~] 待用户审核