1.2.1 Core - Пользователи и Роли | Документация PSP Aggregator

Документ описывает роли, статусы пользователей, права доступа и основные возможности платформы PSP Aggregator.

1. Упрощения архитектуры MVP

Управление провайдерами: данные провайдеров ведут только Admin / SuperAdmin. У провайдера нет доступа в систему.
Закрытая регистрация: единая статичная инвайт-ссылка, которую рассылает SuperAdmin. Свободного Sign Up нет.
Модерация и доступ: новые регистрации получают статус Pending без роли. Роль назначает только SuperAdmin.

Платформа поддерживает четыре роли с кабинетом: SuperAdmin, Admin, Агент, Мерчант. Провайдер — сущность каталога, не роль пользователя.

Главный администратор системы. Зона ответственности — доступ и роли. SuperAdmin обладает всеми правами Admin.

Управление пользователями: только SuperAdmin имеет доступ к модулю Users. Назначает роли (Admin, Agent, Merchant), блокирует и деактивирует аккаунты, обрабатывает заявки в Pending.
Журнал аудита: доступ к логам критических действий в системе.

Сотрудник платформы, отвечает за каталог, провайдеров и сделки.

Управление провайдерами и офферами: создание и редактирование карточек провайдеров, формирование публичных офферов для каталога.
Доступ к экономике: Admin и SuperAdmin видят Real Name провайдера, Raw Provider Rate и Platform Margin, задают Base Rate.
Управление сделками: модерация спорных сделок, флоу Admin Outbound (прямое предложение мерчанту, Agent Margin = 0).
Доступ к мерчантам: Admin не управляет ролями, но видит список активных мерчантов (read-only) для прямой отправки предложений.

Привлекает мерчантов и подбирает решение из каталога.

Просмотр каталога: видит Alias оффера и Base Rate. Real Name провайдера агенту не открывается.
Формирование Proposal: выбирает офферы, задаёт Agent Margin, генерирует Secure-ссылку.
Ограничение по ставке: агент не может снизить Base Rate. Для этого — пинг Request Special Terms админу. Пре-аппрува Admin на отправку ссылки нет.
Срок жизни ссылки: Secure-ссылка деактивируется через 1 неделю; сделка переходит в Revoked.
Закрепление мерчанта: в MVP мерчант закрепляется за агентом по факту созданной сделки.

Бизнес, который ищет платежное решение.

Просмотр предложения: по Secure-ссылке видит Final Fee / Total Fee как единую ставку. В каталоге (Merchant Inbound без агента) видит Base Rate. До Agreed виден Alias, не Real Name.
Решение по сделке: в MVP мерчант принимает или отклоняет условия. Торг идёт в Telegram; агент обновляет маржу в тикете. Текстовый чат в сделке и field-level comments — [Post-MVP].
Личный кабинет: история запросов и активные интеграции. Доступ выдаёт SuperAdmin через назначение роли.

Статус	Смысл
`Pending`	Регистрация по инвайту, роль ещё не назначена
`Active`	Роль назначена, доступ в платформу открыт
`Blocked`	Доступ принудительно закрыт
`Inactive`	Учётная запись деактивирована
`Rejected`	Заявка на регистрацию отклонена SuperAdmin

Модуль / Действие	SuperAdmin	Admin	Агент	Мерчант
Пользователи (Users & Access)
Управление ролями, блокировки	Да	Нет	Нет	Нет
Просмотр списка Merchant / Agent	Да	Да (read-only для сделок)	Нет	Нет
Провайдеры (Providers)
Создание / редактирование провайдера	Да	Да	Нет	Нет
Видимость `Real Name`	Да	Да	Нет	После `Agreed`
Каталог (Offers)
Просмотр ставок	`Raw Provider Rate`, `Platform Margin`, `Base Rate`	`Raw Provider Rate`, `Platform Margin`, `Base Rate`	`Base Rate`	`Total Fee` (inbound без агента = `Base Rate`)
Создание / редактирование оффера	Да	Да	Нет	Нет
Сделки (Deals)
Merchant Inbound из каталога	Нет	Нет	Нет	Да
Сборка Proposal и отправка ссылки	Да	Да	Да	Нет
Назначение `Agent Margin`	Нет	Нет	Да	Нет
Отзыв отправленного предложения	Да	Да	Да (своих)	Да (`Declined`)

После Agreed Real Name провайдера открывается мерчанту. Admin / SuperAdmin видят Real Name и Raw Provider Rate всегда.