Giới thiệu dự án

Ngành du lịch và khách sạn (Hospitality Industry) đang trải qua quá trình chuyển đổi số mạnh mẽ nhằm tối ưu hóa chi phí vận hành và nâng cao trải nghiệm khách hàng. Theo thống kê từ Statista, hơn 68% doanh thu toàn cầu của ngành lưu trú du lịch hiện nay được tạo ra thông qua các kênh trực tuyến. Tuy nhiên, tại nhiều cơ sở lưu trú và chi nhánh nghỉ dưỡng quy mô vừa và lớn, công tác quản lý phòng ốc, điều phối dịch vụ và ghi nhận giao dịch vẫn còn phụ thuộc vào các công cụ thủ công như bảng tính Excel hoặc hệ thống ghi chép rời rạc. Phương thức này gây ra tình trạng trùng lặp lịch đặt phòng (overbooking), thất thoát doanh thu dịch vụ gia tăng, độ trễ cao trong đối soát hóa đơn và suy giảm độ hài lòng của khách du lịch.

Đề tài "Xây dựng website quản lý đặt phòng khách sạn Vinpearl" được thực hiện bởi sinh viên Lê Bá Nhật (Khoa Công nghệ số – Trường Đại học Sư phạm Kỹ thuật, Đại học Đà Nẵng) dưới sự hướng dẫn của ThS. Trần Bửu Dung. Đồ án giải quyết bài toán cốt lõi: số hóa toàn diện quy trình tiếp nhận, quản lý buồng phòng, tích hợp dịch vụ gia tăng và thanh toán theo thời gian thực cho chuỗi cơ sở lưu trú cao cấp.

+-----------------------------------------------------------------------------------+
|                            TỔNG QUAN DỰ ÁN VINPEARL PMS                           |
+--------------------+--------------------------------------------------------------+
| Đơn vị thực hiện   | Trường Đại học Sư phạm Kỹ thuật - Đại học Đà Nẵng            |
| Khoa / Ngành       | Khoa Công nghệ số / Ngành Công nghệ Thông tin                 |
| Tác giả & Cán bộ   | Lê Bá Nhật (1911505310244) - GVHD: ThS. Trần Bửu Dung        |
| Phạm vi nghiên cứu | Khách sạn Vinpearl (341 Trần Hưng Đạo, Sơn Trà, Đà Nẵng)     |
| Trọng tâm kỹ thuật | Backend Golang + Frontend ReactJS + Hệ CSDL PostgreSQL       |
+--------------------+--------------------------------------------------------------+

Mục tiêu dự án

  1. Thiết kế và xây dựng nền tảng Web Application quản lý đặt phòng khách sạn hoàn chỉnh, đáp ứng đồng thời nhu cầu tự phục vụ (self-service) của khách hàng và nghiệp vụ quản trị buồng phòng của nhân viên lễ tân, ban quản lý.
  2. Loại bỏ triệt để xung đột dữ liệu đặt phòng thông qua kiến trúc quản lý phiên giao dịch (ACID Transactions) và cơ chế khóa bản ghi đồng thời.
  3. Tối ưu hóa tốc độ xử lý luồng đặt phòng và tính toán hóa đơn, bảo đảm độ trễ phản hồi API dưới 100ms ngay cả khi lưu lượng truy cập gia tăng đột biến.
  4. Hệ thống hóa module dịch vụ đi kèm (ăn uống, spa, giặt ủi, hội nghị) gắn trực tiếp với mã phiếu đặt phòng nhằm tự động hóa quy trình quyết toán khi check-out.
  5. Cung cấp dashboard báo cáo trực quan thống kê doanh thu theo ngày, tuần, tháng và tỷ lệ lấp đầy phòng (occupancy rate) giúp nhà quản lý đưa ra quyết định kinh doanh chính xác.

Giải pháp kỹ thuật và phạm vi triển khai

  • Cách tiếp cận giải pháp: Xây dựng hệ thống theo mô hình phân tách độc lập giữa Client-side và Server-side thông qua giao thức RESTful API. Hệ thống sử dụng ngôn ngữ lập trình Golang (Go) cho tầng Backend nhờ hiệu năng cao và khả năng xử lý concurrency xuất sắc thông qua Goroutines; thư viện ReactJS cho tầng Frontend nhằm mang lại trải nghiệm SPA (Single Page Application) mượt mà; và hệ quản trị cơ sở dữ liệu quan hệ PostgreSQL đảm bảo tính toàn vẹn dữ liệu đa luồng, hỗ trợ kiểm soát đồng thời đa phiên bản (MVCC).
  • Phạm vi và giới hạn: Triển khai thực nghiệm cho cơ sở Khách sạn Vinpearl tại địa chỉ 341 Trần Hưng Đạo, Quận Sơn Trà, TP. Đà Nẵng. Hệ thống tập trung vào nghiệp vụ đặt phòng trực tuyến, quản lý buồng phòng, check-in/check-out, tính phụ phí dịch vụ và thống kê doanh thu nội bộ.

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

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

Để lựa chọn cấu trúc giải pháp phù hợp, đồ án tiến hành đánh giá so sánh giữa các phương thức quản lý truyền thống, phần mềm PMS đóng gói và giải pháp tùy biến hướng dịch vụ:

