feat: add startup settings warnings

backend/backend/asgi.py

@@ -3,3 +3,7 @@
 
 os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'backend.settings')
 application = get_asgi_application()
+
+from .startup import warn_missing_critical_settings
+
+warn_missing_critical_settings()

backend/backend/startup.py

@@ -0,0 +1,34 @@
+"""Startup checks for critical deployment settings."""
+
+import sys
+
+from django.conf import settings
+
+CRITICAL_STARTUP_SETTINGS = (
+    'GEMINI_API_KEY',
+    'GOOGLE_CLIENT_ID',
+    'GOOGLE_CLIENT_SECRET',
+)
+
+
+def warn_missing_critical_settings(stream=None):
+    """
+    Print a bold-style warning for missing startup settings and return them.
+    """
+    missing = [
+        name
+        for name in CRITICAL_STARTUP_SETTINGS
+        if not str(getattr(settings, name, '') or '').strip()
+    ]
+
+    if not missing:
+        return []
+
+    output = stream or sys.stdout
+    print(
+        '*** WARNING: Missing LeadOrbit startup settings: '
+        f"{', '.join(missing)} ***",
+        file=output,
+        flush=True,
+    )
+    return missing

backend/backend/tests.py

@@ -0,0 +1,36 @@
+from io import StringIO
+
+from django.test import SimpleTestCase, override_settings
+
+from .startup import warn_missing_critical_settings
+
+
+class StartupSettingsValidationTests(SimpleTestCase):
+    @override_settings(
+        GEMINI_API_KEY='',
+        GOOGLE_CLIENT_ID='',
+        GOOGLE_CLIENT_SECRET='',
+    )
+    def test_warns_when_critical_settings_are_missing(self):
+        buffer = StringIO()
+
+        missing = warn_missing_critical_settings(stream=buffer)
+
+        self.assertEqual(
+            missing,
+            ['GEMINI_API_KEY', 'GOOGLE_CLIENT_ID', 'GOOGLE_CLIENT_SECRET'],
+        )
+        self.assertIn('Missing LeadOrbit startup settings', buffer.getvalue())
+
+    @override_settings(
+        GEMINI_API_KEY='gemini-key',
+        GOOGLE_CLIENT_ID='client-id',
+        GOOGLE_CLIENT_SECRET='client-secret',
+    )
+    def test_returns_quietly_when_all_settings_exist(self):
+        buffer = StringIO()
+
+        missing = warn_missing_critical_settings(stream=buffer)
+
+        self.assertEqual(missing, [])
+        self.assertEqual(buffer.getvalue(), '')

backend/backend/wsgi.py

@@ -3,3 +3,7 @@
 
 os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'backend.settings')
 application = get_wsgi_application()
+
+from .startup import warn_missing_critical_settings
+
+warn_missing_critical_settings()