# Hệ Thống Quản Lý Văn Bản Pháp Luật
Đây là mã nguồn hệ thống quản lý, tra cứu và lưu trữ văn bản pháp luật hiện đại, được xây dựng trên nền tảng Next.js, React, Prisma và cơ sở dữ liệu. Hệ thống có giao diện đẹp mắt (hỗ trợ Light/Dark mode), responsive, tích hợp xem PDF trực tiếp và tìm kiếm thông minh.
xem video để xem trang hoạt động: https://youtu.be/V7r9x8Ed72w
Password - Mật khẩu giải nén: huyhuy@123
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
# Hệ Thống Quản Lý Văn Bản Pháp Luật
Đây là mã nguồn hệ thống quản lý, tra cứu và lưu trữ văn bản pháp luật hiện đại, được xây dựng trên nền tảng Next.js, React, Prisma và cơ sở dữ liệu. Hệ thống có giao diện đẹp mắt (hỗ trợ Light/Dark mode), responsive, tích hợp xem PDF trực tiếp và tìm kiếm thông minh.
## 🚀 Công Nghệ Sử Dụng
- **Framework**: [Next.js 16](https://nextjs.org/) (App Router)
- **UI/UX**: React 19, CSS modules, CSS variables (cho Light/Dark mode)
- **Database ORM**: [Prisma](https://www.prisma.io/)
- **Search Engine**: Meilisearch (nếu có sử dụng)
- **Icons**: Lucide React
- **PDF Viewer**: @react-pdf-viewer
## 📦 Yêu Cầu Hệ Thống
Trước khi cài đặt, hãy đảm bảo máy tính/máy chủ của bạn đã cài đặt sẵn các phần mềm sau:
1. **Node.js**: Phiên bản 20.x trở lên.
2. **NPM hoặc Yarn**: Trình quản lý package của Node.js.
3. **Cơ sở dữ liệu**: MySQL / PostgreSQL / SQLite (tùy thuộc vào cấu hình trong `prisma/schema.prisma`).
## 🛠️ Hướng Dẫn Cài Đặt
CÀI ĐẶT DOCKER DESKTOP và bật sẵn trước khi sử dụng
### Bước 1: Giải nén mã nguồn
Giải nén file mã nguồn bạn vừa tải về và mở Terminal (Command Prompt / PowerShell) tại thư mục gốc của dự án.
### Bước 2: Cài đặt thư viện (Dependencies)
Chạy lệnh sau để cài đặt tất cả các thư viện cần thiết:
```bash
npm install
```
### Bước 3: Cấu hình biến môi trường
1. Tìm file `.env.example` (hoặc tạo một file mới tên là `.env` ở thư mục gốc).
2. Mở file `.env` và cấu hình kết nối cơ sở dữ liệu của bạn:
```env
# Ví dụ kết nối MySQL/PostgreSQL
DATABASE_URL="mysql://USER:PASSWORD@HOST:PORT/DATABASE"
```
### Bước 4: Khởi tạo Cơ sở dữ liệu (Prisma)
Chạy lệnh sau để tạo các bảng trong cơ sở dữ liệu dựa trên schema của Prisma:
```bash
npx prisma db push
```
*(Nếu hệ thống có file seed dữ liệu mẫu, bạn có thể chạy thêm `npx prisma db seed`)*.
### Bước 5: Chạy dự án (Môi trường Phát triển)
Sau khi setup xong DB, khởi động server bằng lệnh:
```bash
npm run dev
```
Truy cập vào trình duyệt theo địa chỉ: `http://localhost:3000`
---
## 🚀 Hướng Dẫn Triển Khai Thực Tế (Production)
Để đưa website lên chạy thực tế (Production), bạn cần build dự án và start server Production:
1. **Build dự án**:
```bash
npm run build
```
2. **Start dự án**:
```bash
npm run start
```
*Lưu ý: Bạn có thể sử dụng các công cụ quản lý process như `pm2` để giữ server luôn chạy (`pm2 start npm --name "vanban" -- start`).*
## 📚 Hướng Dẫn Sử Dụng Cơ Bản
1. **Trang Chủ**: Hiển thị danh sách các văn bản mới nhất, văn bản nổi bật.
2. **Tìm Kiếm**: Ô tìm kiếm trên Header cho phép tìm kiếm nhanh theo Số hiệu hoặc Tiêu đề văn bản.
3. **Chi Tiết Văn Bản**: Xem thông tin chi tiết, xem trước file PDF đính kèm (hỗ trợ zoom, in, tải về).
4. **Quản trị**: (Nếu có tính năng Upload/Sửa) Bạn có thể thêm văn bản mới, đính kèm file PDF gốc qua chức năng Quản trị.
## 🤝 Hỗ Trợ
Nếu gặp khó khăn trong quá trình cài đặt, vui lòng liên hệ người bán hoặc tác giả để được hỗ trợ kỹ thuật chi tiết.
Nguồn: Topcode.vn
