feat(FN-002): complete Step 3 — FastAPI Backend App Skeleton

apps/api/app/config.py

@@ -0,0 +1,28 @@
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore",
+    )
+
+    app_name: str = "Headquarter API"
+    debug: bool = False
+    api_v1_prefix: str = "/api/v1"
+
+    # Authentik OIDC placeholders (to be wired in FN-004)
+    authentik_issuer_url: str = ""
+    authentik_client_id: str = ""
+    authentik_client_secret: str = ""
+
+    # Database (to be wired in FN-004)
+    database_url: str = "postgresql://postgres:postgres@localhost:5432/headquarter"
+
+    # Deployment
+    root_domain: str = "localhost"
+    tool_subdomain_pattern: str = "{tool}-{project}-{user}.tools.{root_domain}"
+
+
+settings = Settings()

apps/api/app/main.py

@@ -0,0 +1,22 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from app.config import settings
+
+app = FastAPI(
+    title=settings.app_name,
+    debug=settings.debug,
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["http://localhost:5173"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.get("/health")
+def health() -> dict[str, str]:
+    return {"status": "ok", "service": settings.app_name}