Menu
本地启动、调试和排查本项目问题。包括启动后端、前端、Celery Worker，以及常见错误的排查方法。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | debug-and-run |
| description | 本地启动、调试和排查本项目问题。包括启动后端、前端、Celery Worker，以及常见错误的排查方法。 |
本项目包含 4 个需要同时运行的服务：
| 服务 | 技术 | 端口 | 命令 |
|---|---|---|---|
| 后端 API | FastAPI | 8000 | uv run uvicorn app.main:app --reload |
| 前端 | Vite/Vue3 | 5173 | npm run dev |
| 任务队列 | Celery | - | celery -A app.core.celery_app worker |
cd backend
source .venv/bin/activate
uv run uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
cd backend
source .venv/bin/activate
celery -A app.core.celery_app worker --loglevel=info
# 调试模式 (单进程，方便查看日志):
celery -A app.core.celery_app worker --loglevel=debug --concurrency=1 --pool=solo
cd frontend
npm run dev
backend/backend_proper.log # 后端 API 运行日志
backend/celery_proper.log # Celery 任务执行日志
frontend/frontend_proper.log # 前端构建日志
backend/allure-results/ # 测试结果（含截图）
后端启动后访问：
为本项目添加新数据库模型或修改现有模型，并使用 Alembic 生成和运行数据库迁移脚本。
在本项目中创建标准的 FastAPI API 端点，包含 schema、service、router 注册，遵循项目现有架构模式。
为本项目的 UI 自动化测试平台创建测试步骤和测试用例，理解平台内部的测试步骤数据结构、Runner 执行逻辑和 Playwright 操作类型。
在本项目中创建标准的 Vue 3 + TypeScript 组件，使用 Naive UI 组件库、Pinia 状态管理，遵循项目现有架构模式。