# Рабочая платформа на сервере Hestia (пилот)

Решение владельца продукта (2026-11-18): пилот работает на сервере компании с панелью Hestia, рядом с песочницей и
другими сайтами компании. В облако (этапы 11.1–11.3: контейнеры, Kubernetes, управляемые PostgreSQL и Redis) платформа
переезжает, когда магазинов станет больше или сервер перестанет справляться. Адрес сервера — у владельца продукта.

| Адрес | Что |
|---|---|
| `https://app.rebonus.ru` | кабинеты магазинов и партнёров, Runtime API, Management API, API участника |
| `https://console.rebonus.ru` | консоль платформы (`CONSOLE_DOMAIN`) |
| `https://card.rebonus.ru/p/<адрес программы>/` | кабинет покупателя (`PORTAL_DOMAIN`) |
| `https://kassa.rebonus.ru` | веб-касса (`TILL_DOMAIN`) |
| `https://check.rebonus.ru` | окошко «Я не робот» кабинета покупателя (`PORTAL_CAPTCHA_DOMAIN`) |

Записи DNS не нужны: запись `*` домена rebonus.ru ведёт все поддомены на сервер.

## Что на сервере

- **Hestia.**
  - Пользователь `rebonusapp` без входа по SSH. Уведомления Hestia уходят на hello@rebonus.ru.
  - Сайт `app.rebonus.ru` с адресами `console`, `card`, `kassa` и `check.rebonus.ru`:
    - PHP-FPM 8.5, шаблон `rebonus-PHP-8_5`: общий с песочницей, это `PHP-8_5` без `open_basedir` (зачем и как —
      `deploy/sandbox-hestia/README.md`, «Шаблон PHP»);
    - сертификат Let's Encrypt на все пять имён, только HTTPS.
  - Пользователей, сайты, сертификаты и задания cron заводят только командами Hestia `v-*`. Другие сайты сервера не
    трогать.
- **PostgreSQL 17, свой экземпляр `prod`** на порту 5433, только localhost. Свой нужен потому, что роли базы
  (`loyal_app`, `loyal_rls_tenant` и другие, ADR-0002) общие на весь экземпляр: в одном экземпляре с песочницей её
  роли получили бы доступ к рабочей базе.
  - База `rebonus`, роли создаёт `db:bootstrap` при первой выкладке. Пароль суперпользователя `postgres` задаётся только
    на это время.
  - Роль `loyal_backup` читает всё (`BYPASSRLS`, `pg_read_all_data`) и ничего не меняет — для копий. Её пароль лежит в
    `~/.pgpass` пользователя `rebonusapp`.
  - Память урезана под общий сервер: `shared_buffers` 64 МБ, `max_connections` 40.
- **Код.** Лежит в `/home/rebonusapp/web/app.rebonus.ru/private/app/`:
  - `releases/<коммит>` — релизы;
  - `shared/` — `.env` с правами 600 и `storage`;
  - `current` — ссылка на текущий релиз.

  `public_html` сайта — ссылка на `private/app/current/public`.
- **Планировщик.** Задание cron пользователя `rebonusapp` в Hestia: каждую минуту `schedule:run`, с тем же
  `PHP_INI_SCAN_DIR=:/etc/php/8.5/rebonus-cli.d`, что у песочницы (pcntl, `deploy/sandbox-hestia/99-enable-pcntl.ini`).
  Задания он выполняет в своём процессе, отдельные процессы — только для фоновых (`deploy/sandbox-hestia/README.md`,
  «Что на сервере»).
- **Очередь.** Служба systemd `rebonus-app-queue` (очереди `default` и `offline`), файл —
  `rebonus-app-queue.service`.
- **Почта** — как у песочницы: exim сервера, `sendmail -t`, от noreply@rebonus.ru, подпись DKIM домена rebonus.ru.

## Резервные копии

- **База.** В 04:30 задание cron пользователя `rebonusapp` запускает `backup-db.sh` из текущего релиза:
  - выгрузка `pg_dump` в `private/backups`;
  - хранятся семь последних.
- **Копия Hestia.** В 05:10 Hestia сама копирует папку сайта вместе с выгрузками на сервер копий Timeweb в
  Санкт-Петербурге.
- **Ключи.** Исключены из копий Hestia (`v-update-user-backup-exclusions`,
  `WEB='app.rebonus.ru:.env:bootstrap/cache/config.php'`):
  - файл `.env` с `APP_KEY`, `PII_ENCRYPTION_KEYS` и `PII_BLIND_INDEX_KEY`;
  - кеш конфигурации каждого релиза `bootstrap/cache/config.php`: `config:cache` переписывает туда те же ключи и
    пароли базы. До 2026-11-20 он попадал в копии: ночная копия от 20.11 ещё их содержит, следующая заменит её
    (хранится одна).
  - Телефоны и почта в выгрузке зашифрованы этими ключами.
  - Копия ключей — у владельца продукта в менеджере паролей. Первая выкладка кладёт её в файл только для root
    `/root/rebonus-deploy/production-keys.txt`, владелец переносит её к себе, а файл удаляют.
  - Без этой копии телефоны и почту из резервной копии не восстановить.
