51 lines
3.8 KiB
Markdown
51 lines
3.8 KiB
Markdown
# Вечерний детектив — приложение площадки
|
||
|
||
Статус: SCREEN-001 в работе; технический стенд реализован, аппаратная приёмка открыта.
|
||
Архитектура пересмотрена 17.10.2026: добавлен пульт телефона по доверенной LAN.
|
||
|
||
Цель: ведущий управляет показом на компьютере с macOS, Windows или Linux, а подключённый монитор или
|
||
проектор показывает материалы игрокам. Все материалы показа заранее находятся
|
||
на диске; локальная команда не ждёт сеть или ответ сервера.
|
||
|
||
Стек: Electron + Vue + TypeScript + Vite. Первая версия включает шесть сборок:
|
||
macOS Intel/Apple Silicon, Windows x64/ARM64 и Linux x64/ARM64.
|
||
Поддерживаемые версии ОС и условия проверки описаны в PLAN.md.
|
||
Использовать текущие паттерны фронтенда и переиспользовать подходящие компоненты,
|
||
не переносить весь сайт в приложение и не выделять общий пакет заранее.
|
||
|
||
План: [PLAN.md](PLAN.md). Очередь реализации: [TASKS.md](TASKS.md).
|
||
Эти документы находятся здесь по прямому указанию владельца — исключение из
|
||
общего правила хранения задач в `../docs/agent`. Не дублировать их там.
|
||
Идентификаторы `SCREEN-*` относятся только к этому приложению.
|
||
|
||
Для начала: `Выполнить задачу: SCREEN-001`.
|
||
Новые задачи: `Новая задача: <описание>`.
|
||
Commit и push выполняет только пользователь. Вложенные `.git` не изменять.
|
||
|
||
## Запуск стенда SCREEN-001
|
||
|
||
Нужны Node.js 24.15+ и ffmpeg с libx264 в PATH.
|
||
|
||
```sh
|
||
npm ci
|
||
npx --no-install install-electron --no
|
||
npm run media:generate
|
||
npm run dev
|
||
```
|
||
|
||
До запуска подключите второй дисплей в режиме расширенного рабочего стола
|
||
и назначьте экран компьютера основным. В пульте выберите
|
||
его и откройте показ. Аудио и видео — синтетические локальные файлы длительностью
|
||
60 секунд; бинарники находятся в игнорируемом fixtures/ и не входят в Git.
|
||
Стенд поддерживает пуск с начала, паузу, остановку и перемотку. Полные игровые
|
||
режимы, загрузка игр и авторизация пока не реализованы.
|
||
|
||
Для телефона выберите IPv4-адрес доверенной сети и включите LAN-пульт. Откройте
|
||
показанный адрес в браузере телефона, введите код и подтвердите запрос с тем же
|
||
коротким идентификатором на компьютере. Отключение LAN отзывает все подключения.
|
||
Если устройства не видят друг друга, проверьте firewall и изоляцию клиентов Wi-Fi;
|
||
локальный пульт компьютера продолжает работать.
|
||
|
||
Проверки: npm run type-check, npm run lint, npm run lint:css, npm test, npm run build.
|
||
[Сборки и аппаратная приёмка](docs/SCREEN-001_ACCEPTANCE.md).
|