Перейти к основному содержимому

CRM

Зачем нужно​

CRM отвечает за коммерческий контур платформы: accounts, leads, deals, orders, products, product runs, price plans, billing, payments, refunds, entitlements, support и преподавательские выплаты.

Входит в домен​

  • клиентские accounts, контакты и связи с пользователями identity;
  • leads, deals, orders и order items;
  • канонические product, product_run, product_type и price_plan;
  • invoices, payments, refunds, balance entries и adjustments;
  • entitlements и журнал их потребления соседними доменами;
  • tickets, notes, teacher rates, payroll periods и payroll items;
  • CRM audit и sync logs.

Не входит​

  • аутентификация и роли пользователей, это identity;
  • фактическое обучение, группы, занятия и attendance, это LMS;
  • публичные страницы и формы витрины, это storefront;
  • управленческие dashboards, goals, diagnostics и recommendations, это management.

Карта документов​

  • scope.md — границы домена, ownership и внешние зависимости.
  • data-model.md — канонические сущности CRM.
  • database-schema.md — стартовая SQL-схема.
  • state-machines.md — lifecycle account, lead, deal, invoice, payment, refund, entitlement, ticket и payroll.
  • api-map.md — endpoints, permissions, service scopes и error codes.
  • api-contracts.md — DTO, validation и response schemas.
  • permissions-matrix.md — action-to-permission матрица.
  • events.md — входящие и исходящие события CRM.
  • integrations.md — ссылки на cross-domain спецификации слоя integrations/.
  • user-flows.md, screen-spec.md, security.md, test-plan.md, acceptance.md — сценарии, экраны, безопасность, тесты и критерии готовности.
  • features/*.md — детализация пользовательских карт, billing, payroll, permissions и admin flows.

Связи​

CRM потребляет заявки из storefront, identity references, факты потребления из LMS и competitions, а также управленческие задачи из management. CRM публикует финансовые и entitlement-события для LMS, competitions, management и storefront read-models.

Канон структуры​

Домен следует 15-файловому канону: overview.md, scope.md, data-model.md, database-schema.md, state-machines.md, api-map.md, api-contracts.md, permissions-matrix.md, events.md, integrations.md, user-flows.md, screen-spec.md, security.md, test-plan.md, acceptance.md, плюс детальные спецификации в features/*.md.