# GLOSSARY.md ## GLOSSARY.md — Ubiquitous Language CardApp / МояКарта Единый глоссарий домена CardApp / МояКарта, собранный из `DOMAIN.md`, `EVENT_STORMING.md` и `SERVICE_POLICIES.md`. Цель документа — зафиксировать общий язык для продукта, разработки, аналитики, поддержки, админки и event sourcing-модели. Документ задаёт canonical terms. Если в старых документах встречается другой термин или другое значение, приоритет имеет этот глоссарий, если явно не указано обратное. *** ### Правила языка #### Canonical term Для каждого важного понятия должен быть один canonical term. В интерфейсах можно использовать человекочитаемый русский текст, но в коде, событиях, аналитике и спецификациях нужно придерживаться canonical name. Пример: ``` Русский термин: Пополнение Canonical name: Deposit События: Sbp.Deposit.Initiated, Wallet.CryptoDeposit.Credited ``` #### Не смешивать бизнес-термин и техническую реализацию Если пользователь видит «баланс карты», это не значит, что у пользователя есть отдельный реальный банковский или crypto-счёт. Внутри средства лежат в master/omnibus accounts, а пользовательский баланс — это ledger projection. #### Event naming События называются в прошедшем времени и фиксируют факт, который уже произошёл. Рекомендуемый формат: ``` Context.Aggregate.EventName ``` Примеры: ``` User.Registered Card.IssuanceConfirmed Sbp.Deposit.Credited Ledger.Entries.Posted ``` #### Команды и события не путать Команда — намерение что-то сделать. Событие — факт, что это уже произошло. Примеры: ``` Command: RequestCardIssuance Event: Card.IssuanceRequested Command: PostLedgerEntries Event: Ledger.Entries.Posted ``` *** ### Название продукта и системные обозначения | Термин | Canonical name | Определение | Не путать с | | ------------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | | CardApp / МояКарта | CardApp | Рабочее название сервиса: финтех-продукт для открытия виртуальных/физических карт, пополнения через СБП/crypto и карточных платежей. | Не путать с конкретным приложением Telegram Mini App или Web. | | Сервис | Service | Весь продуктовый и операционный контур CardApp: приложения, backend, провайдеры, админка, ledger, support. | Не только frontend. | | Платформа | Platform | Внутренняя система CardApp, которая связывает пользователя, карты, депозиты, ledger, провайдеров и админку. | Не путать с Telegram/MAKS platform. | | Приложение | App | Клиентский интерфейс: Telegram Mini App, Web, future mobile app. | Не равно всему сервису. | | Telegram Mini App | TelegramMiniApp | Канал входа и интерфейс внутри Telegram. | Не является отдельной бизнес-логикой. | | Web-версия | WebApp | Веб-интерфейс CardApp. | Не отдельный продукт. | | MAKS Mini App | MaksMiniApp | Future scope. Потенциальный канал входа и уведомлений через MAKS. | В v1 не моделируется как активная платформа. | *** ### Акторы и роли | Термин | Canonical name | Определение | Не путать с | | ------------------------------------ | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Пользователь | User | Любой зарегистрированный пользователь сервиса: не имеет карты. | Не обязательно прошёл KYC. | | Держатель карты | Cardholder | User, у которого есть хотя бы одна открытая карта. В актуальной модели Cardholder не обязан заранее пройти KYC, так как KYC risk-based. | В старом `DOMAIN.md` Cardholder был определён как User с KYC Basic и Upstream `kyc_entity_id`; это устарело для текущей политики. | | Гость | Guest | Человек, который открыл ссылку/лендинг/mini app, но ещё не завершил регистрацию. | Не имеет полноценного аккаунта. | | Реферал / приглашённый пользователь | ReferralInvitee | User, пришедший по реферальной ссылке другого пользователя. | Не партнёр. | | Реферер / пригласивший пользователь | Referrer | User, который создал реферальную ссылку и пригласил другого пользователя. | Не affiliate partner. | | Партнёр | AffiliatePartner | Внешний B2B/B2B2C-партнёр: канал, инфлюенсер, арбитражник, вебмастер или команда, привлекающая трафик через партнёрскую программу. | Не обычный пользователь с реферальной ссылкой. | | AI-ассистент | AiAssistant | AI-слой поддержки, который отвечает строго по knowledge base, собирает данные и эскалирует к человеку. | Не принимает финальные решения по спорам, KYC, возвратам или ограничениям. | | Support / сотрудник поддержки | SupportOperator | Оператор поддержки, который отвечает пользователю, собирает данные, создаёт и эскалирует запросы. | Не может делать refunds, manual adjustments или снимать ограничения. | | Admin | Admin | Администратор с расширенными правами и участием в critical approvals. | Не должен обходить ledger/audit/four-eyes. | | Control Observer / оператор контроля | ControlObserver | Read-only роль отдела контроля. Подтверждает сверки и high-risk операции как второй участник approval. | Не имеет прав изменять данные или выполнять финансовые действия. | | Провайдер | Provider | Внешняя система, предоставляющая услугу: card issuing, CaaS, СБП, custody, KYC, notification delivery. | Не пользователь и не партнёр. | *** ### Bounded Contexts | Термин | Canonical name | Определение | | | | ----------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ---------------------- | | Источники входа | EntrySources |

Контекст ссылок, источников трафика, first-touch attribution и funnel entry.
(было заменено с Вход и атрибуция AcquisitionAndAttribution)

