Files
Hotel-Booking/docs/tasks-admin.md
Iliyan Angelov 93d4c1df80 update
2025-11-16 15:12:43 +02:00

208 lines
4.2 KiB
Markdown

# 🏨 Hotel Management & Booking System
## Admin Analysis Document (SRS Admin Analysis)
---
## 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. Admin Functionality Analysis
---
## 2.1 Setup Module (System Setup)
### 2.1.1 Setup Rooms (Room Management)
**User Roles:** Manager, Admin
**Functions:**
- Add new room
- Edit room information
- Delete room *(only when room has no bookings)*
- Upload room images
**Room Information:**
- RoomID
- Description
- Type (VIP, DELUX, SUITE, …)
- Size (Single, Double, …)
- Price
- Pictures
**Rules:**
- Validate all data when adding/editing
- Do not allow deletion of rooms that have bookings
---
### 2.1.2 Setup Services (Service Management)
**Roles:** Manager, Admin
**Functions:**
- Add service
- Edit
- Delete service
**Service Information:**
- Service ID
- Service Name
- Description
- Unit (hour, portion, time, …)
- Price
**Rules:**
- Validate all input data
---
### 2.1.3 Promotion Management
**Roles:** Manager, Admin
**Functions:**
- Add promotion
- Edit promotion
- Delete promotion
- Promotion can be applied by code or automatically in booking
**Information:**
- ID
- Name
- Description
- Value (percentage or fixed amount)
---
# 2.2 Operation Module (Hotel Operations)
---
## 2.2.1 Booking Management
**Roles:** Staff, Manager, Admin
**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
**Roles:** Staff, Manager
**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 (Guest Service Registration)
**Roles:** Staff
**Functions:**
- Register services for guests based on Room Number
- Print ticket if requested
---
## 2.2.4 Check-out
**Roles:** Staff, Manager
**Functions:**
- Calculate:
- Room fee
- Service fee
- Other surcharges
- Create invoice
- Deduct deposit amount (booking value)
- Guest pays remaining amount
---
# 2.3 Report Module
**Roles:** Manager, Admin
**Functions:**
- Enter time range From → To
- List all bookings within the time range
- Calculate total revenue
- Export reports:
- Excel
- PDF
**Report Content:**
- Booking ID
- Customer Name
- Room
- Total Amount
- Booking Date
- Status
- Revenue Summary
---
# 2.4 System Administration Module
---
## 2.4.1 User Management
**Roles:** Admin
**Functions:**
- Add user
- Edit user
- Delete user
- View user detail
- List all users
- Assign role (Admin, Manager, Staff)
---
## 2.4.2 Security
**System Security Functions:**
### Defined Roles:
| Role | Permissions |
|------|-------|
| **Customer** | No login required |
| **Staff (Sale)** | Access Operation Module |
| **Manager** | Access Setup Module |
| **Admin** | Full access, including User & Security |
### Security Rules:
- Staff & admin must login
- Operation permissions depend on role
- Session timeout after 30 minutes of inactivity
---
# 3. Summary from Admin Perspective
| Module | Admin Permissions | Content |
|--------|-------------|----------|
| 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. 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.