Как мы навайбкодили международный портал и за неделю превратили его в Евразийскую ассоциацию

Коротко о чём статья

Команда AI MAP собрала международный портал для нишевого спортивного сообщества методом вайбкодинга — разработки с ИИ-ассистентом по формализованному стандарту. Проект некоммерческий: основатель AI MAP Леон Николаев и его коллега Маргарита Нечитайло — профессиональные игроки в риичи-маджонг, организаторы турниров на Кавказе и технологические спонсоры ассоциации.

Но метод, которым собран портал, — ровно тот же, что AI MAP применяет в коммерческих проектах для клиентов. Старт — март 2025. Меньше чем через месяц — пять стран, 3000+ клубных игр в базе, личные кабинеты игроков. И ещё несколько стран на стадии переговоров.

Контекст: зачем нишевому сообществу понадобился портал

Риичи-маджонг — интеллектуальная дисциплина, входящая в IMSA (Международную ассоциацию интеллектуальных видов спорта) наряду с шахматами, го и бриджем. Сообщество нишевое — рейтинговых игроков в мире тысячи, не миллионы, — но организованное и с серьёзной инфраструктурой. У каждого игрока параллельно живут аккаунты в нескольких системах.

Pantheon — система учёта и статистики оффлайн-игр. Клубы и турниры фиксируют результаты здесь, отсюда идёт рейтинг.

Mahjong Soul — главный глобальный онлайн-сервер, на котором играют десятки тысяч человек по всему миру. Данные по игрокам высокого ранга доступны через сторонний агрегатор amae-koromo.

Tenhou — исторический японский онлайн-сервер. На его вершинах концентрация профессионалов максимальна. Это своего рода «старая школа» онлайн-маджонга.

mahjong.click — российский портал с историей турниров, рейтингами и базой игроков. Важный контекст: организации по маджонгу в Армении, Грузии, Сербии, Черногории и Кыргызстане основали релоканты из России, у многих из которых — богатая турнирная история именно на этом портале. Вокруг mahjong.click сложилось русскоязычное комьюнити риичи, и игроки Kōkasoku — его часть.

Ни одна из этих систем не давала единой картины по нашему региону: сколько человек сыграл за карьеру, где он в общем рейтинге ассоциации, как выглядит его профиль целиком. На российском портале есть страницы клубов и городов — но отдельной выборки по странам Закавказья, Балкан и Центральной Азии там нет.

«Логичный вопрос: зачем делать своё, если есть mahjong.click? — говорит Леон Николаев. — Можно было договориться и отображать наши страны там. Но у нас другой вектор: ещё год назад мы подали заявки на вступление в Европейскую ассоциацию маджонга. Показывать европейским коллегам выборку с российского портала — не вариант. Нужна собственная платформа, которую можно предъявить как инфраструктуру независимых национальных организаций».

Решение — собрать портал методом вайбкодинга как внутренний R&D-проект AI MAP.

Что такое вайбкодинг в понимании AI MAP

Термин трактуют по-разному. В NC Team (проектный офис AI MAP) вайбкодинг — не «ИИ пишет, я смотрю». Это формализованный процесс с зафиксированным стеком, правилами ревью и границами ответственности человека.

Внутренний стандарт vibecoding-ncteam применяется на каждом проекте. Его суть: ИИ-ассистент не выбирает технологии сам и не изобретает архитектуру с нуля. Ему заранее задан коридор — какой стек использовать, как организовать код, куда деплоить. В этом коридоре он работает предсказуемо и быстро.

Человек — архитектор и ревьюер. Он принимает решения о структуре проекта, проверяет результат, направляет. ИИ (Claude Code в связке с VS Code) генерирует код, предлагает решения, выполняет рутину.

Благодаря стандарту время от идеи до работающего сайта сокращается с недель до дней. Портал Kōkasoku стал полигоном, где стандарт обкатали — а потом проверили на прочность, когда проект начал расти быстрее плана.

От прототипа до продукта за три этапа

Принципиальный момент в подходе AI MAP к вайбкодингу: не строить финальную систему сразу. Начинать с минимума и наращивать по мере реальной потребности.

Этап 1. Прототип. За один рабочий сеанс собрали сайт со статическими данными: 45 игроков ереванского клуба, два кубка с полными результатами, историческая хронология турниров. Данные лежали прямо в коде — никакой базы, никакого сервера. Залили на бесплатный хостинг — и портал уже в интернете. В базе было 500+ клубных игр.

