Giới thiệu dự án

Trong bối cảnh chuyển đổi số giáo dục đại học tại Việt Nam, việc minh bạch hóa và tự động hóa quy trình quản lý kết quả học tập, văn bằng, chứng chỉ đang là ưu tiên hàng đầu. Theo thống kê của ngành giáo dục, các trường đại học hàng năm phải tiếp nhận và xử lý hàng chục nghìn lượt yêu cầu xác minh văn bằng, trích lục bảng điểm từ sinh viên, cựu sinh viên và các đơn vị tuyển dụng. Phương thức quản lý truyền thống dựa trên hồ sơ giấy hoặc các phần mềm quản lý đơn khối (Monolithic) cũ bộc lộ nhiều điểm nghẽn nghiêm trọng: quy trình tra cứu thủ công mất từ 3 đến 7 ngày làm việc, chi phí in ấn và lưu trữ cao, rủi ro làm giả bằng cấp tinh vi và khó khăn trong việc đáp ứng quy định pháp lý về công khai thông tin giáo dục.

Căn cứ theo Điều 26, Thông tư 21/2019/TT-BGDĐT của Bộ Giáo dục và Đào tạo ban hành Quy chế quản lý văn bằng, chứng chỉ của hệ thống giáo dục quốc dân, các cơ sở giáo dục có thẩm quyền bắt buộc phải xây dựng hệ thống cơ sở dữ liệu để công bố công khai thông tin cấp văn bằng, chứng chỉ trên cổng thông tin điện tử, đảm bảo dữ liệu trùng khớp tuyệt đối với sổ gốc, dễ dàng truy cập và chống làm giả.

Đồ án "Xây dựng Website quản lý kết quả học tập và văn bằng chứng chỉ của sinh viên" được thực hiện tại Trường Đại học Quản lý và Công nghệ Hải Phòng (HPU) nhằm giải quyết triệt để bài toán trên thông qua việc tái cấu trúc kiến trúc phần mềm, ứng dụng các mô hình kỹ thuật hiện đại.

+-----------------------------------------------------------------------------------+
|                        MỤC TIÊU DỰ ÁN (PROJECT OBJECTIVES)                        |
+---+-------------------------------------------------------------------------------+
| 1 | Bóc tách nghiệp vụ quản lý văn bằng từ hệ thống ERP Edu cũ (464 bảng dữ liệu) |
|   | bằng phương pháp thiết kế hướng tên miền (Domain-Driven Design - DDD).        |
+---+-------------------------------------------------------------------------------+
| 2 | Ứng dụng kiến trúc Microservices/BFF kết hợp Hasura GraphQL Engine và         |
|   | cơ sở dữ liệu quan hệ PostgreSQL để tăng tốc độ truy vấn đa bảng.            |
+---+-------------------------------------------------------------------------------+
| 3 | Tích hợp giải pháp xác thực bảo mật không trạng thái (Stateless Auth)         |
|   | qua Clerk Authentication và Json Web Token (JWT) theo chuẩn Hasura Claims.    |
+---+-------------------------------------------------------------------------------+
| 4 | Tự động hóa xuất phụ lục văn bằng chuẩn PDF và tạo mã QR Code động phục vụ   |
|   | tra cứu xác thực tức thì (Instant Verification) cho nhà tuyển dụng.          |
+---+-------------------------------------------------------------------------------+

Phương pháp tiếp cận của đề tài là xây dựng một hệ thống phân tán hướng dịch vụ (Microservices Architecture), tách biệt hoàn toàn tầng dữ liệu nền tảng với tầng ứng dụng người dùng. Giải pháp giúp giảm thời gian tra cứu từ vài ngày xuống dưới 200 mili-giây (ms), đảm bảo tính sẵn sàng 99.9% và triệt tiêu 100% nguy cơ giả mạo hồ sơ học tập thông qua cơ chế ký số và mã hóa QR Code.

Phạm vi đề tài tập trung vào hệ thống đào tạo đại học chính quy theo học chế tín chỉ của Nhà trường, trích xuất dữ liệu từ các phân hệ quản lý đào tạo, điểm toàn khóa, chuẩn đầu ra chứng chỉ và cấp phát văn bằng.

Phân tích và thiết kế giải pháp

Phân tích hiện trạng

Trước khi triển khai dự án, công tác quản lý đào tạo tại trường vận hành trên phần mềm quản lý đào tạo tổng thể EduMng (phát triển bởi Công ty TNHH Phần mềm Hoàng Hà), quản lý dữ liệu qua cơ sở dữ liệu quan hệ gồm 464 bảng. Cơ sở dữ liệu này được thiết kế theo nhiều quy chế đào tạo tích hợp (Quy chế 25, Quy chế 43, Quyết định 58/2007/QĐ-BGD&ĐT,...), dẫn đến mức độ phụ thuộc dữ liệu (coupling) rất cao.

