How hariharan024/hackarena works
Sakhi guides a woman from a spoken, typed, or button-selected situation through a stateless conversation to a potential pension match and personalized document checklist. The browser owns the profile and presents the result; FastAPI routes turns to the dialogue engine, which combines language understanding, deterministic eligibility rules, and verified scheme data. Voice input and output are browser features, with optional Gemini extraction and speech fallback. Source excerpts show the main calls; unsampled result-screen details are supported by the README and component excerpts.
Main entry points: dialogue.py Turn and result flow · App.jsx Conversation UI · gemini_service.py Optional Gemini services · main.py HTTP API
Components 15
Guidance interface
- Conversation UI
frontend/src/App.jsx - Guidance screens
frontend/src/components.jsx - Interface labels
frontend/src/ui.js - API client
frontend/src/api.js
Conversation service
- HTTP API
backend/main.py - Turn and result flow
backend/dialogue.py
Pension domain
- Eligibility rules
backend/eligibility.py - Schemes and documents
backend/scheme_data.py - Conversation wording
backend/messages.py
Voice and language
- Browser speech
frontend/src/speech.js - Tamil and English parser
backend/nlu.py - Optional Gemini services
backend/gemini_service.py
Other components
- Woman user
- Browser speech services
- Google Gemini
Connections 18
- Woman user → Conversation UI: answers questions
README.md - Conversation UI → Guidance screens: renders screens
frontend/src/App.jsx - Conversation UI → Interface labels: loads labels
frontend/src/App.jsx - Conversation UI → API client: sends turns
frontend/src/App.jsx - Conversation UI → Browser speech: controls speech
frontend/src/App.jsx - Browser speech → Browser speech services: recognizes and speaks
frontend/src/speech.js - Browser speech → API client: requests TTS
frontend/src/speech.js - API client → HTTP API: calls chat and TTS
frontend/src/api.js - HTTP API → Turn and result flow: handles chat turn
backend/main.py - HTTP API → Optional Gemini services: requests speech
backend/main.py - Turn and result flow → Tamil and English parser: parses answers
backend/dialogue.py - Turn and result flow → Optional Gemini services: extracts fallback facts
backend/main.py - Turn and result flow → Eligibility rules: evaluates profile
backend/dialogue.py - Turn and result flow → Schemes and documents: builds checklist
backend/dialogue.py - Eligibility rules → Schemes and documents: reads scheme rules
backend/eligibility.py - Turn and result flow → Conversation wording: formats replies
backend/dialogue.py - Optional Gemini services → Schemes and documents: validates document keys
backend/gemini_service.py - Optional Gemini services → Google Gemini: calls model
backend/gemini_service.py