CRM_14¶

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

О документе: README кратко описывает проект CRM_14, его назначение, состав MVP, структуру документации, команду и общий порядок работы с проектом.

Для кого: для проектной команды, преподавателя, учебного заказчика и любого участника, который впервые знакомится с проектом.

Основано на: презентации CRM_14, кейсе №3 «CRM-мини: лиды и воронка продаж», схеме БД mini_crm_simple и уточнениях команды.

Что это за проект¶

CRM_14 — учебный демонстрационный проект в рамках проектной деятельности. Команда разрабатывает MVP мини-CRM для работы с лидами, их статусами, источниками и базовой аналитикой по воронке продаж.

Проект относится к кейсу №3: CRM-мини: лиды и воронка продаж.

Система предназначена для учебного моделирования базового CRM-контура. Она не является полноценной промышленной CRM-платформой, но показывает ключевые процессы:

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

Проблема¶

Компании теряют лидов из-за разрозненных данных, непрозрачной воронки и нехватки аналитики. Из-за этого снижается контроль над процессом продаж, падает конверсия и замедляется принятие управленческих решений.

Для маркетинговых агентств и небольших команд продаж такая проблема особенно заметна: лиды могут приходить из разных источников, обрабатываться разными менеджерами и теряться между стадиями, если нет единого инструмента для контроля.

Бизнес-цель¶

Разработать MVP CRM-системы, которая:

централизует работу с лидами;
визуализирует этапы воронки продаж;
позволяет отслеживать текущую стадию каждого лида;
показывает базовые метрики продаж;
помогает руководителю отдела продаж и аналитику видеть узкие места процесса.

Для какой отрасли¶

Проект может применяться в разных сферах, где есть входящие лиды и процесс продаж. В первую очередь CRM_14 рассматривается как учебная модель для маркетинговых агентств и небольших отделов продаж.

Принятое допущение: формулировку «в первую очередь для маркетинговых агентств» можно уточнить, если преподаватель требует привязку к конкретной отрасли.

Учебный характер проекта¶

CRM_14 — учебный демонстрационный проект. Поэтому в нём:

нет боевой авторизации;
выбор роли реализован упрощённо;
используются тестовые данные;
нет реальных персональных данных;
нет интеграции с телефонией;
нет email-рассылок;
нет промышленного контура эксплуатации;
часть функций оформлена как MVP или демонстрационный сценарий.

Основные роли пользователей¶

В системе используются четыре пользовательских роли в демонстрационном контуре:

manager_1 — менеджер 1;
manager_2 — менеджер 2;
sales_head — руководитель отдела продаж;
analyst — аналитик как отдельная роль интерфейса и сценария.

В схеме БД enum users содержит manager_1, manager_2, sales_head. Аналитик используется как роль доступа в интерфейсе и документации, но не обязательно является владельцем лида в БД.

Принятое допущение: если аналитик должен храниться в БД как пользователь, enum users нужно расширить значением analyst. В текущей схеме БД это не делаем.

Команда CRM_14¶

Участник	Группа	Роль в проекте	Основной вклад
Кармаев Андрей	ИНБО-30-25	Тимлид / аналитик / Project Lead	Руководство командой, требования, User Stories, BPMN, ERD, финальное согласование
Маркина Майя Витальевна	ЭФБО-02-25	Frontend-разработчик	Канбан-доска, страница аналитики, страница запросов на возврат, история лида, интеграция frontend с backend API и маппинг данных, экспорт лидов, UI-утилиты, сохранение фильтров через cookie
Полухина Елизавета Константиновна	ЭФБО-02-25	Frontend-разработчик	Стартовая страница, сессия и авторизация, роутинг и защита маршрутов, таблица лидов, каркас страницы лидов, модальные окна добавления/импорта/редактирования, базовый API-клиент, CSS, точка входа
Рахимов Шамиль Рашитович	ЭФБО-02-25	Backend-разработчик	API, backend, структура БД, обработка данных, KPI, помощь с Git
Кучин Иван Вадимович	ЭПБО-01-25	1С-разработчик	База и таблицы в 1С, HTTP-методы для связи 1С и Python

Принятое допущение: в презентации Кармаев Андрей указан как тимлид. В документации он также назначен аналитиком/Project Lead, потому что требования, User Stories и RACI закреплены за ним.

Стек технологий¶

Frontend:

React;
Vite;
React Router;
js-cookie.

Backend:

Python;
FastAPI;
Uvicorn;
Pydantic.

Данные и интеграция:

PostgreSQL как логическая схема mini_crm_simple;
1С как учебный контур хранения/табличной части и обмена;
связь 1С—Python через HTTP-методы;
CSV/XLSX импорт;
Excel/CSV экспорт.

Подробные инструкции по связи 1С и Python:

Принятое допущение: в презентации в блоке БД указаны 1С и Python Connector, а в схеме БД указан PostgreSQL. В документации это сведено так: PostgreSQL описывает логическую модель, 1С используется как учебный контур данных и обмена.

Ключевые KPI¶

KPI	Формула	Смысл
Конверсия	`количество выигранных лидов / общее количество лидов`	Показывает долю лидов, дошедших до `won`
Средняя длительность стадии	`sum(left_at - entered_at) / count(stage records)`	Показывает, где лиды задерживаются
Время отклика отчёта	`время формирования отчёта`	Показывает удобство работы с аналитикой

Принятое допущение: пороги KPI не были точно названы. Для финальной версии можно добавить: отчёт строится ≤ 2 сек на 100 лидах.

Основные экраны¶

экран выбора роли;
таблица лидов для менеджера;
таблица лидов для аналитика;
таблица лидов для руководителя отдела продаж;
канбан-доска по стадиям;
история лида;
форма добавления лида;
форма импорта CSV/XLSX;
очередь возвратов стадии;
экспорт Excel/CSV;
отчёт по воронке продаж.

Структура документации¶

Документация собрана в едином файле, но логически делится на разделы:

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