Tiêu chí phân tích Hệ thống Monolith cũ (EduMng ERP) Giải pháp tùy biến PHP/MySQL Giải pháp đề xuất (Microservices + Hasura)
Kiến trúc Monolithic đơn khối, cơ sở dữ liệu tập trung Monolithic 3 lớp truyền thống Microservices hướng dịch vụ, API-first
Hiệu năng truy vấn Chậm khi Join nhiều bảng lớn (800ms - 2.5s) Trung bình (400ms - 900ms) Cực nhanh nhờ Hasura GraphQL Compiler (< 150ms)
Bảo mật & Phân quyền Session-based, gắn chặt vào Web Server Session/Cookie, dễ bị tấn công CSRF JWT Stateless, Clerk Identity Provider, RBAC cấp Row/Column
Khả năng mở rộng Khó mở rộng độc lập từng phân hệ Mở rộng theo chiều dọc (Scale-up) Mở rộng linh hoạt theo chiều ngang (Scale-out)
Tích hợp bên ngoài Đóng kín, khó giao tiếp qua API chuẩn REST API tự viết, thiếu chuẩn hóa Chuẩn GraphQL + RESTful API mở, hỗ trợ Realtime Subscriptions

Yêu cầu người dùng được phân loại theo mô hình MoSCoW:

  • Must have (Bắt buộc): Tra cứu kết quả học tập toàn khóa qua Mã sinh viên/Số CCCD; Quản lý thông tin cấp bằng (vb_capbang); Tạo và in phụ lục văn bằng dạng PDF; Tạo mã QR code xác thực; Đăng nhập/phân quyền an toàn.
  • Should have (Nên có): Bổ sung và quản lý minh chứng văn bằng, chứng chỉ qua dịch vụ đám mây (Cloudinary); Sổ lưu phụ lục văn bằng điện tử; Thống kê số lượng văn bằng theo đợt tốt nghiệp.
  • Could have (Có thể có): Gửi thông báo realtime qua GraphQL Subscription khi trạng thái xét duyệt chứng chỉ thay đổi; Tích hợp công cụ quét mã QR trực tiếp trên giao diện web.
  • Won't have (Chưa thực hiện): Chỉnh sửa trực tiếp điểm gốc môn học trên hệ thống lõi Edu (nhằm đảm bảo an toàn toàn vẹn dữ liệu).

Thiết kế hệ thống

Kiến trúc hệ thống được xây dựng theo mô hình phân tầng hướng dịch vụ, áp dụng nguyên lý Domain-Driven Design (DDD) để bóc tách các Bounded Context:

+---------------------------------------------------------------------------------------+
|                                  NGƯỜI DÙNG / CLIENT LAYER                            |
|             [Sinh viên tra cứu]     [Cán bộ Phòng Đào tạo]     [Nhà tuyển dụng]       |
+-------------------------------------------+-------------------------------------------+
                                            | (HTTPS / WSS)
                                            v
+---------------------------------------------------------------------------------------+
|                               API GATEWAY & AUTHENTICATION                            |
|        [ Clerk Identity Provider ] <--- JWT Bearer Token ---> [ Nginx Reverse Proxy ] |
+-------------------------------------------+-------------------------------------------+
                                            |
                                            v
+---------------------------------------------------------------------------------------+
|                                  APPLICATION SERVICES                                 |
|  +------------------------------+  +------------------------------------------------+ |
|  |     Hasura GraphQL Engine    |  |               Node.js Core Service             | |
|  | - Auto GraphQL API Generator |  | - Business Logic & DDD Aggregates              | |
|  | - RBAC Row/Column Security   |  | - PDF Generator Engine (PDFKit/Puppeteer)      | |
|  | - Realtime Subscriptions     |  | - Dynamic QR Generator & Verification Service  | |
|  +--------------+---------------+  +------------------------+-----------------------+ |
+-----------------|-------------------------------------------|-------------------------+
                  |                                           |
                  +---------------------+---------------------+
                                        | (SQL Queries / Connection Pool)
                                        v
+---------------------------------------------------------------------------------------+
|                                    PERSISTENCE LAYER                                  |
|   +---------------------------------------+  +--------------------------------------+ |
|   | PostgreSQL Database (Edu Data Replica)|  |   Cloudinary Cloud Storage (Media)   | |
|   | - sinhvien, vb_capbang, chungchi,...  |  |   - Ảnh scan văn bằng, minh chứng    | |
|   +---------------------------------------+  +--------------------------------------+ |
+---------------------------------------------------------------------------------------+

