iTi-Flask/docs/MODULES.md

模块协议

模块是同一个 FastAPI 进程内的业务边界。 它不是独立服务。

注册

from iti import create_app
from my_app.modules.example import ExampleModule

app = create_app(modules=[ExampleModule()])

模块类

class ExampleModule:
    name = "example"

    def init_app(self, app):
        pass

    def register_routes(self, app):
        app.include_router(router)

    def register_permissions(self, app):
        pass

    def register_menu_seed(self, app):
        pass

    def register_tasks(self, app):
        pass

执行顺序：

1. init_app
2. register_tasks
3. register_routes
4. register_permissions
5. register_menu_seed

路由

使用 FastAPI 原生 APIRouter。

from fastapi import APIRouter
from iti.responses import ok

router = APIRouter(prefix="/example", tags=["example"])


@router.get("/ping")
def ping():
    return ok({"pong": True})

权限元数据

from iti.modules import ModulePermission

def register_permissions(self, app):
    app.state.iti_modules.register_permission(
        ModulePermission("example:item:list", "示例列表")
    )

框架负责收集元数据。 具体授权由 PermissionProvider 决定。 单独使用 iti-flask 时可注入自己的 provider。 使用 iti-system 时由系统包提供数据库 provider。