# Local Setup

## Prerequisites

- Python 3.12
- Node.js 22
- Docker Desktop

## First Run

```bash
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

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

## Frontend Checks

```bash
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`