Интеграции CRM

Зачем нужно

Интеграции CRM связывают клиентский и финансовый контур с витриной, LMS, identity и управленческой аналитикой.

Канонические cross-domain контракты

• ../../integrations/storefront--crm.md
• ../../integrations/crm--lms.md
• ../../integrations/lms--crm.md
• ../../integrations/crm--management.md
• ../../integrations/management--crm.md
• ../../integrations/crm--competitions.md
• ../../integrations/identity--all.md

Кто использует

• CRM backend;
• менеджеры и support;
• финансовый контур;
• LMS и identity как соседние домены;
• management analytics.

Сценарии

• заявка с витрины создаёт CRM-контекст;
• оплата открывает доступ к обучению;
• LMS отдаёт факты обучения в карточку;
• identity отдаёт техническую информацию аккаунта;
• CRM отдаёт показатели в management.

Данные

• lead;
• customer;
• payment status;
• entitlement signal;
• learning summary;
• support event;
• CRM task.

Правила

• CRM не должна хранить пароль, refresh token или учебный progress как источник истины.
• Интеграции должны явно различать read-model и команду на изменение.
• Финансовые события должны быть идемпотентными.

API

Канонические API и payload-контракты распределены по source-of-truth файлам:

Сценарий	Канонический контракт
лиды из витрины	../../integrations/storefront--crm.md, storefront.lead.submitted
платежи, счета, возвраты и entitlement lifecycle	api-contracts.md, events.md
открытие/отзыв доступа в LMS	../../integrations/crm--lms.md, crm.entitlement.*
открытие/отзыв доступа к олимпиадам	../../integrations/crm--competitions.md
учебный summary и payroll-факты из LMS	../../integrations/lms--crm.md
управленческие метрики и задачи	../../integrations/crm--management.md, ../../integrations/management--crm.md

Серверная часть

CRM backend реализует consumers/producers для перечисленных контрактов, хранит crm_sync_log, применяет retry/DLQ по platform events rules и дедуплицирует входящие события по messageId или business idempotency key.

Интеграции

• storefront → CRM: лиды и заявки;
• CRM ↔ billing: платежи и долги;
• CRM ↔ identity: аккаунты и доступ;
• CRM ← LMS: учебные summary;
• CRM → management: показатели и задачи.

Безопасность

Интеграции передают PII и финансовые данные. Требуются сервисные роли, аудит и минимизация полей.

Нестандартные случаи

• лид без аккаунта;
• оплата пришла раньше создания доступа;
• дубли webhook;
• LMS недоступна;
• CRM-карточка объединена после покупки.

Готовность

• основные события проходят без ручной синхронизации;
• ошибки видны операционной команде;
• источник истины каждого поля понятен.