How ctu-lingutechies/vn-law-advisor works
VN-Law-Advisor is a Vietnamese legal-information product for asking questions and finding, reading, and summarizing codified law and legal documents. Users enter through the Next.js web app; its major experiences include chat, authentication, codification browsing, and document search. The backend separates identity, law-data APIs, and RAG question answering; a crawler imports codification data. The README also documents keyword-based document recommendations and user feedback, though their runtime wiring is not sampled. RAG retrieval and generation follow the README and app excerpt; some service-to-service links remain unverified.
Main entry points: services Web API clients · app.py RAG question API · AuthController.js Auth API · lawservice Law-data API
Components 16
Web experience
- Next.js web app
web/src/app - Web API clients
web/services
Identity
- Auth API
backend/auth-service/controllers/AuthController.js - User database
backend/auth-service/services/sequelizeService.js - Refresh-token cache
backend/auth-service/services/redisService.js
Legal data
- Law-data API
backend/law-service/src/main/java/lingutechies/vnlawadvisor/lawservice - Codification hierarchy
backend/law-service/src/main/java/lingutechies/vnlawadvisor/lawservice/PDDieu/PDDieu.java - Legal documents
backend/law-service/src/main/java/lingutechies/vnlawadvisor/lawservice/VBPL/VBPL.java - Document recommendations
backend/recommendation
Question answering
- RAG question API
backend/rag/app.py - Legal embeddings
backend/rag/vectorize_corpus.py - Answer generation service
- Question history
backend/rag/models.py
Data ingestion
- Codification crawler
law-crawler/main.py - Crawler data models
law-crawler/models/models.py
Other components
- Legal information seeker
Connections 15
- Legal information seeker → Next.js web app: uses
README.md - Next.js web app → Web API clients: requests data
- Web API clients → Auth API: authenticates
- Web API clients → Law-data API: retrieves law
- Web API clients → RAG question API: asks questions
- Web API clients → Document recommendations: requests suggestions
- Auth API → User database: reads and writes
backend/auth-service/controllers/AuthController.js - Auth API → Refresh-token cache: stores tokens
backend/auth-service/controllers/AuthController.js - Law-data API → Codification hierarchy: serves codification
README.md - Law-data API → Legal documents: serves documents
README.md - RAG question API → Legal embeddings: retrieves context
backend/rag/app.py - RAG question API → Answer generation service: sends prompt
backend/rag/app.py - RAG question API → Question history: stores answers
backend/rag/app.py - Codification crawler → Crawler data models: imports models
law-crawler/main.py - Codification crawler → Codification hierarchy: loads law data
README.md