Phân tích & Thiết kế Database HUCA

​

1. Tổng quan

​

1.1. Quy ước đặt tên

​

2. Kiến trúc tổng thể

​

2.1. Phân nhóm theo giai đoạn

HUCA Database
├── Phần 0: Danh mục dùng chung (7 bảng)
│   ├── t_huca_provinces
│   ├── t_huca_faculties
│   ├── t_huca_academic_years
│   ├── t_huca_classes
│   ├── t_huca_roles
│   ├── t_huca_permissions
│   └── t_huca_role_permissions
│
├── Phần 1: Giai đoạn 1 - Nền tảng Web (18 bảng)
│   ├── Người dùng & Phân quyền
│   │   ├── t_huca_users
│   │   ├── t_huca_user_roles
│   │   └── t_huca_account_links
│   ├── Ban Liên lạc
│   │   ├── t_huca_liaison_committees
│   │   ├── t_huca_committee_terms
│   │   └── t_huca_committee_members
│   ├── Nhóm & Tương tác
│   │   ├── t_huca_groups
│   │   ├── t_huca_group_members
│   │   ├── t_huca_posts
│   │   ├── t_huca_comments
│   │   ├── t_huca_reactions
│   │   └── t_huca_media
│   ├── Tin tức
│   │   ├── t_huca_article_categories
│   │   └── t_huca_articles
│   ├── Sự kiện
│   │   ├── t_huca_events
│   │   └── t_huca_event_registrations
│   ├── Gây quỹ & Thanh toán
│   │   ├── t_huca_fundraising_campaigns
│   │   ├── t_huca_donations
│   │   └── t_huca_payments
│   └── Nhắn tin & Thông báo
│       ├── t_huca_conversations
│       ├── t_huca_conversation_members
│       ├── t_huca_messages
│       ├── t_huca_notifications
│       ├── t_huca_email_templates
│       └── t_huca_email_logs
│
├── Phần 2: Giai đoạn 2 - App Di động (3 bảng)
│   ├── t_huca_event_attendances
│   ├── t_huca_user_locations
│   └── t_huca_device_tokens
│
├── Phần 3: Giai đoạn 3 - Đào tạo & Nghề nghiệp (11 bảng)
│   ├── Đào tạo
│   │   ├── t_huca_training_programs
│   │   ├── t_huca_program_registrations
│   │   └── t_huca_certificates
│   ├── Cố vấn
│   │   ├── t_huca_mentors
│   │   ├── t_huca_mentorship_matches
│   │   └── t_huca_mentorship_appointments
│   ├── Thi trực tuyến
│   │   ├── t_huca_exam_banks
│   │   ├── t_huca_exams
│   │   ├── t_huca_exam_questions
│   │   └── t_huca_exam_submissions
│   └── Gamification
│       ├── t_huca_points
│       ├── t_huca_badges
│       ├── t_huca_user_badges
│       └── t_huca_leaderboards
│
├── Phần 4: Giai đoạn 4 - Doanh nghiệp & B2B (8 bảng)
│   ├── t_huca_companies
│   ├── t_huca_company_members
│   ├── t_huca_jobs
│   ├── t_huca_job_applications
│   ├── t_huca_vouchers
│   ├── t_huca_voucher_claims
│   ├── t_huca_b2b_opportunities
│   └── t_huca_b2b_responses
│
├── Phần 5: Báo cáo & Thống kê (2 bảng)
│   ├── t_huca_audit_logs
│   └── t_huca_statistics
│
└── Phần 6: Tích hợp HUCE (1 bảng)
    └── t_huca_admin_requests

​

2.2. Sơ đồ quan hệ tổng quát (ERD Overview)

┌──────────────────┐     ┌─────────────────┐     ┌──────────────────┐
│  t_huca_faculties│◄────│  t_huca_classes  │────►│t_huca_academic   │
│                  │     │                  │     │      _years      │
└────────┬─────────┘     └────────┬─────────┘     └──────────────────┘
         │                        │
         │         ┌──────────────┘
         │         │
         ▼         ▼
    ┌─────────────────────────────────────────────────────┐
    │                   t_huca_users                       │
    │  (Bảng trung tâm - FK đến hầu hết các bảng khác)   │
    └──┬──────┬──────┬──────┬──────┬──────┬──────┬────────┘
       │      │      │      │      │      │      │
       ▼      ▼      ▼      ▼      ▼      ▼      ▼
    Events  Groups  Posts  Jobs  Mentors  Exams  Companies

​

3. Chi tiết thiết kế theo giai đoạn

​

3.1. Phần 0: Bảng danh mục dùng chung

​

t_huca_provinces

Danh sách 63 tỉnh/thành phố Việt Nam, phục vụ Bản đồ CSV.