Tiêu chí đánh giá Quản lý thủ công (Sổ tay / Excel) Phần mềm PMS đóng gói (Cloudbeds / ezCloud) Giải pháp tùy biến Golang + React + PostgreSQL
Tính toàn vẹn dữ liệu Rất thấp, dễ nhầm lẫn dữ liệu giữa các ca trực Cao, xử lý tập trung trên Cloud Tuyệt đối nhờ ràng buộc khóa ngoại & PostgreSQL ACID
Khả năng xử lý Concurrency Không có (xung đột dữ liệu liên tục) Tốt (phụ thuộc gói thuê bao) Rất cao (Goroutines + Connection Pooling)
Chi phí vận hành dài hạn Thấp ban đầu, tổn thất vận hành lớn Chi phí duy trì theo tháng/năm cao ($50 - $300/tháng) Chi phí giấy phép = 0$ (Mã nguồn mở hoàn toàn)
Khả năng tùy biến giao diện Không Bị giới hạn theo mẫu của nhà cung cấp Linh hoạt 100% theo nhận diện thương hiệu Vinpearl
Tốc độ phản hồi hệ thống Chậm, phụ thuộc thao tác người nhập Phụ thuộc máy chủ nhà cung cấp (200ms - 500ms) Siêu nhanh (< 50ms nhờ Go compiled binary)

Phân tích yêu cầu chức năng theo mô hình MoSCoW

  • Must Have (Bắt buộc có): Đăng ký/đăng nhập phân quyền (Khách hàng, Lễ tân, Admin), tìm kiếm phòng trống theo khoảng thời gian thực tế, tạo phiếu đặt phòng (PhieuDatPhong), quản lý trạng thái phòng (Trong, DaDat, DangSuDung), tính toán hóa đơn tổng và check-in/check-out.
  • Should Have (Nên có): Thêm dịch vụ phát sinh (PhieuDichVu), cập nhật hồ sơ khách hàng, phân loại hạng phòng (Standard, Deluxe, Suite, Villa), bảng điều khiển thống kê doanh thu đa chiều (ngày/tuần/tháng).
  • Could Have (Có thể mở rộng): Đánh giá/phản hồi chất lượng phòng, gửi email xác nhận đặt phòng tự động.
  • Won't Have (Chưa triển khai trong giai đoạn này): Cổng thanh toán quốc tế đa tiền tệ và tích hợp Channel Manager đồng bộ với OTA quốc tế (Agoda, Booking.com).
+--------------------------------------------------------------------------------+
|                   SƠ ĐỒ PHÂN QUYỀN VÀ USE-CASE CÁC TÁC NHÂN                    |
+--------------------------------------------------------------------------------+
|                                                                                |
|  [ Khách Hàng ]                                                                |
|       │                                                                        |
|       ├──► Đăng ký / Đăng nhập tài khoản                                       |
|       ├──► Tìm kiếm phòng trống (Ngày đến, Ngày đi, Hạng phòng)                |
|       ├──► Tạo đơn đặt phòng trực tuyến & Chọn dịch vụ đi kèm                  |
|       └──► Theo dõi lịch sử đặt phòng & Thông tin cá nhân                      |
|                                                                                |
|  [ Nhân Viên Lễ Tân ]                                                          |
|       │                                                                        |
|       ├──► Tiếp nhận và Xác nhận đơn đặt phòng                                 |
|       ├──► Xử lý thủ tục Check-in / Cấp phát phòng vật lý                      |
|       ├──► Cập nhật dịch vụ phát sinh vào đơn phòng                            |
|       └──► Thực hiện Check-out, Xác nhận thanh toán & In hóa đơn               |
|                                                                                |
|  [ Quản Trị Viên (Admin) ]                                                     |
|       │                                                                        |
|       ├──► Quản lý danh mục phòng & Cấu hình bảng giá theo hạng                |
|       ├──► Quản trị danh sách nhân viên & Phân quyền truy cập                  |
|       ├──► Quản lý danh mục dịch vụ khách sạn                                 |
|       └──► Dashboard phân tích & Thống kê doanh thu (Ngày / Tuần / Tháng)      |
+--------------------------------------------------------------------------------+

Thiết kế hệ thống

Kiến trúc tổng thể hệ thống (Layered Architecture)

