Development and Testing

开发与测试

目录约定

• backend/botler/：FastAPI 服务、调度、执行器和 GitLab 集成。
• backend/tests/：后端 pytest 测试。
• frontend/：React/Vite 前端、前端测试与 Playwright E2E。
• ci/：CI 辅助脚本及其测试。
• docs/：版本库内的设计、部署和使用文档。

开发流程

1. 更新默认主分支，理解需求、既有实现与测试风格。
2. 先编写正常路径和边界场景测试，确认新增测试在未实现时失败。
3. 实现最小改动，运行新增测试和全量测试。
4. 同步更新 README、CHANGELOG 与相关文档。
5. 在默认主分支提交并推送；禁止创建任务分支和强制推送。
6. 等待 GitLab CI 成功，失败时读取 Job 日志修复后再推送。

本地质量门禁

cd backend && .venv/bin/python -m pytest tests/ -q -n auto
cd frontend && npm test && npm run lint
python3 -m pytest ci/ -q

新增功能需涵盖空输入、异常输入、重复调用和适用的并发或资源边界；修复缺陷必须先用测试复现。