Hệ thống sử dụng Stack công nghệ hiện đại với phiên bản định danh cụ thể:

  • Backend / API: Hasura GraphQL Engine (v2.28+), Node.js (v18 LTS), Express REST Gateway.
  • Identity & Auth: Clerk Authentication Platform, JWT tiêu chuẩn RFC 7519 với thuật toán ký RS256.
  • Database: PostgreSQL (v14.8) lưu trữ bản sao dữ liệu tối ưu từ hệ thống Edu.
  • Media CDN: Cloudinary SDK (v1.34) phục vụ lưu trữ minh chứng văn bằng chứng chỉ.
  • Frontend: React.js (v18.2) kết hợp thư viện dựng giao diện TailwindCSS và Apollo Client GraphQL.

Thiết kế mô hình cơ sở dữ liệu trích xuất

Từ 464 bảng của hệ thống gốc, đồ án tập trung tối ưu hóa 10 bảng cốt lõi thuộc Domain kết quả học tập và văn bằng:

+-------------------+           +-------------------+           +-----------------------+
|     sinhvien      | 1       * |    vb_capbang     | *       1 | xephangtotnghiep_tinchi|
+-------------------+-----------+-------------------+-----------+-----------------------+
| masinhvien (PK)   |           | id (PK)           |           | xeploai (PK)          |
| hodem             |           | masinhvien (FK)   |           | ten                   |
| ten               |           | sohieubang        |           +-----------------------+
| gioitinh          |           | sovaoso           |
| socmnd            |           | hangtotnghiep(FK) |
| ngayvaotruong     |           +-------------------+
| mahedaotao (FK)   +----+
| makhoahoc (FK)    +--+ |      +---------------------------+
| manganh (FK)      +-+| |    * | sv_diemtrungbinhtoankhoa  |
+-------------------+ || +----->+---------------------------+
                      ||        | masinhvien (FK)           |
                      ||        | diem                      |
                      ||        +---------------------------+
                      ||
                      ||        +-------------------+           +-----------------------+
                      ||      * |  sv_datchungchi   | *       1 |       chungchi        |
                      |+------->+-------------------+-----------+-----------------------+
                      |         | masinhvien (FK)   |           | ma (PK)               |
                      |         | machungchi (FK)   |           | ten                   |
                      |         | sohieu, ngaycap   |           +-----------------------+
                      |         +-------------------+
                      |
                      |         +---------------------------+   +-----------------------+
                      |       * | sv_diemtrungbinhmonhoc    | * |        monhoc         |
                      +-------->+---------------------------+---+-----------------------+
                                | masinhvien (FK)           | 1 | mamonhoc (PK)         |
                                | mamonhoc (FK)             |   | tenmonhoc             |
                                | namhoc, hocky, diem       |   +-----------------------+
                                +---------------------------+

Methodology

Quy trình phát triển phần mềm tuân thủ phương pháp luận Agile/Scrum với chu kỳ 6 Sprint (mỗi Sprint kéo dài 2 tuần), thực hiện từ 27/03/2023 đến 17/06/2023.

+---------------+-----------------------------------------------+-----------------------------------+
| Sprint / Giai | Nội dung công việc chính                      | Kết quả bàn giao (Deliverables)   |
| đoạn          |                                               |                                   |
+---------------+-----------------------------------------------+-----------------------------------+
| Sprint 1 - 2  | Khảo sát CSDL Edu (464 bảng), áp dụng DDD để  | Sơ đồ Bounded Context, tài liệu   |
| (Tuần 1 - 4)  | xác định các Aggregate Root và Entity.        | thiết kế lược đồ CSDL chuẩn hóa.  |
+---------------+-----------------------------------------------+-----------------------------------+
| Sprint 3 - 4  | Cấu hình Hasura Engine, thiết lập quan hệ     | GraphQL API Endpoint hoàn chỉnh,  |
| (Tuần 5 - 8)  | bảng, tích hợp Clerk Auth và phân quyền RBAC. | Token Authentication Middleware.  |
+---------------+-----------------------------------------------+-----------------------------------+
| Sprint 5      | Xây dựng UI tra cứu, module tạo QR Code động, | Giao diện tra cứu, module xuất    |
| (Tuần 9 - 10) | module render phụ lục văn bằng ra file PDF.   | PDF và Cloudinary Media Service.  |
+---------------+-----------------------------------------------+-----------------------------------+
| Sprint 6      | Kiểm thử tích hợp, UAT với phòng Đào tạo,     | Báo cáo kiểm thử, hệ thống sẵn    |
| (Tuần 11 - 12)| tối ưu hóa truy vấn SQL và đóng gói deploy.   | sàng bàn giao và đưa vào sử dụng. |
+---------------+-----------------------------------------------+-----------------------------------+

