Danro-Jump/README.md

Danro Jump

Danro Jump — Unity-проект вертикального платформера в духе Doodle Jump, развиваемый как коммерчески применимая игровая система с аппаратной интеграцией, денежным балансом, призовой витриной, выдачей QR-призов и сервисным контуром для обслуживающего персонала.

Проект ориентирован не только на аркадный игровой цикл, но и на эксплуатацию на целевом автомате: запуск через защищённый startup-flow, работу с внешними устройствами по COM, настройку экономики без пересборки, диагностику, выдачу призов и сохранение важных эксплуатационных данных.

Целевая концепция

Основные направления продукта:

• быстрый вертикальный платформер с короткой игровой сессией;
• рост высоты, набор очков, монет и прогрессирующая сложность;
• денежный баланс для платного старта и continue;
• интеграция с внешним оборудованием по COM-порту;
• выдача малых и больших призов через призовую витрину;
• выдача призов или бонусов через QR-коды;
• сервисное меню для персонала с настройками, статистикой и служебными действиями;
• подготовка к длительной работе на целевом автомате.

Текущий статус

Текущая рабочая версия содержит широкий gameplay-, экономический и infrastructure-контур:

• Unity 6000.4.9f1;
• сцены Bootstrap, MainMenu и Game добавлены в Build Settings;
• старт приложения проходит через Bootstrap и сервисные runtime-системы;
• настроены Extenject, ProjectContext, scene installers и SceneFlowService;
• есть главное меню на UI Toolkit с правилами, настройками, фокусом клавиатуры/геймпада и переходом в игру;
• реализован вертикальный gameplay loop: игрок, камера, прыжки, платформы, смерть, respawn, game over и возврат в меню;
• есть HUD для счёта, высоты, рекорда, жизней, монет, смертей и состояния сессии;
• реализованы платформы, оборудование, коллектаблы, враги, weighted-spawn и ScriptableObject-прогрессия сложности;
• реализован и стабилизирован джетпак с подъёмом, блокировкой контактов, attach/detach, падением и VFX;
• есть COM-система: serial-транспорт, авторизация, роли устройств, входные биты, ADC, платёжные импульсы, денежный баланс, статусы призовых ячеек и команды открытия;
• есть кастомное устройство Input System для COM-контроллера;
• платный старт и continue через денежный баланс со списанием и проверкой достаточности;
• призовой flow: PrizeFlowService оценивает сессию по таблице призовых уровней и определяет тип награды;
• экраны continue (ContinueGameOverlayWindow) и результата приза (PrizeResultOverlayWindow);
• таблица призовых уровней с JSON-сериализацией и CRUD через сервисное меню;
• сервисное меню с маршрутизацией кнопок: статистика, настройки призов, QR, витрина, телефон, суперприз, поддержка, валюта, тест выдачи;
• модальные окна: настройки, правила, информационные, текстовый ввод, таблица и добавление призовых уровней;
• сервисные настройки загружаются через Addressables/fallback, сохраняются в JSON и доступны через UI;
• есть debug-модуль с каналами логирования, Unity Console/file handlers и development overlay;
• заведены EditMode и PlayMode-тесты для ключевых подсистем.

Архитектура

Gameplay

• GameplaySession — управляет состоянием забега: очки, монеты, жизни, смерти, высота, рекорд, continue и призовой flow
• PlatformSpawner / PlatformContentSpawner — спавн платформ и контента по весовым профилям
• GameplayDifficultyProgression — ScriptableObject-прогрессия сложности по этапам
• JumpPlayerController — управление игроком, прыжки, смерть, respawn
• VerticalCameraFollow — вертикальное слежение за игроком

Экономика и призы

• PrizeFlowService / IPrizeFlowService — оценка завершённой сессии и определение типа награды
• PrizeLevelTable — таблица призовых уровней с привязкой к порогам очков (JSON)
• PrizeRewardKind — типы наград: None, Small, Big, QRCode, Hopper, PrizeStand
• PrizeResultOverlayWindow — полноэкранный результат выдачи приза
• ContinueGameOverlayWindow — экран предложения продолжить игру за баланс

Сервисное меню

• SettingsModalWindow — динамическое построение UI настроек из ServiceSettingsDatabase
• ServiceSettingsActionRouter — маршрутизация кнопок сервисного меню в действия
• PrizeLevelsModalWindow / PrizeLevelAddModalWindow — управление таблицей призовых уровней
• ServiceTextInputModalWindow — текстовый ввод для телефонов и строковых настроек
• ServiceInfoModalWindow — отображение результатов сервисных действий
• ModalStackController — управление стеком модальных окон

Аппаратура

• ComSystem — управление COM-устройствами: авторизация, кредиты, ввод, подсветка, призовая витрина
• ComLightingSystem — аппаратная подсветка: board effects, hat blink, prize showcase
• ComControllerInputBridge — кастомное устройство Input System для COM-контроллера
• ReflectionSerialComTransport / ReflectionComPortProvider — транспортный слой через System.IO.Ports

Инфраструктура

• BootstrapEntryPoint / StartupProtectionService — защищённый startup-flow
• SceneFlowService — централизованная загрузка сцен
• ServiceSettingsService — чтение, применение и сохранение сервисных настроек
• DebugLogService — каналы логирования, Unity Console и файловый handler

Технологическая база

• Unity 6;
• Universal Render Pipeline для 2D;
• Input System;
• UI Toolkit;
• Test Framework;
• Extenject;
• UniTask;
• Addressables;
• DOTween;
• NuGet for Unity;
• локальная документация и проектные гайды в GUIDES.

Структура репозитория

• Assets/Scripts/Runtime/ — runtime-код, разбитый по подсистемам: Gameplay, Hardware/Com, Prizes, Settings, UI, Bootstrap, SceneFlow, Debugging;
• Assets/Scripts/Editor/ — редакторские расширения;
• Assets/Tests/ — EditMode и PlayMode тесты;
• Assets/Scenes/ — сцены Bootstrap, MainMenu, Game;
• Packages/ — зависимости проекта и пакетная конфигурация Unity;
• ProjectSettings/ — настройки Unity-проекта;
• GUIDES/ — проектные гайды по архитектуре, пакетам, workflow и инфраструктуре;
• ROADMAP.md — актуальная дорожная карта проекта;
• .codex/ — локальные настройки агентной работы и RAG/MCP-инфраструктуры.

Legacy reference

В Assets/Temp/Legacy сохранён архив старых материалов, которые используются как reference для миграции идей, API и сценариев. Этот код не следует подключать к runtime целиком.

Наиболее ценные направления для аккуратного переиспользования:

• аппаратный слой и COM-протокол;
• призовая витрина;
• QR-выдача;
• сервисные настройки;
• статистика и эксплуатационные UI-сценарии.

Перенос должен идти через новые интерфейсы, сервисы и UI-представления проекта, а не через прямой импорт старых managers/controllers.