- **Восстановление:**
  1. `pg_restore` в пустую базу экземпляра `prod`;
  2. `.env` с ключами из копии владельца;
  3. выкладка релиза.

## Выкладка новой версии

С машины разработчика, из корня репозитория. Нужны Node 22 и `sdk/typescript/node_modules`.

```bash
sha=$(git rev-parse --short HEAD)
composer till:build && composer portal:build
git archive --format=tar.gz -o code-$sha.tar.gz $sha
tar -czf builds-$sha.tar.gz public/till-app public/portal-app
scp code-$sha.tar.gz builds-$sha.tar.gz root@<сервер>:/root/rebonus-deploy/
scp deploy/production-hestia/deploy.sh root@<сервер>:/root/rebonus-deploy/deploy_production.sh
ssh root@<сервер> bash /root/rebonus-deploy/deploy_production.sh $sha /root/rebonus-deploy/code-$sha.tar.gz /root/rebonus-deploy/builds-$sha.tar.gz
```

Скрипт кладут под своим именем: в той же папке сервера лежит `deploy.sh` песочницы.

Скрипт:
1. распаковывает релиз;
2. ставит зависимости Composer без пакетов разработки;
3. выполняет миграции от владельца схемы;
4. кеширует конфигурацию, маршруты, события и шаблоны;
5. переключает `current`;
6. перезагружает PHP-FPM 8.5, чтобы новый релиз видели все процессы PHP, и перезапускает очередь.

Хранятся три последних релиза.

Первую выкладку запускают с последним аргументом `first`. Тогда скрипт ещё:
- пишет `.env` с новыми секретами;
- создаёт ключи, роли и базу, роль копий;
- кладёт копию ключей для владельца.

## Первый раз: что сделано руками (2026-11-18)

Все команды — от root, объекты Hestia — только командами Hestia.

1. Пользователь: `v-add-user rebonusapp <случайный пароль> hello@rebonus.ru`. Пароль никто не видел.
2. Сайт: `v-add-web-domain rebonusapp app.rebonus.ru <IP> yes "console.rebonus.ru,card.rebonus.ru,kassa.rebonus.ru,check.rebonus.ru"`,
   затем:
   - `v-change-web-domain-backend-tpl rebonusapp app.rebonus.ru PHP-8_5`;
   - `v-add-letsencrypt-domain rebonusapp app.rebonus.ru "<те же адреса>"`;
   - `v-add-web-domain-ssl-force rebonusapp app.rebonus.ru`.
3. PostgreSQL:
   - `pg_createcluster 17 prod --port 5433 --start`;
   - `shared_buffers` и `max_connections` через `pg_conftool`, затем перезапуск экземпляра.
4. Первая выкладка с `first`, затем `public_html` → `private/app/current/public`.
5. Служба очереди: `rebonus-app-queue.service` в `/etc/systemd/system`, `systemctl enable --now`.
6. Cron:
   - `v-add-cron-job rebonusapp "*" "*" "*" "*" "*" "<schedule:run>"`;
   - `v-add-cron-job rebonusapp 30 4 "*" "*" "*" "<backup-db.sh>"`.
7. Исключение из копий: `v-update-user-backup-exclusions rebonusapp <файл с WEB='app.rebonus.ru:.env'>`.
8. Администратор консоли — владелец продукта:
   - `php8.5 artisan staff:create verh@korzilla.ru --name=…`;
   - `staff:grant verh@korzilla.ru --platform --role=admin`.

   Пароль задаётся через «Забыли пароль?».
9. 2026-11-19: шаблон PHP `rebonus-PHP-8_5` вместо `PHP-8_5` —
   `v-change-web-domain-backend-tpl rebonusapp app.rebonus.ru rebonus-PHP-8_5`. Ответ ускорился с 0,7 до 0,1 с.
10. 2026-11-20: кеш конфигурации с ключами — тоже вне копий: `v-update-user-backup-exclusions rebonusapp <файл с
    WEB='app.rebonus.ru:.env:bootstrap/cache/config.php'>`. Файл — `/root/rebonus-deploy/backup-excludes-rebonusapp.conf`.

## Если что-то сломалось

- **Задачи планировщика не идут.** Снять блокировки — от `rebonusapp` с тем же `PHP_INI_SCAN_DIR`:

  ```bash
  php8.5 artisan schedule:clear-cache
  ```
- **Где смотреть.**
  - журнал — `shared/storage/logs/laravel-<дата>.log`;
  - состояние платформы — консоль, «Состояние системы»;
  - последняя выгрузка базы — `private/backups`.
- **Память.** На сервере 4 ГБ на все сайты. Если платформа или кассы отвечают медленно, память сервера увеличивают в
  панели Timeweb или платформа переезжает (см. начало).
