🕒 School Timetable Management System

Welcome to the Timetable Management System! This project is designed to help schools efficiently manage their schedules and bell timings. It consists of two main modules: one for managing class schedules and another for managing bell timings.

🔧 Features

Schedule Management Module

• 🔎 Quick Access to Lessons: View a list of all lessons for fast navigation.
• 📅 Weekly Schedule Table: Organized table showing lessons for each day of the week.
• 🔒 Backup and Restore: Create backups of the schedule table and restore it when needed.

Bell Management Module

• 🎯 Manually Triggered Events: Start custom events (e.g., meetings, announcements) on demand.
• ⏰ Timed Events (Automatic): Schedule recurring or one-time events such as daily notifications or special meetings.
• 🔔 Bell Table Automation: Define a bell timetable to automatically play sounds when classes start and end.
• 🎶 Playlist Integration: Play music or audio from a third-party API (e.g., for breaks or background music).

🛠️ Technology Stack

• 🖥️ ASP.NET Core Web API: A powerful framework for building web APIs.
• ⚡ SignalR: For real-time communication features.
• 🗄️ MongoDB: A NoSQL database for efficient data storage and retrieval.
• 🌐 Blazor: A powerful frontend framework for building web UI applications.

🐋 DockerHub Repositories

• 🖥️ Frontend: Frontend Repository
• 🔧 API: API Repository

🚀 Deployment Instructions

To deploy the Timetable Management System, follow these steps.

Prerequisites:

• Ensure you have Docker and docker-compose installed on your server.

Steps to Deploy:

1. Create a docker-compose.yml file in the desired directory with the following content:

      services:
     mongo:
       image: mongo
       ports:
         - "27017:27017"
       volumes:
         - mongo-data:/data/db
       networks:
         - custom-network
   
     timetable.api:
       image: xoggas/timetable.api
       build:
         context: .
         dockerfile: Timetable.Api/Dockerfile
       ports:
         - "5000:8080"
       depends_on:
         - mongo
       networks:
         - custom-network
       environment:
         - ASPNETCORE_ENVIRONMENT=Production
       volumes:
         - sound-files:/app/SoundFiles
     
     timetable.frontend:
       image: xoggas/timetable.frontend
       ports:
         - "80:8080"
       depends_on:
         - timetable.api
       build:
         context: .
         dockerfile: Timetable.Frontend/Dockerfile
       networks:
         - custom-network
       environment:
         - ASPNETCORE_ENVIRONMENT=Production
         - SOUND_API_URL=http://localhost:5000/api/bells-schedule/sound-file/
         - BG_API_URL=http://localhost:5000/api/random-background-image
         - TZ=Europe/Moscow
   
   networks:
     custom-network:
       external: false
   
   volumes:
     mongo-data:
     sound-files:

2. Deploy the application using docker-compose:

   docker-compose up -d

3. Access the application:

   • Frontend: Open your browser and go to http://your-server-ip.
   • API: The API is accessible at http://your-server-ip:5000.

Stopping the Application:

To stop the services, run:

docker-compose down

License

This project is licensed under the MIT License. See the LICENSE file for more details.