Skip to content

spcfictdu/hrbms-frontend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

244 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Hotel Room and Booking Management System

🏨 Introduction

A comprehensive Vue.js-based solution for hotel operations, providing seamless booking management, guest services, transaction processing, and reporting capabilities.

πŸš€ Key Features

  • πŸ›οΈ Room inventory management and availability tracking
  • 🧳 Guest-facing booking portal with self-service options
  • πŸ‘¨β€πŸ’Ό Staff dashboard for booking administration
  • πŸ’³ Integrated payment processing system
  • πŸ“Š Comprehensive reporting and analytics
  • πŸ“± Responsive design for all devices

πŸ› οΈ Technologies Used

Vue.js Vuetify JavaScript Node.js HTML5 CSS3

πŸ“¦ Prerequisites

1. Required Software

2. πŸ”§ Configuration and Connectivity Setup

βœ… Critical Configuration Checklist

Configuration File / Location Action Required
API Endpoint urls.js βœ… Set the correct backend API endpoint
Backend URL main.js 🌐 Set the correct backend hosting: deployed, local, network
Backend Connectivity hrbms-backend πŸ”— Ensure complete integration and successful communication

⚠️ Common Pitfalls

Misconfiguration can lead to:

  • API connection failures
  • Image loading issues
  • Data synchronization issues

πŸ’‘ Best Practices

  • Double-check all endpoint URLs
  • Test all connections in a staging environment before production
  • Avoid hardcoding sensitive data; use the designated configuration files

πŸ—οΈ Project Architecture

hrbms-frontend/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ assets/                 # Static assets like images, svgs
β”‚   β”œβ”€β”€ components/             # Reusable Vue components
β”‚   β”œβ”€β”€ mixins/                 # Vue Mixins
β”‚   β”œβ”€β”€ plugins/                # Vue plugins configuration
β”‚   β”œβ”€β”€ router/                 # Application routing
β”‚   β”œβ”€β”€ store/                  # Vuex state management
β”‚   β”œβ”€β”€ utils/                  # Helper functions and utilities
β”‚   β”œβ”€β”€ views/                  # Page components
β”‚   β”œβ”€β”€ App.vue                 # Root component
β”‚   └── main.js                 # Entry point
└── public/                     # Public static assets

The application follows a modular architecture with clear separation of concerns:

  • Presentation Layer: Vue.js components and Vuetify UI framework
  • State Management: Centralized Vuex store for application data
  • Service Layer: API integration and third-party services
  • Utility Layer: Helper functions and shared logic

πŸš€ Project Setup

Install Dependencies

npm install  # πŸ“¦ Installs all required node modules

Available Commands

Command Description
npm run serve πŸ”§ Start in development mode with hot-reload
npm run build πŸ“¦ Build for production (minified and optimized)
npm run lint 🧹 Lint and fix code issues

πŸ” Troubleshooting Guide

API Connection Issues

Issue Solution
API timeout errors Check network connectivity and backend server status
Authentication failures Verify correct API credentials in urls.js
CORS errors Ensure backend has proper CORS configuration for your domain
Data synchronization issues Check local storage quota and clear cache if necessary
Image loading issues Verify correct API endpoint in url urls.js

πŸ“‹ Commit Message Guidelines

Use the following emojis to indicate the nature of your commits:

Emoji Code Description
πŸ’― :100: Full functionality implementation
πŸ”§ :wrench: Code improvement / refactor
πŸ› :bug: Bug fix
πŸ“‘ :bookmark_tabs: Documentation and comments
β˜• :coffee: Minor or initial changes
🚧 :construction: Work in progress
πŸ—‘οΈ :wastebasket: Code or file deletion
πŸ““ :notebook: README updates
✏️ :pencil2: Typo or naming corrections
♻️ :recycle: Code refactoring
πŸ”€ :twisted_rightwards_arrows: Branch merge
βͺ :rewind: Reverting changes
πŸ“± :iphone: Responsive design changes
πŸ“Œ :pushpin: Hotfixes

🀝 Contributing Guidelines

Branch Naming

  • developer: For main development
  • feature/feature-name: For new features
  • hotfix/issue-name: For critical fixes
  • release/version: For release preparation

Code Style

  • Follow Vue.js style guide
  • Use ESLint configuration
  • Write meaningful comments

πŸ”’ Security Considerations

  • All API requests must use HTTPS
  • Sensitive data must be encrypted at rest and in transit
  • User authentication tokens should be stored securely
  • Implement proper input validation to prevent injection attacks
  • Regular security audits are conducted on the codebase

For security issues, please contact the security team at spcf.ictdu@spcf.edu.ph.

πŸ‘₯ Development Team

  • πŸ‘¨β€πŸ’» Gabriel Alfonso M. Gatbonton - Senior Frontend Developer
  • πŸ‘¨β€πŸ’» Prince Charles M. Clemente - Senior Frontend Developer
  • πŸ‘¨β€πŸ’» Rhymeses E. Cortez - Junior Frontend Developer

About

🏨 Modern hotel management system built with Vue.js and Vuetify. Features room management, guest booking portal, staff administration, payment processing, and reporting tools. Streamlines hotel operations from reservation to checkout.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors