How minhanhjr/luatganban_mvp works
LUẬT GẦN BẢN is a voice-first legal-procedure assistant for Hmong-speaking residents. The main workflow takes a spoken question through speech recognition, two-stage procedure routing, plain-language guidance, translation and speech playback; uncertain cases can be handed to staff. Staff also manage procedure data, review generated answers and administer accounts. The graph retains documented language and audio capabilities. Some UI-to-core calls are supported by the SOURCE INDEX rather than complete excerpts; unsampled implementation details are not inferred.
Main entry points: cong_dan.py Citizen portal · llm.py Gemini client · quan_tri.py Procedure administration · app.py App navigation
Components 22
Application
- App navigation
app.py
Resident assistance
- Citizen portal
giao_dien/cong_dan.py - Introduction
giao_dien/gioi_thieu.py
Language and AI
- Speech recognition
core/stt.py - Intent routing
core/router.py - Procedure knowledge
core/kb.py - Legal simplification
core/simplify.py - Translation
core/translate.py - Hmong transcription
core/hmong/rpa_vi.py - Speech synthesis
core/tts.py - Gemini client
core/llm.py - Runtime configuration
core/config.py - Procedure catalog
data/manifest.json
Staff operations
- Procedure administration
giao_dien/quan_tri.py - Account management
giao_dien/tai_khoan.py - Authentication and roles
core/auth.py - Staff catalog overrides
data/kho_ghi_de.json - Reviewed answers cache
data/cache/simplified - User records
data/users.json
Other components
- Resident
- Google Gemini
- SpeechRecognition fallback
Connections 28
- Resident → Citizen portal: asks aloud
README.md - App navigation → Citizen portal: routes to
README.md - App navigation → Procedure administration: routes to
README.md - App navigation → Introduction: routes to
README.md - Citizen portal → Speech recognition: recognizes speech
giao_dien/cong_dan.py - Citizen portal → Intent routing: routes question
giao_dien/cong_dan.py - Intent routing → Procedure knowledge: selects procedure
core/router.py - Procedure knowledge → Procedure catalog: loads catalog
core/kb.py - Citizen portal → Legal simplification: gets guidance
giao_dien/cong_dan.py - Citizen portal → Translation: translates answer
giao_dien/cong_dan.py - Translation → Hmong transcription: converts script
core/translate.py - Citizen portal → Speech synthesis: requests playback
giao_dien/cong_dan.py - Speech synthesis → Hmong transcription: phonetic fallback
core/tts.py - Intent routing → Gemini client: classifies intent
core/router.py - Legal simplification → Gemini client: generates guidance
core/simplify.py - Translation → Gemini client: translates with
core/translate.py - Gemini client → Google Gemini: calls API
README.md - Speech recognition → Gemini client: uses recognition model
core/stt.py - Speech recognition → SpeechRecognition fallback: fallback recognition
README.md - Procedure administration → Procedure knowledge: edits catalog
giao_dien/quan_tri.py - Procedure administration → Legal simplification: prewarms answers
README.md - Procedure administration → Reviewed answers cache: reviews answers
giao_dien/quan_tri.py - Procedure administration → Staff catalog overrides: saves edits
README.md - Account management → Authentication and roles: manages accounts
giao_dien/tai_khoan.py - App navigation → Authentication and roles: checks access
app.py - Authentication and roles → User records: reads and writes
README.md - Intent routing → Runtime configuration: uses thresholds
core/router.py - Gemini client → Runtime configuration: uses model settings
core/llm.py