​

t_huca_faculties

Danh sách Khoa/Viện của HUCE.

​

t_huca_academic_years

Khóa học theo năm (VD: Khóa 60, 61, 62…).

​

t_huca_classes

Lớp học theo Khoa và Khóa.

​

t_huca_roles & t_huca_permissions & t_huca_role_permissions

Hệ thống RBAC (Role-Based Access Control) phân quyền linh hoạt.

• ADMIN - Quản trị viên hệ thống
• ALUMNI - Cựu sinh viên đã xác thực
• STUDENT - Sinh viên đang theo học
• BLL_LEADER - Trưởng Ban Liên lạc
• ENTERPRISE - Đại diện doanh nghiệp
• MODERATOR - Điều phối viên nội dung

​

3.2. Giai đoạn 1: Nền tảng Web

​

t_huca_users (Bảng trung tâm)

Lưu thông tin người dùng: cựu sinh viên, sinh viên, quản trị viên.

• Hỗ trợ đăng nhập đa phương thức: Email/Password, Google, Facebook, SSO HUCE
• Mã QR định danh duy nhất cho mỗi hồ sơ xác thực (“Thẻ CSV số”)
• Cài đặt hiển thị riêng tư cho từng trường thông tin
• Quy trình: Đăng ký -> Xác thực email/SĐT -> Admin phê duyệt -> Kích hoạt

​

t_huca_account_links (Liên kết tài khoản)

Giải pháp số hóa danh sách lớp cũ: Admin tải lên Excel -> Hệ thống sinh Link + Mã -> CSV liên kết tài khoản.

1. Admin nhập danh sách lớp (Excel)
2. Hệ thống tạo LinkToken (link lớp) + PersonalCode (mã cá nhân) cho mỗi CSV
3. Ban cán sự lớp gửi Link + Mã qua Zalo/Email
4. CSV truy cập link, nhập mã -> Tự động liên kết với hồ sơ chuẩn

​

t_huca_liaison_committees (Ban Liên lạc)

Phân cấp BLL theo 3 loại: Khóa, Khoa, Khu vực.

• Mỗi BLL có nhiều Nhiệm kỳ (t_huca_committee_terms)
• Mỗi Nhiệm kỳ có nhiều Thành viên (t_huca_committee_members) với chức danh: Trưởng ban, Phó ban, Thư ký, Ủy viên
• BLL có không gian riêng để đăng thông báo (qua t_huca_posts.CommitteeId)

​

t_huca_groups & t_huca_group_members

Nhóm thảo luận theo sở thích hoặc chuyên môn.

• Chỉ Admin/Trưởng BLL mới được tạo nhóm
• Phân loại: Interest (sở thích), Professional (chuyên môn), Faculty (khoa), Class (lớp)
• Quyền hạn trong nhóm: Admin, Moderator, Member

​

t_huca_posts, t_huca_comments, t_huca_reactions

Hệ thống bài viết, bình luận và tương tác.

• Bài viết có thể thuộc Nhóm hoặc Ban Liên lạc
• Hỗ trợ bình luận lồng nhau (reply) qua ParentId
• Tương tác đa dạng: Like, Love, Celebrate
• Đếm tương tác được denormalize cho hiệu năng (LikeCount, CommentCount)

​

t_huca_events & t_huca_event_registrations

Quản lý sự kiện từ tạo, đăng ký đến thanh toán phí.

• Hỗ trợ tọa độ GPS + GeoFence cho điểm danh (Giai đoạn 2)
• Mã QR sự kiện (EventQrCode) cho check-in
• Tích hợp thanh toán phí qua PaymentId
• Trạng thái: Draft -> Published -> Ongoing -> Completed

​

t_huca_fundraising_campaigns & t_huca_donations

Cổng gây quỹ minh bạch với thanh tiến độ và bảng vinh danh.

• Thanh tiến độ: CurrentAmount / TargetAmount
• Bảng vinh danh điện tử (Digital Donor Wall): ShowOnDonorWall
• Hỗ trợ quyên góp ẩn danh: IsAnonymous

​

t_huca_payments

Cổng thanh toán trực tuyến hỗ trợ VNPay, ZaloPay, MoMo, QR ngân hàng.

• Polymorphic reference: ReferenceType + ReferenceId liên kết đến EventRegistration, Donation, hoặc ProgramRegistration
• Lưu trữ response từ payment gateway cho đối soát

​

t_huca_conversations, t_huca_messages

Nhắn tin riêng 1-1 và nhóm.

• t_huca_conversations: Hỗ trợ Direct (1-1) và Group
• t_huca_conversation_members: Quản lý thành viên, trạng thái đọc, tắt tiếng
• t_huca_messages: Hỗ trợ Text, Image, File

​

