# Implementation Plan: Page Automation Verification

**Branch**: `main` | **Date**: 2026-01-26 | **Spec**: `docs/seed_verification.md`
**Input**: 将验证流程转为纯页面自动化测试（Playwright）。

**Note**: 本计划遵循 `docs/templates/plan-template.md`。

## Summary

新增一份“纯页面自动化验证”文档，包含服务启动步骤（backend/portal/superadmin）和 Playwright 操作清单，确保 AI 能在无 API 调用前提下完成冒烟验证。

## Technical Context

**Language/Version**: JS (Playwright) + Go 1.22 + Vite
**Primary Dependencies**: Playwright, Vite dev server
**Storage**: PostgreSQL (seed 数据)
**Testing**: 页面自动化 (browser-driven)
**Target Platform**: Local + staging
**Project Type**: Web application
**Performance Goals**: N/A
**Constraints**: 仅写文档，不修改业务代码
**Scale/Scope**: 覆盖 portal + superadmin 冒烟场景

## Constitution Check

- 不修改生成文件
- 仅新增/更新文档

## Project Structure

### Documentation (this feature)

```text
docs/
├── plan.md
└── seed_verification.md
```

## Plan Phases

### Phase 1: 启动流程梳理
- 明确 backend/portal/superadmin 本地启动方式与代理关系。

### Phase 2: 自动化场景清单
- 按 portal/superadmin 视图输出可自动化步骤与断言。

### Phase 3: 输出验证文档
- 更新 `docs/seed_verification.md` 为“纯页面自动化”版本。

## Tasks

**Format**: `[ID] [P?] [Story] Description`

### Phase 1
- [x] T001 [US0] 梳理服务启动命令与端口

### Phase 2
- [x] T010 [US1] Portal 页面自动化步骤
- [x] T011 [US1] Superadmin 页面自动化步骤

### Phase 3
- [x] T020 [US2] 更新验证文档（含 DevTools MCP 指引）

## Dependencies

- Phase 1 → Phase 2 → Phase 3。

## Acceptance Criteria

- 文档包含完整启动流程与端口说明。
- 文档包含可直接执行的页面自动化步骤。
- 不涉及 API 级验证说明。

## Risks

- 登录依赖 OTP/浏览器控制台获取。

## Complexity Tracking

无。