Pilot-ready architecture

Connector readiness

CivicOps runs without secrets by using local deterministic fallback, and activates live connectors only through environment configuration and explicit actions.

WhatsApp Cloud API is connector-ready for sandbox/live-test and future production pilots. CivicOps does not depend on WhatsApp. Residents can report, track, and receive alerts through the Citizen App / Installable PWA and web portal.

Gemini diagnostics

Enabled

No

Key present

No

Primary

gemini-2.5-flash

Routine

gemini-3.1-flash-lite

Quota/model error

Skipped: Gemini disabled or key missing

Calls this session

0

Fallback active

Yes

Fallback models: gemini-3.1-flash-lite, gemini-2.5-flash-lite, gemini-2.0-flash-lite, gemini-2.0-flash

Last action: manual-health-test · Last model: None · Last result: Skipped: Gemini disabled or key missing

Run live Gemini health test (manual)

Optional WhatsApp connector readiness

Production use requires WhatsApp Business setup, opt-in/templates, billing and approved recipients. Sandbox mode limits live recipients and masks numbers in CivicOps outputs.

Status
Sandbox Active — configure Meta credentials and public URL for live readiness
Mode
Needs Environment Variables
Webhook verify
/webhooks/whatsapp
Open optional WhatsApp sandbox

Gemini AI Agent

Fallback Active

AI-powered incident classification and routing

Configuration: GEMINI_ENABLED, GEMINI_API_KEY, GEMINI_MODEL, GEMINI_ROUTINE_MODEL, GEMINI_FALLBACK_MODELS, GEMINI_AUTO_RUN_AGENT_PAGE, GEMINI_MANUAL_TEST_COOLDOWN_SECONDS, GEMINI_QUOTA_COOLDOWN_MINUTES, GEMINI_MODE

Docs: /Home/BobEvidence and docs/gemini-setup.md

Citizen App / PWA / App Channel

Backend Gemini/fallback enrichment

Main public channel for reports, tracking, alerts and profile without WhatsApp dependency

Configuration: None on device; Gemini runs on backend only

Docs: docs/mobile-pwa.md

Department/ERP Connector Readiness

Pilot-ready architecture

Department queues can be mapped to municipal ticketing/ERP systems after approvals

Configuration: ERP_API_URL, ERP_API_KEY

Docs: docs/integration-readiness.md

GIS/Geocoding Connector Readiness

Synthetic ward estimates now

Real GIS/ward data required for production-grade geocoding

Configuration: GIS_API_KEY

Docs: docs/integration-readiness.md

Weather/Area Context Connector Readiness

Area risk cards

Weather and area context support alert recommendations

Configuration: WEATHER_API_KEY

Docs: docs/integration-readiness.md

Email/SMS Connector Readiness

Placeholder

Approved citizen messaging channels can be added without changing the intake story

Configuration: SMS_API_KEY, SMTP_HOST

Docs: docs/integration-readiness.md

WhatsApp Optional Connector Readiness

Needs Environment Variables

Optional connector-ready WhatsApp Cloud API integration for future pilots/live-test messaging.

Configuration: WHATSAPP_ENABLED, WHATSAPP_DEMO_MODE, WHATSAPP_VERIFY_TOKEN, WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_GRAPH_VERSION, WHATSAPP_PUBLIC_BASE_URL

Docs: /Home/BobEvidence and docs/whatsapp-setup.md

Voice-note Transcript Readiness

Transcript sandbox

Voice-note transcripts can enter the same Gemini/fallback intake pipeline

Configuration: VOICE_API_KEY, VOICE_SERVICE_URL

Docs: docs/integration-readiness.md