Chiến lược quản trị rủi ro bao gồm:

  1. Rủi ro tắc nghẽn truy cập CSDL gốc: Thiết lập cơ chế Read-Only Replica tách biệt giữa hệ thống vận hành và cổng tra cứu công khai.
  2. Rủi ro lộ thông tin cá nhân (PII): Sử dụng Hasura Permissions Rules kiểm soát trường dữ liệu trả về theo vai trò (Anonymous chỉ xem thông tin công khai của văn bằng; Sinh viên đăng nhập mới xem được chi tiết điểm từng môn học).

Implementation và kết quả

Development process

1. Xây dựng truy vấn trích xuất dữ liệu tổng hợp (Complex SQL Mapping)

Để xuất được đầy đủ phụ lục văn bằng của sinh viên, hệ thống phải thực thi truy vấn kết nối đa bảng nhằm trích xuất đồng thời điểm toàn khóa, thông tin khóa học, ngành học và văn bằng tốt nghiệp:

-- Truy vấn trích xuất hồ sơ văn bằng và điểm tích lũy của sinh viên
SELECT 
    sv.masinhvien,
    CONCAT(sv.hodem, ' ', sv.ten) AS hoten,
    sv.gioitinh,
    sv.socmnd,
    hdt.tenhedaotao,
    ng.tennganh,
    kh.tenkhoahoc,
    vb.sohieubang,
    vb.sovaoso,
    xh.ten AS xeploaitotnghiep,
    dtb.diem AS diemtrungbinhtoankhoa
FROM sinhvien sv
INNER JOIN hedaotao hdt ON sv.mahedaotao = hdt.mahedaotao
INNER JOIN nganh ng ON sv.manganh = ng.manganh
INNER JOIN khoahoc kh ON sv.makhoahoc = kh.makhoahoc
LEFT JOIN vb_capbang vb ON sv.masinhvien = vb.masinhvien
LEFT JOIN xephangtotnghiep_tinchi xh ON vb.hangtotnghiep = xh.xeploai
LEFT JOIN sv_diemtrungbinhtoankhoa dtb ON sv.masinhvien = dtb.masinhvien
WHERE sv.masinhvien = :masinhvien OR sv.socmnd = :socmnd;

-- Truy vấn trích xuất toàn bộ bảng điểm chi tiết các học phần đã tích lũy
SELECT 
    mh.mamonhoc,
    mh.tenmonhoc,
    ctk.tongso AS sotinchi,
    dtb.namhoc,
    dtb.hocky,
    dtb.diem AS thangdiem10,
    CASE 
        WHEN dtb.diem >= 8.5 THEN 4.0
        WHEN dtb.diem >= 7.0 THEN 3.0
        WHEN dtb.diem >= 5.5 THEN 2.0
        WHEN dtb.diem >= 4.0 THEN 1.0
        ELSE 0.0
    END AS thangdiem4,
    CASE 
        WHEN dtb.diem >= 8.5 THEN 'A'
        WHEN dtb.diem >= 7.0 THEN 'B'
        WHEN dtb.diem >= 5.5 THEN 'C'
        WHEN dtb.diem >= 4.0 THEN 'D'
        ELSE 'F'
    END AS diemchu
FROM sv_diemtrungbinhmonhoc dtb
INNER JOIN monhoc mh ON dtb.mamonhoc = mh.mamonhoc
INNER JOIN chuongtrinhdaotaokhung ctk ON mh.mamonhoc = ctk.mamonhoc
WHERE dtb.masinhvien = :masinhvien AND dtb.lanthu = 1
ORDER BY dtb.namhoc ASC, dtb.hocky ASC;

2. Định nghĩa cấu trúc truy vấn GraphQL trên Hasura

Thông qua Hasura Engine, các bảng được ánh xạ thành các GraphQL Types, cho phép giao diện người dùng chỉ cần một lần gọi mạng duy nhất để lấy toàn bộ dữ liệu cần thiết:

query GetStudentDiplomaAndTranscript($masinhvien: String!) {
  sinhvien(where: { masinhvien: { _eq: $masinhvien } }) {
    masinhvien
    hodem
    ten
    socmnd
    gioitinh
    hedaotao {
      tenhedaotao
    }
    nganh {
      tennganh
    }
    khoahoc {
      tenkhoahoc
    }
    vb_capbangs {
      sohieubang
      sovaoso
      xephangtotnghiep_tinchi {
        ten
      }
    }
    sv_diemtrungbinhtoankhoas {
      diem
    }
    sv_datchungchis {
      machungchi
      sohieu
      ngaycap
      chungchi {
        ten
      }
    }
  }
}

3. Tích hợp JWT Custom Claims giữa Clerk và Hasura

Để Hasura có thể phân quyền truy cập dữ liệu chính xác theo từng vai trò (Role-Based Access Control), Clerk được cấu hình để nhúng các claims bắt buộc vào Payload của JWT:

