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

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

Функциональные характеристики

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

«Культура Платежей» — платформа для сопровождения международных платежей. Клиенты регистрируются, пополняют баланс сервиса в рублях и создают заявки на международные платежи. Менеджеры обрабатывают заявки, вручную выполняют переводы во внешних платёжных сервисах и фиксируют результаты в платформе. Программа рассчитывает суммы и комиссии и ведёт внутренний учёт средств в USD. Для работы через браузер предусмотрены клиентский и административный кабинеты. Доступ к действиям в административном кабинете зависит от назначенных ролей.

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

Назначение и пользователи

Клиент регистрируется, заполняет профиль компании, проходит проверку и работает со своими реквизитами и заявками. Проверяющий рассматривает профили клиентов. Оператор подтверждает поступления и обрабатывает выплаты. Суперадминистратор управляет сотрудниками, ролями и правилами комиссий, просматривает журнал аудита.

Сценарий международного платежа

  1. Регистрация клиента. Клиент регистрируется, заполняет профиль компании и отправляет его на проверку. В справочниках сохраняются реквизиты плательщика и зарубежного получателя.
  2. Пополнение баланса сервиса. Клиент создаёт заявку на пополнение в RUB и получает реквизиты и назначение платежа. Затем выполняет банковский перевод вне программы и может приложить платёжный документ. После подтверждения фактического поступления оператором программа зачисляет баланс в USD по курсу Банка России на дату поступления.
  3. Заявка на международный платёж. Клиент выбирает плательщика и получателя, валюту и сумму, проверяет расчёт комиссии и итоговое списание в USD. При необходимости прикладывает инвойс как подтверждающий документ и отправляет заявку на международный платёж. Создание заявки требует достаточного баланса и фиксирует списание в учёте.
  4. Обработка и результат. Менеджер с правами оператора обрабатывает заявку, вручную выполняет перевод во внешнем платёжном сервисе и фиксирует результат в административном кабинете. Статус и подтверждающие документы доступны в кабинете; движение средств отображается в истории.

К заявке можно приложить подтверждающие документы, например инвойс. Пополнение баланса сервиса не означает открытие клиенту банковского счёта в программе.

Основные функции

  1. Регистрация и профиль компании. Работа с учётной записью, заполнение сведений о компании и проверка профиля сотрудниками.
  2. Плательщики и получатели. Хранение реквизитов компаний, банков и SWIFT-реквизитов. Выбранные реквизиты сохраняются в заявке на момент её создания.
  3. Пополнения в RUB. Формирование заявки с номером, суммой, реквизитами и назначением платежа, загрузка платёжного документа. Оператор подтверждает фактически полученную сумму, дату и банковский идентификатор. Сервер рассчитывает зачисление USD по курсу Банка России на дату поступления без наценки. Загрузка документа сама по себе средства не зачисляет.
  4. Баланс и история. Учёт в USD, отображение пополнений, списаний и возвратов, фильтры истории и экспорт проводок в CSV. Повторное подтверждение одного поступления отклоняется.
  5. Международные платежи. Реализованный способ перевода — SWIFT. Поддерживаются USD, EUR, CNY, AED и GBP. До подтверждения отображаются сумма получателя, комиссия SWIFT, курс, валютная наценка и итоговое списание USD. При SHA комиссия удерживается из суммы получателя, при OUR добавляется к сумме списания в валюте платежа.
  6. Серверный расчёт. Котировка действует 15 минут и фиксирует курс, наценку и комиссию для клиента. Просроченная котировка обновляется. Недостаточный баланс блокирует создание заявки; повтор того же запроса не вызывает повторного списания. Для валют, отличных от USD, применяется кросс-курс Банка России и валютная наценка, заданная настройками сервера; в поставляемом выпуске её значение по умолчанию — 0,1%. Итог округляется до цента по правилу half-up.
  7. Обработка и возвраты. Принятие заявки в работу, фиксация выполнения и банковского идентификатора, загрузка подтверждения, отметка ошибки. Предусмотрены отмена ожидающей заявки клиентом и однократный возврат выполненной заявки оператором. При ошибке, отмене или возврате восстанавливается исходно списанная сумма USD.
  8. Курсы Банка России. Получение официальных курсов, учёт номинала валюты и даты действия, хранение в базе. Курсы запрашиваются при запуске и ежедневно начиная с 00:10 по Москве; при ошибке предусмотрены повторные попытки. Без подтверждённого курса новый расчёт конвертации блокируется.
  9. Администрирование и аудит. Разграничение доступа по ролям, работа со списками и карточками клиентов, пополнений и выплат, настройка комиссий. Существенные административные действия и финансовые корректировки фиксируются в журнале.

Состав системы

Четыре контейнерных сервиса: API, клиентский интерфейс, административный интерфейс и PostgreSQL. Внешний доступ по HTTPS обеспечивает хостовый Nginx. База и загруженные документы хранятся в постоянных томах. Банк России используется как внешний источник курсов.

Собственный код приложения написан на TypeScript. Сервер использует NestJS, Express и Prisma, интерфейсы — React. Состав зависимостей зафиксирован в комплекте выпуска.

Условия работы

Серверный комплект предназначен для Linux x86_64 с Docker Engine, Docker Compose с поддержкой up --wait и Python 3.9 или новее. Для внешнего доступа нужны домен, Nginx и доверенный TLS-сертификат; для получения курсов — исходящий HTTPS-доступ к www.cbr.ru.

Клиентское рабочее место — браузер с поддержкой JavaScript, HTTPS и cookie. Установка отдельного настольного приложения не требуется.

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

Установка и эксплуатация

Порядок развёртывания приведён в инструкции по установке. Действия пользователей описаны в руководстве по эксплуатации. Учётные данные для проверки предоставляются отдельно.

Скачать полное описание функциональных характеристик · DOCX ↓