"""# Summary

FastAPI application bootstrap — uses OpenAPIFirstApp for spec-driven routing.
Handlers are looked up by operationId in interfaces.openapi, so no router tables
are declared here; the lifespan initializes and shuts down app resources.

---

``load_dotenv()`` runs before the app is constructed so ``{AUTH_SERVER}`` in
``openapi.yaml``'s bearer-JWT security scheme resolves from ``.env`` at build
time (openapi_first resolves env placeholders when the spec is loaded).
"""
# ruff: noqa: E402
import logging
from contextlib import asynccontextmanager

from dotenv import load_dotenv
from openapi_first.app import OpenAPIFirstApp
from starlette.middleware.cors import CORSMiddleware

load_dotenv()

logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s [%(name)s] %(levelname)s: %(message)s",
)

import interfaces.openapi as openapi_routes
from init import init, shutdown

logger = logging.getLogger(__name__)


@asynccontextmanager
async def lifespan(app: OpenAPIFirstApp):
    """Initialize resource wiring on startup and shut it down on exit.

    Args:
        app (OpenAPIFirstApp): The ASGI application exposing app.state.

    Yields:
        None: The application runs while the context is open.
    """
    resources = await init()
    app.state.db_resources = resources

    yield

    await shutdown()


app = OpenAPIFirstApp(
    openapi_path="openapi.yaml",
    routes_module=openapi_routes,
    title="Veterinary Clinic API",
    version="0.1.0",
    lifespan=lifespan,
)

app.add_middleware(CORSMiddleware, allow_origins=["*"], allow_methods=["*"], allow_headers=["*"])