JanSeva is a state-of-the-art civic-tech platform that empowers NGOs to manage disaster relief and community development through data-driven intelligence. By bridging the gap between donors, volunteers, and high-need regions, JanSeva ensures that every Rupee and every hour of volunteer time is directed where it will have the maximum impact.
Our core engine uses advanced clustering and scoring algorithms to analyze village vulnerability across four key domains: Health, Food Security, Education, and Shelter.
- Vulnerability Scoring: Automated ranking of villages based on multi-dimensional survey data.
- Priority Classification: Categorization of mission zones into
CRITICAL,HIGH,MEDIUM, andLOWtiers.
- Proportional Fund Distribution: Automatically splits campaign budgets based on vulnerability indices. High-need villages receive larger shares of aid without manual calculation.
- Diversity-Matched Volunteer Assignment: A round-robin interleaved algorithm that ensures every village gets a balanced group of experienced (Tier A/B) and novice volunteers, preventing "expertise silos."
- Multi-Domain Targeting: Support for campaigns focusing on specific sectors (e.g., Medical missions) or broad "Multi-Domain Aid" missions.
- Impact Visualizations: Dynamic heatmaps and charts showing resource distribution.
- NGO Mission Control: Comprehensive tools for NGOs to create campaigns, ingest survey data via CSV, and monitor deployment plans.
- Volunteer Tracking: Real-time registration and match status updates.
JanSeva/
├── Frontend/ # React 18 + Vite + Tailwind CSS
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # ML Hub, Dashboards, Campaign Details
│ │ └── utils/ # API wrappers and data formatters
├── Backend/ # Node.js + Express + MongoDB
│ ├── src/
│ │ ├── controllers/# Campaign, User, and NGO logic
│ │ ├── models/ # Mongoose Schemas (Campaigns, VillageScores, Assignments)
│ │ └── routes/ # API endpoints
├── ML/ # Intelligent Matching Core
│ ├── controllers/ # Proportional allocation and diversity algorithms
│ └── python/ # ML seeding and data processing scripts
└── scratch/ # Administrative and maintenance utilities- Node.js (v18.0.0 or higher)
- MongoDB (Local instance or Atlas URI)
- npm or yarn
cd Backend
npm install
# Configure your .env file with MONGO_URI, JWT_SECRET, etc.
npm run devcd Frontend
npm install
npm run devThe application will be available at http://localhost:3000 (or 5173 depending on configuration).
| Layer | Technology |
|---|---|
| Frontend | React 18, Vite, Tailwind CSS 4, Recharts |
| Backend | Node.js, Express, Mongoose |
| Database | MongoDB |
| Security | JWT, Passport.js, Helmet, Rate Limiting |
| ML Engine | Custom JavaScript Heuristics & Python Data Tools |
We welcome contributions to make JanSeva even more effective!
- Fork the repository.
- Branch:
git checkout -b feature/amazing-feature. - Commit:
git commit -m "feat: adds specific value". - Push:
git push origin feature/amazing-feature. - Open PR: Submit a pull request for review.
This project is licensed under the MIT License. See LICENSE for more details.
Built with ❤️ for social impact by the JanSeva Team.