iTi-Flask/docs/SEEDS.md

种子数据

iTi-Flask 不提供系统 seed。

seed 分三类：

• 框架 seed：当前没有。
• 系统 seed：由 iti-system 提供。
• 业务 seed：由业务项目自己维护。

规则

seed 代码必须：

• 幂等。
• 可重复执行。
• 按唯一键 upsert。
• 不做破坏性操作。

seed 代码不得：

• 删除用户数据。
• 重置已有管理员密码。
• 写入与当前包无关的数据。
• 替代 migration 修改表结构。

系统 Seed

需要用户、角色、菜单等系统能力时，业务项目应依赖 iti-system。

命令：

uv run python -m flask --app app.py iti-system seed system

iti-system seed 只写系统域初始数据。 引入即全量写入。

业务 Seed

业务项目可以自行提供 seed 命令。

业务 seed 可以写：

• 业务字典。
• 业务默认配置。
• 业务演示数据。

业务 seed 不应写：

• 框架内部数据。
• 其它服务的数据。
• ERP 外部系统数据。

运行时数据库文件不是 seed 文件，也不提交。