This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# 架构重构决策日志
## 当前决策
iTi-Flask 收敛为框架底座。
系统业务拆到独立包 `iti-system`。
ERP Service 作为独立业务项目，只依赖 `iti-flask`。
当前整体形态：
-`iTi-Flask`：框架基座。
-`iTi-System`：可选系统业务包。
-`erp-service`：ERP 中转服务。
- MES 主项目：按需依赖 `iti-flask + iti-system`。
## iTi-Flask 边界
保留：
- 应用工厂。
- 配置加载。
- APIFlask 集成。
- SQLAlchemy / Flask-Migrate。
- JWT 基础集成。
- 缓存、限流、日志、错误处理。
- module 协议。
- service client。
- 单进程 task runner。
- 可选 SPA 静态目录承载。
- Copier 业务项目模板。
移出：
-`sys_*` 模型。
- 系统路由。
- 系统 service。
- 系统 seed。
- 系统 migration。
- 系统事件处理器。
- 权限校验装饰器。
- 系统日志入库扩展。
## iTi-System 边界
`iti-system` 提供系统域能力：
- 认证。
- 用户。
- 用户扩展属性。
- 角色。
- 菜单。
- 部门。
- 字典。
- 系统配置。
- 文件。
- 审计日志。
业务项目只决定是否引入 `iti-system`。
引入即全量引入。
不提供 profile。
不提供系统模块选择。
不拆分系统 migration。
示例：
```python
fromiti_systemimportcreate_system_module
modules=[
create_system_module(),
]
```
## 微服务边界
当前不是强微服务平台。
不做：
- 服务注册发现。
- Kubernetes service mesh。
- 分布式事务。
- Saga。
- gRPC。
- 消息总线全家桶。
- 自动弹性伸缩。
- 多租户网关。
保留轻量服务协作：
- HTTP JSON。
- service token。
- 超时。
- 保守重试。
- 可选熔断。
- trace id 透传。
## ERP Service 决策
ERP Service 不属于框架。
它是独立业务项目。
职责：
- 调用既有 Monitor ERP API。
- 调用既有 Monitor ERP ODBC 数据源。
- 承担必要的 ERP 数据同步任务。
- 对其它业务项目提供 HTTP JSON 中转能力。
它不依赖 `iti-system`。
它不共享 MES 系统库。
## 数据库和迁移
每个业务项目只保留一条 Alembic migration 流。
iTi-Flask 不提供系统 migration。
需要系统能力时，由 `iti-system` 同步系统 migration：
```bash
uv run python -m flask --app app.py iti-system migrations sync
uv run python -m flask --app app.py db upgrade
```
`iti-system` 系统迁移是全量系统表集合。
不按 auth、user、role 等能力拆分。
轻服务不需要系统表时，直接不依赖 `iti-system`。
## Seed
iTi-Flask 不提供系统 seed。
`iti-system` 提供系统 seed：
```bash
uv run python -m flask --app app.py iti-system seed system