requirements.txt - зависимости находятся в файле go.mod

🚀 Инструкция по запуску проекта

Скачать проект с GitHub

git clone [email protected]:Karielka/Hackaton_MAX.git
cd Hackaton_MAX

или

git clone https://github.com/Karielka/Hackaton_MAX.git
cd Hackaton_MAX

Для запуска

1. Сбилдить и запустить контейнеры

docker compose up --build

либо при повторных запусках:

docker compose up 

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

Определение целевой аудитории и проблемы.

Целевая аудитория

Целевой аудиторией нашего бота являются студенты любого курса и любой степени образования очной и заочной формы обучения.

Решаемая проблема

Студенты ежедневно сталкиваются с потерей времени и нервов при поиске базовой университетской информации, которая разбросана по разным источникам, либо существует только в онлайн-формате.

Сценарий взаимодействия

Общий принцип:

Бот использует интуитивные команды и кнопки, чтобы пользователь мог получить информацию за 2-3 тапа.

Запуск бота

Пользователь нажимает кнопку Начать, после чего в меню команд выбирает команду /start или /menu. После отправки команды боту пользователю выводится меню доступных команд. Доступные команды:

1. Поиск препода - найти расписание преподавателя или его контакты
2. Деканат - получить расписание деканата
3. Корпуса - получить информацию о корпусе.
4. Столовые/копирки - получить информацию о местах в вузе.
5. Частые вопросы - посмотерть ответы на частые вопросы.

📘 Сценарий 1: Поиск преподавателя

Действие пользователя	Ответ бота
Нажимает «Поиск преподавателя»	Бот спрашивает: «Как будем искать?» Показывает варианты: по факультету, по кафедре, по ФИО.
Выбирает способ поиска	Бот просит уточнить запрос (название факультета, кафедры или часть ФИО).
Вводит текст	Бот ищет подходящих преподавателей.
Найдены совпадения	Бот показывает список преподавателей с краткой информацией и предлагает повторить поиск.
Совпадений нет	Бот пишет: «Ничего не найдено. Попробуйте иначе.»
Ошибка	Сообщение об ошибке поиска.

📘 Сценарий 2: Расписание деканата

Действие пользователя	Ответ бота
Нажимает «Деканат»	Бот просит ввести название факультета.
Вводит факультет	Бот ищет подходящие варианты.
Совпадений нет	«Факультеты не найдены. Попробуйте иначе.»
Найден один вариант	Бот показывает расписание или сообщает, что оно отсутствует.
Найдено точное совпадение	Бот показывает нужную информацию.

📘 Сценарий 3: Информация о корпусах

Действие пользователя	Ответ бота
Нажимает «Корпуса»	Бот показывает список корпусов для выбора.
Выбирает корпус	Бот показывает подробную информацию: название, адрес, метро, описание.
Нажимает «Показать на карте»	Бот отправляет краткую информацию с адресом и метро.
Нажимает «Назад»	Возврат к списку корпусов или в главное меню.

📘 Сценарий 4: Столовые, буфеты, копирки

Действие пользователя	Ответ бота
Нажимает «Столовые / копирки»	Бот предлагает выбрать корпус.
Выбирает корпус	Бот показывает, что доступно в этом корпусе: столовая, буфеты, копирки (если есть).
Выбирает «Столовая»	Бот показывает карточку с названием, адресом, временем работы и меню.
Выбирает «Буфеты»	Бот показывает список всех буфетов в корпусе.
Выбирает «Копирки»	Бот показывает список копировальных точек.
Нажимает «Назад»	Возврат к выбору корпуса или в меню.

📘 Сценарий 5: Частые вопросы (FAQ)

Действие пользователя	Ответ бота
1. Нажимает «Частые вопросы» или пишет "частые вопросы".	«Выберите тему, которая вас интересует: [Кнопки: Академические вопросы, Документы и справки, Общежитие, Стипендия, Другое]»
3. Пользователь нажимает «Академические вопросы».	«• Как записаться на пересдачу? → Ответ: Через заявление в деканат... • Где найти учебный план? → Ответ: В разделе "Документы" вашего ЛК... • Что делать, если потерял студенческий? → Ответ: Обратиться в отдел кадров, ауд. 100...»