Hackathon team repository for Sirius

IdeaMatch

1. Название проекта

IdeaMatch — платформа, которая связывает реальные задачи бизнеса со студенческими командами и помогает превращать первоначальную бизнес-идею в структурированную Task Card.

2. Краткое описание

IdeaMatch решает проблему неполных и неясных практических задач от бизнеса.

Представитель бизнеса описывает проблему, после чего система помогает уточнить информацию, формирует Task Card и рассчитывает рейтинг готовности задачи от 0 до 100.

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

Финальное решение о выборе студента или команды всегда принимает представитель бизнеса.

Платформа предназначена для:

• представителей бизнеса;
• студентов;
• студенческих команд.

3. Что реализовано

В текущей версии IdeaMatch реализованы:

• отдельные роли Business и Student;
• создание пользовательского профиля;
• профили студентов и представителей бизнеса;
• создание бизнес-задачи;
• уточняющие вопросы для формирования Task Card;
• редактирование Task Card владельцем;
• AI Readiness Rating от 0 до 100;
• отображение недостающей информации;
• общий каталог опубликованных задач;
• фильтрация задач по направлению и уровню готовности;
• сортировка задач;
• дедлайны;
• необходимые навыки для задач;
• студенческие proposals;
• просмотр профиля студента при рассмотрении proposal;
• Accept / Reject со стороны бизнеса;
• AI Match как рекомендация;
• система отзывов и рейтингов;
• оценки от 1 до 5;
• отображение имени автора отзыва;
• отдельные сценарии для студента и бизнеса;
• уведомления о приближающихся дедлайнах;
• переключение языков KZ / RU / EN;
• режим повышенной контрастности;
• увеличение и уменьшение текста;
• простой режим интерфейса;
• чтение текста вслух;
• адаптивный интерфейс.

Также в проекте присутствуют демонстрационные бизнес-задачи разных направлений: EdTech, IT, FinTech, E-commerce, HealthTech, Marketing, Logistics и другие.

4. Как работает решение

Сценарий бизнеса

1. Представитель бизнеса входит в IdeaMatch как Business.
2. Заполняет свой профиль.
3. Описывает первоначальную бизнес-проблему.
4. Система показывает уточняющие вопросы.
5. На основе введенной пользователем информации создается Task Card.
6. Рассчитывается AI Readiness Rating.
7. Бизнес видит, какой информации не хватает.
8. После заполнения Task Card задача публикуется в общем каталоге.
9. Студенты могут просматривать задачу и отправлять proposals.
10. Бизнес просматривает proposal вместе с информацией о студенте.
11. Представитель бизнеса самостоятельно нажимает Accept или Reject.
12. После взаимодействия можно оставить рейтинг и текстовый отзыв.

Сценарий студента

1. Студент входит в IdeaMatch как Student.
2. Заполняет профиль и информацию о навыках и проектах.
3. Просматривает общий каталог бизнес-задач.
4. Может открыть задачу независимо от ее readiness score.
5. Выбирает интересующую задачу.
6. Отправляет proposal с идеей решения, планом, технологиями и ссылкой на prototype/GitHub.
7. Бизнес рассматривает предложение.
8. Студент видит результат.
9. Пользователи могут оставлять оценки и отзывы.

Важно: студент не может изменять чужую бизнес-задачу. Редактировать Task Card может только ее владелец.

5. AI Readiness Rating

IdeaMatch оценивает полноту Task Card по шкале от 0 до 100.

Используется следующая система:

Критерий	Баллы
Контекст и потребность	20
Данные	20
Ожидаемый результат	15
Критерии успеха	15
Ограничения	10
Пользователи	10
Связь с бизнесом	10
Итого	100

Уровни готовности:

• 0–39 — Draft;
• 40–69 — Working;
• 70–89 — Ready;
• 90–100 — Priority.

Система показывает недостающие поля и пересчитывает рейтинг после изменения Task Card.

AI не должен самостоятельно добавлять факты, которых не сообщил пользователь.

AI Match используется только как рекомендация. Система не выбирает студента автоматически.

6. Технологии

В проекте используются:

Frontend

• HTML5
• CSS3
• JavaScript

Backend

• Python
• FastAPI

Дополнительная логика

• Java — отдельная реализация логики расчета readiness score.

Хранение данных в demo-версии

• Browser LocalStorage

LocalStorage используется для демонстрационного хранения профилей, задач, proposals, отзывов и пользовательских настроек.

7. Архитектура проекта

Основные компоненты IdeaMatch:

User Profile

Хранит информацию о пользователе и его роли.

Поддерживаются две основные роли:

• Business
• Student

Task Card

Содержит структурированную информацию о бизнес-задаче.

Rating Engine

Рассчитывает readiness score задачи от 0 до 100.

Catalog

Показывает опубликованные бизнес-задачи.

Proposal System

Позволяет студентам отправлять идеи решения бизнесу.

Business Decision

Позволяет владельцу задачи принять или отклонить proposal.

Profile & Reputation

Содержит навыки, проекты, рейтинг и отзывы пользователей.

Deadline & Notification

Показывает дедлайны задач и уведомления.

Основной поток данных:

Business Problem → Clarification → Task Card → Readiness Rating → Catalog → Student Proposal → Business Decision → Feedback

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

Вариант 1. Frontend demo

Для демонстрационной версии достаточно открыть:

index.html

в современном браузере.

Также frontend может быть размещен через GitHub Pages.

Вариант 2. Python backend

Для запуска FastAPI необходимо установить Python.

Установка зависимостей:

pip install fastapi uvicorn

## 12. Deployed version

Рабочая версия IdeaMatch опубликована через GitHub Pages:

https://aru-tr.github.io/project-23.09/