docs: add ui page testing checklist

This commit is contained in:
2026-02-02 20:15:09 +08:00
parent 3ab1434821
commit bb90bef02e
3 changed files with 105 additions and 120 deletions

View File

@@ -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