How alok-codes21/integrated-gdg works
Integrated Sahayak AI is a citizen-welfare discovery and entitlement-matching platform, delivered through a guided React experience and a separate multi-screen portal. Citizens provide profile details, authenticate when needed, and request scheme matches; the API evaluates eligibility and returns results. The product also supports profile storage, scheme search, AI-assisted profile conversations, document text scanning, and portal journeys for life events and application preparation. The README documents several API capabilities whose route wiring was not included in the sampled source, so those links are limited to documented responsibilities.
Main entry points: app.js Express API · pages Portal journeys · App.jsx Guided discovery · matchingService.js Eligibility rules
Components 20
Citizen interfaces
- Guided discovery
frontend/src/App.jsx - Welfare portal
ml-portal/src/App.jsx - Portal journeys
ml-portal/src/pages - Application tracking
ml-portal/src/data/applications.js
API and identity
- Express API
backend/server/app.js - Authentication
backend/server/services/authService.js - Portal auth client
ml-portal/src/services/authService.js - Portal API client
ml-portal/src/services/api.js
Eligibility intelligence
- Eligibility rules
backend/server/services/matchingService.js - Scheme retrieval
backend/server/services/ragService.js - Profile extraction
backend/server/services/aiService.js - AI assistant
backend/server/services/assistantService.js - Gemini service
backend/server/services/geminiService.js - Document text scan
backend/server/services/ocrService.js - Portal matching
ml-portal/src/services/matchingEngine.js
Citizen data
- Profile model
backend/server/models/Profile.js - User model
backend/server/models/User.js - MongoDB
Other components
- Citizen
- Browser speech APIs
Connections 25
- Citizen → Guided discovery: provides profile
- Guided discovery → Express API: requests matches
- Express API → Eligibility rules: evaluates eligibility
- Eligibility rules → Express API: returns match results
- Guided discovery → Express API: authenticates and saves
- Express API → Authentication: checks credentials
- Express API → User model: reads and writes users
- Express API → Profile model: reads and writes profiles
- User model → MongoDB: persists
- Profile model → MongoDB: persists
- Express API → Scheme retrieval: searches schemes
- Scheme retrieval → Eligibility rules: reads scheme catalog
- Express API → Profile extraction: extracts profile
- Express API → AI assistant: answers questions
- AI assistant → Gemini service: uses AI provider
- Express API → Document text scan: scans document text
- Citizen → Welfare portal: uses portal
- Welfare portal → Portal journeys: routes to journeys
- Portal journeys → Portal API client: requests portal data
- Portal journeys → Portal auth client: authenticates
- Portal auth client → Portal API client: calls API
- Portal journeys → Portal matching: evaluates schemes
- Portal journeys → Application tracking: shows tracker data
- Citizen → Browser speech APIs: speaks or listens
- Guided discovery → Browser speech APIs: uses speech features