iTi-System/README.md

iTi-System

iti-system 是 iTi-Flask 的可选系统业务包。

它提供认证、用户、角色、菜单、部门、字典、配置、文件、日志、用户扩展属性等系统域能力。 引入即全量引入。 不提供模块选择。 不拆分 migration。

ERP Service 这类服务不需要依赖本包。 MES 这类主业务项目可以依赖本包。

安装

业务项目依赖：

dependencies = [
  "iti-flask @ git+https://git.noahlan.cn/iti-framework/iTi-Flask.git@v0.1.1",
  "iti-system @ git+https://git.noahlan.cn/iti-framework/iTi-System.git@v0.1.1",
]

本地开发：

uv sync --extra dev
uv run --extra dev pytest
uv run --extra dev mypy

使用

from iti.applications import create_app
from iti_system import create_system_module

app = create_app(
    modules=[
        create_system_module(),
    ],
)

数据库迁移

业务项目只保留一条 Alembic migration 流。 系统 migration 同步到业务项目的 migrations/versions。

uv run python -m flask --app app.py iti-system migrations sync
uv run python -m flask --app app.py db upgrade

系统 migration 是全量系统表集合。 轻服务如果不需要系统表，应不依赖 iti-system。

Seed

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

seed 使用 Python 代码。 必须幂等。 不会重置已有管理员密码。