72 lines
2.3 KiB
Python
72 lines
2.3 KiB
Python
|
"""Единая точка регистрации модулей: API, веб-UI и подписки на события.
|
||
|
|
|
||
|
|
Новый модуль: файл в `onguard24/modules/`, запись в `MODULE_MOUNTS` — см. docs/MODULES.md.
|
||
|
|
"""
|
||
|
|
|
||
|
|
from __future__ import annotations
|
||
|
|
|
||
|
|
from collections.abc import Awaitable, Callable
|
||
|
|
from dataclasses import dataclass
|
||
|
|
|
||
|
|
from fastapi import APIRouter
|
||
|
|
from starlette.requests import Request
|
||
|
|
|
||
|
|
from onguard24.domain.events import EventBus
|
||
|
|
from onguard24.modules import contacts, schedules, statusboard
|
||
|
|
|
||
|
|
# async (Request) -> str — фрагмент HTML для главной страницы (опционально)
|
||
|
|
HomeFragment = Callable[[Request], Awaitable[str]]
|
||
|
|
|
||
|
|
|
||
|
|
@dataclass(frozen=True)
|
||
|
|
class ModuleMount:
|
||
|
|
"""Один модуль: API под url_prefix, UI под /ui/modules/{slug}."""
|
||
|
|
|
||
|
|
router: APIRouter
|
||
|
|
url_prefix: str
|
||
|
|
register_events: Callable[[EventBus], None]
|
||
|
|
slug: str
|
||
|
|
title: str
|
||
|
|
ui_router: APIRouter | None = None
|
||
|
|
render_home_fragment: HomeFragment | None = None
|
||
|
|
|
||
|
|
|
||
|
|
def _mounts() -> list[ModuleMount]:
|
||
|
|
return [
|
||
|
|
ModuleMount(
|
||
|
|
router=schedules.router,
|
||
|
|
url_prefix="/api/v1/modules/schedules",
|
||
|
|
register_events=schedules.register_events,
|
||
|
|
slug="schedules",
|
||
|
|
title="Календарь дежурств",
|
||
|
|
ui_router=schedules.ui_router,
|
||
|
|
render_home_fragment=schedules.render_home_fragment,
|
||
|
|
),
|
||
|
|
ModuleMount(
|
||
|
|
router=contacts.router,
|
||
|
|
url_prefix="/api/v1/modules/contacts",
|
||
|
|
register_events=contacts.register_events,
|
||
|
|
slug="contacts",
|
||
|
|
title="Контакты",
|
||
|
|
ui_router=contacts.ui_router,
|
||
|
|
render_home_fragment=contacts.render_home_fragment,
|
||
|
|
),
|
||
|
|
ModuleMount(
|
||
|
|
router=statusboard.router,
|
||
|
|
url_prefix="/api/v1/modules/statusboard",
|
||
|
|
register_events=statusboard.register_events,
|
||
|
|
slug="statusboard",
|
||
|
|
title="Светофор",
|
||
|
|
ui_router=statusboard.ui_router,
|
||
|
|
render_home_fragment=statusboard.render_home_fragment,
|
||
|
|
),
|
||
|
|
]
|
||
|
|
|
||
|
|
|
||
|
|
MODULE_MOUNTS: list[ModuleMount] = _mounts()
|
||
|
|
|
||
|
|
|
||
|
|
def register_module_events(bus: EventBus) -> None:
|
||
|
|
for m in MODULE_MOUNTS:
|
||
|
|
m.register_events(bus)
|