CivicBridge

Production-ready civic complaint platform for TNWISE Hackathon under Inclusive Digital Transformation.

Tech Stack

• Frontend: React (CDN modules), HTML, CSS, JS
• Backend: FastAPI (Python)
• Database: PostgreSQL
• AI: Rule-based NLP classifier
• IVR: Twilio webhook flow
• Notifications: SMS and Email adapters
• Deployment: Docker and docker-compose

Project Structure

• frontend/
• backend/
• ivr/
• ai/
• notifications/
• docs/

Quick Start

1. Copy .env.example to .env
2. Run: docker compose up --build
3. Backend API: http://localhost:8000
4. Frontend: serve frontend folder with any static server

Required Features Covered

• Urban complaint reporting with image upload and geolocation fields
• Rural IVR complaint reporting with language selection
• AI category and urgency classification
• Ticket tracking using CB-YYYY-XXXX format
• Officer login, complaint actions, escalation
• Cluster detection for >3 complaints in 500 meters
• Transparency analytics API and frontend dashboard