How hard-sign-hackaton/employer_first_roadmap works
Это MAX-бот профориентации и поступления для школьников, дополненный HTTP API для администраторов и работодателей. Основной путь проходит от выбора интересов и компании через проверку карьерного направления и экзаменов к созданию и выполнению roadmap: поступлению, практике/стажировке и заявке на работу. Внутренние слои — сервисы предметной логики и GORM-репозитории; PostgreSQL хранит каталог и прогресс, а состояние активного диалога также ведётся в памяти. Отдельно показаны каталог, API, feedback и напоминания. Связи сценария частично основаны на README; unsampled реализацию не предполагаю.
Main entry points: main.go События и команды · database.go PostgreSQL · trajectory_service_impl.go Проверка траектории · gorm_roadmap_repository.go Хранилище roadmap
Components 28
Диалог MAX
- События и команды
main.go - Маршрутизация сообщений
handlers/message_listener.go - Опросы
handlers/small_survey.go - Быстрый опрос
handlers/small_survey_flow.go - Выбор направления
handlers/big_survey_flow.go - Состояние диалога
utils/user_state_storage.go
Профориентация
- Профиль
services/profile_service_impl.go - Проверка траектории
services/trajectory_service_impl.go
Поступление и roadmap
- Подбор поступления
services/admission_service_impl.go - Шаги roadmap
handlers/roadmap_flow.go - Управление roadmap
services/roadmap_service_impl.go - Roadmap и прогресс
models/roadmap.go
Данные и каталог
- Карьерный каталог
repositories/gorm_career_repository.go - Каталог образования
repositories/gorm_education_repository.go - Профили
repositories/gorm_profile_repository.go - Хранилище roadmap
repositories/gorm_roadmap_repository.go - Справочники
repositories/gorm_reference_repository.go - Основной каталог
database/main_catalog.go - Справочные данные
database/seed.go - PostgreSQL
database/database.go
API и напоминания
- REST API и роли
employerapi/handler.go - API-хранилище
employerapi/store.go - Напоминания
reminders/service.go - Планировщик
reminders/scheduler.go - MAX-доставка
reminders/max_sender.go
Other components
- Школьник
- MAX Bot API
- Администратор / работодатель
Connections 40
- Школьник → MAX Bot API: пишет боту
- MAX Bot API → События и команды: передаёт события
main.go - События и команды → Маршрутизация сообщений: обрабатывает сообщения
main.go - События и команды → Опросы: регистрирует команды
main.go - Опросы → Быстрый опрос: запускает опрос
- Маршрутизация сообщений → Выбор направления: обрабатывает диалог
- Быстрый опрос → Состояние диалога: хранит состояние
- Выбор направления → Состояние диалога: хранит состояние
- События и команды → Профиль: настраивает сервис
main.go - События и команды → Проверка траектории: настраивает сервис
main.go - События и команды → Подбор поступления: настраивает сервис
main.go - События и команды → Управление roadmap: настраивает сервис
main.go - Проверка траектории → Карьерный каталог: читает направления
services/trajectory_service_impl.go - Проверка траектории → Каталог образования: проверяет экзамены
services/trajectory_service_impl.go - Проверка траектории → Профили: читает профиль
- Проверка траектории → Хранилище roadmap: создаёт цель
services/trajectory_service_impl.go - Профиль → Профили: сохраняет профиль
- Выбор направления → Проверка траектории: запрашивает оценку
- Шаги roadmap → Подбор поступления: подбирает программы
- Шаги roadmap → Управление roadmap: ведёт шаги
- Подбор поступления → Каталог образования: ищет программы
- Подбор поступления → Профили: читает результаты
- Подбор поступления → Хранилище roadmap: сохраняет план
- Управление roadmap → Хранилище roadmap: читает и обновляет
services/roadmap_service_impl.go - Хранилище roadmap → Roadmap и прогресс: сохраняет состояние
repositories/gorm_roadmap_repository.go - Карьерный каталог → PostgreSQL: читает и пишет
- Каталог образования → PostgreSQL: читает и пишет
repositories/gorm_education_repository.go - Профили → PostgreSQL: читает и пишет
- Хранилище roadmap → PostgreSQL: читает и пишет
repositories/gorm_roadmap_repository.go - Справочники → PostgreSQL: читает справочники
- Основной каталог → PostgreSQL: заполняет каталог
- Справочные данные → PostgreSQL: заполняет справочники
- Администратор / работодатель → REST API и роли: вызывает REST API
- REST API и роли → API-хранилище: обрабатывает запросы
employerapi/handler.go - API-хранилище → PostgreSQL: читает и пишет
- REST API и роли → MAX-доставка: отправляет feedback
employerapi/handler.go - Планировщик → Напоминания: запускает отправку
- Напоминания → Хранилище roadmap: читает активные пути
- Напоминания → MAX-доставка: доставляет напоминания
reminders/service.go - MAX-доставка → MAX Bot API: отправляет push