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-2.5-flash-lite

Quota/model error

Fallback used before live Gemini call

Calls this session

0

Fallback active

Yes

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

Last action: WhatsApp-intake · Last model: Local deterministic fallback · Last result: Fallback used before live Gemini call

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: Server-side only; see .env.example. No keys are rendered to the browser.

Docs: 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; model providers run 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: Server-side connector secret store only.

Docs: docs/integration-readiness.md

GIS/Geocoding Connector Readiness

Synthetic ward estimates now

Real GIS/ward data required for production-grade geocoding

Configuration: Server-side connector secret store only.

Docs: docs/integration-readiness.md

Weather/Area Context Connector Readiness

Area risk cards

Weather and area context support alert recommendations

Configuration: No browser-exposed keys.

Docs: docs/integration-readiness.md

Email/SMS Connector Readiness

Placeholder

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

Configuration: Server-side connector secret store only.

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: Server-side only; see .env.example. Token values are never rendered.

Docs: docs/whatsapp-setup.md

Voice-note Transcript Readiness

Transcript sandbox

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

Configuration: Server-side connector secret store only.

Docs: docs/integration-readiness.md