iTi-Flask/docs/COPIER_TEMPLATE.md

Copier 模板

copier-template 生成 FastAPI 业务后端骨架。 模板只引用框架包，不复制框架源码。

生成

uvx copier copy ./copier-template ../my-business-app
cd ../my-business-app
uv sync --extra dev
uv run alembic upgrade head
uv run uvicorn app:app --reload

参数

参数	说明
project_name	业务项目显示名称
project_slug	业务项目 Python 包名
framework_git	iTi-Flask Git 地址
framework_tag	iTi-Flask Git tag
include_system	是否引入 iTi-System
system_git	iTi-System Git 地址
system_tag	iTi-System Git tag

默认推荐私有 Git tag。 允许改成 branch 或 file://，但多人协作项目不建议依赖本机路径。

生成内容

• app.py
• config.py
• pyproject.toml
• migrations/
• 示例 FastAPI 模块
• 示例 SQLAlchemy 模型
• 示例测试

系统业务

选择 include_system=true 时，模板会注册 create_system_module()。 生成后执行：

uv run iti-system migrations sync --target migrations/versions
uv run alembic upgrade head
uv run iti-system seed system app:app