Respect APT 🎓✨

Respect APT — это система управления репутацией студентов, которая позволяет учителям добавлять или уменьшать репутацию студентов. Студенты также могут использовать свою репутацию для снятия пропусков или прогулов. 🚀

---

🛠 Технологии

Backend 🖥️

• NestJS � — фреймворк для построения серверных приложений на Node.js.
• Bcrypt 🔐 — библиотека для хеширования паролей.
• Class-validator ✅ — библиотека для валидации данных.
• Cookie-parser 🍪 — middleware для работы с cookies.
• ExcelJS 📊 — библиотека для работы с Excel файлами.
• Multer 📁 — middleware для обработки файлов.
• Passport 🛂 — библиотека для аутентификации.
• Passport-jwt 🔑 — стратегия для аутентификации через JWT.
• Swagger-ui-express 📜 — инструмент для документации API.

Frontend 🖼️

• Vite + React ⚛️ — фреймворк для построения пользовательских интерфейсов.
• React-dropzone 📂 — компонент для загрузки файлов.
• React-icons 🎨 — библиотека иконок.
• React-paginate 🔢 — компонент для пагинации.
• React-router-dom 🛣️ — библиотека для маршрутизации.
• React-spinners ⏳ — библиотека спиннеров.
• React-toastify 🍞 — библиотека для уведомлений.
• XLSX 📄 — библиотека для работы с Excel файлами.
• Zustand � — библиотека для управления состоянием.

---

⚙️ Настройка окружения

Продублируйте файл .env.example в корневой директории проекта и уберите строку .example. Впишите свою конфигурацию:

#  --- BACKEND ---
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_USER=postgres
DATABASE_PASSWORD=postgres
DATABASE_NAME=Respect
JWT_SECRET=secret123
PORT="3000"

# --- FRONTEND ---
VITE_API_URL="http://localhost:your_api_port"

Этот файл используется как для backend, так и для frontend. 🖥️🖼️

---

🚀 Запуск проекта

Backend 🖥️

1. Установите зависимости:

   cd backend
   npm install

2. Запустите сервер:

   npm run start:dev

Frontend 🖼️

1. Установите зависимости:

   cd frontend
   npm install

2. Запустите клиент:

   npm run dev

---

📚 Документация API

Документация API доступна по адресу: http://localhost:your_api_port/api-docs. 📜

---

🎯 Основные функции

Студенты 🎓

• Просмотр истории репутации 📊: Получение истории изменений репутации
• Просмотр предметов 📚: Получение всех предметов для студента
• Управление долгами ⚖️:
  • Отправка заявок на списание долга
  • Просмотр истории своих заявок на списание
  • Получение детальной информации о заявке по ID

Учителя 👩‍🏫👨‍🏫

• Управление студентами 👥:
  • Просмотр всех студентов
  • Просмотр всех групп
  • Получение истории репутации студента
  • Экспорт истории репутации в Excel
• Управление репутацией ⭐:
  • Добавление репутации студентам
  • Увеличение репутации студентам
• Управление заявками 📋:
  • Просмотр всех заявок на списание долгов
  • Получение детальной информации о заявках
  • Принятие заявок на списание
  • Отклонение заявок на списание

Администраторы ⚙️

• Управление пользователями 👨‍💼:
  • Регистрация новых пользователей
  • Просмотр всех пользователей
  • Получение пользователя по ID
  • Обновление пользователей
  • Удаление пользователей
• Управление студентами 🎓:
  • Создание студента с автогенерацией данных
  • Просмотр всех студентов
  • Массовое создание студентов
  • Получение студента по ID
  • Обновление студентов
  • Удаление студентов
  • Получение учетных данных студента
• Управление группами 🏫:
  • Создание групп
  • Просмотр всех групп
  • Получение группы по ID
  • Обновление групп
  • Удаление групп
• Управление предметами 📚:
  • Создание новых учебных предметов
  • Просмотр всех учебных предметов
  • Обновление учебных предметов
• Управление преподавателями 👨‍🏫:
  • Добавление предметов учителю
  • Удаление предметов у учителя

---

Хорошего дня! 😊