Hệ thống vận hành theo mô hình kiến trúc 3 tầng phân tách:

  1. Presentation Layer (Giao diện người dùng): Ứng dụng Single Page Application (SPA) xây dựng bằng ReactJS v18.2, quản lý trạng thái luồng đặt phòng bằng React Context/Hooks, tích hợp Axios để gửi các HTTP Request bất đồng bộ.
  2. Application & Business Logic Layer (Tầng nghiệp vụ Backend): Sử dụng Golang v1.21, tổ chức theo chuẩn RESTful API. Hệ thống tiếp nhận Request qua Router hiệu năng cao, định tuyến qua các Middleware (JWT Authentication, CORS, Logger, Recovery) trước khi đưa vào Service Layer xử lý nghiệp vụ đặt phòng.
  3. Database Layer (Tầng lưu trữ dữ liệu): Sử dụng PostgreSQL v15.x, tận dụng triệt để các kiểu dữ liệu nâng cao (NUMERIC, VARCHAR, DATE, UUID), cơ chế khóa dòng (Row-Level Locking) và chỉ mục B-tree để tối ưu hóa truy vấn tìm kiếm buồng phòng trống.
       +-------------------------------------------------------------+
       |             CLIENT TIER (ReactJS 18.2 SPA)                 |
       |  [Customer Portal]     [Receptionist UI]     [Admin Hub]    |
       +------------------------------+------------------------------+
                                      | (HTTPS / JSON REST API)
                                      ▼
       +-------------------------------------------------------------+
       |             API GATEWAY & MIDDLEWARE (Golang)               |
       |  - JWT Auth Guard       - Rate Limiting     - CORS Policy   |
       +------------------------------+------------------------------+
                                      |
                                      ▼
       +-------------------------------------------------------------+
       |             BACKEND SERVICES (Golang Engine)                |
       |  - Booking Engine       - Room Manager      - Service Hub   |
       |  - Invoice Engine       - Auth Controller   - Stats Worker  |
       +------------------------------+------------------------------+
                                      | (Connection Pool / GORM)
                                      ▼
       +-------------------------------------------------------------+
       |             DATABASE TIER (PostgreSQL 15.x Engine)          |
       |  - Tables: NhanVien, KhachHang, Phong, LoaiPhong, PhieuDat |
       |  - WAL Logging   - Row-level Locks   - MVCC Isolation       |
       +-------------------------------------------------------------+

Thiết kế cơ sở dữ liệu quan hệ (Relational Database Schema)

Cơ sở dữ liệu được chuẩn hóa đạt chuẩn 3NF (Third Normal Form) nhằm loại bỏ dư thừa dữ liệu và đảm bảo tính toàn vẹn quan hệ:

-- 1. Bảng Loại Phòng
CREATE TABLE LoaiPhong (
    IdLoaiPhong NUMERIC PRIMARY KEY,
    TenLoaiPhong VARCHAR(100) NOT NULL,
    Gia NUMERIC(12, 2) NOT NULL CHECK (Gia >= 0),
    HangPhong VARCHAR(50) NOT NULL
);

-- 2. Bảng Phòng
CREATE TABLE Phong (
    IdPhong NUMERIC PRIMARY KEY,
    IdLoaiPhong NUMERIC NOT NULL REFERENCES LoaiPhong(IdLoaiPhong) ON DELETE RESTRICT,
    SoPhong NUMERIC NOT NULL UNIQUE,
    SoTang NUMERIC NOT NULL,
    TinhTrang VARCHAR(30) DEFAULT 'Trong' CHECK (TinhTrang IN ('Trong', 'DaDat', 'DangSuDung', 'BaoTri'))
);

-- 3. Bảng Khách Hàng
CREATE TABLE KhachHang (
    IdKhachHang NUMERIC PRIMARY KEY,
    TenKhachHang VARCHAR(150) NOT NULL,
    GioiTinh VARCHAR(10),
    NgaySinh DATE,
    Sdt VARCHAR(15) NOT NULL UNIQUE,
    Cmnd VARCHAR(20) NOT NULL UNIQUE,
    DiaChi VARCHAR(255)
);

-- 4. Bảng Nhân Viên
CREATE TABLE NhanVien (
    IdNhanVien NUMERIC PRIMARY KEY,
    TenNhanVien VARCHAR(150) NOT NULL,
    GioiTinh VARCHAR(10),
    NgaySinh DATE,
    Sdt VARCHAR(15) NOT NULL,
    Cmnd VARCHAR(20) NOT NULL UNIQUE,
    DiaChi VARCHAR(255),
    NgayVaoLam DATE DEFAULT CURRENT_DATE
);

-- 5. Bảng Phiếu Đặt Phòng
CREATE TABLE PhieuDatPhong (
    IdPhieuDatPhong NUMERIC PRIMARY KEY,
    IdKhachHang NUMERIC NOT NULL REFERENCES KhachHang(IdKhachHang),
    IdNhanVien NUMERIC REFERENCES NhanVien(IdNhanVien),
    NgayLapPhieu DATE DEFAULT CURRENT_DATE,
    NgayDen DATE NOT NULL,
    NgayTraPhong DATE NOT NULL,
    TinhTrang VARCHAR(30) DEFAULT 'ChoXacNhan' CHECK (TinhTrang IN ('ChoXacNhan', 'DaXacNhan', 'DaNhanPhong', 'DaThanhToan', 'DaHuy')),
    CONSTRAINT chk_ngay_dat CHECK (NgayTraPhong > NgayDen)
);

-- 6. Bảng Chi Tiết Phiếu Đặt Phòng
CREATE TABLE ChiTietPhieuDatPhong (
    IdChiTietPhieuDatPhong NUMERIC PRIMARY KEY,
    IdPhong NUMERIC NOT NULL REFERENCES Phong(IdPhong),
    IdPhieuDatPhong NUMERIC NOT NULL REFERENCES PhieuDatPhong(IdPhieuDatPhong) ON DELETE CASCADE,
    NgayDen DATE NOT NULL,
    NgayTraPhong DATE NOT NULL
);

-- 7. Bảng Dịch Vụ và Phiếu Dịch Vụ
CREATE TABLE DichVu (
    IdDichVu NUMERIC PRIMARY KEY,
    TenDichVu VARCHAR(100) NOT NULL,
    GiaDichVu NUMERIC(12, 2) NOT NULL CHECK (GiaDichVu >= 0)
);

