Self AR Admin: Десктопная панель управления AR-киоском
Self AR Admin — это специализированное десктопное приложение на Electron, предназначенное для настройки и конфигурации интерактивных AR-фотобудок (киосков). Инструмент заменяет ручное редактирование сложных JSON-конфигов интуитивно понятным визуальным интерфейсом.
| Метрика | Значение |
|---|---|
| Тип | Desktop App (Windows/Portable) |
| Runtime | Electron + Node.js |
| Связь | Embedded REST API (Localhost) |
| UI | Material UI (Dark Theme) |
Краткая выжимка (TL;DR)
Разработка “админки для оффлайна”. Создание надежного инструмента для операторов фотобудок с глубоко вложенными формами, управлением файловой системой и запуском внешних Unity-процессов.
Ключевые инженерные решения
🏗️ Гибридная архитектура (Electron + Express)
Вместо стандартного IPC (Inter-Process Communication), я внедрил нестандартное, но эффективное решение:
- Embedded Express Server: Внутри Main-процесса Electron запущен легковесный Express-сервер.
- REST API на localhost: Renderer-процесс (React) общается с системными функциями через обычные HTTP-запросы. Это обеспечило чистоту кода, легкую тестируемость и отсутствие необходимости
nodeIntegration.
📝 Управление сложными данными
- Глубокая вложенность: Реализовал форму с 3 уровнями вложенности (Библиотеки -> Сцены -> Персонажи) через
react-final-formиFieldArray. - Парсинг и валидация: Система автоматического парсинга и генерации JSON-конфигов со сложной схемой именования файлов и поддержкой обратной совместимости форматов.
- Динамические порты: Реализовал механизм автоматического поиска свободного порта для встроенного сервера, что позволяет запускать несколько копий админки.
⚙️ Системная интеграция
- Управление процессами: Реализовал запуск внешнего Unity-приложения (
selfar.exe) с передачей актуальных параметров конфигурации одной кнопкой. - Hardware Config: Интерфейс для настройки COM-портов камер и принтеров, SMTP-серверов и параметров видеопотока.
Технические детали
- Material UI: Использование темной темы для комфортной работы операторов в затемненных помещениях инсталляций.
- Portable Mode: Оптимизация сборки через
electron-builderдля работы приложения с переносных носителей. - Testing: Интеграция Jest для логики и TestCafe для сквозного тестирования интерфейса.