🏛️ Trust-First Caste Census Intelligence Platform

🎥 Demo Video

Demonstrating citizen self-registration, verification workflows, analytics dashboard, policy simulation, and audit transparency.

Alternative: Watch on YouTube for faster loading

---

A citizen-centric, trust-governed census intelligence system designed to modernize caste and socio-economic data collection for governments. The platform minimizes cost, reduces corruption, improves inclusion, and delivers policy-ready insights while respecting constitutional and ethical boundaries.

---

🌟 Features

Core Functionality

• Citizen Self-Registration: Aadhaar & DigiLocker-based login with offline and voice-assisted support
• Layered Verification Workflow: Citizen → Community Facilitator → Government Officer
• Census Record Management: Secure creation, review, correction, and approval of census data
• Household Relationship Mapping: Visual family and household graphs for structural validation
• Economic Condition Verification: Consent-based triangulation using income, employment, and welfare indicators
• Dynamic Policy Simulation: Test eligibility rules and budget impact without exposing raw data
• Citizen Census Receipt: Verifiable proof of participation with immutable reference ID
• Audit & Transparency Logs: Complete traceability of data access and modifications

---

Technical Highlights

• Offline-First Architecture for low-connectivity regions
• Graph-Based Anomaly Detection for fraud without algorithmic exclusion
• Consent-Governed Data Views for citizens, auditors, and policymakers
• Privacy-Preserving Analytics with purpose-limited access
• Role-Based Access Control (RBAC) for all administrative actions

---

🏗️ Tech Stack

Backend

• Framework: FastAPI (Python)
• Server: Uvicorn (ASGI)
• Authentication: OAuth2 + JWT-based sessions
• Data Storage: PostgreSQL (configurable)
• Graph Engine: Neo4j (household & kinship modeling)
• Security: AES-256 encryption, audit logging
• Optional Integrity Layer: Blockchain anchoring (Hyperledger Fabric – optional)

---

Frontend

• Framework: React
• Styling: Tailwind CSS
• UI Components: shadcn/ui + Radix UI
• Charts & Maps: Recharts + interactive India map
• State Management: React Hooks
• Notifications: Toast-based alerts

---

📋 Prerequisites

• Node.js (v16+)
• npm
• Python (v3.8+)
• pip
• (Optional) PostgreSQL / Neo4j for production deployments

---

🚀 Installation & Setup

1. Clone the Repository

git clone YOUR_REPO_URL
cd app

Project structure:

app/
├── backend/
├── frontend/
└── README.md

---

2. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

Create a .env file:

DATABASE_URL=postgresql://user:password@localhost:5432/census
CORS_ORIGINS=*
SECRET_KEY=your_secret_key

---

3. Frontend Setup

cd ../frontend
npm install

Create a .env file:

REACT_APP_BACKEND_URL=http://localhost:8000

---

▶️ Running the Application

Start Backend

cd backend
uvicorn server:app --reload --host 0.0.0.0 --port 8000

API Docs: http://localhost:8000/docs

---

Start Frontend

cd frontend
npm start

App runs at: http://localhost:3000

---

🔐 Authentication & Access

Citizen Access

• Aadhaar + DigiLocker login
• Voice-assisted self-registration
• View census receipt and access logs

Administrative Login

• Secure OAuth login
• Role-based dashboards

---

👥 User Roles & Permissions

Role	Capabilities
Citizen	Self-register, view receipt, track verification
Community Facilitator	Assist corrections, trigger reviews
District Officer	Verify flagged records
State Analyst	Analytics & reports
Policy Maker	Run policy simulations

---

📊 Application Pages

1. Citizen Portal

• Self-registration
• Census receipt
• Access history

2. Verification Dashboard

• Flagged cases
• Review workflows
• Approval actions

3. Household View

• Family relationship graph
• Structural consistency checks

4. Analytics Dashboard

• State & district summaries
• Socio-economic insights

5. Policy Simulation

• Income & caste-based eligibility testing
• Impact visualization

6. Audit Logs

• Immutable action history
• Role-based visibility

---

🔌 API Endpoints (Sample)

Census

• POST /api/census/register
• GET /api/census/record/{id}
• PUT /api/census/review/{id}

Analytics

• GET /api/analytics/summary
• POST /api/policy/simulate

Audit

• GET /api/audit/logs

---

🔒 Security & Ethics

⚠️ Important Design Principles

• No caste inference from surname or proxies
• No automatic exclusion by AI
• No centralized “god-mode” access
• All actions are auditable

For production:

• Enable HTTPS/TLS
• Use hardened database roles
• Apply rate limiting
• Implement backups & monitoring

---

🎯 Future Enhancements

• Full offline citizen app
• Multi-language voice input
• Advanced fraud analytics
• Mobile app release
• Government system integrations
• Public transparency dashboards

---

📄 License

Developed as part of HACK4DELHI under the CivicTech track. Licensing subject to organizer guidelines.

---

🤝 Contributing

1. Fork the repo
2. Create a feature branch
3. Commit changes
4. Submit a PR

---

🙋 Support

• Open an issue on GitHub
• Contact the development team

---

Built with 🇮🇳 civic responsibility for inclusive governance