SPOSCHEDULE

Описание проекта

Веб-приложение для управления расписанием занятий в колледже позволяет пользователям (администраторам, преподавателям и студентам) эффективно создавать, редактировать и просматривать расписание пар. Оно поддерживает гибкую настройку расписаний, их изменение по дням недели, отображение информации о корпусах, группах и преподавателях.

Приложение включает несколько основных функций, таких как логирование действий, контроль доступа, экспорт расписания в PDF и поддержка изменений в расписании на конкретные даты и т.д.

Проект создавался с учетом спицифики работы Рязанского Колледжа Электроники.

Технологии

Backend

• PHP (Laravel 11) — серверная логика и API.
• PostgreSQL — база данных для хранения информации.
• Docker — контейнеризация приложения для упрощения развертывания.

Frontend

• Vue.js — динамическое взаимодействие с пользователем, поддержка реактивных данных.
• PrimeVue — UI библиотека готовых компонентов.
• TailwindCSS — CSS-фреймворк.
• TanStack Query v5 — для управления асинхронным состоянием приложения
• HTML5, CSS3, JavaScript — для разработки пользовательского интерфейса.

DevOps

• GitHub Actions — для CI/CD.
• Docker Compose — для развертывания приложения.

Установка и запуск

Требования

• Docker и Docker Compose

Инструкции по установке

1. Клонируйте репозиторий:

   git clone ссылка_на_этот_репозиторий
   

2. Перейдите в директорию проекта:

   cd sposchedule
   

3. Настройте файл окружения .env:

   cp .env.example .env
   

   Настройте параметры подключения к базе данных и другие переменные окружения.

4. Соберите и запустите контейнеры:

   docker-compose -f docker-compose.prod.yml up -d --build
   

5. Подключитесь к контейнеру app (docker exec -it название_контейнера bash) и выполните миграции и заполните таблицу (только при первом развертывании):

   php artisan migrate --seed
   

6. Приложение будет доступно на порту, указанном в docker-compose.prod.yml.

Использование

• Для входа в систему администратору потребуется учетная запись, которая создалась во время заполнения БД (сидинга).
• Расписание можно управлять через веб-интерфейс, который доступен после авторизации.

Лицензия

Приложение распространяется по лицензии Apache License 2.0.

Авторы

• GreenBabyBorn - Основной разработчик

Если у вас есть вопросы или предложения, пожалуйста, свяжитесь с нами.