RivaLMS
Tài liệu

Bắt đầu

RivaLMS là hệ thống quản lý học tập (LMS) nội bộ của nhà trường. Đào tạo được tổ chức theo Khoa → Khóa học → Lớp học, giao diện chỉ có tiếng Việt và tài khoản do nhà trường cấp.

Khoa → Khóa học → Lớp học

Khoa quản lý các khóa học. Mỗi khóa học mở nhiều lớp học với giảng viên, lịch học và sĩ số riêng; bài học dùng chung cho mọi lớp.

Bốn vai trò

Học viên, Giảng viên, Quản lý đào tạo và Quản trị hệ thống, mỗi vai trò có trang tổng quan riêng.

Trò chơi hóa

XP, cấp và huy hiệu ghi nhận tiến độ học tập của học viên.

Trợ lý AI

Trợ lý trò chuyện trong mọi trang tổng quan, chạy bằng Ollama trên máy hoặc OpenAI khi triển khai.

Bắt đầu nhanh

Chạy RivaLMS trên máy của bạn trong vài bước, từ thư mục mã nguồn. Bạn cần Node.js 20 trở lên và Docker; chi tiết xem trang Cài đặt.

Bước 1: Cài dependency

npm ci

Bước 2: Tạo file môi trường

cp .env.example .env
# rồi đặt AUTH_SECRET bằng giá trị từ: npx auth secret

Bước 3: Khởi động PostgreSQL và MinIO

docker compose up -d

Bước 4: Tạo schema và dữ liệu mẫu

npm run db:deploy
npm run db:seed

Bước 5: Chạy ứng dụng

npm run dev

Mở http://localhost:3000 để dùng ứng dụng.

Công nghệ

Next.js 16

Framework React với App Router và Server Components

TypeScript

Kiểm tra kiểu khi phát triển

Tailwind CSS 4

Giao diện theo kiểu utility-first

Prisma 7

Truy cập cơ sở dữ liệu an toàn kiểu, quản lý schema bằng Prisma Migrate

PostgreSQL 16

Cơ sở dữ liệu, chạy trong Docker

MinIO

Kho lưu file tương thích S3, chạy trong Docker

Auth.js (NextAuth v5)

Đăng nhập và phiên làm việc (JWT)

next-intl

Chuỗi giao diện tiếng Việt

Ollama / OpenAI

LLM cho trợ lý AI: Ollama trên máy, OpenAI khi triển khai

Tiếp theo