CREATE TABLE PhieuDichVu (
    IdPhieuDichVu NUMERIC PRIMARY KEY,
    IdPhieuDatPhong NUMERIC NOT NULL REFERENCES PhieuDatPhong(IdPhieuDatPhong) ON DELETE CASCADE,
    NgaySuDungDichVu DATE DEFAULT CURRENT_DATE,
    TongTien NUMERIC(12, 2) DEFAULT 0
);

CREATE TABLE ChiTietDichVu (
    IdChiTietDichVu NUMERIC PRIMARY KEY,
    IdPhieuDichVu NUMERIC NOT NULL REFERENCES PhieuDichVu(IdPhieuDichVu),
    IdDichVu NUMERIC NOT NULL REFERENCES DichVu(IdDichVu),
    SoLuong NUMERIC DEFAULT 1 CHECK (SoLuong > 0),
    DonGia NUMERIC(12, 2) NOT NULL
);

Thiết kế RESTful API Specification

Các API được thiết kế theo cấu trúc chuẩn ngữ nghĩa HTTP Status Codes (200 OK, 201 Created, 400 Bad Request, 401 Unauthorized, 409 Conflict, 500 Internal Error):

Phương thức Endpoint URI Phân quyền (Role) Mô tả chức năng
POST /api/v1/auth/login Public Đăng nhập hệ thống, cấp mã JWT Token
POST /api/v1/auth/register Public Đăng ký tài khoản khách hàng mới
GET /api/v1/rooms/available Public / Khách hàng Truy vấn danh sách phòng trống theo khoảng ngày
POST /api/v1/bookings/create Khách hàng / Lễ tân Tạo mới phiếu đặt phòng kèm giao dịch ACID
PUT /api/v1/reception/bookings/{id}/confirm Lễ tân / Admin Xác nhận đơn đặt phòng và khóa phòng vật lý
POST /api/v1/reception/check-in Lễ tân Thực hiện quy trình nhận phòng của khách
POST /api/v1/reception/check-out Lễ tân Tổng hợp tiền phòng + dịch vụ, xuất hóa đơn
GET /api/v1/admin/analytics/revenue Admin Báo cáo doanh thu theo bộ lọc thời gian thực

Phương pháp nghiên cứu và phát triển (Methodology)

Đồ án áp dụng quy trình phát triển phần mềm theo mô hình Agile/Scrum lặp cuốn chiếu với chu kỳ 2 tuần/sprint:

+------------------------------------------------------------------------------------+
|                         LỘ TRÌNH TRIỂN KHAI DỰ ÁN (16 TUẦN)                        |
+--------+------------------------------------------------+--------------------------+
| Giai đoạn | Nội dung công việc chi tiết                   | Kết quả bàn giao (Artifacts) |
+--------+------------------------------------------------+--------------------------+
| Tuần 1-3  | Khảo sát thực tế tại Vinpearl Đà Nẵng, lấy yêu | Tài liệu SRS, Use-case,   |
|        | cầu nghiệp vụ lễ tân, thiết kế ERD & DB        | Sơ đồ DDL PostgreSQL     |
| Tuần 4-7  | Xây dựng Golang REST API backend, cấu hình DB, | Core API Engine, Router, |
|        | triển khai thuật toán kiểm tra phòng trống     | JWT Middleware           |
| Tuần 8-11 | Xây dựng giao diện ReactJS, tích hợp API, làm   | Portal Khách hàng & UI   |
|        | module đặt phòng, quản trị phòng & dịch vụ      | Nghiệp vụ Lễ tân         |
| Tuần 12-14| Tích hợp module Thống kê doanh thu, Kiểm thử   | Báo cáo Test Coverage,   |
|        | Unit test, Integration test, sửa lỗi bảo mật   | Benchmark k6 / ApacheBench |
| Tuần 15-16| Đóng gói hệ thống, nghiệm thu UAT, hoàn thiện   | Đồ án hoàn chỉnh, hướng  |
|        | báo cáo khóa luận tốt nghiệp                    | dẫn triển khai hệ thống  |
+--------+------------------------------------------------+--------------------------+

Implementation và kết quả

Quy trình phát triển và Thuật toán cốt lõi

1. Thuật toán kiểm tra và xử lý đặt phòng chống xung đột (Golang Concurrency Engine)

Để giải quyết triệt để lỗi Overbooking khi nhiều khách hàng cùng đặt một loại phòng vào cùng một khoảng thời gian, Backend Golang sử dụng Transaction với mức cô lập cao kết hợp câu lệnh truy vấn kiểm tra khoảng giao nhau giữa hai khoảng thời gian [NgayDen, NgayTraPhong].

Khoảng thời gian yêu cầu $[A_{start}, A_{end}]$ bị xung đột với khoảng thời gian đã đặt $[B_{start}, B_{end}]$ khi và chỉ khi: $$\max(A_{start}, B_{start}) < \min(A_{end}, B_{end}) \iff (A_{start} < B_{end}) \land (A_{end} > B_{start})$$

Đoạn mã Golang dưới đây xử lý kiểm tra và tạo đơn đặt phòng trong Database Transaction:

package services

