01
Tình trạng phòng
Tồn kho theo ngày kết nối loại phòng, phòng cụ thể và khoảng lưu trú.
The Sailing Bay · 2025
Hotel
Management.
Đồ án capstone Django đã hoàn thành, xây dựng một monolith server-rendered với SQLite cho đặt phòng, tồn kho, hủy phòng và quản trị, kèm một trợ lý kiến thức theo hướng RAG.
DjangoPythonSQLiteServer-renderedRAGFAISS
Xem mã nguồn 
2025.10 → 12
Thời gian phát triển
6
Focused tests
SQLite
Cơ sở dữ liệu
Đã hoàn thành
Trạng thái capstone
Phạm vi đã xác minh
Một hệ thống đặt phòng có ranh giới rõ ràng.
02
Đặt phòng
Vòng đời đặt phòng bao gồm tạo đặt chỗ, từ chối trùng lịch và hủy phòng.
03
Tồn kho
Signal đặt phòng giảm tồn kho và thao tác hủy khôi phục các dòng liên quan.
04
Luồng tài khoản
Người dùng đã xác thực có thể sử dụng luồng hồ sơ và lịch sử đặt phòng.
05
Vận hành nhân viên
Tổng hợp dashboard và thao tác check-in hoặc check-out hỗ trợ quyền nhân viên.
06
Trợ lý khách sạn
Một luồng RAG chuẩn bị kiến thức khách sạn trước khi tạo phản hồi từ LLM.
Kiến trúc
MVT ở lõi, RAG ở một ranh giới riêng.
Django MVT monolithURL configuration → views and ORM → server-rendered templates
↓ Domain workflows
Booking domainRooms · inventory · reservations · cancellations
SQLiteUsers · rooms · dates · booking records
Selected ORM loadingConcrete select_related usage in targeted queries
↓ Knowledge retrieval path
Knowledge base → HuggingFace embeddings → FAISS → retrieved context → LLM responseGroq cloud path or optional local LlamaCpp / Phi-4 path
Hai đường provider là các lựa chọn riêng trong code. Không có automatic fallback, async inference hoặc bằng chứng về runtime AI production.
Quyết định kỹ thuật
Tính nhất quán trước các con số đẹp.
01
transaction.atomic và select_for_update bao quanh phần kiểm tra xung đột đặt phòng được ghi nhận.
02
Signal đặt phòng giảm tồn kho theo khoảng lưu trú, còn thao tác hủy khôi phục các dòng tồn kho liên quan.
03
Việc tải quan hệ ở một số truy vấn được trình bày như kỹ thuật ORM cụ thể, không phải tuyên bố tối ưu query toàn hệ thống.
Dấu mốc repository
Được phát triển qua ba mốc rõ ràng.
2025.10.28Commit đầu tiên của repository
2025.11.19Commit phiên bản hoàn thiện
2025.12.04Thêm tích hợp Groq
Bằng chứng kiểm thử
Sáu test tập trung vào hành vi cốt lõi.
Baseline hiện có bao phủ tạo booking và giảm tồn kho, từ chối overlap, khôi phục khi hủy, ownership của user, input chatbot bị thiếu và lỗi chatbot đã được sanitize.
python manage.py checkpython manage.py testCác test mock boundary của chatbot và không gọi provider AI bên ngoài. Đây là baseline có ý nghĩa, không phải comprehensive coverage.
Giới hạn bằng chứng hình ảnh
Không dựng bằng chứng từ những gì chưa có.
Repository chưa lưu screenshot của booking/search, room detail, admin dashboard hoặc chatbot. Các ảnh phòng và dịch vụ chỉ là content imagery, không phải ảnh chụp UI.
Cần chụp lại
Booking/search, room detail, admin, chatbot
Sẵn sàng hỗ trợ
Room and service gallery content
Không dùng
ERD stale và media đã loại bỏ
Quyền sở hữu
Student Project Owner / Maintainer
Chủ dự án chịu trách nhiệm về yêu cầu, hướng capstone, quyết định tính năng, kiểm thử và bàn giao học thuật. AI hỗ trợ implementation, refactoring, đề xuất kiến trúc, debugging và testing assistance.