{
  "https://hasura.io/jwt/claims": {
    "x-hasura-default-role": "student",
    "x-hasura-allowed-roles": ["student", "officer", "admin"],
    "x-hasura-user-id": "1912101003",
    "x-hasura-student-id": "1912101003"
  },
  "sub": "user_2Nkxabc123456",
  "iat": 1686000000,
  "exp": 1686086400
}

4. Thuật toán tạo mã QR Code động xác thực văn bằng

import QRCode from 'qrcode';
import crypto from 'crypto';

/**
 * Tạo mã QR bảo mật chứa link xác thực và mã băm toàn vẹn dữ liệu
 * @param {string} studentId - Mã sinh viên
 * @param {string} diplomaNo - Số hiệu văn bằng
 * @param {string} secretKey - Khóa bí mật của hệ thống
 */
export async function generateDiplomaQRCode(studentId, diplomaNo, secretKey) {
  const timestamp = Date.now();
  const rawSignature = `${studentId}|${diplomaNo}|${timestamp}`;
  
  // Tạo chữ ký số HMAC-SHA256 chống làm giả dữ liệu URL
  const hash = crypto
    .createHmac('sha256', secretKey)
    .update(rawSignature)
    .digest('hex');
    
  const verificationUrl = `https://vanbang.hpu.edu.vn/verify?sv=${studentId}&doc=${diplomaNo}&t=${timestamp}&sig=${hash}`;
  
  // Render mã QR dạng DataURL phục vụ in trực tiếp lên phụ lục văn bằng PDF
  const qrDataUrl = await QRCode.toDataURL(verificationUrl, {
    errorCorrectionLevel: 'H',
    margin: 1,
    width: 250,
    color: {
      dark: '#002B49',
      light: '#FFFFFF'
    }
  });
  
  return { qrDataUrl, verificationUrl, hash };
}

Testing và validation

Hệ thống đã trải qua quá trình kiểm thử tự động và kiểm thử chấp nhận người dùng (UAT) với các chỉ số đo lường thực tế:

Hạng mục kiểm thử Công cụ thực hiện Kịch bản / Mẫu thử Kết quả đạt được Trạng thái
Unit Testing Jest / Supertest 48 Test cases cho API & JWT Auth 100% Pass, Code coverage 91.5% Đạt
Load Testing k6 Load Test Mô phỏng 500 Virtual Users truy vấn đồng thời Latency trung bình: 142ms, Error rate: 0.0% Đạt
PDF Generation PDFKit Benchmark Xuất 100 tệp Phụ lục văn bằng liên tục Thời gian tạo trung bình: 0.85s / tệp Đạt
Tính hợp lệ QR ZBar Scanner Test Quét 200 mẫu QR in trên các khổ giấy A4 Độ chính xác quét thành công: 100% Đạt
UAT Phòng Đào tạo Trực tiếp tại HPU Nhập liệu sổ lưu, xuất 50 phụ lục văn bằng thực tế 100% cán bộ đánh giá thao tác tiện lợi Đạt

Kết quả đạt được

Hệ thống đã hoàn thành 100% các tính năng đề ra theo đề cương nghiên cứu:

  • Module Tra cứu công khai: Hỗ trợ tìm kiếm theo Mã sinh viên hoặc Số CCCD/CMND, hiển thị trực quan thông tin tốt nghiệp, số hiệu bằng, số vào sổ và danh sách chứng chỉ đạt chuẩn đầu ra.
  • Module Xuất phụ lục văn bằng: Tự động tạo tệp PDF đúng biểu mẫu chuẩn của Bộ GD&ĐT, bao gồm bảng điểm 8 học kỳ, điểm trung bình toàn khóa (thang 10 và thang 4), xếp loại tốt nghiệp và mã QR xác minh.
  • Module Quản lý sổ lưu văn bằng: Cán bộ phòng đào tạo có thể theo dõi sổ lưu phụ lục văn bằng theo từng đợt xét, cập nhật hình ảnh minh chứng chứng chỉ gốc qua Cloudinary.
  • Bảo mật phân quyền: Kiểm soát truy cập chặt chẽ giữa 3 nhóm đối tượng: Khách vãng lai, Sinh viên và Cán bộ quản lý đào tạo.

Đổi mới và đóng góp

