Культура Платежей← Все документы

ДОКУМЕНТАЦИЯ

Установка и запуск

Культура Платежей · Версия 1.0.0 · Правообладатель ООО «КУЛЬТУРА КОДА»

Инструкция описывает установку серверного выпуска «Культура Платежей» версии 1.0.0 из поставляемого комплекта готовых контейнерных образов. Node.js и средства сборки на сервере установки не требуются.

Новую установку выполняют в пустую схему базы данных. Повторная инициализация существующей установки не выполняется. Обычные остановка и запуск сохраняют данные.

1. Подготовка сервера

Проверенная конфигурация экземпляра: Debian GNU/Linux 13.7, 2 vCPU, 4 ГБ RAM, диск 40 ГБ, swap 2 ГБ. Это параметры проверенного экземпляра, а не заявленные минимальные требования.

python3 --version
docker info
docker compose version
docker compose up --help
nginx -v

Справка Docker Compose должна содержать параметр --wait.

2. Получение и проверка комплекта

Комплект 1.0.0.tar.gz и контрольная сумма SHA-256 предоставляются отдельно. Сравните контрольную сумму полученного файла с переданной вместе с комплектом. Замените пути в примере: каталог установки должен существовать и быть пустым.

sha256sum /path/to/1.0.0.tar.gz
tar -xzf /path/to/1.0.0.tar.gz -C /path/to/install

Перейдите в корневой каталог распакованного выпуска и выполните:

sha256sum -c SHA256SUMS
cd distribution
python3 run.py check

Все проверки должны завершиться без ошибок. Команда check проверяет состав и контрольные суммы файлов; доступность Docker и курсов она не проверяет.

3. Создание настроек

В примерах замените payments.example.org на домен нового экземпляра, а admin@example.org — на адрес создаваемого суперадминистратора. Из каталога distribution выполните один раз:

python3 run.py init \
    --web-origin https://payments.example.org \
    --admin-origin https://payments.example.org \
    --admin-email admin@example.org

В origins указывайте HTTPS-адрес без пути /admin/. Установщик сам формирует ADMIN_PUBLIC_URL с этим префиксом и создаёт файлы .local/installation.json и .local/runtime.env со случайными секретами.

Логин и пароль суперадминистратора находятся в SUPERADMIN_EMAIL и SUPERADMIN_PASSWORD файла .local/runtime.env. Файл имеет права 600 и не должен публиковаться. Сохраняйте .local вместе с резервными копиями.

4. Запуск сервисов

python3 run.py up
python3 run.py status

Установщик загружает поставленные образы и запускает API, клиентский интерфейс, административный интерфейс и PostgreSQL. Сборка и скачивание образов из внешнего реестра не выполняются. При первом запуске API применяет миграции новой базы и создаёт суперадминистратора.

API доступен на 127.0.0.1:8091, клиентский интерфейс — на 127.0.0.1:8092, административный — на 127.0.0.1:8093. PostgreSQL наружу не публикуется. Браузеры обращаются к интерфейсам через хостовый HTTPS-прокси.

5. Внешний доступ через HTTPS

Настройте хостовый Nginx. Административный интерфейс собран для /admin/, оба интерфейса обращаются к API через /api/. Пример конфигурации:

server {
    listen 80;
    server_name payments.example.org;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    server_name payments.example.org;
    ssl_certificate /etc/letsencrypt/live/payments.example.org/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/payments.example.org/privkey.pem;
    client_max_body_size 15m;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    location = /admin {
        return 301 /admin/;
    }
    location /admin/ {
        proxy_pass http://127.0.0.1:8093/;
    }
    location /api/ {
        proxy_pass http://127.0.0.1:8091/;
        proxy_cookie_path /v1/ /api/v1/;
    }
    location / {
        proxy_pass http://127.0.0.1:8092;
    }
}

Замените домен и пути сертификата на фактические. Установите конфигурацию в подключаемый каталог Nginx вашей ОС, проверьте и примените её:

sudo nginx -t
sudo systemctl reload nginx

Завершающий / в proxy_pass для /admin/ и /api/ удаляет внешний префикс перед передачей запроса контейнеру. Cookie Path переписывается с /v1/ на /api/v1/; атрибуты Secure и HttpOnly сохраняются.

6. Проверка установки

  1. Проверьте состояние сервисов командой python3 run.py status.
  2. Откройте клиентский кабинет по HTTPS и административный интерфейс по пути /admin/.
  3. Войдите в административный интерфейс под созданным суперадминистратором. Проверьте дату курсов и результат синхронизации.
  4. Зарегистрируйте тестового клиента и заполните профиль компании. Подтвердите профиль в административном кабинете с учётной записью проверяющего.
  5. Создайте тестовое пополнение в RUB и подтвердите его оператором. Проверьте зачисление USD и запись в истории.
  6. Выберите плательщика и зарубежного получателя, сформируйте тестовую заявку на международный платёж способом SWIFT. При необходимости приложите тестовый инвойс как файл; проверьте комиссию и итог списания. Проверьте отмену ожидающей заявки и восстановление суммы в USD.
  7. Убедитесь, что данные сохраняются после штатных остановки и запуска.

Демонстрационные реквизиты не используются для реальных переводов. В рабочем процессе менеджер вручную выполняет перевод во внешнем платёжном сервисе и фиксирует результат в административном кабинете. При тестировании реальный перевод не выполняется.

7. Остановка и повторный запуск

Из каталога distribution выполните:

python3 run.py stop
python3 run.py up

Постоянные данные сохраняются. Не удаляйте тома PostgreSQL и uploads и не выполняйте повторный init существующей установки. Перед обновлениями сохраняйте базу, вложения и конфигурацию.

Предоставленный демонстрационный экземпляр

Клиентский кабинет: demo.kulturapay.ru. Административный интерфейс: demo.kulturapay.ru/admin/. Учётные данные эксперта передаются отдельно. SSH для работы через браузер не требуется.

Сценарии использования приведены в руководстве по эксплуатации.