VN-Law-Advisor [![Demo]()]() [![Documentation]()]()

Bug Report ⚠️

Request Feature 👩‍💻

Ứng dụng hỗ trợ tra cứu, hỏi đáp tri thức pháp luật dựa trên Bộ pháp điển và CSDL văn bản QPPL Việt Nam.

Mục tiêu là phát triển một hệ thống tra cứu, hỏi đáp tri thức pháp luật Việt Nam. Dựa trên các mô hình ngôn ngữ lớn cùng với nền tảng lowcode.

Dự án được open source theo giấy phép GNU General Public License v3.0 bởi đội tác giả HIT-OS.

Để biết thêm chi tiết về cuộc thi, bạn có thể xem tại đây.

Link thuyết trình Canva tại cuộc thi [link]()

Slide bài thuyết trình tại cuộc thi dưới dạng PDF có thể được truy cập tại đây: [Slide]()

🔎 Danh Mục

1. Giới Thiệu
2. Chức Năng
3. Tổng Quan Hệ Thống
4. Cấu Trúc Thư Mục
5. Hướng Dẫn Cài Đặt
   • 📋 Yêu Cầu - Prerequisites
   • 🔨 Cài Đặt
6. CI/CD
7. 🙌 Đóng Góp
8. 📝 License

Giới Thiệu

• Pháp điển là tập hợp các quy phạm pháp luật đang còn hiệu lực của các văn bản quy phạm pháp luật do cơ quan nhà nước ở trung ương ban hành, từ Thông tư trở lên và trừ Hiến pháp.
• Cơ sở dữ liệu văn bản quy phạm pháp luật Việt Nam được xây dựng từ năm 2000, bao gồm các văn bản quy phạm pháp luật từ năm 1990 đến nay. Cơ sở dữ liệu này được cập nhật thường xuyên, đảm bảo tính toàn vẹn, đầy đủ và chính xác của các văn bản quy phạm pháp luật.
• Tuy nhiên, do việc cập nhật không thường xuyên của pháp điển so với các văn bản quy phạm pháp luật, nên pháp điển hiện tại không đảm bảo tính toàn vẹn, đầy đủ và chính xác của các văn bản quy phạm pháp luật.

Chức Năng Chính

Project tập trung vào các chức năng chính như sau:

• 🤖 Trả lời các câu hỏi về pháp luật của người dùng.
• 🔍 Hệ thống tra cứu các pháp điển, văn bản quy phạm pháp luật: chỉ mục, liên kết các điều mục, các bảng và biểu mẫu.
• 📖 Tóm tắt văn bản, hỗ trợ người dùng trong lúc tra cứu.
• 📝 Gợi ý văn bản quy phạm pháp luật theo từ khóa tìm kiếm, nhận đóng góp để cải thiện gợi ý.

👩‍💻 Tổng Quan Hệ Thống

Backend của hệ thống được thiết kế theo kiến trúc microservices, với các công nghệ sử dụng như sau:

• NextJS 14: Xây dựng web-app, hỗ trợ SEO, SSR, SSG.
• Kong API Gateway: API Gateway cho hệ thống.
• ExpressJS: Dựng API cho Auth Service.
• SpringBoot: Dựng API cho Law Service.
• Flask: Dựng API cho Q&A - RAG Service.
• LangChain: Sử dụng để truy vấn các context là tri thức luật.
• MySQL: Cơ sở dữ liệu quan hệ.
• Redis: Cơ sở dữ liệu NoSQL in-memory dạng key-value.
• ChromaDB: Cơ sở dữ liệu embedding dạng vector.
• RabbitMQ: Message broker cho hệ thống.
• Docker: Containerize các service.
• Docker Compose: Quản lý các container.
• Prometheus: Monitor các metrics.
• Grafana: WebUI hiển thị metrics.
• Transformer.js: Thư viện transformer cho JS, load trực tiếp trên trình duyệt web.

RAG

Sử dụng mô hình Vietnamese SBERT để tạo embedding cho các tri thức pháp luật. Các embedding được lưu vào Chroma - một loại vector database.

Sau đó, xây dựng hệ thống RAG với framework LangChain để truy vấn các context là các điều từ pháp điển, sau đó đưa context cho mô hình LLM để sinh ra các câu trả lời.

Mô hình LLM chọn sử dụng là phoGPT, kết hợp context và câu hỏi để sinh câu trả lời.

CI/CD

Project CI/CD sử dụng Github và Github Actions để tự động hóa quá trình build và deploy. Quy trình như hình vẽ sau:

![CI/CD]()

Các workflows của project được lưu tại: .github/workflows, với các workflow như sau:

• server.yaml: Build docker for dockerhub

Cấu trúc thư mục

• Crawler - Crawl vào CSDL từ nguồn pháp điển Việt Nam.
• Server - Chứa các mô hình, services, kiến trúc của hệ thống.
• Web - Giao diện người dùng.

Hướng Dẫn Cài Đặt

Tất cả các images build từ services backend bạn có thể tìm thấy tại [Docker Hub]().

Yêu Cầu 📋

Để cài đặt và chạy được dự án, trước tiên bạn cần phải cài đặt các công cụ bên dưới. Hãy thực hiện theo các hướng dẫn cài đặt sau, lưu ý chọn hệ điều hành phù hợp với máy tính của bạn:

• Docker-Installation
• Docker-Compose-Installation
• NodeJS v18-Installation

Lưu ý: NextJS 14 chỉ tương thích với NodeJS từ version 18 trở lên.

🔨 Cài Đặt

Trước hết, hãy clone dự án về máy tính của bạn:

git clone https://github.com/HIT-OS/VN_Legal_Document_Retrieval.git

cd vào thư mục VN_Legal_Document_Retrieval:

cd VN_Legal_Document_Retrieval

Chạy crawler lấy dữ liệu pháp điển và các van bản quy phạm pháp luật (optional):

Bước này chỉ cần chạy một lần duy nhất để lấy dữ liệu pháp điển và các văn bản quy phạm pháp luật vào cơ sở dữ liệu MySQL. Nếu bạn đã có dữ liệu, bạn có thể bỏ qua bước này và tự import vào hệ thống với hướng dẫn phía dưới.

Để cào dữ liệu, hãy:

cd law-crawler

Và tiếp tục theo hướng dẫn trong thư mục law-crawler README.md.

Chạy backend hệ thống

• Đầu tiên, cd vào thư mục backend:

cd server

• Start các services với 1 lệnh docker-compose:

docker-compose up -d

Chạy web-app

🙌 Đóng góp cho dự án

Bug Report ⚠️

Request Feature 👩‍💻

Mọi đóng góp của các bạn đều được trân trọng, đừng ngần ngại gửi pull request cho dự án.

Liên hệ

• Phạm Đình Tiến:
• Đặng Hoàng Phương:
• Nguyễn Tiến Kiên:

📝 License

This project is licensed under the terms of the GPL V3 license.