System Requirements Document (SRD)

Project Title: steel-hotel

1. Introduction

The steel-hotel project is an AI-Enhanced Hotel Management System designed to streamline hotel operations and enhance user experience through cutting-edge AI features. This system caters to both customers and administrators, offering functionalities such as secure authentication, room booking, personalized recommendations, and advanced analytics. The project is tailored for Aryan, based in India (IN), ensuring locale-specific defaults such as INR currency, IST timezone, and culturally relevant design elements.

This document outlines the system requirements, design, and implementation plan for the steel-hotel project, ensuring it meets academic standards for a final-year B.Tech submission and is suitable for real-world deployment.

2. System Overview

The steel-hotel system is a web-based application with mobile compatibility, designed to manage hotel operations efficiently. It includes:

• Customer Features: Room browsing, booking, chatbot assistance, and personalized recommendations.
• Admin Features: Room management, booking oversight, analytics, and report generation.
• AI Integration: NLP chatbot, recommendation system, and demand forecasting.
• Secure Authentication: Role-based access control for admins and customers.

The system architecture follows a modular design, ensuring scalability, security, and ease of maintenance.

3. Functional Requirements

Customer Features

• As a User, I should be able to sign up and log in securely.
• As a User, I should be able to browse available rooms with details.
• As a User, I should be able to book or reserve rooms.
• As a User, I should be able to view my booking history.
• As a User, I should be able to chat with an AI chatbot for queries.
• As a User, I should receive personalized room recommendations.

Admin Features

• As an Admin, I should be able to log in securely.
• As an Admin, I should be able to add, update, or delete room listings.
• As an Admin, I should be able to manage bookings and customer data.
• As an Admin, I should be able to view analytics (revenue, occupancy).
• As an Admin, I should be able to generate reports (PDF invoices).

4. User Personas

1. Admin

• Role: Manages hotel operations.
• Responsibilities: Room management, booking oversight, analytics, and report generation.
• Access Level: Full access to admin dashboard and system settings.

2. Customer

• Role: Books rooms and interacts with the system.
• Responsibilities: Browsing rooms, booking, viewing history, and interacting with the AI chatbot.
• Access Level: Limited access to user dashboard.

5. Visuals Colors and Theme

Color Palette

The steel-hotel project adopts a sleek and modern theme inspired by steel and luxury. The colors are designed to evoke professionalism and comfort.

• Background: #F5F5F5 (Soft Silver Gray)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Dark Charcoal Gray)
• Accent: #0077B6 (Steel Blue)
• Muted Tones: #B0BEC5 (Muted Steel Gray)

6. Signature Design Concept

Floating Room Selector

The homepage of steel-hotel will feature a 3D interactive room selector. Users will see a floating map of the hotel, where each room is represented as a glowing node. Hovering over a node will display room details (price, amenities, availability) in a sleek pop-up. Clicking on a node will initiate the booking process.

Details:

• Animation: Nodes gently pulse and glow, creating a futuristic feel.
• Interaction: Smooth transitions when hovering or clicking.
• Color Shifts: Nodes change color based on availability (green for available, red for booked).
• Micro-Interactions: Subtle sound effects and haptic feedback (for mobile users).

This design ensures the homepage is visually captivating and sets the tone for a luxurious experience.

7. Non-Functional Requirements

• Performance: The system should handle up to 10,000 concurrent users.
• Security: Implement bcrypt for password hashing and JWT for authentication.
• Scalability: Modular architecture to support future features.
• Localization: Default currency set to INR and timezone to IST.
• Usability: Intuitive UI for both admins and customers.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL (preferred for structured data)
• Alembic for migrations

AI Models

• GPT 5.4 for user-friendly responses
• Gemini 3.1 Pro for recommendations
• Google Nano Banana for image generation

AI Tools

• LangChain
• LiteLLM for LLM routing

Orchestration

• Docker for local orchestration
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

Assumptions

• Users will have access to stable internet connections.
• Admins will have basic technical knowledge to operate the dashboard.
• The system will primarily target mid-sized hotels in India.

Constraints

• Budget limitations may restrict advanced AI features.
• Deployment will be limited to cloud platforms supporting Kubernetes.

10. Glossary

• NLP: Natural Language Processing, used for AI chatbot interactions.
• JWT: JSON Web Token, a secure method for authentication.
• RBAC: Role-Based Access Control, defines user permissions.
• RDBMS: Relational Database Management System, used for structured data storage.
• API: Application Programming Interface, enables communication between system components.

This SRD provides a comprehensive foundation for the steel-hotel project. Let me know if you'd like to proceed with user flows, system architecture, or coding!