Точка входа в документацию Payment Manager — выбери свою роль и перейди в нужный раздел.

Payment Manager — документация¶

Что такое Payment Manager¶

Payment Manager (PM) — единственный платёжный оркестратор OneWallet и единственный сервис с доступом к TigerBeetle SDK на запись.

Через PM проходят все денежные операции пользователей и мерчантов:

пополнения через PSP (IPPS, QP);
P2P-переводы между пользователями;
оплаты в мини-приложениях;
мерчант-инвойсы;
административные корректировки балансов.

Здесь же живут правила комиссий, дневные и месячные лимиты, step-up-политики (когда требуется подтверждение биометрией или PIN) и saga, которые ведут каждый intent от создания до окончательного расчёта в ledger.

Контекст в системе OneWallet¶

PM не существует в вакууме:

Auth Center выдаёт пользовательский JWT и зовёт POST /intents через nginx;
мини-приложения шлют HMAC-подписанные запросы напрямую в PM;
Admin Panel читает TigerBeetle в read-only через собственный SDK-доступ;
PSP-адаптеры (IPPS, QP) подключаются к PM через Redis Streams (Phase 2B).

Полная картина системы, разделение схем PostgreSQL (public.* vs pm.*) и кросс-сервисные правила — в корневом CLAUDE.md.

Куда идти дальше¶

Документация разделена по ролям читателя. Выбери себя:

Я бизнес или продукт¶

Продуктовое описание PM без терминов кода — что умеет кошелёк, какие сценарии оплаты поддержаны, какие правила и лимиты применяются к пользователям и мерчантам:

business/01-system-overview.md — что такое PM с точки зрения продукта и куда он встроен в OneWallet.
business/02-glossary.md — словарь ключевых терминов (intent, channel, operation type, fee, limit, policy).
business/03-payment-scenarios.md — основные пользовательские сценарии оплаты и перевода.
business/04-operation-types.md — какие типы операций различает PM и зачем.
business/05-fees-and-limits.md — как устроены комиссии и дневные/месячные лимиты.
business/06-auth-policies.md — когда требуется step-up (биометрия/PIN) и почему.
business/07-merchant-invoice-flow.md — мерчант-инвойсы: жизненный цикл и стороны процесса.
business/08-business-glossary-tigerbeetle.md — TigerBeetle и ledger в бизнес-терминах.
business/09-roadmap.md — что уже работает (Phase 1) и что планируется в Phase 2B и далее.
business/10-money-flow.md — money flow: как деньги заходят и выходят, роль system.equity.THB, блок про отчётность нацбанку / комплайнсу / бухгалтеру.

Я разработчик¶

Архитектура, модули, API, интеграции, операционные процедуры и рецепты для тех, кто пишет, тестирует или сопровождает код PM:

dev/README.md — навигатор по технической документации (architecture, modules, api, reference, integrations, operations, cookbook, testing).

Если только что присоединился к команде — начни с раздела «С чего начать» в dev/README.md, там расписан рекомендуемый порядок чтения.

Я devops или оператор¶

Эксплуатация PM в проде и стейджинге, разбор инцидентов и health-чеки:

dev/operations/deployment.md — Docker, окружения, выкат.
dev/operations/runbook.md — разбор типовых инцидентов и восстановление застрявших intent.
dev/operations/monitoring.md — метрики, алёрты, дашборды.
dev/operations/health-checks.md — endpoint'ы здоровья и readiness/liveness.

История изменений¶

CHANGELOG — что менялось в коде PM и почему. Обновляется в каждом PR.
CLAUDE.md (root) — кросс-сервисные правила и архитектурные инварианты системы OneWallet.