# {{ project_name }}

FastAPI 业务后端项目。
由 iTi-Flask Copier 模板生成。

## 依赖

默认使用私有 Git 依赖。
推荐固定 tag，也允许 branch。
`file://` 只建议框架开发者本机验证模板时使用。

## 初始化

```bash
uv sync --extra dev
uv run alembic upgrade head
```

{% if include_system %}
同步系统 migration 和 seed：

```bash
uv run iti-system migrations sync --target migrations/versions
uv run alembic upgrade head
uv run iti-system seed system app:app
```
{% endif %}

## 开发

```bash
uv run uvicorn app:app --reload
uv run pytest -q
```

## 数据库迁移

```bash
uv run alembic revision --autogenerate -m "alice add example table"
uv run alembic upgrade head
```

规则：

- `migrations/versions` 必须提交。
- migration message 第一个词写作者名。
- 生产只从 `main` 执行 `alembic upgrade head`。