Các điểm cải tiến kỹ thuật nổi bật

  1. Bóc tách kiến trúc Domain-Driven Design trên CSDL di sản (Legacy DB): Khác với các giải pháp thông thường cố gắng viết lại toàn bộ CSDL hoặc can thiệp trực tiếp vào 464 bảng của hệ thống EduMng gây rủi ro tê liệt hệ thống, đồ án đã định nghĩa thành công một Bounded Context riêng cho nghiệp vụ văn bằng. Giải pháp này ánh xạ trực tiếp các Aggregate Root cần thiết mà không phá vỡ cấu trúc phần mềm lõi.
  2. Tận dụng sức mạnh của Hasura GraphQL Engine: Giảm 85% thời gian viết mã Backend cho các tác vụ CRUD (Create, Read, Update, Delete) thông thường, đồng thời tận dụng khả năng biên dịch truy vấn GraphQL sang SQL tối ưu, giúp giảm tải hơn 60% mức tiêu thụ CPU của Database Server so với các ORM truyền thống (như Sequelize hay TypeORM).
  3. Cơ chế xác thực không trạng thái (Stateless Authentication): Sử dụng Clerk làm Identity Provider kết hợp JWT Custom Claims giúp hệ thống sẵn sàng mở rộng đa cụm máy chủ (Horizontal Scaling) mà không cần duy trì Session Storage tập trung (như Redis).
  4. Tích hợp mã QR bảo mật động: Biến mỗi văn bằng/phụ lục văn bằng thành một tài liệu có thể xác minh tức thì qua Internet, loại bỏ hoàn toàn khả năng can thiệp chỉnh sửa điểm số hoặc thông tin tốt nghiệp bằng các công cụ chỉnh sửa hình ảnh.

Bảng so sánh với các giải pháp hiện hành

Chỉ số so sánh Phương thức truyền thống (EduMng ERP) Cổng thông tin viết bằng PHP thông thường Giải pháp Website của Đồ án (Hasura + Clerk) Mức độ cải thiện
Thời gian phản hồi truy vấn 850 ms 420 ms 145 ms Nhanh hơn 82.9%
Thời gian tạo 1 phụ lục văn bằng 3 - 5 phút (Word/Excel thủ công) 5 - 10 giây 0.85 giây (Tự động PDF) Giảm 99.7% thời gian
Khả năng chịu tải đồng thời ~50 người dùng ~200 người dùng > 1,500 người dùng Tăng gấp 7.5 lần
Thời gian triển khai tính năng mới 3 - 4 tuần 1 - 2 tuần 2 - 3 ngày (nhờ Hasura) Nhanh hơn 75%
Rủi ro rò rỉ dữ liệu điểm gốc Cao (Truy cập DB chính) Trung bình Rất thấp (Read-only + RBAC) An toàn tuyệt đối

Ứng dụng thực tế và triển khai

Kịch bản triển khai thực tế

+----------------------------------------------------------------------------------------------------+
|                                      QUY TRÌNH NGHIỆP VỤ THỰC TẾ                                   |
+---+-----------------------------+------------------------------------------------------------------+
| 1 | Sinh viên tốt nghiệp        | Truy cập cổng web, nhập Mã SV -> Nhận kết quả học tập & xem      |
|   |                             | phụ lục văn bằng số -> Tải tệp PDF có gắn mã QR chứng thực.      |
+---+-----------------------------+------------------------------------------------------------------+
| 2 | Nhà tuyển dụng / Cơ quan    | Dùng camera điện thoại quét mã QR trên bản in phụ lục văn bằng   |
|   |                             | -> Hệ thống điều hướng về link xác thực chính chủ -> Đối chiếu.  |
+---+-----------------------------+------------------------------------------------------------------+
| 3 | Cán bộ Phòng Đào tạo        | Đăng nhập qua Clerk -> Tra cứu danh sách tốt nghiệp theo khóa ->  |
|   |                             | Bổ sung minh chứng ảnh -> Tạo sổ lưu phụ lục văn bằng điện tử.   |
+---+-----------------------------+------------------------------------------------------------------+

Hướng dẫn triển khai hệ thống (Deployment Instructions)

Hệ thống được đóng gói hoàn toàn dưới dạng Docker Containers, đảm bảo khả năng triển khai nhanh chóng trên các môi trường máy chủ Linux (Ubuntu Server 20.04/22.04 LTS):

# docker-compose.yml
version: '3.8'

services:
  postgres-replica:
    image: postgres:14-alpine
    container_name: hpu_postgres_replica
    restart: always
    environment:
      POSTGRES_DB: edu_replica
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  graphql-engine:
    image: hasura/graphql-engine:v2.28.0
    container_name: hpu_hasura_engine
    restart: always
    ports:
      - "8080:8080"
    depends_on:
      - postgres-replica
    environment:
      HASURA_GRAPHQL_DATABASE_URL: postgres://${DB_USER}:${DB_PASSWORD}@postgres-replica:5432/edu_replica
      HASURA_GRAPHQL_ENABLE_CONSOLE: "false"
      HASURA_GRAPHQL_DEV_MODE: "false"
      HASURA_GRAPHQL_ADMIN_SECRET: ${HASURA_ADMIN_SECRET}
      HASURA_GRAPHQL_JWT_SECRET: '{"jwk_url": "https://clerk.your-domain.com/.well-known/jwks.json"}'

  web-client:
    build:
      context: ./frontend
      dockerfile: Dockerfile
    container_name: hpu_web_portal
    restart: always
    ports:
      - "3000:3000"
    environment:
      NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY: ${CLERK_PUBLISHABLE_KEY}
      NEXT_PUBLIC_GRAPHQL_ENDPOINT: https://vanbang.hpu.edu.vn/v1/graphql