t_huca_notifications & t_huca_email_templates

Hệ thống thông báo đa kênh: In-App, Email, Push.

• Notification đa dạng: Event, Message, Group, Fundraising, System
• Email templates có biến động: {{FullName}}, {{EventTitle}}…
• Lịch sử gửi email (t_huca_email_logs) để theo dõi

​

3.3. Giai đoạn 2: App Di động

​

t_huca_event_attendances (Điểm danh sự kiện)

Ghi nhận điểm danh bằng QR/GPS với chống điểm danh hộ.

• So sánh tọa độ GPS với GeoFenceRadius của sự kiện
• Ghi nhận DeviceId để phát hiện 1 thiết bị điểm danh nhiều người
• Cảnh báo điểm danh ngoài khu vực

​

t_huca_user_locations (Tìm CSV lân cận)

Vị trí người dùng cho tính năng “Radar” tìm CSV gần.

• SharingMode: Always / WhenActive / Never (mặc định)
• ShowExactLocation: false = chỉ hiển thị xấp xỉ (quận/huyện)
• Vị trí xấp xỉ: ApproxDistrict, ApproxProvince

​

t_huca_device_tokens

Token thiết bị cho Push Notification (iOS/Android).

​

3.4. Giai đoạn 3: Đào tạo & Phát triển Nghề nghiệp

​

t_huca_training_programs & t_huca_program_registrations

Cổng Học tập Suốt đời (LLL Portal).

• Master - Thạc sĩ
• PhD - Tiến sĩ
• Certificate - Chứng chỉ hành nghề (Định giá XD, Chỉ huy trưởng)
• ShortCourse - Khóa ngắn hạn
• Workshop / Seminar

​

t_huca_certificates

Chứng chỉ số với mã xác thực QR.

• Mỗi chứng chỉ có mã duy nhất (CertificateCode)
• URL xác thực (QrVerifyUrl) cho bên thứ ba kiểm tra

​

t_huca_mentors & t_huca_mentorship_matches

Hệ thống cố vấn nghề nghiệp (Mentorship).

1. CSV đăng ký làm Mentor với chuyên môn, dịch vụ cung cấp
2. Mentee đăng ký và mô tả mong muốn phát triển
3. Hệ thống gợi ý ghép cặp (Smart Matching) theo ngành, lĩnh vực
4. Mentor/Mentee đặt lịch hẹn qua t_huca_mentorship_appointments
5. Sau khi kết thúc: đánh giá, feedback lẫn nhau

​

t_huca_exams, t_huca_exam_questions, t_huca_exam_submissions

Thi tuyển dụng trực tuyến với chống gian lận.

• DetectTabSwitch: Phát hiện chuyển tab
• RecordBehavior: Ghi nhận hành vi
• TabSwitchCount: Đếm số lần chuyển tab
• BehaviorFlags: JSON flags hành vi bất thường

• Ngân hàng đề chung (t_huca_exam_banks) hoặc đề riêng
• Trắc nghiệm chấm tự động
• Xáo trộn câu hỏi

​

t_huca_points, t_huca_badges, t_huca_user_badges, t_huca_leaderboards

Trò chơi hóa (Gamification).

• Mentor Tiêu biểu, Nhà tài trợ Vàng/Bạc
• Người tham gia tích cực, Hồ sơ hoàn chỉnh
• Người học suốt đời, Top Contributor, Người kết nối

​

3.5. Giai đoạn 4: Doanh nghiệp & Dịch vụ gia tăng

​

t_huca_companies & t_huca_company_members

Trang vàng HUCA - Danh bạ doanh nghiệp CSV.

• Hồ sơ năng lực số: Logo, quy mô, lĩnh vực chuyên sâu
• Phân loại ngành hẹp: Giao thông, Dân dụng, Kiến trúc, Vật liệu
• Danh sách nhân sự là người HUCE đang làm tại đó

​

t_huca_jobs & t_huca_job_applications

Bảng việc làm & Ứng tuyển nhanh (1-click apply).

• Hỗ trợ: FullTime, PartTime, Internship, Contract
• Ứng tuyển nhanh bằng Hồ sơ số HUCA (UseHucaProfile = 1)
• Liên kết với kỳ thi tuyển dụng (ExamSubmissionId)

​

t_huca_vouchers & t_huca_voucher_claims

Hệ sinh thái Đặc quyền HUCA (HUCA Exclusives).

• Doanh nghiệp phát hành mã giảm giá/chiết khấu
• Chỉ dành cho Verified Alumni
• Giới hạn: số lượng tổng, số lần/người, thời hạn

​

t_huca_b2b_opportunities & t_huca_b2b_responses

Bảng thông tin Đấu thầu & Giao thương B2B.

