docs: add ui page testing checklist
This commit is contained in:
53
docs/plan.md
53
docs/plan.md
@@ -1,64 +1,63 @@
|
||||
# Implementation Plan: Improve Error Logging
|
||||
# Implementation Plan: UI Page Testing Checklist
|
||||
|
||||
**Branch**: `main` | **Date**: 2026-01-26 | **Spec**: N/A
|
||||
**Input**: 完善应用错误记录,输出更精确的错误定位信息。
|
||||
**Input**: 制定页面级自动化测试清单,覆盖 portal/superadmin 核心业务流。
|
||||
|
||||
**Note**: 本计划遵循 `docs/templates/plan-template.md`。
|
||||
|
||||
## Summary
|
||||
|
||||
定位当前错误记录入口与结构,补充关键上下文信息(请求 ID、路径、用户/租户 ID、处理器名称、错误链),并统一输出格式,方便快速定位问题。
|
||||
梳理并落地一份可执行的 UI 页面测试清单,涵盖 Portal 与 Superadmin 的关键流(登录、订单、内容、财务、通知等),便于 AI/MCP 按步骤执行与验证。
|
||||
|
||||
## Technical Context
|
||||
|
||||
**Language/Version**: Go 1.22
|
||||
**Primary Dependencies**: Fiber, logrus, errorx
|
||||
**Storage**: N/A
|
||||
**Testing**: go test / 运行时日志
|
||||
**Language/Version**: JS (Vue3 + Vite) + Chrome DevTools MCP
|
||||
**Primary Dependencies**: Vite dev servers, seeded data
|
||||
**Storage**: PostgreSQL (seed required)
|
||||
**Testing**: 页面自动化(MCP)
|
||||
**Target Platform**: local/staging
|
||||
**Project Type**: Web application
|
||||
**Performance Goals**: N/A
|
||||
**Constraints**: 不修改生成文件
|
||||
**Scale/Scope**: 日志格式与错误处理
|
||||
**Constraints**: 仅文档/指令,不改业务代码
|
||||
**Scale/Scope**: Portal + Superadmin 核心页面
|
||||
|
||||
## Constitution Check
|
||||
|
||||
- 遵循 `backend/llm.txt`
|
||||
- 只改非生成文件
|
||||
- 不修改生成文件
|
||||
|
||||
## Project Structure
|
||||
|
||||
```text
|
||||
backend/app/errorx/
|
||||
backend/providers/http/
|
||||
backend/app/middlewares/
|
||||
docs/
|
||||
├── plan.md
|
||||
└── seed_verification.md
|
||||
```
|
||||
|
||||
## Plan Phases
|
||||
|
||||
### Phase 1: 现状定位
|
||||
- 追踪错误记录入口与结构(errorx + middleware + http provider)。
|
||||
### Phase 1: 场景整理
|
||||
- 列出 Portal/Superadmin 关键页面与断言点。
|
||||
|
||||
### Phase 2: 日志增强
|
||||
- 补充 request-id、path、method、tenant/user、handler、error chain。
|
||||
- 确认错误等级与格式一致。
|
||||
### Phase 2: 测试步骤编排
|
||||
- 为每个场景编排 MCP 步骤(导航、表单、断言、错误检查)。
|
||||
|
||||
### Phase 3: 验证
|
||||
- 使用典型 4xx/5xx 请求验证日志输出。
|
||||
### Phase 3: 输出清单
|
||||
- 将清单写入 `docs/seed_verification.md`。
|
||||
|
||||
## Tasks
|
||||
|
||||
**Format**: `[ID] [P?] [Story] Description`
|
||||
|
||||
### Phase 1
|
||||
- [x] T001 [US0] 定位错误记录入口与字段
|
||||
- [ ] T001 [US0] 梳理 Portal 核心页面与断言
|
||||
- [ ] T002 [US0] 梳理 Superadmin 核心页面与断言
|
||||
|
||||
### Phase 2
|
||||
- [x] T010 [US1] 增强错误日志上下文
|
||||
- [x] T011 [US1] 统一格式与等级
|
||||
- [ ] T010 [US1] 编排 MCP 步骤(导航/登录/断言/错误检查)
|
||||
|
||||
### Phase 3
|
||||
- [x] T020 [US2] 验证输出与文档说明
|
||||
- [ ] T020 [US2] 输出并归档测试清单
|
||||
|
||||
## Dependencies
|
||||
|
||||
@@ -66,12 +65,12 @@ backend/app/middlewares/
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- 日志可直接定位请求来源与错误链。
|
||||
- 关键字段完整(request-id、path、tenant/user、handler)。
|
||||
- 文档包含 Portal/Superadmin 主要页面与清晰断言点。
|
||||
- 每个场景有 MCP 执行步骤(含登录、导航、断言、console error 检查)。
|
||||
|
||||
## Risks
|
||||
|
||||
- 日志字段增加影响性能或泄露敏感信息。
|
||||
- 环境/端口变更导致脚本需调整。
|
||||
|
||||
## Complexity Tracking
|
||||
|
||||
|
||||
Reference in New Issue
Block a user