# AGENTS для deploy

## Главное

- Все вопросы деплоя SHiNE решать через эту папку `deploy/`.
- Скрипты лежат в `deploy/scripts/`.
- Production-серверы: `shineup.me` и `server2.shineup.me`.
- Test/devnet серверы: `t1.shineup.me`, `t2.shineup.me`, `t3.shineup.me`, `t4.shineup.me`.
- TURN-серверы: `turn1.shineup.me`, `turn2.shineup.me`, `turn3.shineup.me`.
- В deploy-документах и скриптах использовать домены, а не IP.

## Production safety

- Любой deploy на `shineup.me` или `server2.shineup.me` выполнять только после отдельного явного подтверждения пользователя.
- Перед production deploy обязательно проверить, что свежий бэкап лежит в `deploy/backup/archive/`.
- Production wrappers требуют наличие `deploy/backup/archive/<date>/MANIFEST.txt`.
- Секреты, `.env`, JWK, TURN shared secrets и приватные ключи не коммитить.

## Как деплоить

Сервер:

```bash
bash deploy/scripts/<target>_server.sh
```

UI:

```bash
bash deploy/scripts/<target>_ui.sh
```

Для настоящего `t2.shineup.me` использовать:

```bash
bash deploy/scripts/test_t2_server.sh
bash deploy/scripts/test_t2_ui.sh
```

Не путать `server2.shineup.me` и `t2.shineup.me`.

## Документы

- `README.md` — карта deploy-папки.
- `PRODUCTION_SERVERS.md` — production.
- `TEST_SERVERS.md` — test/devnet.
- `TURN_SERVERS.md` — TURN.
- `CONFIGURE_TURN_IN_SHINE.md` — подключение TURN к SHiNE backend.
- `SETUP_SERVER_FROM_ZERO.md` — сервер + Caddy + UI с нуля.
- `SETUP_TURN_SERVER.md` — TURN с нуля.
- `backup/README.md` — backup.

## Gradle

- Gradle deploy-задачи удалены.
- Для сборки jar общий server deploy script вызывает `./gradlew shadowJar`.
- Для локального запуска можно использовать `./gradlew startLocal`.