volumes:
  pgdata:

Phân tích hiệu quả kinh tế và ROI

  • Chi phí tiết kiệm: Giảm 80% chi phí giấy in đặc chủng và mực in văn bằng thử nghiệm; giảm ước tính 600 giờ lao động thủ công của cán bộ phòng Đào tạo mỗi năm trong các đợt phát bằng tốt nghiệp.
  • Thời gian hoàn vốn (ROI): Với chi phí duy trì hạ tầng đám mây thấp (nhờ sử dụng Tier miễn phí/tiêu chuẩn của Hasura, Clerk, Cloudinary), hệ thống đạt điểm hoàn vốn đầu tư kỹ thuật ngay trong học kỳ đầu tiên áp dụng chính thức tại trường.

Hạn chế và hướng phát triển

Hạn chế kỹ thuật hiện tại

  • Hệ thống hiện hoạt động trên mô hình bản sao dữ liệu (Read Replica) được đồng bộ định kỳ từ hệ thống Edu chính, do đó dữ liệu xét chứng chỉ phát sinh trong ngày có độ trễ đồng bộ nhất định (khoảng 15-30 phút tùy cấu hình cronjob).
  • Việc xác thực mã QR hiện phụ thuộc vào kết nối mạng Internet để kiểm tra tính toàn vẹn chữ ký số trên máy chủ của Nhà trường.
  • Hệ thống chưa hỗ trợ nhận dạng ký tự quang học (OCR) đối với các tài liệu văn bằng lịch sử được cấp trước năm 2010 (giai đoạn hồ sơ chưa số hóa hoàn toàn vào phần mềm Edu).

Hướng phát triển trong tương lai

  • Ứng dụng công nghệ Blockchain (Verifiable Credentials): Neo trữ (Anchor) mã băm (Hash) của văn bằng lên mạng lưới chuỗi khối (như Polygon hoặc Ethereum) theo chuẩn W3C Decentralized Identifiers (DIDs), cho phép xác thực phi tập trung ngay cả khi máy chủ trường học mất kết nối.
  • Tích hợp module AI OCR: Xây dựng luồng tự động quét và bóc tách thông tin từ các sổ gốc cấp bằng dạng văn bản giấy cũ để tự động đẩy vào cơ sở dữ liệu số hóa.
  • Phát triển ứng dụng di động (Mobile App) hỗ trợ Ví văn bằng số: Cho phép sinh viên lưu trữ bản sao số có chữ ký điện tử của văn bằng trực tiếp trên smartphone thông qua chuẩn chứng chỉ số giáo dục.

Đối tượng hưởng lợi

Hệ thống mang lại giá trị thực tiễn rõ rệt cho 4 nhóm đối tượng chính:

+-------------------+-----------------------------------------------------------------------------------+
| Nhóm đối tượng    | Lợi ích định lượng và giá trị mang lại                                            |
+-------------------+-----------------------------------------------------------------------------------+
| Sinh viên         | - Tiết kiệm 100% thời gian di chuyển, tra cứu kết quả mọi lúc mọi nơi trên web.   |
|                   | - Nhận ngay phụ lục văn bằng dạng PDF chuẩn trong 1 giây để nộp hồ sơ xin việc.  |
+-------------------+-----------------------------------------------------------------------------------+
| Cán bộ quản trị   | - Giảm 75% áp lực tiếp nhận và xác nhận hồ sơ giấy tờ tại bộ phận một cửa.        |
| (Phòng Đào tạo)   | - Tự động hóa việc lập sổ lưu phụ lục văn bằng và lưu trữ minh chứng điện tử.     |
+-------------------+-----------------------------------------------------------------------------------+
| Doanh nghiệp      | - Xác minh tính xác thực của ứng viên ngay lập tức bằng cách quét mã QR.          |
| (Nhà tuyển dụng)  | - Triệt tiêu 100% rủi ro tuyển dụng nhân sự sử dụng văn bằng, bảng điểm giả.     |
+-------------------+-----------------------------------------------------------------------------------+
| Kỹ sư / Sinh viên | - Mẫu kiến trúc tham khảo hoàn chỉnh về DDD và Microservices trên CSDL di sản.   |
| nghiên cứu CNTT   | - Thực hành tích hợp Hasura GraphQL, Clerk Stateless JWT và Cloudinary thực tế.  |
+-------------------+-----------------------------------------------------------------------------------+

Câu hỏi thường gặp

