Архитектура игры «Сходка»: C4 и критические пути

Игра «Сходка» — субботний вечер IT-сообщества в баре Батуми, 19:00 → 01:00, около 18 минут: браузер, без сервера и сборки, three.js лежит рядом. Здесь описано, как она устроена: схемы C4 до уровня компонентов и четыре пути, на которых всё держится.

C4: контекст и контейнеры

Уровень 1. Система и её окружение

Уровень 2. Контейнеры

C4 уровня 3: компоненты контекстов

Все части — обычные скрипты с реестром L: L.def объявляет часть, L.use берёт её и выполняет при первом обращении. Циклическая зависимость падает сразу с понятной ошибкой. Контексты общаются через шину событий мира (world.bus) и вызов world.act.

Симуляция

• World держит часы (180 с реального времени на игровой час), людей, игрока, места и шину событий; наружу даёт step, act, view.
• Crowd строит гостей из ролей, складов и нужд, а расписание прихода сводит к кривой вечера инвариантом, а не подбором.
• Brain решает за гостей: место, бар, курилка, группы разговора. Director запускает события и сообщения в телефон.
• Talk разыгрывает карточки-реплики; Score считает знакомства, пары, фото и звание.

Зал и люди

• Зал строит SushiGO из плана и декора, 2–4 настоящих источника света, остальной свет запечён в текстуры; эффекты: дождь, саксофон, караоке и другие.
• Quality переключает low / mid / high по частоте кадров: быстро вниз, медленно вверх и не выше ступени, на которой уже падали.
• Люди: каждый человек — один SkinnedMesh, анимация процедурная по позе, настроению и «говорит ли».

Интерфейс

• Ui подписывается на события мира (talk:line, ladder, pair, chat, toast, end) и отдаёт действия игрока в world.act.
• Своя шина ui.bus: пауза, качество, звук, «ещё одна суббота».

Четыре критических пути

1. Запуск и новый вечер

2. Шаг симуляции

3. Реплика игрока и её последствия

4. Кадр

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

• Симуляция не знает об экране. Ни DOM, ни THREE: её видно только через view() и шину событий.
• Содержание — данные. Движок получает CONTENT целиком; истории и числа правятся без движка, числа перекрывает TUNING.
• Один сид — один вечер. Генератор случайных чисел с сидом и фиксированный шаг дают повторяемость.
• Инвариант вместо подбора. Число людей в часы пика сводится в коридор формулой.
• Слабая машина — первая. Качество подстраивается по кадрам, свет в основном запечён.

Слабые места