How mundlapudimuneendra-ops/jansahay-ai works
JANSAHAY is a citizen-assistance guide for discovering government documents and understanding how to prepare and apply; it does not issue certificates. The principal journey runs from catalogue/search through document details, requirements, application steps, and application-channel guidance. Separate branches provide multilingual access, saved-document accounts, and a bilingual/trilingual AI assistant. Relationships are based on the README journey and capabilities, plus the supplied source excerpts and SOURCE INDEX; unsampled implementation details are represented conservatively.
Main entry points: App.tsx App routing · documentsData.ts Document dossiers · jansahayAiService.ts Local AI guidance · WhereToApplyPage.tsx Apply locations
Components 25
Document discovery
- Document catalogue
frontend/src/pages/DocumentsPage.tsx - Document search
frontend/src/services/documentSearch.ts - Search results
frontend/src/pages/SearchResultsPage.tsx - Document dossiers
frontend/src/data/documentsData.ts
Application guidance
- Document overview
frontend/src/pages/DocumentDetailPage.tsx - Requirements checklist
frontend/src/pages/RequirementsPage.tsx - Application timeline
frontend/src/pages/ApplicationGuidePage.tsx - Apply locations
frontend/src/pages/WhereToApplyPage.tsx - Civic center data
frontend/src/data/civicCenters.ts
Citizen experience
- App routing
frontend/src/App.tsx - Language context
frontend/src/hooks/useLanguage.tsx - Localized content
frontend/src/data/documentTranslations.ts - Interface translations
frontend/src/data/translations.ts - Citizen session
frontend/src/hooks/useAuth.tsx - AI assistant
frontend/src/components/ai/JansahayAiAssistant.tsx
Application services
- Frontend auth API
frontend/src/services/authService.ts - Auth routes
backend/src/routes/authRoutes.ts - Auth controller
backend/src/controllers/authController.ts - Auth service
backend/src/services/authService.ts - User database
backend/src/db/database.ts - Local AI guidance
frontend/src/services/jansahayAiService.ts - AI routes
backend/src/routes/aiRoutes.ts - AI controller
backend/src/controllers/aiController.ts - Gemini integration
backend/src/services/geminiService.ts
Other components
- Citizen
Connections 32
- Citizen → App routing: opens
- App routing → Document catalogue: routes to
frontend/src/App.tsx - App routing → Search results: routes to
frontend/src/App.tsx - App routing → Document overview: routes to
frontend/src/App.tsx - App routing → Requirements checklist: routes to
frontend/src/App.tsx - App routing → Application timeline: routes to
frontend/src/App.tsx - App routing → Apply locations: routes to
frontend/src/App.tsx - Document catalogue → Document dossiers: reads
frontend/src/pages/DocumentsPage.tsx - Search results → Document search: queries
frontend/src/pages/SearchResultsPage.tsx - Document search → Document dossiers: searches
frontend/src/services/documentSearch.ts - Document overview → Document dossiers: reads
frontend/src/pages/DocumentDetailPage.tsx - Requirements checklist → Document dossiers: uses dossier
- Application timeline → Document dossiers: reads
frontend/src/pages/ApplicationGuidePage.tsx - Apply locations → Document dossiers: reads
frontend/src/pages/WhereToApplyPage.tsx - Apply locations → Civic center data: uses locator data
- App routing → Language context: provides language
frontend/src/App.tsx - Language context → Localized content: localizes documents
frontend/src/hooks/useLanguage.tsx - Language context → Interface translations: loads strings
frontend/src/hooks/useLanguage.tsx - App routing → Citizen session: provides session
frontend/src/App.tsx - Citizen session → Frontend auth API: calls
frontend/src/hooks/useAuth.tsx - Frontend auth API → Auth routes: HTTP requests
frontend/src/services/authService.ts - Auth routes → Auth controller: dispatches
backend/src/routes/authRoutes.ts - Auth controller → Auth service: delegates
backend/src/controllers/authController.ts - Auth service → User database: reads and writes
backend/src/services/authService.ts - App routing → AI assistant: renders
frontend/src/App.tsx - AI assistant → Local AI guidance: requests guidance
frontend/src/components/ai/JansahayAiAssistant.tsx - Local AI guidance → Document search: normalizes queries
frontend/src/services/jansahayAiService.ts - Local AI guidance → Document dossiers: grounds answers
frontend/src/services/jansahayAiService.ts - Local AI guidance → Localized content: localizes answers
frontend/src/services/jansahayAiService.ts - Local AI guidance → AI routes: optional API
- AI routes → AI controller: dispatches
backend/src/routes/aiRoutes.ts - AI controller → Gemini integration: generates response
backend/src/controllers/aiController.ts