| | | | Идентификация и доступ | IdentityAndAccess | Регистрация, email/phone, OTP, 2FA, sessions, devices, platform identities. | | | | KYC и compliance | KycAndCompliance | Risk-based KYC, внешний KYC provider, sanctions/PEP/watchlist статусы, депозитные ограничения. | | | | Тарифы и открытие карты | TariffsAndCardOpening | Тарифы, цены, FX markup, quote, оплата открытия карты. | | | | Карты | Cards | Жизненный цикл карты: выпуск, реквизиты, frozen/blocked, доставка, закрытие, incident reissue. | | | | СБП-депозиты | SbpDeposits | Приём RUB через СБП, плательщик, лимиты, возвраты, KYC triggers. | | | | Crypto-депозиты | CryptoDeposits | Приём crypto/stables, late/unmatched deposits, claim flow. | | | | Платежи и 3DS | PaymentsAnd3DS | Card authorizations, 3DS, clearing, reversals, refunds, decline reasons. | | | | Ledger и финансы | LedgerAndFinance | Double-entry ledger, master accounts, ledger entries, projections, manual adjustments. | | | | Казначейство | Treasury | Funding CaaS/card providers, provider credit limit, liquidity alerts, treasury operations. | | | | Risk | Risk | Риск-сигналы, risk evaluation, restrictions, warnings. | | | | Поддержка и споры | SupportAndDisputes | Тикеты, AI intake, disputes, escalation to human/upstream. | | | | Реферальная программа | Referral | User-to-user referral links, activation, rewards, transfer to card. | | | | Партнёрская программа | Affiliate | Affiliate cabinet, links/QR, Sub-ID, CPA/RevShare, postback API, payouts. | | | | Уведомления | Notifications | Notification preferences, categories, channels, delivery lifecycle. | | | | Админка | AdminPanel |

AdminPanel sections, roles, permissions, approvals, audit.
(заменено с | Админка и RBAC | AdminPanelAndRBAC)

