zhangxiang
5c65139fd8
- 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）
1.8 KiB
1.8 KiB
description
| 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可本地全量回归
报告格式
输出简洁表格：层、状态（✅/❌/⚠️）、发现的问题