Initial kitchen scaffold — Phase 1 kitchen port (build-verified 2026-07-11)

FastAPI backend (Python 3.11, MSSQL ODBC for SambaPOS, Azure DI OCR),
kitchen_db on central PG. React/TS/Vite frontend with navy sidebar layout.

Backend: auth.py (APP_SLUG=kitchen, SimpleNamespace — archive routes use
.kitchen_id/.is_admin without modification), main.py (51 migrations, scheduler,
internal router for KDS bookings feed), api/internal.py, full archive API
(31 routers: invoices, recipes, menus, sambapos, resos, newbook, disputes,
purchase_orders, etc.), models, migrations, OCR pipeline.
kitchen_id pinned to 1 (B1 — single hotel).

Frontend: AuthGate (app=kitchen, token shim for archive compat — B5b pending),
Layout (navy sidebar, 6 sections, Lucide icons, teal --app-primary),
App.tsx (Outlet pattern, UploadApp outside Layout), index.css (full :root block).
strict: false — archive components have type issues; build clean.

Note: 45 archive components call fetch('/api/...') without /kitchen/ prefix
(B5b). Runtime 404s; deferred until after initial testing.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

backend/migrations/add_budget_settings.py

@@ -0,0 +1,81 @@
+"""
+Migration: Add budget settings columns to kitchen_settings table
+
+Adds:
+- forecast_api_url: URL for external forecasting API
+- forecast_api_key: API key for forecast authentication
+- budget_gp_target: Target GP percentage (default 65%)
+- budget_lookback_weeks: Number of weeks for supplier % calculation (default 4)
+"""
+import asyncio
+from sqlalchemy import text
+from database import engine
+
+
+async def migrate():
+    async with engine.begin() as conn:
+        # Add forecast_api_url column
+        try:
+            await conn.execute(text(
+                """
+                ALTER TABLE kitchen_settings
+                ADD COLUMN forecast_api_url VARCHAR(500)
+                """
+            ))
+            print("+ Added forecast_api_url column")
+        except Exception as e:
+            if "already exists" in str(e).lower() or "duplicate column" in str(e).lower():
+                print("- forecast_api_url column already exists, skipping")
+            else:
+                raise
+
+        # Add forecast_api_key column
+        try:
+            await conn.execute(text(
+                """
+                ALTER TABLE kitchen_settings
+                ADD COLUMN forecast_api_key VARCHAR(500)
+                """
+            ))
+            print("+ Added forecast_api_key column")
+        except Exception as e:
+            if "already exists" in str(e).lower() or "duplicate column" in str(e).lower():
+                print("- forecast_api_key column already exists, skipping")
+            else:
+                raise
+
+        # Add budget_gp_target column
+        try:
+            await conn.execute(text(
+                """
+                ALTER TABLE kitchen_settings
+                ADD COLUMN budget_gp_target NUMERIC(5,2) DEFAULT 65.00
+                """
+            ))
+            print("+ Added budget_gp_target column")
+        except Exception as e:
+            if "already exists" in str(e).lower() or "duplicate column" in str(e).lower():
+                print("- budget_gp_target column already exists, skipping")
+            else:
+                raise
+
+        # Add budget_lookback_weeks column
+        try:
+            await conn.execute(text(
+                """
+                ALTER TABLE kitchen_settings
+                ADD COLUMN budget_lookback_weeks INTEGER DEFAULT 4
+                """
+            ))
+            print("+ Added budget_lookback_weeks column")
+        except Exception as e:
+            if "already exists" in str(e).lower() or "duplicate column" in str(e).lower():
+                print("- budget_lookback_weeks column already exists, skipping")
+            else:
+                raise
+
+
+if __name__ == "__main__":
+    print("Running migration: add_budget_settings")
+    asyncio.run(migrate())
+    print("Migration complete!")