ДОКУМЕНТАЦИЯ
Функциональные характеристики
Культура Платежей · Версия 1.0.0 · Правообладатель ООО «КУЛЬТУРА КОДА»
«Культура Платежей» — платформа для сопровождения международных платежей. Клиенты регистрируются, пополняют баланс сервиса в рублях и создают заявки на международные платежи. Менеджеры обрабатывают заявки, вручную выполняют переводы во внешних платёжных сервисах и фиксируют результаты в платформе. Программа рассчитывает суммы и комиссии и ведёт внутренний учёт средств в USD. Для работы через браузер предусмотрены клиентский и административный кабинеты. Доступ к действиям в административном кабинете зависит от назначенных ролей.
Менеджер с правами оператора обрабатывает заявки в административном кабинете. Переводы выполняются вручную во внешних платёжных сервисах; платформа хранит результат обработки и отражает движение средств в учёте.
Назначение и пользователи
Клиент регистрируется, заполняет профиль компании, проходит проверку и работает со своими реквизитами и заявками. Проверяющий рассматривает профили клиентов. Оператор подтверждает поступления и обрабатывает выплаты. Суперадминистратор управляет сотрудниками, ролями и правилами комиссий, просматривает журнал аудита.
Сценарий международного платежа
- Регистрация клиента. Клиент регистрируется, заполняет профиль компании и отправляет его на проверку. В справочниках сохраняются реквизиты плательщика и зарубежного получателя.
- Пополнение баланса сервиса. Клиент создаёт заявку на пополнение в RUB и получает реквизиты и назначение платежа. Затем выполняет банковский перевод вне программы и может приложить платёжный документ. После подтверждения фактического поступления оператором программа зачисляет баланс в USD по курсу Банка России на дату поступления.
- Заявка на международный платёж. Клиент выбирает плательщика и получателя, валюту и сумму, проверяет расчёт комиссии и итоговое списание в USD. При необходимости прикладывает инвойс как подтверждающий документ и отправляет заявку на международный платёж. Создание заявки требует достаточного баланса и фиксирует списание в учёте.
- Обработка и результат. Менеджер с правами оператора обрабатывает заявку, вручную выполняет перевод во внешнем платёжном сервисе и фиксирует результат в административном кабинете. Статус и подтверждающие документы доступны в кабинете; движение средств отображается в истории.
К заявке можно приложить подтверждающие документы, например инвойс. Пополнение баланса сервиса не означает открытие клиенту банковского счёта в программе.
Основные функции
- Регистрация и профиль компании. Работа с учётной записью, заполнение сведений о компании и проверка профиля сотрудниками.
- Плательщики и получатели. Хранение реквизитов компаний, банков и SWIFT-реквизитов. Выбранные реквизиты сохраняются в заявке на момент её создания.
- Пополнения в RUB. Формирование заявки с номером, суммой, реквизитами и назначением платежа, загрузка платёжного документа. Оператор подтверждает фактически полученную сумму, дату и банковский идентификатор. Сервер рассчитывает зачисление USD по курсу Банка России на дату поступления без наценки. Загрузка документа сама по себе средства не зачисляет.
- Баланс и история. Учёт в USD, отображение пополнений, списаний и возвратов, фильтры истории и экспорт проводок в CSV. Повторное подтверждение одного поступления отклоняется.
- Международные платежи. Реализованный способ перевода — SWIFT. Поддерживаются USD, EUR, CNY, AED и GBP. До подтверждения отображаются сумма получателя, комиссия SWIFT, курс, валютная наценка и итоговое списание USD. При SHA комиссия удерживается из суммы получателя, при OUR добавляется к сумме списания в валюте платежа.
- Серверный расчёт. Котировка действует 15 минут и фиксирует курс, наценку и комиссию для клиента. Просроченная котировка обновляется. Недостаточный баланс блокирует создание заявки; повтор того же запроса не вызывает повторного списания. Для валют, отличных от USD, применяется кросс-курс Банка России и валютная наценка, заданная настройками сервера; в поставляемом выпуске её значение по умолчанию — 0,1%. Итог округляется до цента по правилу half-up.
- Обработка и возвраты. Принятие заявки в работу, фиксация выполнения и банковского идентификатора, загрузка подтверждения, отметка ошибки. Предусмотрены отмена ожидающей заявки клиентом и однократный возврат выполненной заявки оператором. При ошибке, отмене или возврате восстанавливается исходно списанная сумма USD.
- Курсы Банка России. Получение официальных курсов, учёт номинала валюты и даты действия, хранение в базе. Курсы запрашиваются при запуске и ежедневно начиная с 00:10 по Москве; при ошибке предусмотрены повторные попытки. Без подтверждённого курса новый расчёт конвертации блокируется.
- Администрирование и аудит. Разграничение доступа по ролям, работа со списками и карточками клиентов, пополнений и выплат, настройка комиссий. Существенные административные действия и финансовые корректировки фиксируются в журнале.
Состав системы
Четыре контейнерных сервиса: 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 ↓
← Все документы