quyun-v2/docs/plan.md

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)

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

• T001 [US0] 梳理服务启动命令与端口

Phase 2

• T010 [US1] Portal 页面自动化步骤
• T011 [US1] Superadmin 页面自动化步骤

Phase 3

• T020 [US2] 更新验证文档（含 DevTools MCP 指引）

Dependencies

• Phase 1 → Phase 2 → Phase 3。

Acceptance Criteria

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

Risks

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

Complexity Tracking

无。