1. Yêu cầu phần cứng và hạ tầng kỹ thuật tối thiểu để triển khai hệ thống là gì?

Để triển khai hệ thống với khả năng phục vụ cho quy mô 10,000 sinh viên, máy chủ cần cấu hình tối thiểu: 2 vCPU, 4GB RAM, 50GB SSD, cài đặt hệ điều hành Linux (Ubuntu 20.04+), Docker v24.0+ và Docker Compose. Về dịch vụ ngoài, cần đăng ký tài khoản tại Clerk (quản trị người dùng) và Cloudinary (lưu trữ ảnh scan văn bằng).

2. Hệ thống xử lý vấn đề quá tải (Scalability limits) trong các đợt phát bằng như thế nào?

Nhờ kiến trúc phi trạng thái (Stateless), tầng ứng dụng (Frontend & Hasura GraphQL Engine) có thể tự động nâng rộng theo chiều ngang (Horizontal Pod Autoscaling) bằng cách đặt sau Nginx Load Balancer. Hasura biên dịch trực tiếp GraphQL thành các câu lệnh SQL tối ưu có thời gian thực thi dưới 50ms, cho phép một cụm cơ sở dữ liệu PostgreSQL cơ bản xử lý dễ dàng hơn 1,200 requests/giây.

3. Việc tích hợp hệ thống mới có làm gián đoạn CSDL 464 bảng của phần mềm Edu đang chạy không?

Không. Hệ thống áp dụng mô hình liên kết phi xâm lấn (Non-invasive Integration). Cổng thông tin chỉ kết nối tới một cơ sở dữ liệu bản sao (Read-only Replica) hoặc sử dụng các View chuyên biệt được thiết lập trên PostgreSQL/SQL Server, hoàn toàn không thực hiện bất kỳ lệnh ghi hay khóa bảng (Lock Table) nào trên cơ sở dữ liệu gốc của phần mềm EduMng.

4. Chi phí duy trì hệ thống và thời gian bảo trì định kỳ là bao nhiêu?

Hệ thống tận dụng các giải pháp mã nguồn mở và gói dịch vụ Cloud tiêu chuẩn nên chi phí duy trì phần mềm định kỳ gần như bằng 0 VNĐ. Nhà trường chỉ cần chi trả chi phí thuê máy chủ (khoảng 300,000 - 500,000 VNĐ/tháng). Thời gian bảo trì định kỳ ước tính khoảng 2 giờ mỗi quý để cập nhật các bản vá bảo mật cho hệ điều hành và Docker Images.

5. Cơ chế bảo mật nào ngăn chặn việc giả mạo mã QR trên phụ lục văn bằng?

Mỗi mã QR không chỉ chứa đường dẫn đơn thuần mà chứa một chữ ký số tạo bởi thuật toán mã hóa HMAC-SHA256 kết hợp giữa Mã sinh viên, Số hiệu văn bằng, Dấu thời gian (Timestamp) và một Khóa bí mật (Secret Key) chỉ lưu trữ tại máy chủ Nhà trường. Nếu kẻ gian tự ý chỉnh sửa đường dẫn URL hoặc đổi số hiệu văn bằng, chữ ký số sẽ không hợp lệ và hệ thống sẽ hiển thị cảnh báo văn bằng không hợp pháp ngay lập tức khi quét mã.

Kết luận

Đồ án tốt nghiệp "Xây dựng Website quản lý kết quả học tập và văn bằng chứng chỉ của sinh viên" của sinh viên Vũ Hoài Nam (Trường Đại học Quản lý và Công nghệ Hải Phòng) đã giải quyết thành công một bài toán cấp thiết trong quá trình chuyển đổi số giáo dục đại học. Bằng việc ứng dụng khéo léo phương pháp thiết kế hướng tên miền (Domain-Driven Design), kiến trúc hướng dịch vụ Microservices, Hasura GraphQL Engine, xác thực Clerk JWT và mã QR bảo mật động, đồ án đã chứng minh tính khả thi vượt trội trong việc số hóa, công khai văn bằng theo đúng tinh thần Thông tư 21/2019/TT-BGDĐT.

Hệ thống không chỉ mang lại giá trị kỹ thuật với độ trễ truy vấn thấp (145ms), khả năng tự động hóa xuất phụ lục văn bằng PDF trong 0.85 giây mà còn tạo ra giá trị kinh tế - xã hội to lớn: bảo vệ uy tín đào tạo của Nhà trường, hỗ trợ sinh viên tối đa và ngăn chặn triệt để vấn nạn văn bằng giả trong xã hội. Đây là một mô hình ứng dụng tiêu biểu, có khả năng chuyển giao và triển khai nhân rộng cho nhiều trường đại học, cao đẳng và cơ sở giáo dục nghề nghiệp trên cả nước.