BookAFaci

Facility and Equipment Booking System

Streamlining reservations for Ateneo De Naga University's Physical Plant Administration

---

📖 About

BookAFaci is a comprehensive booking management system designed to streamline facility and equipment reservations at Ateneo De Naga University. The platform provides an efficient, user-friendly interface for managing all reservation needs with real-time availability tracking.

✨ Key Features

• 🏢 Facility Management - Browse and book university facilities with real-time availability, capacity information, and amenities
• 🎛️ Equipment Reservation - Reserve equipment like projectors, sound systems, and other resources with availability tracking
• 📅 Real-time Calendar - Interactive calendar
• 🔒 Secure Authentication - Role-based access control for internal and external users with JWT authentication
• 📊 Admin Dashboard - Comprehensive admin panel for managing bookings, users, facilities, and equipment with statistics tracking
• 📱 Mobile Responsive - Fully responsive design optimized for desktop, tablet, and mobile devices
• ✅ Comprehensive Booking Management - Create, edit, and cancel bookings with status tracking (pending, approved, completed, cancelled)

🛠️ Tech Stack

Frontend:

• React 18
• Tailwind CSS
• React Router
• Axios
• React Toastify

Backend:

• Node.js
• Express.js
• MongoDB with Mongoose
• JWT Authentication

Deployment:

• Vercel

👥 Development Team

Frances Yvonne P. Madera Backend Developer

Irene B. Artiaga Backend Developer

Jeremiah Martin D. Lirag Frontend Developer

Marijoe R. San Juan Frontend Developer

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• MongoDB
• npm or yarn

Installation

1. Clone the repository

git clone https://github.com/Irene050/BookAFaci.git
cd BookAFaci

2. Install backend dependencies

cd backend
npm install

3. Install frontend dependencies

cd ../frontend/BookAFaci
npm install

4. Set up environment variables

# Backend (.env)
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret

# Frontend (.env)
VITE_API_URL=your_backend_api_url

5. Run the application

# Backend
cd backend
npm start

# Frontend (in a new terminal)
cd frontend/BookAFaci
npm run dev

📝 License

This project is licensed under the MIT License.

---

"It's always easy with BookAFaci"

© 2024 BookAFaci. All rights reserved.