feat: add showcase mode to disable all AI/Gemini features (#105)

- Add SHOWCASE_MODE env variable (defaults to true)
- Disable all Celery scheduled tasks when in showcase mode
- Block all API endpoints that trigger AI tasks:
  - /api/admin/tasks/* (collect, generate-alerts, etc.)
  - /api/bluesky/trigger
  - /api/archive/trigger
  - /api/notifications/email/batch
- Block geocoding endpoints:
  - /auth/geocode
  - /api/alerts/regions/search
- Add showcase mode checks to services:
  - analysis.py (Gemini AI)
  - geocoding_service.py (Google Geocoding)
  - population_estimator.py (Google reverse geocoding)
- Update docker-compose.yml with SHOWCASE_MODE for all services
- Add showcase mode banner to admin dev-tools page
- Graceful error handling in location onboarding

This puts the app in portfolio/demo mode with $0 API costs
while keeping all read-only functionality working.

Author: geeth24

client/app/admin/dev-tools/page.tsx

@@ -152,6 +152,22 @@ export default function DevToolsPage() {
         )}
       </div>
 
+      {/* Showcase Mode Banner */}
+      <Card className="border-amber-500/50 bg-amber-500/10">
+        <CardContent className="pt-6">
+          <div className="flex items-center gap-3">
+            <span className="text-2xl">🎭</span>
+            <div>
+              <h3 className="font-semibold text-amber-600 dark:text-amber-400">Showcase Mode Active</h3>
+              <p className="text-sm text-muted-foreground">
+                AI features and data collection are disabled to prevent API costs. 
+                The app displays existing data only for portfolio demonstration.
+              </p>
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+
       <div className="grid gap-4 grid-cols-1 md:grid-cols-2 lg:grid-cols-3">
         <Card>
           <CardHeader>

client/components/location-onboarding.tsx

