How nanthini2007/digital-sakhi works
SAKHI is a bilingual (Tamil/English) government-service guidance app. Users ask by text or voice, receive service-specific step guidance, and can advance, ask for simpler help, or open an official site. The repository also has a separate session-backed journey API for starting, advancing, checking, and recovering a journey. Source excerpts show some calls directly; where route wiring is supported only by the source index, the graph avoids inferring additional flow.
Main entry points: page.tsx Guidance screen · supabase.ts Journey persistence · sakhi/route.ts Guidance handler · start/route.ts Start journey
Components 25
User experience
- Guidance screen
src/app/page.tsx - Language header
src/components/Header.tsx - Voice control
src/components/MicButton.tsx - Speech engine
src/lib/voice.ts - Step card
src/components/JourneyCard.tsx - Sahayata card
src/components/SahayataCard.tsx - Stuck help
src/components/StuckModal.tsx - Official handoff
src/components/OfficialHandoffModal.tsx
Guidance and services
- Language registry
src/data/languages.ts - Chat endpoint
src/app/api/ai/chat/route.ts - Guidance handler
src/app/api/sakhi/route.ts - Service catalog
src/data/schemes.ts - Input safety
src/lib/safety.ts
Journey API
- Start journey
src/app/api/journey/start/route.ts - Advance journey
src/app/api/journey/next/route.ts - Read journey state
src/app/api/journey/state/route.ts - Stuck endpoint
src/app/api/journey/stuck/route.ts - Service details endpoint
src/app/api/service/details/route.ts
Persistence and operations
- Rate limiter
src/lib/rate-limit.ts - Journey persistence
src/lib/supabase.ts - Safe event logger
src/lib/logger.ts
Other components
- Service seeker
- Google Gemini
- Supabase
- Browser speech APIs
Connections 28
- Service seeker → Guidance screen: asks for guidance
src/app/page.tsx - Guidance screen → Language header: renders
src/app/page.tsx - Guidance screen → Voice control: renders
src/app/page.tsx - Guidance screen → Step card: renders
src/app/page.tsx - Guidance screen → Stuck help: renders
src/app/page.tsx - Guidance screen → Official handoff: renders
src/app/page.tsx - Guidance screen → Sahayata card: renders
src/app/page.tsx - Language header → Language registry: reads
src/components/Header.tsx - Voice control → Speech engine: uses
src/components/MicButton.tsx - Speech engine → Browser speech APIs: uses
src/lib/voice.ts - Guidance screen → Speech engine: starts and stops speech
src/app/page.tsx - Guidance screen → Chat endpoint: posts chat request
src/app/page.tsx - Chat endpoint → Guidance handler: delegates to
src/app/api/ai/chat/route.ts - Guidance handler → Rate limiter: checks requests
src/app/api/sakhi/route.ts - Guidance handler → Input safety: checks input
src/app/api/sakhi/route.ts - Guidance handler → Service catalog: selects service
src/app/api/sakhi/route.ts - Guidance handler → Google Gemini: requests generation
src/app/api/sakhi/route.ts - Start journey → Journey persistence: creates session and saves state
src/app/api/journey/start/route.ts - Start journey → Service catalog: resolves service
src/app/api/journey/start/route.ts - Start journey → Rate limiter: checks requests
src/app/api/journey/start/route.ts - Start journey → Safe event logger: logs start
src/app/api/journey/start/route.ts - Advance journey → Journey persistence: loads service and saves state
src/app/api/journey/next/route.ts - Advance journey → Safe event logger: logs progress
src/app/api/journey/next/route.ts - Stuck endpoint → Journey persistence: loads service
src/app/api/journey/stuck/route.ts - Stuck endpoint → Safe event logger: logs stuck event
src/app/api/journey/stuck/route.ts - Read journey state → Journey persistence: reads state
src/app/api/journey/state/route.ts - Service details endpoint → Journey persistence: reads service
src/app/api/service/details/route.ts - Journey persistence → Supabase: reads and writes
src/lib/supabase.ts