# 测试与部署方案

本轮开发验证不依赖 Docker，不依赖真实数据库。
真实 MySQL/PostgreSQL 和 Docker Compose 属于集成验证阶段。

## 本地轻量验证

```bash
cd <workspace>/iTi-Flask
uv run pytest -q

cd <workspace>/iTi-System
uv run pytest -q

cd <workspace>/my-business-app
uv run pytest -q
```

这些测试允许使用 SQLite 内存库，只验证框架行为、路由契约和模块组装。

## MySQL 集成验证

准备独立测试库：

```sql
CREATE DATABASE iti_test CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE DATABASE my_business_app_test CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

执行：

```bash
export DATABASE_URL='mysql+pymysql://root:password@127.0.0.1:3306/iti_test?charset=utf8mb4'
uv run python -m alembic upgrade head
uv run iti-system migrations sync --target migrations/versions
PYTHONPATH=. uv run iti-system seed system app:create_app
uv run uvicorn main:app --reload
```

## PostgreSQL 集成验证

准备独立测试库：

```sql
CREATE DATABASE iti_test;
CREATE DATABASE my_business_app_test;
```

执行：

```bash
export DATABASE_URL='postgresql+psycopg://postgres:password@127.0.0.1:5432/iti_test'
uv run python -m alembic upgrade head
uv run uvicorn main:app --reload
```

验证：

```bash
curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/ready
```

如启用 `ready_check_db=True`，`/ready` 会执行 `SELECT 1`。

## Docker Compose 健康检查

模板生成项目已经包含 Docker Compose：

```bash
cp .env.example .env
iticli docker up
iticli docker logs
iticli docker down
```

如需本地数据库：

```bash
iticli docker up --db
iticli docker down --db
```

服务容器使用：

```yaml
healthcheck:
  test: ["CMD", "curl", "-f", "http://127.0.0.1:8000/health"]
  interval: 10s
  timeout: 3s
  retries: 3
```

依赖数据库就绪的服务可检查 `/ready`。

## 生产运行

简单部署：

```bash
uv run uvicorn main:app --host 0.0.0.0 --port 8000
```

多 worker：

```bash
uv run gunicorn main:app -k uvicorn.workers.UvicornWorker -w 4 -b 0.0.0.0:8000
```

`tasks_enabled=True` 时不要在多个 worker 同时启用调度。
轻量任务只保证单进程内正常运行。