This commit is contained in:
Iliyan Angelov
2025-11-16 15:12:43 +02:00
parent 824eec6190
commit 93d4c1df80
54 changed files with 1606 additions and 1612 deletions

View File

@@ -1,30 +1,30 @@
# 🏨 Hotel Management & Booking System
## Bản Phân Tích Dành Cho Admin (SRS Admin Analysis)
## Admin Analysis Document (SRS Admin Analysis)
---
## 1. Giới thiệu
Tài liệu này phân tích các yêu cầu từ SRS của hệ thống **Hotel Management & Booking Online (e-Hotel)**, tập trung hoàn toàn vào phần **Admin / Manager / Staff** (không bao gồm khách hàng).
Mục tiêu là nắm rõ các chức năng quản trị, vận hành và bảo mật của hệ thống.
## 1. Introduction
This document analyzes the requirements from the SRS of the **Hotel Management & Booking Online (e-Hotel)** system, focusing entirely on the **Admin / Manager / Staff** section (excluding customers).
The goal is to understand the administration, operation, and security functions of the system.
---
# 2. Phân tích chức năng dành cho Admin
# 2. Admin Functionality Analysis
---
## 2.1 Setup Module (Thiết lập hệ thống)
## 2.1 Setup Module (System Setup)
### 2.1.1 Setup Rooms (Quản lý phòng)
**Vai trò sử dụng:** Manager, Admin
### 2.1.1 Setup Rooms (Room Management)
**User Roles:** Manager, Admin
**Các chức năng:**
- Thêm mới phòng
- Chỉnh sửa thông tin phòng
- Xoá phòng *(chỉ khi phòng chưa có booking)*
- Upload hình ảnh phòng
**Functions:**
- Add new room
- Edit room information
- Delete room *(only when room has no bookings)*
- Upload room images
**Thông tin phòng gồm:**
**Room Information:**
- RoomID
- Description
- Type (VIP, DELUX, SUITE, …)
@@ -32,114 +32,114 @@ Mục tiêu là nắm rõ các chức năng quản trị, vận hành và bảo
- Price
- Pictures
**Quy tắc:**
- Validate toàn bộ dữ liệu khi thêm/sửa
- Không cho xoá phòng đã phát sinh booking
**Rules:**
- Validate all data when adding/editing
- Do not allow deletion of rooms that have bookings
---
### 2.1.2 Setup Services (Quản lý dịch vụ)
**Vai trò:** Manager, Admin
### 2.1.2 Setup Services (Service Management)
**Roles:** Manager, Admin
**Chức năng:**
- Thêm dịch vụ
- Chỉnh sửa
- Xoá dịch vụ
**Functions:**
- Add service
- Edit
- Delete service
**Thông tin dịch vụ:**
**Service Information:**
- Service ID
- Service Name
- Description
- Unit (giờ, suất, lần,…)
- Unit (hour, portion, time, …)
- Price
**Quy tắc:**
- Validate tất cả dữ liệu nhập
**Rules:**
- Validate all input data
---
### 2.1.3 Promotion Management (Quản lý khuyến mãi)
**Vai trò:** Manager, Admin
### 2.1.3 Promotion Management
**Roles:** Manager, Admin
**Chức năng:**
**Functions:**
- Add promotion
- Edit promotion
- Delete promotion
- Promotion có thể áp dụng bằng code hoặc tự động trong booking
- Promotion can be applied by code or automatically in booking
**Thông tin:**
**Information:**
- ID
- Name
- Description
- Value (phần trăm hoặc số tiền)
- Value (percentage or fixed amount)
---
# 2.2 Operation Module (Vận hành khách sạn)
# 2.2 Operation Module (Hotel Operations)
---
## 2.2.1 Booking Management
**Vai trò:** Staff, Manager, Admin
**Roles:** Staff, Manager, Admin
**Chức năng:**
- Tìm booking theo tên khách, số booking, ngày đặt
- Xem chi tiết booking
- Xem bill dịch vụ
- Xử lý yêu cầu:
- Hủy booking
**Functions:**
- Search booking by guest name, booking number, booking date
- View booking details
- View service bill
- Process requests:
- Cancel booking
- Checkout
---
## 2.2.2 Check-in
**Vai trò:** Staff, Manager
**Roles:** Staff, Manager
**Quy trình check-in:**
- Khách xuất trình Booking Number
- Nhân viên kiểm tra thông tin booking
- Nhập thông tin từng khách trong phòng
- Gán số phòng thực tế
- Thu thêm phí nếu có trẻ em hoặc extra person
**Check-in Process:**
- Guest presents Booking Number
- Staff verifies booking information
- Enter information for each guest in the room
- Assign actual room number
- Collect additional fees if there are children or extra persons
---
## 2.2.3 Use Services (Khách đăng ký sử dụng dịch vụ)
**Vai trò:** Staff
## 2.2.3 Use Services (Guest Service Registration)
**Roles:** Staff
**Chức năng:**
- Đăng ký dịch vụ cho khách dựa trên Room Number
- In ticket nếu có yêu cầu
**Functions:**
- Register services for guests based on Room Number
- Print ticket if requested
---
## 2.2.4 Check-out
**Vai trò:** Staff, Manager
**Roles:** Staff, Manager
**Chức năng:**
- Tính toán:
- Phí phòng
- Phí dịch vụ
- Phụ phí khác
- Tạo hóa đơn (Invoice)
- Khấu trừ tiền đã đặt cọc (booking value)
- Khách thanh toán phần còn lại
**Functions:**
- Calculate:
- Room fee
- Service fee
- Other surcharges
- Create invoice
- Deduct deposit amount (booking value)
- Guest pays remaining amount
---
# 2.3 Report Module (Báo cáo)
# 2.3 Report Module
**Vai trò:** Manager, Admin
**Roles:** Manager, Admin
**Chức năng:**
- Nhập khoảng thời gian From → To
- Liệt kê toàn bộ booking trong khoảng thời gian
- Tính tổng doanh thu
- Xuất báo cáo:
**Functions:**
- Enter time range From → To
- List all bookings within the time range
- Calculate total revenue
- Export reports:
- Excel
- PDF
**Nội dung báo cáo:**
**Report Content:**
- Booking ID
- Customer Name
- Room
@@ -150,58 +150,58 @@ Mục tiêu là nắm rõ các chức năng quản trị, vận hành và bảo
---
# 2.4 System Administration Module (Quản trị hệ thống)
# 2.4 System Administration Module
---
## 2.4.1 User Management
**Vai trò:** Admin
**Roles:** Admin
**Chức năng:**
**Functions:**
- Add user
- Edit user
- Delete user
- View user detail
- List tất cả user
- n role (Admin, Manager, Staff)
- List all users
- Assign role (Admin, Manager, Staff)
---
## 2.4.2 Security
**Chức năng bảo mật của hệ thống:**
**System Security Functions:**
### Roles được định nghĩa:
| Role | Quyền |
### Defined Roles:
| Role | Permissions |
|------|-------|
| **Customer** | Không cần login |
| **Staff (Sale)** | Truy cập Operation Module |
| **Manager** | Truy cập Setup Module |
| **Admin** | Toàn quyền, bao gồm User & Security |
| **Customer** | No login required |
| **Staff (Sale)** | Access Operation Module |
| **Manager** | Access Setup Module |
| **Admin** | Full access, including User & Security |
### Quy tắc bảo mật:
- Nhân viên & admin bắt buộc phải login
- Quyền thao tác phụ thuộc vào role
- Session timeout sau 30 phút không hoạt động
### Security Rules:
- Staff & admin must login
- Operation permissions depend on role
- Session timeout after 30 minutes of inactivity
---
# 3. Tóm tắt theo góc nhìn Admin
# 3. Summary from Admin Perspective
| Module | Quyền Admin | Nội dung |
| Module | Admin Permissions | Content |
|--------|-------------|----------|
| Room Setup | Full | CRUD phòng |
| Service Setup | Full | CRUD dịch vụ |
| Promotion Setup | Full | CRUD khuyến mãi |
| Booking Management | Full | Xem, duyệt, hủy booking |
| Check-in / Check-out | Full | Quản lý vận hành |
| Service Usage | Full | Ghi log dịch vụ |
| Reports | Full | Thống kê, xuất file |
| User Management | Full | Quản lý nhân viên |
| Security | Full | Role, phân quyền |
| Room Setup | Full | CRUD rooms |
| Service Setup | Full | CRUD services |
| Promotion Setup | Full | CRUD promotions |
| Booking Management | Full | View, approve, cancel bookings |
| Check-in / Check-out | Full | Operations management |
| Service Usage | Full | Service logging |
| Reports | Full | Statistics, export files |
| User Management | Full | Staff management |
| Security | Full | Roles, permissions |
---
# 4. Kết luận
Phân tích trên giúp xác định đầy đủ các chức năng cần triển khai cho **Admin / Manager / Staff** trong hệ thống quản lý khách sạn.
Tài liệu có thể được sử dụng để xây dựng database, API, UI/UX, và phân quyền hệ thống.
# 4. Conclusion
The above analysis helps identify all the functions that need to be implemented for **Admin / Manager / Staff** in the hotel management system.
This document can be used to build the database, API, UI/UX, and system permissions.