# TCG Companion 4.0 Beta · браузерная публикация локального Piovium

## Что готово
- `index.html`: отдельная стартовая страница тестовой версии, не связанная с основным Supabase
- `deck-lab.html`: редактор 3 персонажей + 30 карт; кнопка «Играть этой колодой в Piovium» открывает русское поле с выбранным набором
- `piovium-arena.html`: русское поле, Piovium рассчитывает действия и игровые эффекты; два игрока за одним устройством
- `piovium-engine.html`: оригинальный режим Piovium, запасной способ диагностики
- `piovium/`: собранный клиент, исполняемый мост, лицензия и соответствующие исходники

## Проверка локально
1. Распакуйте ZIP полностью.
2. Откройте CMD в папке и выполните `py -m http.server 8000`.
3. Откройте `http://localhost:8000` и запустите две демонстрационные колоды.
4. Затем выберите 3 персонажей и 30 карт в конструкторе и нажмите «Играть этой колодой в Piovium».
5. Второму игроку можно оставить демонстрационную колоду либо выбрать сохранённую.

## Публикация без риска для рабочего сайта
1. Cloudflare Dashboard → Workers & Pages → Create → Pages → Direct Upload.
2. Создайте **новый тестовый проект** (например `tcg-piovium-beta`), не меняйте `tcg-companion`.
3. Загрузите содержимое распакованной папки Beta (или ZIP, если интерфейс это поддерживает), а не папку уровнем выше. `index.html` должен лежать в корне сайта.
4. Проверьте новый `https://<ваш-проект>.pages.dev/`: стартовую страницу, обе демо-колоды, действия, выбор собственных колод.
5. Существующий Supabase не нужен для этого теста. **Не надо вводить сервисный ключ Supabase.**

В Pages ограничение на один статический файл 25 MiB; этот комплект проверяется на соблюдение лимита при сборке.

## Ограничения
- **Это локальный hotseat-режим**, не сетевой бой между устройствами. Для настоящего онлайн-PvP необходим сервер, который создаёт Game, проверяет команды, раздельно отправляет информацию игроков и поддерживает переподключение.
- Наличие Piovium ID не доказывает, что карта разрешена в конкретной версии или в конкретной колоде.
- В каталоге есть токены, формы персонажей и дополнительные карты без стандартного share ID, поэтому не все 816 записей могут быть помещены в стандартную колоду через этот редактор.
- Известные ошибки движка Piovium также могут возникать в этой сборке.

## Лицензия
Основной Piovium и код интеграции подпадают под AGPL-3.0-or-later; сохранены LICENSE, исходники и ссылки. При публикации исходный код соответствующей версии должен быть доступен посетителям.