import (
	"context"
	"database/sql"
	"errors"
	"time"
)

type BookingRequest struct {
	KhachHangID  int64     `json:"khach_hang_id"`
	PhongID      int64     `json:"phong_id"`
	NgayDen      time.Time `json:"ngay_den"`
	NgayTraPhong time.Time `json:"ngay_tra_phong"`
}

type BookingService struct {
	DB *sql.DB
}

// CreateBookingWithLock xử lý tạo phiếu đặt phòng an toàn đa luồng
func (s *BookingService) CreateBookingWithLock(ctx context.Context, req BookingRequest) (int64, error) {
	// Khởi tạo Transaction với Database
	tx, err := s.DB.BeginTx(ctx, &sql.TxOptions{Isolation: sql.LevelReadCommitted})
	if err != nil {
		return 0, err
	}
	defer tx.Rollback()

	// 1. Kiểm tra xem phòng có bị trùng lịch trong khoảng thời gian yêu cầu hay không
	checkQuery := `
		SELECT COUNT(1) 
		FROM ChiTietPhieuDatPhong ct
		JOIN PhieuDatPhong pdp ON ct.IdPhieuDatPhong = pdp.IdPhieuDatPhong
		WHERE ct.IdPhong = $1 
		  AND pdp.TinhTrang NOT IN ('DaHuy')
		  AND (ct.NgayDen < $3 AND ct.NgayTraPhong > $2)
		FOR UPDATE;
	`
	var conflictCount int
	err = tx.QueryRowContext(ctx, checkQuery, req.PhongID, req.NgayDen, req.NgayTraPhong).Scan(&conflictCount)
	if err != nil {
		return 0, err
	}

	if conflictCount > 0 {
		return 0, errors.New("phòng đã được đặt trong khoảng thời gian này, vui lòng chọn phòng khác")
	}

	// 2. Chèn dữ liệu vào bảng PhieuDatPhong
	var bookingID int64
	insertPDPQuery := `
		INSERT INTO PhieuDatPhong (IdKhachHang, NgayLapPhieu, NgayDen, NgayTraPhong, TinhTrang)
		VALUES ($1, CURRENT_DATE, $2, $3, 'ChoXacNhan')
		RETURNING IdPhieuDatPhong;
	`
	err = tx.QueryRowContext(ctx, insertPDPQuery, req.KhachHangID, req.NgayDen, req.NgayTraPhong).Scan(&bookingID)
	if err != nil {
		return 0, err
	}

	// 3. Chèn dữ liệu vào bảng ChiTietPhieuDatPhong
	insertDetailQuery := `
		INSERT INTO ChiTietPhieuDatPhong (IdPhong, IdPhieuDatPhong, NgayDen, NgayTraPhong)
		VALUES ($1, $2, $3, $4);
	`
	_, err = tx.ExecContext(ctx, insertDetailQuery, req.PhongID, bookingID, req.NgayDen, req.NgayTraPhong)
	if err != nil {
		return 0, err
	}

	// 4. Xác nhận commit transaction
	if err := tx.Commit(); err != nil {
		return 0, err
	}

	return bookingID, nil
}

2. Xây dựng giao diện tìm kiếm và đặt phòng trên ReactJS

Phía Client sử dụng React Hooks (useState, useEffect, useCallback) để quản lý trạng thái tải danh sách phòng và gửi payload đặt phòng an toàn:

import React, { useState, useEffect } from 'react';
import axios from 'axios';

export const RoomSearchComponent = () => {
  const [searchParams, setSearchParams] = useState({
    checkIn: '',
    checkOut: '',
    roomType: 'all'
  });
  const [availableRooms, setAvailableRooms] = useState([]);
  const [loading, setLoading] = useState(false);
  const [errorMessage, setErrorMessage] = useState('');

  const fetchAvailableRooms = async () => {
    if (!searchParams.checkIn || !searchParams.checkOut) return;
    setLoading(true);
    setErrorMessage('');
    try {
      const res = await axios.get('/api/v1/rooms/available', {
        params: {
          start: searchParams.checkIn,
          end: searchParams.checkOut,
          type: searchParams.roomType
        }
      });
      setAvailableRooms(res.data.data || []);
    } catch (err) {
      setErrorMessage(err.response?.data?.message || 'Lỗi khi tải danh mục phòng');
    } finally {
      setLoading(false);
    }
  };

  return (
    <div className="room-search-container p-6 bg-white rounded-lg shadow-md">
      <h2 className="text-xl font-bold mb-4 text-blue-900">Tìm Kiếm Phòng Nghỉ Vinpearl</h2>
      <div className="grid grid-cols-1 md:grid-cols-3 gap-4 mb-4">
        <input 
          type="date" 
          className="border p-2 rounded" 
          value={searchParams.checkIn} 
          onChange={(e) => setSearchParams({...searchParams, checkIn: e.target.value})} 
        />
        <input 
          type="date" 
          className="border p-2 rounded" 
          value={searchParams.checkOut} 
          onChange={(e) => setSearchParams({...searchParams, checkOut: e.target.value})} 
        />
        <button 
          onClick={fetchAvailableRooms} 
          disabled={loading}
          className="bg-blue-600 hover:bg-blue-700 text-white font-medium py-2 px-4 rounded transition"
        >
          {loading ? 'Đang truy vấn...' : 'Kiểm tra phòng trống'}
        </button>
      </div>
      {errorMessage && <div className="text-red-500 mb-4">{errorMessage}</div>}
      <div className="room-grid grid grid-cols-1 md:grid-cols-2 gap-4">
        {availableRooms.map((room) => (
          <div key={room.IdPhong} className="border p-4 rounded shadow-sm hover:shadow">
            <h3 className="font-semibold text-lg">Phòng số: {room.SoPhong} ({room.TenLoaiPhong})</h3>
            <p className="text-gray-600">Giá niêm yết: {new Intl.NumberFormat('vi-VN').format(room.Gia)} VNĐ/đêm</p>
            <span className="inline-block mt-2 px-2 py-1 text-xs bg-green-100 text-green-800 rounded">Trạng thái: Trống</span>
          </div>
        ))}
      </div>
    </div>
  );
};

