# 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
  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
  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 为 `[~]` 待用户审核**