События

Правила

• Финансовые события публикуются только после commit транзакции.
• События не содержат полный PII payload.
• Входящие события обрабатываются идемпотентно через crm_sync_logs.
• Payment webhooks имеют отдельный журнал crm_payment_webhooks.
• Entitlement events являются решением CRM, но целевой домен подтверждает фактическое открытие доступа.

Общий envelope

type CrmEvent<TPayload> = {
  messageId: string;
  messageKind: 'event';
  messageType: string;
  messageVersion: number;
  producer: 'crm';
  producerInstance: string;
  traceId: string;
  occurredAt: string;
  correlationId?: string;
  actor?: {
    type: 'user' | 'service' | 'system';
    id?: string;
  };
  data: TPayload;
  metadata?: Record<string, unknown>;
};

Исходящие события

Event	Когда	Payload
crm.account.created	создан account	accountId, type, ownerUserId
crm.lead.created	создан lead	leadId, accountId, source
crm.lead.converted	lead converted	leadId, accountId, dealId
crm.deal.created	создана сделка	dealId, accountId, leadId
crm.deal.won	сделка выиграна	dealId, accountId, amount
crm.deal.lost	сделка проиграна	dealId, accountId, reason
crm.order.confirmed	заказ подтверждён	orderId, accountId
crm.invoice.issued	счёт выставлен	invoiceId, accountId, amount
crm.invoice.paid	счёт полностью оплачен	invoiceId, accountId, paidAt
crm.invoice.overdue	счёт просрочен	invoiceId, accountId, dueAt
crm.payment.failed	платёж не прошёл	paymentId, invoiceId, reason
crm.payment.succeeded	платёж успешен	paymentId, invoiceId, accountId, amount
crm.refund.created	создан возврат	refundId, paymentId, amount
crm.refund.succeeded	возврат успешен	refundId, paymentId, amount
crm.balance.updated	изменился баланс	accountId, entryId, type, amount
crm.entitlement_balance.overdrawn	entitlement ушёл в отрицательный баланс потребления	entitlementId, accountId, balance
crm.entitlement.activated	доступ активирован	entitlementId, targetDomain, targetRef
crm.entitlement.suspended	доступ приостановлен	entitlementId, reason
crm.entitlement.resumed	доступ возобновлён	entitlementId
crm.entitlement.expired	срок доступа истёк	entitlementId, expiredAt
crm.entitlement.revoked	доступ отозван	entitlementId, reason
crm.ticket.created	создано обращение	ticketId, accountId
crm.teacher_payout.approved	выплата утверждена	payoutId, teacherUserId, amount
crm.teacher_payout.paid	выплата проведена	payoutId, teacherUserId, paidAt

Входящие события

Источник	Событие	Использование
storefront	storefront.form_submission.received	создать lead/account
storefront	storefront.form_submission.forwarded	связать submission и lead
identity	user/family/contact updates	обновить person links/read-model
LMS	enrollment/progress summary events	показать учебный summary в карточке
competitions	registration/payment required events	создать order/invoice/entitlement
payment provider	webhook	payment/refund status
management	task/action events	CRM task/timeline linkage

Payload examples

crm.payment.succeeded

type CrmPaymentSucceededPayload = {
  paymentId: string;
  invoiceId?: string;
  accountId: string;
  amount: {
    amount: string;
    currency: 'RUB';
  };
  paidAt: string;
};

crm.entitlement.activated

type CrmEntitlementActivatedPayload = {
  entitlementId: string;
  accountId: string;
  purchaserUserId?: string;
  beneficiary: {
    type: 'student_profile' | 'user' | 'family_group' | 'organization' | 'manual';
    ref?: string;
  };
  enrollmentSubject?: {
    type: 'student_profile' | 'user' | 'organization_student' | 'manual';
    ref: string;
  };
  productRef: string;
  targetDomain: 'lms' | 'competitions' | 'task-bank';
  targetRef?: string;
  startsAt?: string;
  endsAt?: string;
};

Идемпотентность

Сценарий	Ключ
storefront lead	storefront:{submissionId}
payment webhook	provider:{provider}:event:{providerEventId}
payment success	payment:{provider}:{providerPaymentId}:succeeded
entitlement sync	entitlement:{entitlementId}:status:{status}
payroll calculation	teacher:{teacherUserId}:period:{periodStart}:{periodEnd}

Retention

Данные	Срок
financial events	7 лет
payment webhook payload	3 года, с redaction, если не является финансовым первичным событием
CRM timeline	5 лет
support tickets	3 года после закрытия
audit logs	7 лет
payroll events	7 лет