DOC-ARC-003 UI-экраны и экранная логика

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

О документе: описывает основные экраны CRM_14 и поведение пользователя.

1. Экран выбора роли

Назначение: заменить полноценную авторизацию в учебном проекте.

Роли:

• менеджер 1;
• менеджер 2;
• аналитик;
• руководитель отдела продаж.

Логика:

• пользователь выбирает роль;
• выбор сохраняется;
• интерфейс открывается с учётом роли;
• доступные действия зависят от роли.

2. Таблица лидов менеджера

Назначение: показать менеджеру его лиды.

Содержит:

• ID;
• название;
• описание;
• источник;
• стадию;
• менеджера;
• действия.

Доступные действия:

• история;
• перевод стадии;
• запрос возврата;
• добавление лида;
• импорт.

Менеджер видит только свои лиды.

3. Таблица лидов аналитика

Назначение: показать данные для анализа без редактирования.

Содержит:

• список всех лидов;
• фильтры;
• историю;
• экспорт.

Аналитик не может:

• создавать лиды;
• менять стадии;
• редактировать данные.

4. Таблица лидов РОП

Назначение: управленческий обзор всех лидов.

Содержит:

• все лиды;
• фильтры по владельцу, источнику и датам;
• действия по управлению лидами;
• импорт;
• экспорт;
• переход к очереди возвратов.

РОП может:

• смотреть все лиды;
• редактировать любые лиды;
• переводить стадии;
• одобрять возвраты;
• экспортировать данные.

5. Канбан-доска

Колонки:

• Новый;
• Квалификация;
• Предложение;
• Успешно;
• Потерян.

Логика:

• лиды распределяются по current_stage;
• количество лидов отображается в заголовке колонки;
• для менеджера показываются только его лиды;
• для аналитика и РОП могут показываться все лиды;
• перевод стадии выполняется по бизнес-правилам.

Принятое допущение: если drag-and-drop не реализован, в финальной версии нужно указать, что стадия меняется кнопками/действиями, а канбан является визуализацией.

6. История лида

Назначение: показать карточку лида и историю стадий.

Содержит:

• владельца;
• источник;
• текущую стадию;
• дату создания / входа в стадию;
• список стадий;
• время входа и выхода;
• статус approved;
• комментарии, если есть.

Принятое допущение: в БД нет поля leads.created_at. Если интерфейс показывает дату создания, её нужно получать из первой записи leads_stage.entered_at или добавить поле в модель.

7. Форма добавления лида

Поля:

• название;
• комментарий / заметка;
• источник.

После создания:

• лид получает lead_uid;
• текущая стадия становится new;
• owner определяется выбранной ролью;
• создаётся первая запись истории стадии.

8. Импорт

Назначение: загрузить данные из CSV/XLSX.

Логика:

• пользователь выбирает файл;
• система читает строки;
• проверяет обязательные поля;
• проверяет lead_uid;
• пропускает дубли;
• добавляет валидные записи.

9. Экспорт

Назначение: выгрузить данные в Excel/CSV.

Поля экспорта:

• lead_uid;
• title;
• notes;
• owner;
• stage;
• entered_at;
• source_code.

10. Очередь возвратов

Назначение: дать РОП возможность одобрять возврат стадии.

Содержит:

• ID лида;
• текущую стадию;
• целевую предыдущую стадию;
• комментарий менеджера;
• кнопки «Одобрить» и «Отклонить».

---