• SubcontractorSearch - Tìm nhà thầu phụ
• SupplierSearch - Tìm nhà cung cấp vật tư
• InvestmentPartner - Mời hợp tác đầu tư
• JointVenture - Liên doanh

​

4. Đảm bảo toàn vẹn dữ liệu

​

4.1. Ràng buộc khóa ngoại (Referential Integrity)

• t_huca_users -> t_huca_faculties, t_huca_academic_years, t_huca_classes, t_huca_provinces
• t_huca_classes -> t_huca_faculties, t_huca_academic_years
• t_huca_posts -> t_huca_groups, t_huca_liaison_committees, t_huca_users
• t_huca_events -> t_huca_users, t_huca_provinces, t_huca_liaison_committees
• t_huca_donations -> t_huca_fundraising_campaigns, t_huca_users
• t_huca_jobs -> t_huca_companies, t_huca_users

​

4.2. Ràng buộc duy nhất (Unique Constraints)

​

4.3. Soft Delete

• Dữ liệu lịch sử được bảo toàn
• Có thể phục hồi khi cần
• Không phá vỡ quan hệ FK

​

4.4. Audit Trail

• OldValues / NewValues: JSON snapshot trước và sau thay đổi
• IpAddress, UserAgent: Thông tin phiên truy cập
• Index theo CreatedAt DESC cho truy vấn nhanh

​

4.5. Indexing Strategy

• Index trên tất cả Foreign Key columns
• Index trên các trường thường dùng trong WHERE/ORDER BY
• Filtered index cho trường hợp đặc biệt (VD: IsFeatured = 1)
• Composite index cho các truy vấn phức hợp (VD: (ConversationId, CreatedAt DESC))

​

5. Sơ đồ quan hệ chi tiết (ERD)

​

5.1. Module Người dùng & Phân quyền

t_huca_roles ─────┐
                   │ N:N (qua t_huca_role_permissions)
t_huca_permissions─┘
                   │ N:N (qua t_huca_user_roles)
                   ▼
              t_huca_users
              ┌────┴────┐
              │         │
              ▼         ▼
     t_huca_faculties  t_huca_classes
                         │
                         ▼
                  t_huca_academic_years

​

5.2. Module Sự kiện

t_huca_events
     │
     ├──► t_huca_event_registrations ──► t_huca_payments
     │          │
     │          ▼
     │     t_huca_users
     │
     └──► t_huca_event_attendances (GĐ 2)
                │
                ▼
           GPS + QR + Device

​

5.3. Module Gây quỹ

t_huca_fundraising_campaigns
     │
     └──► t_huca_donations ──► t_huca_payments
                │
                ▼
           t_huca_users

​

5.4. Module Đào tạo & Cố vấn

t_huca_training_programs
     │
     ├──► t_huca_program_registrations
     │
     └──► t_huca_certificates

t_huca_mentors ──► t_huca_mentorship_matches ──► t_huca_mentorship_appointments
                          │
                          ▼
                     t_huca_users (Mentee)

​

5.5. Module Doanh nghiệp & Việc làm

t_huca_companies
     │
     ├──► t_huca_company_members
     ├──► t_huca_jobs ──► t_huca_job_applications
     ├──► t_huca_vouchers ──► t_huca_voucher_claims
     └──► t_huca_b2b_opportunities ──► t_huca_b2b_responses

​

6. Dữ liệu khởi tạo (Seed Data)

​

7. Hướng dẫn triển khai

​

7.1. Yêu cầu hệ thống

• SQL Server: 2022 trở lên (hoặc Azure SQL)
• Collation: Vietnamese_CI_AS (hỗ trợ tiếng Việt)
• Dung lượng ước tính ban đầu: ~500MB (10,000 users)

​

7.2. Thứ tự thực thi

# 1. Tạo database và bảng danh mục
# 2. Tạo bảng Giai đoạn 1
# 3. Tạo bảng Giai đoạn 2
# 4. Tạo bảng Giai đoạn 3
# 5. Tạo bảng Giai đoạn 4
# 6. Tạo bảng hỗ trợ (Audit, Statistics, Admin Requests)
# 7. Insert Seed Data

​

7.3. Ghi chú về mở rộng

• Giai đoạn 1+2: Có thể triển khai ngay, đã đầy đủ quan hệ
• Giai đoạn 3+4: Các bảng FK đến t_huca_companies được thêm bằng ALTER TABLE sau khi bảng companies được tạo
• Spatial Index: Có thể bổ sung SQL Server Spatial Index cho Latitude/Longitude khi cần tìm kiếm theo bán kính (Tìm CSV lân cận)
• Full-Text Index: Có thể bổ sung cho các trường Content, Description phục vụ tìm kiếm nâng cao

​

8. Tổng kết