Этап 2. Референс из open source. Изучили российский mahjong-portal — проект с открытой лицензией, несколько лет развивающийся для русскоязычного сообщества. Использовали его решения как референс для структуры данных, добавили корректную атрибуцию. Вдохновлялись — и сразу начали делать вещи, которых в оригинале нет.

Этап 3. Свой сервер и база данных. Когда стало понятно, что проект растёт, подняли полноценную базу данных, добавили авторизацию и API-слой. Портал превратился из простой «витрины» в самостоятельную систему с собственной историей данных.

Неделя, которая всё изменила

MVP показали как портал грузино-армянского альянса — два клуба, два города. А дальше всё произошло быстрее, чем планировали.

Ещё до основного анонса к Kōkasoku начали присоединяться новые страны. Сербия. Черногория. Потом Кыргызстан. Ещё несколько стран — на стадии переговоров. За неделю альянс двух закавказских клубов стал Евразийской ассоциацией риичи-маджонга.

И вот тут проявилось то, что в бизнесе часто важнее самого кода: скорость реакции на изменения.

«Мы не просто быстро накодили, — объясняет Леон. — Мы провели полную трансформацию продукта: от названия и позиционирования до структуры данных и интерфейса. От старой версии альянса остались только домен и общее название — всё остальное было перестроено под новый масштаб. И это произошло за неделю, не за квартал».

Добавление новой страны занимает 1–2 часа работы плюс примерно час ревью со стороны представителя этой страны. Для контекста: объём данных по Сербии оказался сопоставим с Грузией и Арменией вместе взятыми. Это не «добавить строчку в конфиг» — это импорт игроков, привязка аккаунтов, валидация истории. Но благодаря тому, как устроена система, это часы, а не недели.

Что есть сегодня

Пять стран: Армения 🇦🇲, Грузия 🇬🇪, Сербия 🇷🇸, Черногория 🇲🇪, Кыргызстан 🇰🇬 — и ещё несколько на подходе.

3000+ клубных игр в базе (начинали с 500+ на этапе MVP).

Четыре источника данных агрегируются в единый профиль игрока: Pantheon (оффлайн), Mahjong Soul (глобальный онлайн), Tenhou (японский сервер), mahjong.click (турнирная история).

Личный кабинет игрока — функция, которой нет на российском портале, послужившем референсом. Игрок авторизуется, привязывает свои аккаунты, видит сводную статистику: количество турниров, клубных игр, онлайн-игр, распределение по местам, процент побед, рейтинги — всё на одной странице. Ссылки на внешние профили ведут в один клик.

Двуязычный интерфейс — English / Русский.

Команда продолжает развивать портал, реализуя идеи, до которых пока не дошёл портал-прародитель.

Что это значит для бизнеса

Метод, которым собран Kōkasoku, — ровно тот же, что AI MAP применяет на коммерческих проектах. Вот что демонстрирует этот кейс.

Скорость запуска. Веб-система с базой, авторизацией, личным кабинетом и четырьмя интеграциями — не квартальный проект. Это дни активной работы. При условии, что у команды есть стандарт вайбкодинга и понимание, где человек обязателен, а где ИИ справится сам.

Скорость трансформации. MVP проектировался для двух стран. Через неделю после запуска это была платформа для пяти — перестроенная полностью, от позиционирования до интерфейса.

Скорость масштабирования. Добавление новой страны — 1–2 часа. Не потому что данных мало, а потому что процесс воспроизводим. Каждая следующая интеграция быстрее предыдущей.

Свои фишки рядом с оригиналом. Российский портал — проект с десятилетней историей, огромной базой и функциями, до которых Kōkasoku ещё расти. Но команда уже реализовала вещи, которых там нет — например, личный кабинет с агрегацией четырёх источников. В будущем эти наработки могут быть полезны и российскому сообществу. Вайбкодинг позволяет маленькой команде быстро экспериментировать и находить решения, которые потом перенимают более крупные проекты.

Где применяется этот же подход

Всё, что обкатано на Kōkasoku, работает на клиентских задачах AI MAP и NC Team: корпоративные чат-боты, внутренние SaaS-инструменты для партнёров, портал рейтинга разработчиков DevRating.ru, кейс-лендинги. Стек тот же, процесс тот же, скорость — та же.

Разница — в наличии заказчика, ТЗ и сроков. На Kōkasoku заказчиками были Леон и Маргарита, а мотивацией — желание сделать полезное для сообщества, которое им небезразлично.

Если нужна техническая экспертиза в AI-разработке, автоматизации или построении собственного портала с интеграциями — пишите: aimap.am.

Портал Kōkasoku: kokasoku.com

AI MAP — AI-решения и бизнес-автоматизация, Ереван