Kết quả kiểm thử và đánh giá hiệu năng

+------------------------------------------------------------------------------------+
|                      KẾT QUẢ BENCHMARK HIỆU NĂNG HỆ THỐNG API                      |
+------------------------------+---------------------------+-------------------------+
| Chỉ số đo lường (Metrics)    | Mục tiêu đồ án đề ra      | Kết quả thực nghiệm đạt |
+------------------------------+---------------------------+-------------------------+
| Thời gian phản hồi API (p95) | < 100 ms                  | 28.4 ms                 |
| Thông lượng xử lý (Throughput)| > 500 req/s               | 1,240 req/s             |
| Tỷ lệ lỗi dưới tải cao       | < 1.0 %                   | 0.00 % (0/10,000 reqs)  |
| Kiểm thử đơn vị (Coverage)   | > 80 %                    | 87.5 % code coverage    |
| Xung đột đặt phòng đồng thời | 0 trường hợp              | 0 trường hợp ghi nhận   |
+------------------------------+---------------------------+-------------------------+

Hệ thống được kiểm thử tải giả lập thông qua công cụ k6 với kịch bản 500 người dùng đồng thời (Virtual Users) gửi yêu cầu tìm phòng và gửi đơn đặt liên tục trong thời gian 5 phút. Kết quả ghi nhận Backend Golang duy trì mức chiếm dụng CPU dưới 18% và RAM dưới 65MB, cho thấy khả năng tối ưu hóa tài nguyên vượt trội so với các runtime như Node.js hay PHP truyền thống.

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

Đổi mới công nghệ

  1. Kiến trúc phi tập trung hiệu năng cao: Thay vì sử dụng mô hình MVC nguyên khối (Monolith) cổ điển của PHP/Java, đồ án áp dụng kiến trúc tách rời Client-Server hiện đại. Tầng Backend Golang đóng vai trò Stateless API Server gọn nhẹ, cho phép phục vụ hàng ngàn kết nối đồng thời với dung lượng bộ nhớ cực thấp.
  2. Kỹ thuật chống trùng lịch thông minh tại tầng Database: Sử dụng kết hợp giữa toán tử so sánh giao thoa thời gian và khóa bi quan (Pessimistic Locking FOR UPDATE) ngay trong phiên giao dịch của PostgreSQL, triệt tiêu hoàn toàn race condition khi xảy ra tranh chấp phòng.
  3. Mô hình hóa dữ liệu dịch vụ linh hoạt: Bảng PhieuDichVu và ChiTietDichVu được liên kết động với PhieuDatPhong, cho phép khách hàng tại Vinpearl gọi thêm dịch vụ buồng phòng bất kỳ lúc nào mà không cần tạo hóa đơn thanh toán rời.

So sánh với các giải pháp trên thị trường

Tính năng / Đặc tính Hệ thống Quản lý Vinpearl (Đồ án) ezCloudhotel PMS Cloudbeds
Công nghệ nền tảng Golang v1.21 + ReactJS + PostgreSQL .NET / SQL Server Node.js / AWS Aurora
Mức tiêu thụ RAM Server Rất thấp (~60MB - 120MB) Trung bình (~500MB) Cao (~800MB - 1.5GB)
Chi phí bản quyền Miễn phí hoàn toàn (Mã nguồn tự phát triển) ~500.000đ - 2.500.000đ/tháng Từ $150/tháng trở lên
Khả năng làm chủ mã nguồn 100%, dễ dàng mở rộng nội bộ 0% (Dịch vụ SaaS đóng) 0% (Dịch vụ SaaS đóng)
Tốc độ tải trang Client < 0.8 giây (nhờ React Virtual DOM) 1.8 - 3.2 giây 1.5 - 2.5 giây

Đóng góp thực tiễn

  • Cắt giảm 70% thời gian tạo phiếu đặt và check-in tại quầy lễ tân Vinpearl so với ghi chép thủ công.
  • Tiết kiệm 100% chi phí bản quyền phần mềm định kỳ hàng năm cho doanh nghiệp lưu trú khi đưa mã nguồn vào khai thác thực tế.
  • Chuẩn hóa quy trình báo cáo doanh thu: Tự động hóa quá trình tổng hợp số liệu kế toán theo từng ngày, tuần, tháng, giảm thiểu 95% nguy cơ sai lệch số liệu doanh thu.

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

