# Deploy SHiNE

Эта папка — единая точка входа по деплою SHiNE.

## Правило

- Все deploy-документы, deploy-скрипты и backup-инструкции держать здесь.
- Deploy-привязки задавать через домены, а не через IP.
- Production-серверы менять только после отдельного явного подтверждения пользователя.
- Production deploy выполнять только после обновления локального бэкапа в `deploy/backup/archive/`.

## Контуры

- Основной production: `shineup.me`.
- Второй production: `server2.shineup.me`.
- Test/devnet стенд: `t1.shineup.me`, `t2.shineup.me`, `t3.shineup.me`, `t4.shineup.me`.

Краткое текущее состояние на `2026-07-28`:

- оба production уже на `PostgreSQL 18.4` в отдельных Docker-контейнерах `shine-postgres`;
- весь test/devnet стенд `t1`-`t4` тоже уже на `PostgreSQL 18.4`;
- тестовые контуры используют общий Docker-контейнер `shine-test-postgres`;
- production использует Helius mainnet, test/devnet использует Helius devnet;
- актуальные подробности по всем шести серверам смотреть в `PRODUCTION_SERVERS.md` и `TEST_SERVERS.md`.

## Основные документы

- `PRODUCTION_SERVERS.md` — production-контуры.
- `TEST_SERVERS.md` — test/devnet-контуры.
- `TURN_SERVERS.md` — TURN-серверы.
- `POSTGRESQL_SERVERS_STANDARD.md` — целевой стандарт PostgreSQL для всех серверов SHiNE.
- `SOLANA_USERS_SYNC_SERVER_SETUP.md` — интеграция синхронизации пользовательских Solana PDA в основной сервер.
- `CONFIGURE_TURN_IN_SHINE.md` — как подключить TURN к SHiNE backend.
- `SETUP_SERVER_FROM_ZERO.md` — настройка SHiNE-сервера и UI с нуля.
- `SETUP_TURN_SERVER.md` — настройка TURN через Caddy/DNS/TLS.
- `AGENT_BOT_CODER_LOCAL_SYSTEMD.md` — локальный systemd-deploy Telegram-бота агента-кодера.
- `AGENTS.md` — правила для агента при деплое.

## Скрипты

Общие скрипты:

- `scripts/deploy_server.sh` — обновить существующий серверный jar и перезапустить systemd service.
- `scripts/deploy_ui.sh` — обновить существующий UI, проверить Caddy root и подставить `deploy-config.js`.

Production wrappers:

- `scripts/production_shineupme_server.sh`
- `scripts/production_shineupme_ui.sh`
- `scripts/production_server2_server.sh`
- `scripts/production_server2_ui.sh`

Test/devnet wrappers:

- `scripts/test_t1_server.sh`
- `scripts/test_t1_ui.sh`
- `scripts/test_t2_server.sh`
- `scripts/test_t2_ui.sh`
- `scripts/test_t3_server.sh`
- `scripts/test_t3_ui.sh`
- `scripts/test_t4_server.sh`
- `scripts/test_t4_ui.sh`

## Примеры

UI на настоящий тестовый `t2.shineup.me`:

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

Сервер на настоящий тестовый `t2.shineup.me`:

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

Production UI на `server2.shineup.me`:

```bash
bash deploy/scripts/production_server2_ui.sh
```

Production server на `shineup.me`:

```bash
bash deploy/scripts/production_shineupme_server.sh
```