chore(config): 参考 novavis 完善 Agent 配置体系
- AGENTS.md: 新增 §20 工具脚本复用 / §21 分析结论复用 / §22 Flaky 门禁,更新文档配置表
- .pi/: 新增 settings.json、rules/guardrails.md、prompts/{debug,review,ship}-gym-manage.md
- .agents/: 新增 Hook 配置与 4 个 Hook 脚本(session-start/pre-agent-check/check-completeness/stop-check)
及 protocols/systematic-debugging.md(check-completeness 含接口链缺口检测)
- scripts/flaky-scan.sh: vitest shuffle 稳定性扫描(gym-manage-web)
- .gitignore: 追踪 AGENTS.md 与 .pi 配置,忽略运行时缓存(todos/taskflows-runs/tokenomy/sessions)
This commit was merged in pull request #57.
This commit is contained in:
@@ -0,0 +1,39 @@
|
||||
---
|
||||
description: 健身房管理系统全链路集成审查 — API → Service → Web 组件 / UniApp 页面 → 测试 → CI
|
||||
---
|
||||
Gym Manage 项目专用集成审查,覆盖全链路:
|
||||
|
||||
## 全链路检查清单
|
||||
|
||||
### 1. 后端 Java
|
||||
- `cd gym-manage-api && mvn compile` — 编译检查
|
||||
- `cd gym-manage-api && mvn test` — 单元+集成测试(JUnit 5)
|
||||
- Controller → Service → Mapper 分层清晰,无 Controller 直连 Repository
|
||||
- DTO/VO 与实体分离,响应结构统一(code/message/data)
|
||||
|
||||
### 2. 接口契约
|
||||
- Web 端 `gym-manage-web/src/api/*.api.ts` 请求路径/方法/参数与 Java Controller 注解一致
|
||||
- UniApp 端 `gym-manage-uniapp/api/*.js`、`gym-manage-coach-uniapp/api/*.js` 同步一致
|
||||
- 新增接口已登记(Swagger 注解齐全:`@ApiOperation`/`@ApiModelProperty`)
|
||||
|
||||
### 3. Web 前端
|
||||
- `cd gym-manage-web && pnpm exec vue-tsc --noEmit` — 类型检查
|
||||
- `cd gym-manage-web && pnpm lint` — lint
|
||||
- 组件通过 `src/api/*.api.ts` 取数,无直接裸 `fetch`/`axios` 绕过
|
||||
- store(pinia)状态变更向后兼容;类型与后端 DTO 无漂移
|
||||
|
||||
### 4. UniApp 小程序
|
||||
- 会员端 / 教练端页面通过 `api/*.js` 取数,请求封装(`utils/request.js`)一致
|
||||
- 页面展示字段与接口返回字段对齐(camelCase ↔ 后端命名)
|
||||
|
||||
### 5. 测试覆盖
|
||||
- 后端:`mvn test` 覆盖新增 Service 核心分支 + 边界
|
||||
- Web:`pnpm test`(vitest)覆盖组件关键行为;新增测试通过 `bash scripts/flaky-scan.sh --spec <文件> --runs 3`
|
||||
- 检查 `.only()` / `.skip()` / `console.log` 等调试遗留
|
||||
|
||||
### 6. CI 门禁
|
||||
- `cd gym-manage-web && pnpm build` — 生产构建通过
|
||||
- Jenkins pipeline(Jenkinsfile)兼容性;根目录 `run-all-tests.ps1` 可本地全量回归
|
||||
|
||||
## 报告格式
|
||||
输出简洁表格:层、状态(✅/❌/⚠️)、发现的问题
|
||||
Reference in New Issue
Block a user