GuideRAI

GuideRAI — сервис интеллектуального подбора специальностей и учебных заведений
для абитуриентов Таджикистана на основе сценариев выбора и объяснимых рекомендаций.

Проект помогает абитуриенту не просто «найти варианты»,
а пройти осознанный путь выбора: от целей и приоритетов → к результатам → к объяснению.

---

🚀 Ключевая идея

Абитуриент создаёт сценарий поступления, в котором указывает:

• цель (бюджет / престиж / работа / локация),
• географию,
• интересующие специальности,
• ограничения и приоритеты.

На основе сценария система:

1. подбирает реальные варианты из БД,
2. сохраняет результаты,
3. объясняет выбор с помощью AI (почему именно эти варианты).

---

🧱 Архитектура проекта

Backend

• сценарно-ориентированная архитектура
• разделение логики (scenarios / search / AI)
• расширяемая модель под монетизацию

Frontend

• AdminLTE (временный MVP-интерфейс)
• далее планируется Angular + PrimeNG (stepper, сценарии, mobile-first)

---

🛠 Стек технологий

Backend

• FastAPI
• SQLAlchemy
• MySQL
• AI (fallback + возможность подключения внешних LLM)

Frontend (текущий)

• Bootstrap / AdminLTE
• jQuery (MVP)

Планируется

• Angular 20
• PrimeNG
• TypeScript

---

📦 Основные возможности (реализовано)

Пользователи

• анонимная идентификация по user_uuid
• хранение языка и тарифа (free / pro)

Сценарии

• создание сценариев поступления
• сохранение шагов сценария
• лимиты сценариев (free / pro)
• завершение сценария

Поиск

• поиск по реальной базе вузов и специальностей
• учёт географии (регион → район → населённый пункт)
• бюджет / платное обучение
• языки обучения

AI (BE-3)

• объяснение результатов по сценарию
• учёт цели абитуриента
• why-not (почему другие варианты не показаны)
• fallback-логика (работает без внешнего API)

---

📊 Статус проекта

MVP активно развивается

Backend

• ✅ Scenario system (users, scenarios, steps)
• ✅ Scenario completion → search → result persistence
• ✅ AI explain по сценарию
• ✅ Чистая сервисная архитектура

Frontend

• ⚠ MVP-интерфейс (AdminLTE)
• 🔜 Переработка UX + сценарный stepper
• 🔜 Mobile-first дизайн

---

🧭 Планы развития

• сценарный stepper с анимацией
• сохранение 3–5 сценариев на пользователя
• сравнение сценариев
• вероятность поступления
• монетизация (pro-тарифы)
• полноценный AI-консультант
• подготовка к защите / конкурсу

---

⚠️ Примечание

Проект находится в активной разработке.
Некоторые UX-решения временные и будут переработаны.

---

📌 Автор

GuideRAI — учебно-прикладной проект
для развития EdTech и осознанного выбора образования.