Kịch bản sử dụng thực tế (Use Case Scenarios)

  • Kịch bản 1 (Khách du lịch cá nhân): Khách hàng truy cập website trên điện thoại di động, chọn thời gian lưu trú tại Vinpearl Đà Nẵng từ ngày 15/05 đến ngày 18/05. Hệ thống lọc ra các phòng hạng Suite còn trống. Khách chọn phòng, nhập thông tin cá nhân và tạo phiếu đặt phòng trực tuyến chỉ trong 3 bước (dưới 60 giây).
  • Kịch bản 2 (Lễ tân xử lý đoàn khách nhận phòng): Nhân viên lễ tân đăng nhập vào hệ thống nội bộ, tra cứu mã phiếu đặt phòng, thực hiện đổi trạng thái sang DaNhanPhong, gán thẻ từ và ghi nhận các yêu cầu ăn sáng buffet vào PhieuDichVu.
  • Kịch bản 3 (Tổng kết cuối ca và Check-out): Khi khách trả phòng, hệ thống tự động tổng hợp toàn bộ tiền phòng theo số đêm thực tế và phụ phí dịch vụ đã dùng để in biên lai quyết toán chính xác tuyệt đối.
+------------------------------------------------------------------------------------+
|                       SƠ ĐỒ TRIỂN KHAI HỆ THỐNG VẬN HÀNH                           |
+------------------------------------------------------------------------------------+
|                                                                                    |
|                  [ Users: Desktop / Mobile Browsers ]                              |
|                                    │                                               |
|                                    ▼                                               |
|                 [ Reverse Proxy / Web Server: NGINX ]                              |
|                                    │                                               |
|                    ┌───────────────┴───────────────┐                               |
|                    ▼                               ▼                               |
|         [ Static Assets Storage ]      [ Golang API Daemon ]                       |
|          (ReactJS Built Bundle)       (Port :8080 / Systemd)                       |
|                                                    │                               |
|                                                    ▼                               |
|                                       [ PostgreSQL Database 15 ]                   |
|                                       (Connection Pool: 25 conns)                  |
+------------------------------------------------------------------------------------+

Yêu cầu phần cứng và Hướng dẫn triển khai

  1. Yêu cầu hệ thống tối thiểu (Production Server):
    • CPU: 2 Cores (x86_64 hoặc ARM64).
    • RAM: 2 GB RAM.
    • Dung lượng ổ cứng: 20 GB SSD.
    • Hệ điều hành: Linux Ubuntu 22.04 LTS Server / Debian 12.
  2. Quy trình triển khai 4 bước:
    • Bước 1 (Cấu hình Cơ sở dữ liệu): Cài đặt PostgreSQL 15, khởi tạo Database vinpearl_hotel và chạy tệp kịch bản schema.sql để sinh các bảng cùng quan hệ khóa ngoại.
    • Bước 2 (Build Backend Golang): Biên dịch mã nguồn Go sang tệp thực thi nhị phân: 
      CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o vinpearl-api main.go
    • Bước 3 (Build Frontend ReactJS): Đóng gói ứng dụng web tối ưu hóa dung lượng: 
      npm install && npm run build
    • Bước 4 (Cấu hình Web Server Nginx): Thiết lập Nginx làm Reverse Proxy trỏ cổng 80/443 về thư mục chứa React build và chuyển tiếp prefix /api/v1 sang Golang daemon chạy tại 127.0.0.1:8080.

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

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

  • Chưa tích hợp cổng thanh toán trực tuyến tự động: Hiện tại hệ thống ghi nhận trạng thái thanh toán thông qua xác nhận thủ công của nhân viên lễ tân, chưa kết nối trực tiếp cổng thanh toán như VNPay, MoMo hoặc Stripe Webhook.
  • Chưa có cơ chế đồng bộ đa kênh (Channel Manager): Dữ liệu phòng trống chưa được đồng bộ tự động 2 chiều với các hệ thống phân phối OTA quốc tế.
  • Thông báo thời gian thực: Hiện tại việc cập nhật trạng thái đơn đặt phòng phụ thuộc vào thao tác tải lại dữ liệu hoặc HTTP Polling, chưa triển khai giao thức WebSocket hai chiều.

Hướng phát triển và Nâng cấp

  1. Tích hợp Cổng thanh toán Sandbox VNPay/ZaloPay: Triển khai module chữ ký điện tử HMAC-SHA512 để xử lý thanh toán và sinh mã QR động cho khách hàng.
  2. Triển khai WebSocket / Server-Sent Events (SSE): Cập nhật ngay lập tức sơ đồ phòng cho nhân viên lễ tân khi có khách vừa đặt phòng thành công trên website.
  3. Phát triển ứng dụng di động (Mobile App): Sử dụng React Native để tái sử dụng đến 75% cấu trúc mã nguồn giao diện hiện tại cho hai nền tảng Android và iOS.
  4. Ứng dụng Trí tuệ nhân tạo (AI Engine): Tích hợp thuật toán Dynamic Pricing tự động điều chỉnh giá phòng theo mùa cao điểm và phân tích thói quen của khách hàng để gợi ý combo dịch vụ cá nhân hóa.

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

  • Sinh viên ngành CNTT & Kỹ thuật Phần mềm: Nguồn tài liệu tham khảo thực tế về quy trình phân tích thiết kế hệ thống thông tin hoàn chỉnh, từ sơ đồ Use-case, lược đồ thực thể quan hệ ERD đến triển khai chuẩn 3NF trên PostgreSQL.
  • Lập trình viên (Developers): Nắm bắt kiến trúc kết hợp chuẩn mực giữa Golang (xử lý concurrency, database transactions) và ReactJS (quản lý state, single page application), có thể tái sử dụng mô hình Backend Golang cho các dự án thương mại điện tử hoặc đặt vé.
  • Doanh nghiệp lưu trú, Khách sạn & Nhà nghỉ: Sở hữu một mô hình giải pháp phần mềm quản lý buồng phòng độc lập, vận hành ổn định với chi phí đầu tư hạ tầng máy chủ cực kỳ tiết kiệm (dưới 150.000 VNĐ/tháng cho Cloud VPS).
  • Nhà nghiên cứu ứng dụng: Khung mẫu thực nghiệm đánh giá hiệu năng xử lý đa luồng giữa các ngôn ngữ lập trình biên dịch (Compiled) và thông dịch (Interpreted) trong bài toán quản lý đặt chỗ theo thời gian thực.

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