@@ -149,7 +149,10 @@ export function LocationOnboarding({ onLocationSet }: LocationOnboardingProps) {
       const response = await apiClient(`/auth/geocode?query=${encodeURIComponent(manualLocation.trim())}`);
 
       if (!response.ok) {
-        if (response.status === 404) {
+        if (response.status === 403) {
+          // Showcase mode - geocoding disabled
+          setError('Manual location search is currently unavailable. Please use "Auto-Detect Country" or "Skip Location Setup" instead.');
+        } else if (response.status === 404) {
           setError('Location not found. Please try a different location.');
         } else {
           setError('Failed to find location. Please try again.');

docker-compose.yml

@@ -50,6 +50,7 @@ services:
       DATABASE_URL: postgresql://dev:devpassword@postgres:5432/bluerelief
       REDIS_URL: redis://redis:6379/0
       ENVIRONMENT: ${ENVIRONMENT}
+      SHOWCASE_MODE: ${SHOWCASE_MODE:-true}
       GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID}
       GOOGLE_CLIENT_SECRET: ${GOOGLE_CLIENT_SECRET}
       JWT_SECRET_KEY: ${JWT_SECRET_KEY}
@@ -90,6 +91,7 @@ services:
     environment:
       DATABASE_URL: postgresql://dev:devpassword@postgres:5432/bluerelief
       REDIS_URL: redis://redis:6379/0
+      SHOWCASE_MODE: ${SHOWCASE_MODE:-true}
       BlueSky_Username: ${BlueSky_Username}
       BlueSky_Password: ${BlueSky_Password}
       GOOGLE_API_KEY: ${GOOGLE_API_KEY}
@@ -120,6 +122,7 @@ services:
     environment:
       DATABASE_URL: postgresql://dev:devpassword@postgres:5432/bluerelief
       REDIS_URL: redis://redis:6379/0
+      SHOWCASE_MODE: ${SHOWCASE_MODE:-true}
       BlueSky_Username: ${BlueSky_Username}
       BlueSky_Password: ${BlueSky_Password}
       GOOGLE_API_KEY: ${GOOGLE_API_KEY}

email-service/src/templates/logo.ts

@@ -7,3 +7,5 @@ export const BASE_URL = 'https://bluerelief.app';
 
 
 
+
+

environment.example

@@ -12,6 +12,10 @@ REDIS_URL=redis://localhost:6379/0
 ENVIRONMENT=development
 NODE_ENV=development
 
+# Showcase Mode - When true, disables all AI/Gemini features to prevent API costs
+# Set to false to enable data collection and AI analysis
+SHOWCASE_MODE=true
+
 # Frontend Configuration
 NEXT_PUBLIC_API_URL=http://localhost:8000
 NEXT_PUBLIC_APP_URL=https://platform.private.bluerelief.app

server/celery_app.py

@@ -7,6 +7,9 @@
 
 REDIS_URL = os.getenv("REDIS_URL", "redis://redis:6379/0")
 
+# SHOWCASE_MODE: When enabled, disables all automatic tasks to prevent API costs
+SHOWCASE_MODE = os.getenv("SHOWCASE_MODE", "true").lower() == "true"
+
 celery_app = Celery(
     "bluerelief_tasks",
     broker=REDIS_URL,
@@ -45,47 +48,53 @@
 # Default to running every 8 hours, but can be configured with env var
 SCHEDULE_HOURS = int(os.getenv("SCHEDULE_HOURS", "8"))
 
-celery_app.conf.beat_schedule = {
-    "collect-bluesky-data": {
-        "task": "tasks.collect_and_analyze",
-        "schedule": crontab(hour=f"*/{SCHEDULE_HOURS}", minute=0),
-        "options": {"expires": 60 * 60 * 3},  # Tasks expire after 3 hours
-    },
-    "generate-alerts": {
-        "task": "tasks.generate_alerts",
-        "schedule": 300.0,  # every 5 minutes
-        "options": {
-            "expires": 60 * 5,  # Tasks expire after 5 minutes
+# SHOWCASE MODE: All scheduled tasks are disabled to prevent Gemini/Google API costs
+# The app displays existing data only - no new data collection or AI analysis
+if SHOWCASE_MODE:
+    print("🎭 SHOWCASE MODE ENABLED - All scheduled tasks disabled")
+    celery_app.conf.beat_schedule = {}
+else:
+    celery_app.conf.beat_schedule = {
+        "collect-bluesky-data": {
+            "task": "tasks.collect_and_analyze",
+            "schedule": crontab(hour=f"*/{SCHEDULE_HOURS}", minute=0),
+            "options": {"expires": 60 * 60 * 3},  # Tasks expire after 3 hours
         },
-    },
-    "manage-alert-queue": {
-        "task": "tasks.manage_alert_queue",
-        "schedule": 120.0,  # every 2 minutes
-        "options": {
-            "expires": 60 * 2,  # Tasks expire after 2 minutes
+        "generate-alerts": {
+            "task": "tasks.generate_alerts",
+            "schedule": 300.0,  # every 5 minutes
+            "options": {
+                "expires": 60 * 5,  # Tasks expire after 5 minutes
+            },
         },
-    },
-    "send-alert-emails": {
-        "task": "tasks.send_alert_emails",
-        "schedule": 120.0,  # every 2 minutes
-        "options": {
-            "expires": 60 * 2,  # Tasks expire after 2 minutes
+        "manage-alert-queue": {
+            "task": "tasks.manage_alert_queue",
+            "schedule": 120.0,  # every 2 minutes
+            "options": {
+                "expires": 60 * 2,  # Tasks expire after 2 minutes
+            },
         },
-    },
-    "cleanup-alerts": {
-        "task": "tasks.cleanup_old_alerts",
-        "schedule": crontab(hour=2, minute=0),  # 2 AM daily
-        "options": {
-            "expires": 60 * 60 * 24,  # Tasks expire after 24 hours
+        "send-alert-emails": {
+            "task": "tasks.send_alert_emails",
+            "schedule": 120.0,  # every 2 minutes
+            "options": {
+                "expires": 60 * 2,  # Tasks expire after 2 minutes
+            },
         },
-    },
-    "archive-completed-disasters": {
-        "task": "tasks.archive_completed_disasters",
-        "schedule": crontab(hour=3, minute=0),  # 3 AM daily
-        "options": {
-            "expires": 60 * 60 * 24,  # Tasks expire after 24 hours
+        "cleanup-alerts": {
+            "task": "tasks.cleanup_old_alerts",
+            "schedule": crontab(hour=2, minute=0),  # 2 AM daily
+            "options": {
+                "expires": 60 * 60 * 24,  # Tasks expire after 24 hours
+            },
         },
-    },
-}
+        "archive-completed-disasters": {
+            "task": "tasks.archive_completed_disasters",
+            "schedule": crontab(hour=3, minute=0),  # 3 AM daily
+            "options": {
+                "expires": 60 * 60 * 24,  # Tasks expire after 24 hours
+            },
+        },
+    }
 
 celery_app.conf.timezone = "UTC"

server/main.py

@@ -48,6 +48,7 @@ def get_commit_sha():
 
 APP_VERSION = get_version()
 COMMIT_SHA = get_commit_sha()
+SHOWCASE_MODE = os.getenv("SHOWCASE_MODE", "true").lower() == "true"
 
 app = FastAPI(
     title="BlueRelief API",
@@ -125,6 +126,7 @@ async def version_info():
         "version": APP_VERSION,
         "commit": COMMIT_SHA,
         "environment": os.getenv("ENVIRONMENT", "development"),
+        "showcase_mode": SHOWCASE_MODE,
     }
 
 

server/routers/admin_tasks.py

@@ -2,6 +2,7 @@
 from pydantic import BaseModel
 from typing import List, Optional
 from datetime import datetime
+import os
 from db_utils.db import (
     SessionLocal,
     User,
@@ -27,6 +28,18 @@
 
 router = APIRouter(prefix="/api/admin/tasks", tags=["admin-tasks"])
 
+# SHOWCASE_MODE: When enabled, blocks all AI/data collection tasks
+SHOWCASE_MODE = os.getenv("SHOWCASE_MODE", "true").lower() == "true"
+
+
+def check_showcase_mode():
+    """Raises HTTPException if showcase mode is enabled"""
+    if SHOWCASE_MODE:
+        raise HTTPException(
+            status_code=403,
+            detail="🎭 Showcase Mode: AI features disabled. This app is in portfolio/demo mode.",
+        )
+
 
 def get_db():
     db = SessionLocal()
@@ -56,6 +69,7 @@ def trigger_collection(req: CollectRequest, current_admin: User = Depends(get_cu
     Accepts JSON body: { "include_enhanced": bool, "disaster_types": ["earthquake","flood"] }
     Note: disaster_types is currently accepted for future use but not passed to the Celery task.
     """
+    check_showcase_mode()
     try:
         task = collect_and_analyze.delay(include_enhanced=req.include_enhanced)
         return {"task_id": task.id, "status": "started"}
@@ -65,6 +79,7 @@ def trigger_collection(req: CollectRequest, current_admin: User = Depends(get_cu
 
 @router.post("/generate-alerts")
 def trigger_alert_generation(current_admin: User = Depends(get_current_admin)):
+    check_showcase_mode()
     try:
         task = generate_alerts.delay()
         return {"task_id": task.id, "status": "started"}
@@ -74,6 +89,7 @@ def trigger_alert_generation(current_admin: User = Depends(get_current_admin)):
 
 @router.post("/process-queue")
 def trigger_queue_processing(current_admin: User = Depends(get_current_admin)):
+    check_showcase_mode()
     try:
         task = manage_alert_queue.delay()
         return {"task_id": task.id, "status": "started"}
@@ -83,6 +99,7 @@ def trigger_queue_processing(current_admin: User = Depends(get_current_admin)):
 
 @router.post("/cleanup-alerts")
 def trigger_alert_cleanup(current_admin: User = Depends(get_current_admin)):
+    check_showcase_mode()
     try:
         task = cleanup_old_alerts.delay()
         return {"task_id": task.id, "status": "started"}
@@ -92,6 +109,7 @@ def trigger_alert_cleanup(current_admin: User = Depends(get_current_admin)):
 
 @router.post("/archive")
 def trigger_archive(days_threshold: int = 2, current_admin: User = Depends(get_current_admin)):
+    check_showcase_mode()
     try:
         task = archive_completed_disasters.delay(days_threshold=days_threshold)
         return {"task_id": task.id, "status": "started", "days_threshold": days_threshold}
@@ -144,6 +162,7 @@ def trigger_test_alert(
     Trigger a test alert for a specific user at their location.
     Creates a test disaster near the user and queues an alert for them.
     """
+    check_showcase_mode()
     db = SessionLocal()
     try:
         user = (

server/routers/alerts.py

@@ -1,5 +1,6 @@
 from fastapi import APIRouter, Depends, HTTPException, Query
 from sqlalchemy.orm import Session
+import os
 from db_utils.db import Alert, AlertQueue, UserAlertPreferences, User, SessionLocal, get_db_session
 from services.geocoding_service import geocode_region
 from typing import Optional, List
@@ -8,6 +9,9 @@
 
 router = APIRouter(prefix="/api/alerts", tags=["alerts"])
 
+# SHOWCASE_MODE: When enabled, disables geocoding API calls
+SHOWCASE_MODE = os.getenv("SHOWCASE_MODE", "true").lower() == "true"
+
 
 class AlertResponse(BaseModel):
     id: int
@@ -286,6 +290,13 @@ def update_user_location(
 @router.get("/regions/search", response_model=RegionSearchResult)
 def search_region(query: str = Query(..., min_length=2)):
     """Search for a region using Google Geocoding API"""
+    # SHOWCASE MODE: Geocoding disabled to prevent API costs
+    if SHOWCASE_MODE:
+        raise HTTPException(
+            status_code=403,
+            detail="🎭 Showcase Mode: Region search disabled. This app is in portfolio/demo mode."
+        )
+    
     result = geocode_region(query)
 
     if not result:

server/routers/archive.py

@@ -1,12 +1,16 @@
 from fastapi import APIRouter, Depends, HTTPException
 from sqlalchemy.orm import Session
+import os
 from db_utils.db import SessionLocal, User
 from middleware.admin_auth import get_current_admin
 from tasks import archive_completed_disasters
 from celery_app import celery_app
 
 router = APIRouter(prefix="/api/archive", tags=["archive"])
 
+# SHOWCASE_MODE: When enabled, blocks task triggers
+SHOWCASE_MODE = os.getenv("SHOWCASE_MODE", "true").lower() == "true"
+
 
 def get_db():
     db = SessionLocal()
@@ -43,6 +47,11 @@ def trigger_archive(
     Returns:
         Task info with ID and status
     """
+    if SHOWCASE_MODE:
+        raise HTTPException(
+            status_code=403,
+            detail="🎭 Showcase Mode: Task triggers disabled. This app is in portfolio/demo mode."
+        )
     try:
         task = archive_completed_disasters.delay(days_threshold=days_threshold)
         return {