Vishesh 'ironeagle' Bangotra
406affcfcf
Renumber the 15 reference docs into pillar groups (recipe -> anatomy): - 01 Build Recipe (entry), 02 Composition Root - domains: 10 Layering Rules - contract: 20 Spec-First Routing, 21 CRUD Template, 22 Auth Integration - interfaces/infra: 30 Infra Adapters - UI: 40 UI: Auto-Rendered Admin & Custom Pages (new; @aetoskia packages, client template, x- catalog via react-openapi MCP module) - pipelines: 50 Pipeline Scaffold, 51 Worker & Progress, 52 Human-in-the-Loop - delivery/meta: 90 Drone Pipelines, 91 Versioning & Changelog, 92 Genericity Matrix, 93 Library Registry, 94 Repository Inventory MCP module names are unchanged (NN_ prefix stripped); all cross-references (wiki, templates, hooks, registry) updated; lib index rewritten pillar-first; build recipe bootstraps the client template. Bundle + HTML sites regenerated.
63 lines
1.9 KiB
Python
63 lines
1.9 KiB
Python
"""# Summary
|
|
|
|
Composition root — connects MongoDB (when selected), wires all repos and
|
|
services, and returns the resources dict. Shared bootstrap for the FastAPI
|
|
app, the worker and the seed/drop scripts, guarded against repeated
|
|
initialization via a module-level flag.
|
|
|
|
---
|
|
|
|
The ``memory`` backend skips the Mongo connection entirely — repos are
|
|
process-local dictionaries, so a plain ``uvicorn main:app`` runs with zero
|
|
external services.
|
|
"""
|
|
from typing import Any
|
|
|
|
from config import settings
|
|
from domain.item.ports.db import create_item_repo
|
|
from domain.item.ports.service import get_item_service
|
|
from domain.job.ports.db import create_job_repo
|
|
from domain.job.ports.service import get_job_service
|
|
from infra.db.setup import setup_database, shutdown_database
|
|
|
|
_resources: dict[str, Any] = {}
|
|
_initialized: bool = False
|
|
|
|
|
|
async def init() -> dict[str, Any]:
|
|
"""Wire all repos and services, and return the resources dict.
|
|
|
|
Idempotent: repeated calls short-circuit and return the cached resources.
|
|
Only the ``mongo`` backend performs a network connection here.
|
|
|
|
Returns:
|
|
Dict[str, Any]: Named services keyed by resource name
|
|
(``<resource>_svc`` and ``<resource>_repo``).
|
|
"""
|
|
global _resources, _initialized
|
|
if _initialized:
|
|
return _resources
|
|
|
|
if settings.repo_backend == "mongo":
|
|
await setup_database(uri=settings.mongo_uri, db_name=settings.mongo_db)
|
|
|
|
item_repo = create_item_repo()
|
|
job_repo = create_job_repo()
|
|
|
|
_resources["item_repo"] = item_repo
|
|
_resources["job_repo"] = job_repo
|
|
_resources["item_svc"] = get_item_service(item_repo)
|
|
_resources["job_svc"] = get_job_service(job_repo)
|
|
|
|
_initialized = True
|
|
return _resources
|
|
|
|
|
|
async def shutdown() -> None:
|
|
"""Disconnect MongoDB (if connected) and reset the resources cache."""
|
|
global _initialized
|
|
if settings.repo_backend == "mongo":
|
|
await shutdown_database()
|
|
_resources.clear()
|
|
_initialized = False
|