EventMatch

AI-консультант для выбора event-подрядчиков из каталога.
Понимает идею события, уточняет детали и объясняет каждый вариант фактами.

Возможности · Скриншоты · Запустить · Архитектура · Проверить за 5 минут · Технический справочник

Go 1.25   PostgreSQL 17   OpenAI API   JavaScript · HTML · CSS

Версия демонстрации: возможности, скриншоты и контрольные результаты ниже проверены на Go-версии ab45c2c. Запуск закреплён на этом коммите. В актуальной версии подключён Python-поиск: он получает каталог из PostgreSQL, а Go дополняет ответ ближайшими вариантами и датами. Способы запуска и различия алгоритмов описаны в справочнике.

Хорошее событие начинается с подходящих людей

У заказчика уже есть каталог подрядчиков, но выбрать по нему непросто. Кто работает в нужном городе? Кто свободен? У кого подходящий формат? Почему один вариант лучше другого — и что делать, если никто не подошёл?

EventMatch превращает каталог в понятный выбор. Заказчик рассказывает о мероприятии обычными словами или голосом, вместе с AI уточняет условия и получает до трёх подрядчиков с конкретными объяснениями. Если совпадений нет, сервис показывает причины и ближайшие варианты для пересмотра условий.

Проект команды Soda для HackAlem AI, кейс Firebird «Умный подбор подрядчиков» (#79-lite). Основной пользователь — человек, который организует свадьбу, корпоратив, день рождения или другое событие и хочет разобраться в предложениях своего города.

От «есть идея» до «вот подходящие варианты»

01 · Рассказать, а не заполнять всё с нуля

«Хочу оформить свадьбу, но не знаю, кто нужен» — достаточное начало разговора. AI помогает различить флориста и декоратора, задаёт по одному вопросу, предлагает короткие ответы и принимает свободный текст. Для фотографа уточняет стиль съёмки, для ведущего — характер подачи.

Рядом заполняется карточка «Мы поняли так». Уже известные условия передаются в следующий запрос вместе с историей и ручными исправлениями. Необязательное уточнение о стиле можно пропустить.

02 · Проверить, как нас поняли

Город, дата, формат, категория и бюджет в тенге обязательны. Язык и длительность — дополнительные ограничения. Все поля доступны для правки; диктовку тоже можно отредактировать до отправки.

Неоднозначные требования не исчезают: например, «обязательно без конкурсов» нельзя выдать за подтверждённую услугу только потому, что ведущий описан как спокойный. Такой пункт требует уточнения или явного согласия продолжить без его проверки.

03 · Выбрать дату с пониманием занятости

Интерактивный календарь показывает свободных кандидатов на каждый день и среднюю занятость по месяцам с учётом условий. Если выбранный подрядчик занят, сервис предлагает ближайшие даты без отметки о занятости в известном периоде.

04 · Сравнить конкретные причины

В выдаче — имя, категория, город, начальная цена и объяснение: факт из описания плюс соответствие условиям. Полный профиль раскрывает форматы, языки, часы работы и происхождение данных.

Если никто не подошёл, «Ближайшие варианты» показывают все различия: на сколько выше цена, какой формат не указан, другая ли это дата или город. Эти предложения отделены от строгих совпадений. Выбор новой даты возвращает к подтверждению, а не запускает бронирование.

Посмотрите, как это выглядит

Скриншоты работающей Go-версии ab45c2c. Каталог и результаты настоящие для предоставленного датасета; имена анонимизированы, синтетические профили отмечены в интерфейсе.

Первое знакомство

Диалог и живая карточка условий Один вопрос за раз. Ответ — кнопкой, текстом или голосом.

Календарь с занятостью Доступность по дням и нагрузка по месяцам из каталога.

Результат, который можно объяснить

Даже пустая выдача помогает сделать следующий шаг

Запустить у себя

Нужны: Go 1.25+, Docker с Compose и Git. При первом запуске нужен интернет для загрузки зависимостей и образа PostgreSQL. Node.js, npm и сборка интерфейса не требуются.

git clone https://github.com/BAITC-Hacks/hack-d3e8cd85-soda.git
cd hack-d3e8cd85-soda
git checkout --detach ab45c2ca999be63447b47c055bf77d504759b4d6
docker compose up -d --wait db
go run .

Откройте localhost:8080. Команда go run . остаётся работать в терминале. Используйте отдельную копию репозитория для демонстрации: переключение на закреплённый коммит сохраняет проверенное поведение приложения.

Без API-ключа сразу доступны ручные условия, календарь, строгий подбор, объяснения и ближайшие варианты. Данные автоматически импортируются в PostgreSQL при первом запуске и сохраняются между перезапусками.

cp -n .env.example .env

go run .

go run . -prepare
go run .

Статус представленной версии: текстовый диалог проверен через настоящий OpenAI API. Подготовка смыслового индекса реализована, но в текущем демо индекс отсутствует — порядок по цене. Диктовка реализована и проверена с искусственным микрофоном и подменённым ответом распознавания; качество настоящей транскрипции ещё нужно проверить отдельно.

Настройки внешней БД, переменные окружения и подробности сохранения данных — в техническом справочнике.

Где работает AI, а где — строгие правила

В проверенном Go-сценарии AI участвует до выдачи карточек: разбирается в идее мероприятия, уточняет специализацию и преобразует рассказ в поля и пожелания. Проверку обязательных условий выполняет Go. Поэтому красивое описание профиля не позволяет обойти бюджет или календарь.

flowchart TD
    U["Рассказ или диктовка"] --> C["AI-консультант: смысл и уточнения"]
    C --> R["Редактируемые условия и подтверждение"]
    R --> F["Go: строгая проверка условий"]
    DB[("PostgreSQL: каталог и занятость")] --> F
    F -->|Есть совпадения| S["Смысловой индекс, если подготовлен; иначе цена"]
    S --> E["До 3 карточек: проверенные факты и цитаты"]
    F -->|Нет совпадений| N["Причины и ближайшие варианты"]
    N -->|Пользователь меняет условия| R

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

В Go-сценарии во время поиска по подтверждённым условиям внешняя языковая модель не вызывается. Ориентир ответа — до 10 секунд; это цель задания, а не заявленная гарантия под нагрузкой.

Python-модуль: поиск в актуальной версии

Команда добавила загрузку JSONL-каталога, фильтрацию, локальное сравнение пожеланий и генератор объяснений на Python. Интерфейс актуальной версии обращается к /api/search: Python ранжирует профили из PostgreSQL, а Go добавляет ближайшие варианты и даты из того же снимка данных. /api/matches сохраняет прежний Go-алгоритм. У этих путей разные сортировка и объяснения; подготовка Go-индекса не включает Python-поиск.

Исходники и инструкции обоих направлений сохранены. В техническом справочнике описаны запуск актуального сайта и отдельного Python-модуля, зависимости, контракт API и ограничения. Его результаты не выдаются за проверенные скриншоты и контрольные примеры ниже.

Почему повтор в Go-сценарии возвращает тот же порядок

При одинаковых подтверждённых условиях, пожеланиях, данных, коде и индексе сортировка фиксирована:

1. Смысловая близость, если индекс подготовлен и пожелания выбраны.
2. Начальная цена.
3. Стабильный id при равенстве.

Порядок выбора пожеланий и их дубли не меняют результат. Изменение каталога делает старый индекс несовместимым. Сам свободный текст внешняя модель может разобрать по-разному — поэтому условия обязательно показываются для подтверждения. temperature=0 и кеш не выдаются за гарантию повторяемости.

Что защищает качество Go-подбора

Важные различия: цена «от» не равна итоговой стоимости; отсутствие отметки о занятости не гарантирует бронирование; смысловая близость не подтверждает услугу; другой город не означает возможность выезда.

Проверка для жюри · пять минут

В AI-консультанте есть кнопки готовых примеров: они открывают подтверждение, а не обходят проверки. Таблица ниже проверена на версии ab45c2c и исходном каталоге; для точного порядка оставьте пожелания пустыми.

Для живого AI-сценария: «Хочу оформить свадьбу в Алматы 10 октября 2026. До 300 000 тенге на специалиста, но не знаю, кто нужен». Уточните «цветы и букеты» и проследите, как заполняются поля. Или попросите фотографа и выберите репортажный стиль. Непроверяемое «обязательно без конкурсов» должно остаться для отдельного решения перед поиском.

curl http://localhost:8080/api/matches \
  -H 'Content-Type: application/json' \
  -d '{"city":"Алматы","event_date":"2026-10-06","event_type":"корпоратив","category":"Ведущий","budget_kzt":1300000,"language":"русский","duration_hours":6,"wishes":[],"unverified_requirements":[]}'

Проверки и воспроизводимость

Команды и результаты в этом разделе относятся к закреплённой Go-версии ab45c2c. Проверки нового Python-модуля описаны отдельно.

go test -race ./...
go vet ./...

Обычные Go-тесты не обращаются к внешнему AI. Они проверяют ограничения, происхождение цитат, три исхода, ближайшие варианты, повторяемость, ошибки провайдера и фиксированный смысловой индекс на контрольных векторах.

docker compose up -d --wait db
TEST_DATABASE_URL='postgres://eventmatch:[email protected]:5432/eventmatch?sslmode=disable' go test -race ./...

uv run --with selenium python ui_consultation_check.py
uv run --with selenium python ui_requirements_check.py

Данные, которым можно проследить источник

Для показанного Go-сценария каталог — исходный CSV организаторов: 66 профилей, 17 категорий. Это 50 профилей Алматы, 15 Астаны и один с городом «Зарубежье». Данные из сокращённого HTML-превью не используются.

• 13 синтетических профилей организаторов, 8 дополненных городов и 18 дополненных цен сохраняют исходные флаги. Их происхождение видно в интерфейсе; добавлений команды в рабочем каталоге нет.
• Цитаты проверяются на буквальное присутствие в описании. Это отобранные фрагменты, а не придуманные сведения о подрядчиках.
• max_hours = null означает, что услуга не привязана к присутствию на площадке. Это допустимо, а не повод исключить флориста или декоратора.
• Календарь известен только за 23.09.2026–31.12.2026. За его границами доступность не предполагается.

В проверенной Go-версии PostgreSQL хранит профили, занятость, цитаты и происхождение. Повторный запуск не затирает изменения, а каждый новый запрос читает актуальный каталог.

Границы версии и развитие

Текущая версия предназначена для локальной демонстрации. Публичного развёртывания и подтверждённого доступа к API Firebird нет. Бронирование, оплата и уведомления подрядчикам не входят в реализованный сценарий.

Диалог и форма живут в памяти вкладки: обновление страницы их сбрасывает. История ограничена 11 ответами пользователя, затем можно продолжить вручную. Ключи остаются на сервере; тексты и аудио не записываются приложением в БД или файлы, но отправляются OpenAI для обработки. Первичный разбор AI требует проверки человеком.

Следующие шаги: проверить качество реальной транскрипции и смыслового индекса; расширить проверяемые характеристики специалистов; добавить актуализацию занятости из подтверждённого источника; оценить качество рекомендаций на размеченных запросах. Сохранение проектов мероприятий и публичное размещение — отдельные этапы с настройкой доступа и ограничением расходов API.

Сделано командой Soda для HackAlem AI
_{AI-агент разработки — Codex: реализация, проверки, работа с цитатами и документация.}

Полная техническая документация · Изменения проекта · Запуск