| | Legal и content | LegalAndContent | Legal documents, acceptance, FAQ/knowledge base, notification templates. | | | | Privacy | Privacy | PII masking, full PII access, account closure, retention. | | | | Сверка | Reconciliation | Recon runs, discrepancy detection, manual approval, daily close. | | | *** ### Пользователь, аккаунт, идентификация | Термин | Canonical name | Определение | Не путать с | | --------------------- | ---------------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | Аккаунт | Account | Запись пользователя в CardApp с идентификаторами, статусом, настройками и связями с картами. | Не банковский счёт. | | User ID | UserId | Внутренний идентификатор пользователя. | Не email, phone, Telegram ID. | | Email | Email | Адрес электронной почты пользователя. Должен быть подтверждён для завершения регистрации. | Не канал уведомлений сам по себе. | | Телефон | Phone | Номер телефона пользователя. Должен быть подтверждён для завершения регистрации. | Не всегда СБП-телефон плательщика. | | ФИО пользователя | UserFullName | Фамилия, имя, отчество/вариации, введённые пользователем при регистрации. | Не равно KYC-verified full name до прохождения KYC. | | KYC-ФИО | KycVerifiedFullName | ФИО, подтверждённое внешним KYC-провайдером. | Не равно введённому пользователем ФИО, если KYC не пройден. | | Platform identity | PlatformIdentity | Идентификатор пользователя во внешней платформе: Telegram, future MAKS, future mobile identity. | Не заменяет email/phone. | | Telegram identity | TelegramIdentity | Идентификатор пользователя в Telegram Mini App. | Не UserId. | | Сессия | Session | Авторизованное состояние пользователя на устройстве/в приложении. | Не устройство. | | Устройство | Device | Клиентское устройство/браузер, связанное с пользователем. | Не сессия. | | Доверенное устройство | TrustedDevice | Device, подтверждённое через 2FA и разрешённое для входа. | Новое устройство до 2FA не доверенное. | | OTP | Otp | Одноразовый код подтверждения. В v1 TTL 2 минуты, максимум 5 попыток. | Не полноценный пароль. | | 2FA | TwoFactor | Второй фактор подтверждения рискованных действий или входа с нового устройства. | Не только SMS; есть email OTP, SMS OTP, Telegram bot code, app push. | | Основной 2FA-метод | PrimaryTwoFactorMethod | Метод, который используется первым для 2FA. | Не единственный метод. | | Запасной 2FA-метод | BackupTwoFactorMethod | Метод восстановления/резервного подтверждения. | Не support override. | *** ### Воронка, атрибуция и ссылки | Термин | Canonical name | Определение | Не путать с | | ----------------------- | --------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | Воронка | Funnel | Последовательность пользовательских milestones: вход, регистрация, открытие первой карты, первый депозит. | Не только маркетинговый лендинг. | | Попадание в воронку | FunnelEntered | Первый зафиксированный вход пользователя/гостя в CardApp через ссылку или приложение. | Не регистрация. | | Milestone | FunnelMilestone | Ключевой завершённый этап воронки. | Не технический статус экрана. | | Attribution | Attribution | Привязка пользователя к первому источнику входа. | Не UTM сама по себе. | | First-touch attribution | FirstTouchAttribution | Правило: первая ссылка фиксируется бессрочно и не перезаписывается. | Не last-click. | | Referral link | ReferralLink | Ссылка обычного пользователя-реферера. | Не partner link. | | Partner link | PartnerLink | Ссылка affiliate partner. | Не referral link обычного пользователя. | | Internal marketing link | MarketingLink | Внутренняя рекламная ссылка с UTM и campaign metadata. | Не referral/affiliate attribution. | | UTM | Utm | Метки рекламной кампании. | Не источник истины для affiliate/referral. | | Nurture | NurtureSequence | Серия сообщений для дожима незавершённого этапа воронки. | Не service news. | | Reactivation | ReactivationSequence | Коммуникация с неактивным пользователем после 10 дней без активности. | Уважает marketing preferences. | *** ### KYC и compliance | Термин | Canonical name | Определение | Не путать с | | --------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | KYC | Kyc | Верификация личности через внешнего провайдера. В CardApp запускается по risk triggers, а не обязательна для всех заранее. | Не AML целиком. | | KYC Application | KycApplication | Заявка пользователя на KYC у внешнего провайдера. | Не документ. | | KYC Provider | KycProvider | Внешний поставщик KYC-проверки. | Не CardApp. | | KYC Status | KycStatus | Статус проверки: started, submitted, approved, rejected, expired и т. п. | Не risk decision. | | Face check / liveness | FaceCheck | Лицевая проверка пользователя в KYC-процессе. | Не фото документа. | | KYC-документ | KycDocument | Документ, который пользователь отправляет внешнему KYC-провайдеру: паспорт, загранпаспорт, водительское, ВНЖ с фото. | CardApp не хранит raw document. | | KYC Entity | KycEntity | Запись о верифицированной личности на стороне внешнего KYC/upstream-провайдера, если такой entity возвращается провайдером. | Не внутренний User. | | Re-KYC | ReKyc | Повторная KYC-проверка по причине истечения/изменения данных или compliance trigger. | Не обычный retry после reject. | | KYC retry | KycRetry | Повторная попытка KYC после отказа. В v1 до 5 раз за 24 часа. | Не Re-KYC по истечению документов. | | Sanctions hit | SanctionsHit | Потенциальное совпадение с sanctions/PEP/watchlist по результату провайдера. | Не автоматическая блокировка аккаунта. | | Deposit restriction | DepositRestriction | Ограничение на депозиты пользователя. Может применяться при sanctions hit, СБП payer restriction и других risk cases. | Не блокировка платежей. | | Compliance review | ComplianceReview | Проверка compliance-кейса внешним провайдером или ответственными ролями. | Не support ticket, хотя может быть связан. | *** ### Тарифы, карты и выпуск | Термин | Canonical name | Определение | Не путать с | | ----------------- | ------------------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | Тариф | Tariff | Продуктовый уровень карты, определяющий цену выпуска, FX markup и будущие лимиты. | Не role tier affiliate partner. | | Тип карты | CardType | Virtual или physical. | Не тариф. | | Виртуальная карта | VirtualCard | Карта без физического носителя. | Не обязательно дешёвый тариф. | | Физическая карта | PhysicalCard | Карта с физическим носителем и доставкой. | Может иметь разные режимы выдачи реквизитов по провайдеру. | | Стоимость выпуска | IssuancePrice | Цена открытия/выпуска карты для пользователя. | Не депозит на баланс. | | Первый депозит | InitialDeposit | Минимальная сумма, которая зачисляется на баланс карты при открытии. В текущей политике минимум $10. | Не стоимость выпуска. | | Quote | PaymentQuote | Зафиксированный расчёт суммы, курса, цены и условий оплаты. В v1 действует 2 часа. | Не платёж сам по себе. | | Открытие карты | CardOpening | Пользовательский процесс выбора тарифа/типа, quote, оплаты, выпуска и выдачи реквизитов. | Не просто выбор тарифа. | | Выпуск карты | CardIssuance | Процесс создания карты у card issuing/CaaS provider. | Не оплата открытия. | | Issuance cascade | IssuanceCascade | Попытка выпустить карту у следующего доступного провайдера, если предыдущий не смог. | Не показывается пользователю. | | Реквизиты карты | CardCredentials | PAN/token/last4/expiry/CVV или доступные пользователю платёжные данные. | PAN не хранится в CardApp, если провайдер владеет PCI-периметром. | | PAN | Pan | Полный номер карты. | Запрещено хранить в CardApp; только у provider/upstream. | | Last4 | CardLast4 | Последние 4 цифры карты для отображения/идентификации. | Не полный PAN. | | Token ID | CardTokenId | Токен или внешний идентификатор карты у провайдера. | Не PAN. | | Sub-account | ProviderSubAccount | Внутренний/внешний субсчёт у upstream/CaaS provider, связанный с картой или программой. | Не пользовательский депозит; в новой модели деньги пользователя отражаются через ledger attribution. | | Провайдер выпуска | CardIssuingProvider | Внешний провайдер, который выпускает карты и возвращает статусы/реквизиты. | Не issuer-adapter. | | Issuer Adapter | IssuerAdapter | Anti-Corruption Layer над card issuing providers, унифицирующий их API. | Не внешний провайдер. | | Upstream | UpstreamProvider | Внешний эмитент/процессинг/CaaS provider, который владеет card program, PAN/PCI и частью карточного lifecycle. | Не весь CardApp. | *** ### Статусы карты | Термин | Canonical status | Определение | Кто меняет | | ---------------- | ----------------- | --------------------------------------------------------- | ----------------------- | | Ожидает выпуска | pending\_issuance | Карта оплачена/заявлена, но выпуск ещё не завершён. | Система/provider. | | Активна | active | Карта выпущена и доступна для операций. | Система/provider. | | Заморожена | frozen | Временная self-service заморозка пользователем. | Пользователь. | | Заблокирована | blocked | Принудительная блокировка системой/admin/provider/risk. | Система/Admin/provider. | | Ожидает закрытия | closing\_pending | Закрытие запрошено, но есть pending activity или остатки. | Support/Admin flow. | | Закрыта | closed | Карта окончательно закрыта. | Support/Admin flow. | | Истекла | expired | Срок действия карты закончился. | Система/provider. | *** ### Балансы, ledger и деньги | Термин | Canonical name | Определение | Не путать с | | ------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- | | Деньги пользователя | UserFunds | Обязательство CardApp перед пользователем, отражённое в ledger. | Не отдельный реальный банковский счёт пользователя. | | Баланс карты | CardBalance | UI/projection баланса конкретной карты, рассчитанный из ledger entries. | Не источник истины. | | Ledger | Ledger | Double-entry append-only сервис, источник истины для денежных движений. | Не таблица текущих балансов. | | Ledger account | LedgerAccount | Счёт в ledger для учёта активов, обязательств, revenue, treasury, card balance attribution. | Не обязательно внешний банковский счёт. | | Master account | MasterAccount | Общий фактический счёт/баланс сервиса у провайдера, custody или в иной инфраструктуре. | Не пользовательский счёт. | | Omnibus | OmnibusModel | Модель хранения общих средств, где индивидуальные балансы пользователей существуют через ledger attribution. | Не pooled без учёта. | | Ledger transaction | LedgerTransaction | Логическая финансовая операция, состоящая из набора entries. | Не карточная transaction в UI. | | Ledger entry | LedgerEntry | Атомарная проводка в ledger. Неизменяемая. | Не update balance. | | Ledger entry group | LedgerEntryGroup | Набор проводок, отражающий одну логическую операцию. | Не batch без бизнес-смысла. | | Projection | Projection | Рассчитанное/кэшированное read model из событий или ledger entries. | Не источник истины. | | Balance projection | BalanceProjection | Быстрая проекция баланса для UI/админки. | Не ручной баланс. | | Hold | LedgerHold | Резервирование средств под авторизацию или pending operation. | Не финальное списание. | | Capture | HoldCapture | Превращение hold в финальное списание. | Не новый платёж. | | Release | HoldRelease | Освобождение hold. | Не refund после clearing. | | Reversal | Reversal | Отмена авторизации до clearing. | Не refund. | | Refund | Refund | Возврат после clearing или возврат средств пользователю по поддерживаемому сценарию. | Не reversal и не withdrawal. | | Withdrawal | Withdrawal | Вывод средств пользователю. В v1 только crypto withdrawal при закрытии аккаунта. | Не refund СБП и не card payment. | | Manual adjustment | ManualAdjustment | Ручная финансовая корректировка через ledger transaction с причиной и approval. | Не прямое изменение balance. | *** ### Пополнения и депозиты | Термин | Canonical name | Определение | Не путать с | | ------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | Пополнение | Deposit | Входящее зачисление средств на карту/баланс через СБП или crypto. | Не стоимость выпуска карты. | | Депозитная заявка | DepositIntent | Заявка пользователя на пополнение с quote/payment window. | Не факт поступления денег. | | Зачисленный депозит | CreditedDeposit | Депозит, который прошёл проверки и отражён в ledger/balance projection. | Не paid, если ещё есть hold/review. | | Late deposit | LateDeposit | Платёж, пришедший после истечения quote/payment window. | Для СБП и crypto разные правила. | | Excess deposit | ExcessDeposit | Платёж, превышающий доступные лимиты/ожидаемую сумму. | Не всегда fraud. | | On hold | DepositOnHold | Состояние депозита, который не зачислен до проверки/решения. | Не credited. | | Deposit limit | DepositLimit | Лимит входящих пополнений по карте за период. Считается по сумме credited/reserved deposits, а не по текущему балансу. | Не payment limit. | | Deposit limit reservation | DepositLimitReservation | Временный резерв депозитного лимита на время quote/payment window. | Не расход денег. | | Deposit limit consumed | DepositLimitConsumed | Часть лимита, окончательно использованная после успешного зачисления. | Не текущий баланс. | *** ### СБП | Термин | Canonical name | Определение | Не путать с | | --------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------- | | СБП | Sbp | Система быстрых платежей, канал приёма RUB. | Не банк-эквайер сам по себе. | | СБП-провайдер | SbpProvider | Банк/агрегатор/провайдер, через которого CardApp принимает СБП-платежи. | Не плательщик. | | СБП-депозит | SbpDeposit | Пополнение через СБП. | Не crypto deposit. | | СБП-плательщик | SbpPayer | Человек, от имени которого пришёл СБП-платёж. | Не пользователь CardApp автоматически. | | Данные плательщика | SbpPayerData | Набор данных, пришедших от провайдера: ФИО, телефон, банк, счёт, masked/hash поля, provider ids. | Не гарантированно полный набор. | | Отпечаток плательщика | SbpPayerFingerprint | Вычисляемый идентификатор плательщика на основе доступных данных. | Не один raw field. | | Person fingerprint | SbpPayerPersonFingerprint | Идентификатор человека-плательщика. Один человек из разных банков считается одним плательщиком. | Не instrument fingerprint. | | Instrument fingerprint | SbpPayerInstrumentFingerprint | Идентификатор платёжного инструмента: банк/счёт/телефон/provider customer id. | Не уникальный человек. | | Эталонный плательщик | ReferenceSbpPayer | Плательщик, привязанный по первому успешно зачисленному СБП-депозиту. | Не плательщик returned/onHold платежа. | | Уникальный плательщик | UniqueSbpPayer | Уникальный человек-плательщик для lifetime-счётчика. | Не уникальный счёт/банк. | | Lifetime unique payer count | LifetimeUniquePayerCount | Количество уникальных СБП-плательщиков за всё время жизни пользователя. | Не месячный счётчик. | | Ограничение СБП по KYC-ФИО | SbpOnlyKycPayerRestriction | Restriction, при котором СБП-депозиты разрешены только от плательщика, совпадающего с KYC-ФИО. | Не ограничивает crypto. | | СБП-возврат | SbpRefund | Возврат СБП-платежа, например late/mismatch/restricted payer. | Не crypto withdrawal. | | KYC threshold по СБП | SbpKycThreshold | Порог суммы СБП в RUB, выше которого до KYC требуется проверка. | Не тарифный лимит карты. | *** ### Crypto, custody и treasury | Термин | Canonical name | Определение | Не путать с | | ------------------------ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | Crypto deposit | CryptoDeposit | Пополнение через blockchain/crypto rails. | Не СБП. | | Stable / стейбл | StableAsset | Stablecoin-актив, который CardApp учитывает на выходе crypto processing. | Не обязательно конкретно USDT во всех будущих случаях. | | USDT | Usdt | Stablecoin, один из возможных активов treasury/CaaS. | Не вся crypto-модель. | | Custody | CustodyProvider | Внешний MPC/multisig/crypto custody provider. | Не treasury policy. | | Deposit address | DepositAddress | Адрес/инструкция для crypto-депозита. | Не пользовательский баланс. | | Tx hash | TxHash | Blockchain transaction hash. Используется как доказательство/идентификатор. | Не internal deposit id. | | Network | CryptoNetwork | Blockchain-сеть, например TRON, Ethereum и т. п. | Не asset. | | Late crypto deposit | LateCryptoDeposit | Crypto-платёж после истечения quote, который может быть зачислен, если backend может сопоставить его с заявкой и проверки пройдены. | Не late СБП; СБП возвращается. | | Unmatched crypto deposit | UnmatchedCryptoDeposit | Crypto-платёж, который невозможно сопоставить с пользователем/заявкой. | Не credited deposit. | | Crypto claim | CryptoDepositClaim | Заявка пользователя на присвоение unmatched crypto deposit. High-risk flow. | Не автоматическое зачисление. | | Treasury | Treasury | Управление funding, provider balances, credit limit, liquidity alerts и внутренними перемещениями. | Не ledger. | | Provider funding | ProviderFunding | Пополнение CaaS/card provider balance для обеспечения карточных операций. | Не депозит пользователя. | | Provider credit limit | ProviderCreditLimit | Кредитный лимит/овердрафт у провайдера, покрывающий временную нехватку funding. | Не лимит пользователя. | *** ### Карточные платежи и 3DS | Термин | Canonical name | Определение | Не путать с | | ----------------------- | --------------------- | ------------------------------------------------------------------------------ | --------------------------------------- | | Авторизация | Authorization | Намерение списать средства по карте; обычно создаёт hold. | Не финальный clearing. | | Клиринг | Clearing | Финальное списание после авторизации. | Не authorization. | | Карточная операция | CardTransaction | Пользовательская операция по карте: authorization, clearing, reversal, refund. | Не ledger transaction. | | Онлайн-платёж | OnlinePayment | Card transaction в интернете. Может требовать 3DS. | Не СБП/crypto deposit. | | 3DS | ThreeDS | Дополнительное подтверждение онлайн-платежа. | Не OTP регистрации. | | 3DS challenge | ThreeDSChallenge | Конкретный запрос подтверждения 3DS. | Не risk evaluation. | | Decline | AuthorizationDecline | Отказ по авторизации. | Не refund. | | Decline reason | DeclineReason | Понятная пользователю причина отказа. | Внутренний reason может быть детальнее. | | Payment limit | PaymentLimit | Лимит оплат по карте: суточный/месячный/пользовательский/тарифный. | Не deposit limit. | | Online payments enabled | OnlinePaymentsEnabled | Настройка, разрешающая интернет-платежи. | Не 3DS. | | Suspicious operation | SuspiciousOperation | Риск-сигнал по карточной операции. В v1 только decline, без авто-заморозки. | Не card blocked. | #### Decline reasons v1 | Reason code | Пользовательский смысл | | --------------------------------- | ------------------------------------------------------------------------------------ | | INSUFFICIENT\_FUNDS | Недостаточно средств. | | PAYMENT\_LIMIT\_EXCEEDED | Payment limit exceeded. | | ONLINE\_PAYMENTS\_DISABLED | Онлайн-платежи отключены. | | CARD\_FROZEN | Карта заморожена. | | CARD\_BLOCKED | Карта заблокирована. | | THREE\_DS\_FAILED | 3DS не пройден. | | SUSPICIOUS\_OPERATION | Подозрительная операция. | | SERVICE\_TEMPORARILY\_UNAVAILABLE | Временная недоступность сервиса без раскрытия внутренней liquidity/provider-причины. | *** ### Risk и ограничения | Термин | Canonical name | Определение | Не путать с | | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------ | ---------------------------------------- | | Risk signal | RiskSignal | Отдельный сигнал риска: много плательщиков, mismatch, повтор после возврата, instrument linked и т. п. | Не финальное решение. | | Risk evaluation | RiskEvaluation | Оценка риска по набору сигналов и правил. | Не KYC result. | | Risk decision | RiskDecision | Решение risk engine: allow, deny, review, restrict, warn. | Не событие платежа. | | Risk score | RiskScore | Числовая или категориальная оценка риска. | Не единственный фактор решения. | | User warning | UserWarning | Предупреждение пользователю, например о большом числе СБП-плательщиков. | Не restriction. | | Soft block | SoftBlock | Временное ограничение возможностей аккаунта. В v1 по СБП-сигналам автоматически не применяем. | Не full account closure. | | Blocked user | BlockedUser | Пользователь с заблокированным аккаунтом/действиями. | Не card blocked. | | Deposit restriction | DepositRestriction | Ограничение на депозиты. Может быть типизировано, например `sbp_only_kyc_payer_allowed`. | Не запрет платежей картой. | | Restriction lift | RestrictionLift | Снятие ограничения после проверки. | Не автоматический expiry, если не задан. | #### SBP risk signals v1 | Reason code | Значение | | --------------------------------------------- | ------------------------------------------------------ | | SBP\_TOO\_MANY\_UNIQUE\_PAYERS | У пользователя много уникальных СБП-плательщиков. | | SBP\_NEW\_PAYER\_AFTER\_RESTRICTION | После ограничения пришёл новый/чужой плательщик. | | SBP\_PAYER\_MISMATCH\_KYC\_NAME | Плательщик не совпадает с KYC-ФИО. | | SBP\_FREQUENT\_PAYER\_CHANGE | Частая смена плательщиков за короткий период. | | SBP\_PAYER\_LINKED\_TO\_MULTIPLE\_USERS | Один человек-плательщик пополняет несколько аккаунтов. | | SBP\_INSTRUMENT\_LINKED\_TO\_MULTIPLE\_USERS | Один инструмент пополняет несколько аккаунтов. | | SBP\_INSTRUMENT\_HAS\_MANY\_PROBLEM\_PAYMENTS | У инструмента много failed/refunded/onHold платежей. | | SBP\_RETRY\_AFTER\_REFUND\_OR\_REJECTION | Повторная попытка после отказа/возврата. | *** ### Reconciliation и контроль | Термин | Canonical name | Определение | Не путать с | | --------------------- | ------------------------- | ----------------------------------------------------------------------------------------- | ---------------------- | | Reconciliation | Reconciliation | Сверка данных между ledger, provider balances, master accounts, processing и projections. | Не audit log. | | Recon run | ReconRun | Один запуск сверки за период/слой. | Не daily close. | | Source snapshot | SourceSnapshot | Снимок данных источника для сверки. | Не backup. | | Discrepancy | ReconciliationDiscrepancy | Расхождение между источниками. | Не обязательно fraud. | | Daily close | DailyClose | Закрытие операционного дня после сверки. | В v1 не auto-close. | | Manual recon approval | ManualReconApproval | Подтверждение сверки вручную. В v1 требуется Admin + ControlObserver. | Не financial approval. | *** ### Referral | Термин | Canonical name | Определение | Не путать с | | ----------------------- | -------------------- | ----------------------------------------------------------------------- | ------------------------ | | Referral program | ReferralProgram | Программа приглашения пользователей обычными пользователями CardApp. | Не affiliate program. | | Referral code | ReferralCode | Уникальный код пользователя для приглашений. | Не partner code. | | Referral link | ReferralLink | Ссылка, содержащая referral code. | Не partner link. | | Referral created | ReferralCreated | Факт регистрации/атрибуции приглашённого пользователя по referral link. | Не activation. | | Referral activation | ReferralActivation | Реферал считается активным после открытия карты и первого депозита. | Не просто регистрация. | | Reward | Reward | Бонус по referral program. | Не affiliate commission. | | Reward balance | RewardBalance | Накопленный бонусный баланс пользователя. | Не card balance. | | Reward transfer to card | RewardTransferToCard | Перевод бонусов на выбранную карту после достижения $200. | Не cash withdrawal. | *** ### Affiliate / партнёрская программа | Термин | Canonical name | Определение | Не путать с | | ------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------- | | Affiliate program | AffiliateProgram | Партнёрская программа для внешних партнёров с кабинетом, метриками, postbacks, комиссиями и выплатами. | Не referral program. | | Affiliate cabinet | AffiliateCabinet | Кабинет партнёра: dashboard, статистика, ссылки/QR, postback API, офферы, креативы, выплаты, команда, новости. | Не AdminPanel. | | Partner application | PartnerApplication | Заявка партнёра на подключение. | Не user registration. | | Partner approval | PartnerApproval | Одобрение партнёра Admin или affiliate manager. | Не KYC пользователя. | | Partner code | PartnerCode | Код партнёра, например ABC123. | Не referral code пользователя. | | Offer | AffiliateOffer | Условия/оффер партнёрской программы. | Не card tariff. | | Creative | AffiliateCreative | Баннер/текст/материал для рекламы. | Не notification template. | | Sub-ID | SubId | Метка партнёра для разреза трафика. | Не UserId. | | CPA | Cpa | Вознаграждение за целевое действие, например активированного клиента. | Не RevShare. | | RevShare | RevShare | Доля от revenue/margin, например обменных операций с депозитов. | Не фиксированный CPA. | | Commission | AffiliateCommission | Начисление партнёру по правилам программы. | Не reward обычного пользователя. | | Hold | AffiliateHold | Задержанная часть партнёрского дохода до разблокировки. | Не ledger hold карточной авторизации. | | Available balance | AffiliateAvailableBalance | Доступный к выплате партнёрский баланс. | Не card balance. | | Payout | AffiliatePayout | Выплата партнёру, в v1 раз в месяц по индивидуальным условиям. | Не user withdrawal. | | Tier | AffiliateTier | Уровень партнёра: например Silver/Gold. | Не card tariff/tier. | | Postback API | AffiliatePostbackApi | Механизм отправки партнёру событий о кликах/регистрациях/конверсиях/комиссиях. | Не incoming webhook от провайдера. | | Masked PII | MaskedPii | Маскированные данные пользователя для партнёра, например `ass***@gmail.com`. | Raw PII партнёру не отдаётся. | *** ### Support, AI и споры | Термин | Canonical name | Определение | Не путать с | | ---------------------- | --------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------- | | Тикет | SupportTicket | Обращение пользователя в поддержку. | Не dispute автоматически. | | Linked entity | LinkedEntity | Связанный объект тикета: card, tx, dispute, deposit, user. | Не вложение. | | Escalation | Escalation | Передача тикета от AI/support к человеку/admin/upstream. | Не approval. | | AI reply | AiReply | Ответ AI пользователю. Должен быть строго основан на knowledge base и данных CardApp. | Не финальное решение. | | AI intake | AiIntake | Сбор AI-ассистентом информации по обращению. | Не решение кейса. | | Knowledge base | KnowledgeBase | Опубликованная база знаний, на которую опирается AI. | Не свободные знания модели. | | Dispute | Dispute | Спор по успешно списанной/cleared карточной операции. Открывается через поддержку. | Не вопрос в поддержку без финансового спора. | | Evidence | DisputeEvidence | Доказательства по спору: скриншоты, переписка, чеки, подтверждение отмены и т. п. | Не просто текст жалобы. | | Preliminary assessment | PreliminaryAssessment | Предварительная оценка AI по легитимности спора. | Не финальное решение. | | Upstream escalation | UpstreamEscalation | Передача спора/кейса внешнему provider/upstream. | Не internal escalation. | *** ### Уведомления | Термин | Canonical name | Определение | Не путать с | | --------------------- | ----------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------- | | Уведомление | Notification | Сообщение пользователю через TG/email/push/in-app. | Не notification template. | | Notification category | NotificationCategory | Категория настроек уведомлений. | Не канал. | | Channel | NotificationChannel | Канал доставки: tg, email, push, in\_app. | Не категория. | | Provider | NotificationProvider | Технический поставщик доставки: Telegram Bot API, email provider, push provider. | Не channel. | | Outbox | NotificationOutbox | Очередь гарантированной доставки внешних эффектов. | Не только уведомления, но в этом контексте delivery queue. | | Template | NotificationTemplate | Шаблон текста уведомления. | Не конкретное отправленное уведомление. | | Important category | ImportantNotificationCategory | Категория, где нельзя отключить все каналы. | Не всегда emergency. | | Preference | NotificationPreference | Настройка каналов по категории. | Не факт доставки. | #### Notification categories | Category | Название | Важное | | ------------- | ------------------ | ------ | | TxAll | Все транзакции | да | | TopUp | Пополнения | нет | | ThreeDS | 3DS-запросы | да | | Disputes | Споры | да | | Support | Ответы поддержки | нет | | ServiceNews | Новости сервиса | нет | | Promotions | Акции | нет | | Referral | Реферальные бонусы | нет | | Security | Безопасность | да | | KycCompliance | KYC / Compliance | да | | LegalUpdates | Legal updates | да | | Cards | Карты | да | *** ### AdminPanel, роли и approval | Термин | Canonical name | Определение | Не путать с | | --------------- | ------------------- | ------------------------------------------------------------------------------ | -------------------------------------- | | AdminPanel | AdminPanel | Внутренний интерфейс управления CardApp. | Не affiliate cabinet. | | RBAC | Rbac | Role-Based Access Control: роли и granular permissions. | Не hardcoded role checks. | | Permission | Permission | Конкретное право действия или просмотра. | Не роль. | | Role | Role | Набор permissions, назначенный оператору. | Не должность в компании автоматически. | | Critical action | CriticalAdminAction | Критичное действие, требующее approval/four-eyes. | Не каждое чтение данных. | | Approval | Approval | Подтверждение действия другим участником с правами. | Не audit log. | | Four-eyes | FourEyesApproval | Принцип: действие создаёт один человек, подтверждает другой. | Не self-approval. | | Self-approval | SelfApproval | Попытка одобрить собственное действие. Запрещено для critical actions. | Не второе подтверждение. | | Audit log | AuditLog | Append-only журнал действий, доступа к PII, системных событий и admin actions. | Не business ledger. | | System action | SystemAction | Действие, выполненное системой автоматически. | Не AdminAction. | | Admin action | AdminAction | Действие администратора/оператора в админке. | Не событие пользователя. | #### Роли v1 | Role | Определение | | --------------- | ------------------------------------------------------------------------------------------------------------- | | Admin | Полный доступ, critical actions через approval. | | Support | Тикеты, коммуникации, эскалации, просмотр связанного контекста. Без финансовых действий и снятия ограничений. | | ControlObserver | Read-only контроль, подтверждение сверок/high-risk операций, без изменений. | *** ### Legal, privacy и PII | Термин | Canonical name | Определение | Не путать с | | ---------------- | --------------- | ------------------------------------------------------------------------------------------- | ----------------------------------- | | Legal document | LegalDocument | Юридический документ: Terms, Privacy, tariffs, cardholder terms, refund policy и т. п. | Не FAQ. | | Document version | DocumentVersion | Конкретная версия legal document. | Не перевод. | | Acceptance | LegalAcceptance | Факт принятия пользователем документа. | Не просмотр. | | Re-acceptance | ReAcceptance | Повторное принятие новой версии документа. | Не новая регистрация. | | PII | Pii | Персональные данные пользователя: email, phone, ФИО, документы, чувствительные identifiers. | Не все аналитические события. | | Masked PII | MaskedPii | Замаскированное отображение PII в админке/partner postbacks. | Не raw PII. | | Full PII access | FullPiiAccess | Раскрытие полных персональных данных. Только Admin, с причиной и audit. | Не обычный просмотр тикета. | | Account closure | AccountClosure | Закрытие аккаунта пользователя после вывода/расходования средств. | Не физическое удаление всех данных. | | Retention | Retention | Хранение данных после закрытия по legal/compliance/операционным требованиям. | Не активный аккаунт. | | Soft delete | SoftDelete | Логическое закрытие/скрытие вместо физического удаления. | Не hard delete. | *** ### Технические DDD/Event Sourcing термины | Термин | Canonical name | Определение | | ---------------------- | ------------------- | --------------------------------------------------------------------------------- | | Bounded Context | BoundedContext | Граница модели, внутри которой термины имеют однозначное значение. | | Aggregate | Aggregate | Консистентная доменная сущность/группа сущностей с правилами изменения. | | Domain Event | DomainEvent | Факт домена, который уже произошёл. | | Command | Command | Запрос на выполнение действия. | | Saga / Process Manager | ProcessManager | Долгий межконтекстный процесс, реагирующий на события и отправляющий команды. | | Reactor | Reactor | Обработчик события внутри или рядом с контекстом. | | ACL | AntiCorruptionLayer | Слой защиты доменной модели от внешних API/провайдерских терминов. | | Published Language | PublishedLanguage | Согласованный формат событий/сообщений между контекстами. | | Outbox pattern | OutboxPattern | Паттерн гарантированной доставки внешнего эффекта после записи состояния/события. | | Idempotency | Idempotency | Свойство повторной обработки без дублирующего бизнес-эффекта. | | Correlation ID | CorrelationId | Идентификатор одного end-to-end бизнес-потока через контексты. | | Causation ID | CausationId | Идентификатор события/команды, породившей текущее событие. | | Event version | EventVersion | Версия схемы события. | | Snapshot | Snapshot | Снимок состояния aggregate/projection для ускорения восстановления. | | Replay | Replay | Повторное проигрывание событий для восстановления состояния/projections. | | Rebuild | Rebuild | Перестроение projection из event stream/ledger. | *** ### Запрещённые и опасные синонимы | Нельзя говорить | Почему | Правильно | | --------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------- | | balance update | Баланс нельзя менять прямым update; деньги только через ledger entries. | `Ledger.Entries.Posted`, `BalanceProjection.Updated`. | | удалить пользователя | Данные сохраняются по retention/legal/compliance. | `User.Closed`, `Privacy.RetentionStarted`, `SoftDelete`. | | хранить PAN | PAN должен оставаться у provider/upstream/PCI-периметра. | `CardLast4`, `CardTokenId`, provider vault. | | пользовательский банковский счёт | У пользователя нет отдельного реального счёта в CardApp. | `CardBalance`, `Ledger attribution`, `MasterAccount`. | | депозит = баланс | Депозит — входящая операция; баланс — projection результата многих операций. | `Deposit`, `CardBalance`. | | refund = withdrawal | Refund возвращает/компенсирует; withdrawal выводит средства пользователю. | `Refund`, `Withdrawal`. | | authorization = списание | Authorization только резервирует/проверяет. | `Authorization`, затем `Clearing`. | | frozen = blocked | Frozen делает пользователь, blocked ставит система/admin/provider. | `Card.Frozen`, `Card.Blocked`. | | KYC обязателен до карты | В актуальной модели KYC risk-based. | `RiskBasedKyc`. | | СБП-плательщик = пользователь | Плательщик может быть другим человеком. | `SbpPayer`, `User`. | | уникальный плательщик = уникальный банк | Уникальный плательщик считается по человеку, не по инструменту. | `SbpPayerPersonFingerprint`, `SbpPayerInstrumentFingerprint`. | | partner = referrer | Партнёр — внешний B2B actor; referrer — обычный пользователь. | `AffiliatePartner`, `Referrer`. | | AI решил спор | AI только собирает данные и даёт preliminary assessment. | `AiDisputeIntake`, `Support/Upstream decision`. | | webhook event = domain event | Webhook — интеграционный вход, domain event — нормализованный факт домена. | `Integration event`, `DomainEvent`. | *** ### Разрешение конфликтов между старым DOMAIN.md и актуальной моделью | Тема | Было в DOMAIN.md | Актуальная модель | | -------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | Cardholder | User, прошедший KYC Basic или выше и привязанный к Upstream `kyc_entity_id`. | Cardholder — User с открытой картой. KYC risk-based и не обязателен до открытия карты. | | KYC уровни Lite/Basic/Enhanced | Явно описаны как уровни KYC. | В текущей сессии уровни не подтверждены. KYC либо not\_verified, либо verified для снятия СБП threshold; уровни можно оставить future/TBD. | | Cooling period referral | Referral cooling period в старом документе. | Для user referral cooling period не выбран; защита через порог $200 для transfer reward to card. | | Crypto withdrawal | В старом документе есть обычный withdrawal flow. | В v1 withdrawal доступен только при закрытии аккаунта. | | Auto approval withdrawal < $500 | Было как гипотеза/правило в старом документе. | Не актуально для v1; closure withdrawal требует Admin + ControlObserver. | | СБП mismatch | Старый документ: mismatch → onHold → ручной разбор. | Актуально: до KYC другой плательщик → возврат + KYC; после restriction новый/чужой плательщик → возврат. | | Daily close | Старый документ допускал `Recon.DailyClose.Signed` без уточнения. | В v1 manual approval: ControlObserver + Admin. Автоматизация later. | | Feature flags/settings в админке | В старой карте AdminPanel присутствовал System. | В v1 feature flags/settings через админку не делаем; future scope. | | Reports/BI exports | Старый документ содержит Reports/BI. | В v1 нет массового скачивания баз/raw exports. | | MAKS Mini App | Упоминался в сессии. | Future scope; v1 Telegram Mini App + Web. | *** ### Open glossary questions * Точные значения депозитных и платёжных лимитов по тарифам. * Точные значения СБП KYC threshold `N` в RUB. * Нужны ли KYC levels в продуктовой модели или достаточно `not_verified / verified`. * Конкретные поля, которые отдаст выбранный СБП-провайдер по плательщику. * Конкретный card issuing/CaaS provider contract: когда доступны реквизиты физической карты. * Retention period для late/unmatched crypto matching metadata. * Точные суммы, правила и получатели referral rewards. * Будущие роли: affiliate manager, finance operator, compliance officer. * Форматы event payloads для финального event catalog. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://alt3-capital.gitbook.io/funding-arbitrage-strategy/cart/proektnaya-dokumentaciya/glossary-md.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.