Project started 🍾

app/main.py

@@ -0,0 +1,51 @@
+"""FastAPI composition root: wiring, lifespan, middleware, routers."""
+
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI
+
+from app.api.errors import register_exception_handlers
+from app.api.health import router as health_router
+from app.api.middleware import CorrelationIdMiddleware
+from app.core.config import get_settings
+from app.core.logging import configure_logging, get_logger
+from app.infrastructure.cache import close_redis
+from app.infrastructure.db import dispose_engine
+
+log = get_logger(__name__)
+
+
+@asynccontextmanager
+async def lifespan(_app: FastAPI) -> AsyncIterator[None]:
+    settings = get_settings()
+    log.info("startup", environment=settings.environment)
+    yield
+    log.info("shutdown")
+    await dispose_engine()
+    await close_redis()
+
+
+def create_app() -> FastAPI:
+    settings = get_settings()
+    configure_logging(level=settings.log_level, json=settings.log_json)
+
+    app = FastAPI(
+        title="mcma-backend",
+        version="0.1.0",
+        summary="Self-hosted, offline-first music service.",
+        lifespan=lifespan,
+    )
+
+    app.add_middleware(CorrelationIdMiddleware)
+    register_exception_handlers(app)
+
+    app.include_router(health_router)
+    # Versioned API routers (auth, library, …) are mounted in later steps:
+    #   app.include_router(api_v1_router, prefix="/api/v1")
+    #   app.include_router(subsonic_router, prefix="/rest")
+
+    return app
+
+
+app = create_app()