# TCG Companion 4.0 Alpha 16 — первая онлайн-дуэль Piovium

## Что готово

- **Два устройства и два разных аккаунта** TCG Companion: ведущий создаёт комнату по коду, второй игрок присоединяется по ссылке.
- **Независимые колоды 3+30**: демонстрационные, сохранённые в конструкторе или собственный игровой код.
- **Оригинальный движок Piovium** вычисляет правила партии в браузере ведущего. Второй игрок получает адресованное ему состояние и отправляет ответы на запросы Piovium через защищённые SQL RPC Supabase.
- Передаются выбор активного персонажа, стартовая рука, бросок и переброс кубиков, действия/карты/навыки, сдача и окончание партии. Результат пока НЕ учитывается в рейтинге.
- Изменения из Alpha 15 (поле, рука, эффекты, щиты, подсказки, управление) сохранены.
- Добавлено безопасное восстановление **гостевого** экрана: клиент получает последнее адресованное ему состояние и не выполняет повторно старые ходы после перезагрузки.

## Развёртывание тестовой версии

1. В Supabase Dashboard вашего проекта откройте **SQL Editor → New query**.
2. Вставьте и выполните весь файл `supabase_migration_4_0_alpha16_live.sql`. Не используйте эту миграцию для других проектов без проверки.
3. Опубликуйте полную сборку Alpha 16 в **отдельном тестовом проекте Cloudflare Pages** (или запустите локальный сервер). Не заменяйте основной сайт до сетевых испытаний.
4. В двух разных браузерах/на двух устройствах откройте тестовый сайт и войдите **в разные аккаунты TCG Companion** через страницу `profile.html`.
5. Откройте `online-duel.html` (или раздел «Играть → Онлайн-дуэль»).
6. Первый игрок выбирает колоду → **Создать комнату** → **Скопировать ссылку** и отправляет второму → **Открыть игровое поле**.
7. Второй игрок открывает ссылку, выбирает **свою** колоду и нажимает **Войти в комнату**.
8. Когда второй участник подключится, ведущий автоматически запустит Piovium. Игроки играют в отдельных браузерах; каждое действие вычисляет один экземпляр движка.

## Важно

- **Только нерейтинговые матчи по приглашению.** Ведущий выполняет Piovium на своём компьютере, поэтому может теоретически модифицировать игровой процесс. Этот прототип нельзя использовать для автоматического присвоения рейтинга или призов.
- **Не закрывайте и не перезагружайте вкладку ведущего во время партии**: состояние движка хранится там и пока не восстанавливается. Гость может обновить свою страницу; восстановление его интерфейса зависит от доступности ведущего.
- Обмен происходит через SQL RPC/опрос Supabase с интервалом около 0,5–1 с; это не мгновенное WebSocket-соединение. Для большого числа одновременных матчей потребуется более экономичный серверный протокол.
- Обновление не меняет существующие таблицы `ranked_matches`, `tcg_matches`, `matchmaking_queue`, рейтинг или старый PvP.
- Комната доступна только её участникам; данные игрока Б берутся из его PlayerIO-состояния Piovium. Однако ведущий владеет самим движком и технически может исследовать полное игровое состояние в своём браузере.
- Карты должны поддерживаться установленной версией данных Piovium.
- Смена ведущего/передача хоста, авто-восстановление хоста, зрители, серверный античит и рейтинговая интеграция **не реализованы**.

## Если не запускается

- «Function does not exist», «PGRST202»: SQL-миграция не применена или кеш схемы PostgREST не обновился. Повторно проверьте SQL Editor и выполните `NOTIFY pgrst, 'reload schema';`.
- «Войдите в аккаунт»: войдите в профиль и перезагрузите страницу, соблюдая один и тот же домен сайта.
- «Комната занята»: два разных аккаунта обязательны; создайте новую комнату.
- «Нет доступа»: проверьте, что ссылки открыты на одном тестовом проекте, подключённом к одному Supabase.
- Ведущий закрыл вкладку: создайте новый матч, поскольку состояние текущего Piovium уже потеряно.
- Для диагностики используйте журнал арены (кнопка «Журнал») и консоль разработчика браузера (F12).

## Техническая схема

```
Browser A (host) ─────── Piovium Game (iframe)
      │  state for guest → Supabase RPC → Browser B (guest)
      │  guest RPC reply ← Supabase RPC ← Browser B (guest)
      └─────────────── auth & room membership ──────────────┘
```

Все игровые запросы для ведущего остаются локальными. Гостю не передаётся состояние Piovium для места ведущего. Отправка в БД и получение из неё проверяются авторизацией участников в SQL RPC.

## Следующий этап

Для настоящего рейтингового PvP потребуется **серверный ведущий движок** (например, Cloudflare Worker + Durable Object с исполнением Piovium в поддерживаемой среде), управление сессией на сервере, строгое разграничение видимости и серверное подтверждение результатов. Это уже отдельная архитектурная задача, не косметический патч Alpha 16.

## Лицензия

Используемая часть Piovium — AGPL-3.0-or-later; оригинальная лицензия и соответствующие исходные файлы включены в `piovium/`.
