Data mapping — crm
Источники
- ручные таблицы (Google Sheets, 1C/Excel) — лиды, оплаты, выплаты, KPI;
- payment provider history (Тинькофф/CloudPayments/etc);
- исходный каталог продуктов в Laravel;
- исходная CRM (если есть);
- ручные операции preподавателей.
Mapping сущностей
| Исходная сущность | Целевая сущность | Правило |
|---|---|---|
| Google Sheets clients | crm_account | один клиент → один account |
parent + child строки | crm_account (family) + crm_person_link | связь через identity user |
| Sheets leads | crm_lead | дубль по email/phone дедупируется |
| Sheets deals | crm_deal | mapping статусов в каноническую модель |
| products (Laravel) | product, product_run, price_plan | разделение продукта и реализации |
| invoices (1C/manual) | crm_invoice | сохранить external_id |
| payments (provider) | crm_payment | external_id, provider, idempotency |
| refunds | crm_refund | связь с payment |
| balance таблица | crm_balance_entry | append-only, сверка по периоду |
| entitlements (доступы в LMS, абонементы) | entitlement | mapping старых правил доступа |
| teacher payouts | crm_teacher_payout | per teacher, per period |
Маппинг статусов
| Исходный lead | Целевой lead |
|---|---|
| new | new |
| contacted | contacted |
| qualified | qualified |
| sold | converted |
| lost | lost |
| Исходный invoice | Целевой invoice |
|---|---|
| created | draft |
| issued | issued |
| paid | paid |
| partially_paid | partially_paid |
| canceled | cancelled |
| overdue | overdue |
Сценарии
- backfill payments из истории провайдера через provider API;
- ручные таблицы импортируются раз в день в фазе dual-write;
- entitlements выдаются заново для активных подписок (с правильной длительностью);
- teacher payouts пересчитываются от текущей даты.
Стратегия
-
- read-only mirror;
-
- dual-write при оплатах: webhook идёт в исходный контур и целевой CRM;
-
- backfill;
-
- ручная финансовая сверка;
-
- write switch.
Риски и контроль
- расхождение баланса → daily reconciliation, алерт;
- утрата идемпотентности → idempotency_key из payment provider;
- двойные списания → блокировка дублирующих refundов;
- отсутствующие entitlements → ручная проверка списка активных подписок.