1. Cấu hình phần cứng tối thiểu để triển khai website đặt phòng là gì?

Hệ thống được tối ưu hóa bằng Golang và PostgreSQL nên yêu cầu tài nguyên rất thấp. Một máy chủ ảo (Cloud VPS) với 1 Core CPU, 1GB RAM và 15GB SSD chạy hệ điều hành Linux Ubuntu là hoàn toàn đủ để phục vụ trơn tru cho một khách sạn có quy mô từ 50 đến 200 phòng với lưu lượng truy cập hàng ngày ổn định.

2. Hệ thống giải quyết bài toán đặt trùng phòng (Overbooking) như thế nào?

Hệ thống giải quyết triệt để lỗi Overbooking nhờ việc sử dụng Transaction với mức độ cô lập dữ liệu cao trong PostgreSQL, kết hợp câu truy vấn kiểm tra xung đột thời gian thực thi lệnh FOR UPDATE (Pessimistic Locking). Bản ghi buồng phòng được khóa tạm thời trong vài mili-giây giao dịch, đảm bảo không có hai người dùng nào có thể đặt cùng một phòng trong cùng một khoảng ngày.

3. Có thể tích hợp website với hệ thống khóa thẻ từ của khách sạn không?

Hoàn toàn có thể. Do Backend Golang được thiết kế theo chuẩn RESTful API, các nhà phát triển chỉ cần xây dựng thêm module giao tiếp (Serial Port / TCP IP SDK) kết nối với đầu đọc/ghi thẻ từ thông dụng tại quầy lễ tân để ghi mã phòng và thời hạn lưu trú trực tiếp vào thẻ khi thực hiện thao tác Check-in.

4. Dữ liệu tài chính và doanh thu được bảo mật như thế nào?

Mọi kết nối dữ liệu được định tuyến qua lớp mã hóa HTTPS/TLS. Quyền truy cập vào báo cáo doanh thu được bảo vệ chặt chẽ bởi cơ chế Role-Based Access Control (RBAC) thông qua mã định danh bảo mật JWT (JSON Web Token). Mật khẩu người dùng được băm an toàn, và cơ sở dữ liệu PostgreSQL kích hoạt cơ chế xác thực SCRAM-SHA-256 chống lại các cuộc tấn công đánh cắp dữ liệu.

5. Chi phí duy trì hệ thống này hàng năm là bao nhiêu so với thuê phần mềm ngoài?

Nếu sử dụng phần mềm SaaS bên ngoài, khách sạn phải chi trả từ 6.000.000 VNĐ đến hơn 30.000.000 VNĐ mỗi năm cho phí thuê bao. Với hệ thống tự chủ xây dựng từ Golang và PostgreSQL mã nguồn mở, doanh nghiệp chỉ cần chi trả chi phí thuê tên miền (Domain) và máy chủ lưu trữ (Cloud VPS) khoảng 1.200.000 - 1.800.000 VNĐ/năm, giúp tiết kiệm hơn 85% chi phí vận hành công nghệ thông tin.

Kết luận

Đồ án tốt nghiệp "Xây dựng website quản lý đặt phòng khách sạn Vinpearl" của sinh viên Lê Bá Nhật đã giải quyết thành công bài toán số hóa toàn diện quy trình vận hành khách sạn. Thông qua việc kết hợp sức mạnh xử lý đa luồng tốc độ cao của Golang, giao diện trực quan linh hoạt của ReactJS và nền tảng dữ liệu toàn vẹn PostgreSQL, đề tài đã cung cấp một sản phẩm ứng dụng hoàn chỉnh, đáp ứng chuẩn mực kỹ thuật và tính khả thi thương mại cao.

Hệ thống không chỉ loại bỏ các hạn chế cố hữu của phương thức quản trị buồng phòng truyền thống mà còn mở ra nền tảng công nghệ vững chắc để tiếp tục mở rộng các tính năng nâng cao như thanh toán trực tuyến tự động và tích hợp trí tuệ nhân tạo trong tương lai. Đây là tài liệu tham khảo giá trị và là giải pháp chuyển đổi số thiết thực cho các doanh nghiệp trong ngành lưu trú du lịch.