Add DEMO feature to the project

gateway/app/main.py

@@ -20,7 +20,8 @@ from app.middleware.auth import AuthMiddleware
 from app.middleware.logging import LoggingMiddleware
 from app.middleware.rate_limit import RateLimitMiddleware
 from app.middleware.subscription import SubscriptionMiddleware
-from app.routes import auth, tenant, notification, nominatim, user, subscription
+from app.middleware.demo_middleware import DemoMiddleware
+from app.routes import auth, tenant, notification, nominatim, user, subscription, demo
 from shared.monitoring.logging import setup_logging
 from shared.monitoring.metrics import MetricsCollector
 
@@ -55,11 +56,13 @@ app.add_middleware(
     allow_headers=["*"],
 )
 
-# Custom middleware - Add in correct order (outer to inner)
-app.add_middleware(LoggingMiddleware)
-app.add_middleware(RateLimitMiddleware, calls_per_minute=300)
-app.add_middleware(SubscriptionMiddleware, tenant_service_url=settings.TENANT_SERVICE_URL)
-app.add_middleware(AuthMiddleware)
+# Custom middleware - Add in REVERSE order (last added = first executed)
+# Execution order: DemoMiddleware -> AuthMiddleware -> SubscriptionMiddleware -> RateLimitMiddleware -> LoggingMiddleware
+app.add_middleware(LoggingMiddleware)          # Executes 5th (outermost)
+app.add_middleware(RateLimitMiddleware, calls_per_minute=300)  # Executes 4th
+app.add_middleware(SubscriptionMiddleware, tenant_service_url=settings.TENANT_SERVICE_URL)  # Executes 3rd
+app.add_middleware(AuthMiddleware)             # Executes 2nd - Checks for demo context
+app.add_middleware(DemoMiddleware)             # Executes 1st (innermost) - Sets demo user context FIRST
 
 # Include routers
 app.include_router(auth.router, prefix="/api/v1/auth", tags=["authentication"])
@@ -68,6 +71,7 @@ app.include_router(tenant.router, prefix="/api/v1/tenants", tags=["tenants"])
 app.include_router(subscription.router, prefix="/api/v1", tags=["subscriptions"])
 app.include_router(notification.router, prefix="/api/v1/notifications", tags=["notifications"])
 app.include_router(nominatim.router, prefix="/api/v1/nominatim", tags=["location"])
+app.include_router(demo.router, prefix="/api/v1", tags=["demo"])
 
 
 @app.on_event("startup")