DOC-SPC-002 Архитектурная схема решения и карта модулей

Версия	Статус	Дата создания	Дата обновления
v0.2-test	Draft	2026-04-27	2026-04-27

О документе: описывает основные модули CRM_14.

1. Карта модулей

Модуль	Назначение	Ответственный
Role Selection	выбор роли	Frontend
Leads Table	список лидов	Frontend
Kanban Board	визуализация стадий	Frontend
Lead Form	создание лида	Frontend + Backend
Lead History	история стадий	Frontend + Backend
Stage Service	смена стадий	Backend
Return Approval	возврат стадии	Backend + Frontend
Import Service	импорт CSV/XLSX	Backend + Frontend
Export Service	экспорт Excel/CSV	Backend + Frontend
KPI Service	конверсия и длительность	Backend
1C Connector	связь 1С—Python	1С + Backend

2. Поток данных

1. Пользователь выбирает роль.
2. Frontend запрашивает данные через API.
3. Backend применяет фильтры и права роли.
4. Backend получает/обновляет данные в учебном контуре.
5. Frontend отображает таблицу, канбан или историю.
6. KPI рассчитываются backend-логикой.
7. Экспорт формируется по текущему набору данных.

3. Архитектурные решения

• роли упрощены до выбора в интерфейсе;
• текущая стадия хранится в leads.current_stage;
• история хранится в leads_stage;
• комментарии привязаны к событию стадии;
• lead_uid используется для импорта и защиты от дублей;
• аналитик не редактирует данные;
• РОП имеет полный доступ.

---