81 lines
2.0 KiB
Markdown
81 lines
2.0 KiB
Markdown
# 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
|
||
|
||
无。
|