О проекте

Афиша собирает события культуры Башкортостана в одном месте и показывает только то, что можно проверить.

Демо-данныеСобытия условные: они показывают, как работает афиша.

Путь события

От записи в источнике до карточки на сайте, в боте и в виджете. Каждый шаг можно проверить.

Источник
Сайты учреждений культуры и афишные сервисы. Исходная запись хранится без изменений.
Проверка
Сверка с первоисточником: статус сеанса, цена, возраст и время последней проверки.
Сопоставление дублей
Записи об одном событии сводятся в одну карточку. Спорные пары остаются раздельными.
Каталог
Одна карточка на событие: сеансы, цены, статус и ссылка на источник.
Сайт, бот, виджет
Все каналы читают один REST API, поэтому показывают одно и то же.

Так устроен сервис. Что из этого уже работает в прототипе, сказано в отдельном разделе.

Устройство и прототип

На этой странице

Принципы

Только проверяемое: В каталог попадает то, у чего есть источник. Выдуманных мероприятий нет даже для красоты, демонстрационные помечены.
Источник у каждого события: На карточке видно, откуда запись и когда её последний раз сверяли с первоисточником.
Неизвестное остаётся неизвестным: Неизвестная цена не превращается в «бесплатно», неизвестный возраст в «0+», неизвестный статус в «состоится».
Статусы не исчезают молча: Отменённые и перенесённые сеансы не удаляются: они остаются в каталоге с явным статусом.
Сомнительное не склеивается: Без сильного доказательства две записи не объединяются. Лучше дубль, чем потерянный сеанс.
Один каталог для всех: Сайт, бот, виджет и API берут данные из одного места, поэтому фильтры дают везде одинаковый результат.

Событие, сеанс, цена

Афиша различает три уровня. Так перенос одного сеанса не ломает карточку, а неизвестная цена не превращается в ноль.

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

Как проверяются события

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

Статусы сеансов

Те же плашки, что в каталоге и на карточке события. Цвет никогда не единственный признак: рядом всегда значок и подпись.

Плашка	Что значит
Состоится	Сеанс состоится: источник это подтверждает.
Перенесён	Сеанс перенесён, новая дата известна. Прежняя дата хранится рядом.
Перенесён, дата уточняется	Сеанс перенесён, новой даты пока нет.
Отменён	Сеанс отменён. Карточка остаётся в каталоге с этим статусом и не исчезает молча.
Билеты кончились	Сеанс состоится, но билетов по данным источника нет.
Статус не подтверждён	Источник не подтвердил статус. Афиша не выдаёт такой сеанс за «состоится».

Цены

Если источник не сообщил цену, возраст или статус, афиша пишет «не указано». Неизвестная цена не превращается в «бесплатно», а неизвестный статус в «состоится».

На карточке	Что значит
Бесплатно	Источник прямо сообщил, что вход свободный.
от 500 ₽	Минимальная цена общего билета. Детские и льготные тарифы видны в карточке события.
Цена не указана	Источник не сообщил цену. Это не значит «бесплатно».

Время проверки

Время последней сверки видно на карточке события. Если источник перестал отдавать запись, это ещё не отмена: такую запись отправляют на перепроверку, а не скрывают.

Как работает дедупликация

Одно и то же событие часто публикуют несколько источников. Афиша сводит такие записи в одну карточку и показывает, из скольких источников она собрана.

Как идёт сопоставление

Приводим к общему виду названия, даты, время и площадки.
Ищем кандидатов: одна площадка, близкое время, похожее название.
Объединяем только при сильных совпадениях и без противоречий. Спорные пары уходят модератору и остаются раздельными.
Объединение обратимо: исходные записи не удаляются, ошибку можно исправить.

Три исхода

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

Объединить
Когда
Есть сильное доказательство, что это одна запись: общий ключ источника или подтверждённый общий идентификатор. И нет запретов: разных городов, разных постановок, связи «фестиваль и его концерт».
Что увидит зритель
Одна карточка. На ней написано, из скольких источников она собрана.
Оставить раздельно
Когда
Есть подтверждение, что события разные: другая постановка, другой город гастролей, концерт из программы фестиваля.
Что увидит зритель
Две карточки. Похожее название и одинаковая цена этого не меняют.
На ручную проверку
Когда
Доказательств мало, они противоречат друг другу или неясно, где граница события.
Что увидит зритель
Пока модератор не решил, записи показываются раздельно. Модератор видит исходные записи рядом и историю решений.

Ошибочно склеить два разных события хуже, чем оставить дубль. Поэтому в сомнительных случаях афиша не объединяет.

Ошибку можно исправить

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

Счётчик источников

На карточке события написано, из скольких источников она собрана. Ссылка с этой строки ведёт сюда.

Устройство и прототип

Что задумано и что из этого есть в прототипе хакатона прямо сейчас.

Тема	Как устроено	Сейчас в прототипе
Источники	Открытые источники: сайты учреждений культуры и афишные сервисы.	Один «Демо-источник». Его ссылка ведёт в раздел «Демо-данные» на этой странице.
События	Только реальные события из источников.	Условные события на настоящих площадках. Каждое помечено «Демо-данные», в API у него стоит `synthetic: true`.
Проверка	Регулярная сверка с первоисточником.	Время проверки условное: оно отсчитывается от текущего момента, чтобы показать и свежую, и давнюю проверку.
Статусы и цены	Статус сеанса, цена и возраст из источника. Неизвестное так и помечается.	Работают по тем же правилам. В демо есть отменённые, перенесённые и неподтверждённые сеансы, события без цены и без возраста.
Дедупликация	Сопоставление записей, три исхода, журнал объединений, ручная проверка спорных пар.	Правила и формат решений описаны и проверяются на синтетических парах в репозитории команды. Число источников у демо-карточек условное.
ИИ-подбор	Языковая модель переводит фразу в условия, код проверяет их по полям событий.	Фразу разбирают правила без языковой модели. Условия проверяет тот же код.
Каналы	Сайт, Telegram-бот, виджет и REST API читают один каталог.	Сайт, виджет и REST API работают на демо-данных. Telegram-бот открывается по ссылке в разделе «Откуда проект».