ai-ticket-platform/docs/development/local-setup.md

Local Setup

Prerequisites

• Python 3.12
• Node.js 22
• Docker Desktop

First Run

copy .env.example .env
cd infra
docker compose --env-file ../.env up --build

首次启动时，backend 容器会自动等待 PostgreSQL、执行数据库迁移，并初始化企业后台治理数据。

Backend:

• API: http://localhost:8000/api/docs
• Health: http://localhost:8000/api/system/health

Frontend:

• App: http://localhost:5173

默认管理员:

• 账号: admin
• 密码: admin12345
• 可通过 .env 中的 DJANGO_SUPERUSER_USERNAME、DJANGO_SUPERUSER_PASSWORD、DJANGO_SUPERUSER_EMAIL 修改。

Backend Tests

cd backend
python -m pip install -e ".[dev]"
pytest -v

Frontend Checks

cd frontend
npm install
npm run typecheck
npm run build

Stage 1 API Smoke Tests

• Tickets: GET http://localhost:8000/api/tickets
• Ticket export: GET http://localhost:8000/api/tickets/export
• Solutions: GET http://localhost:8000/api/solutions