# Micro CRM

**Micro CRM** включает в себя:

* Управление клиентами и контактами
* Чаты и коммуникации
* Telegram-боты с [визуальным конструктором](https://book.microcrm.online/konstruktor-chat-botov)
* Транзакции и финансовый учет
* Автоматические напоминания
* Шаблоны сообщений
* Воронка продаж (Kanban)
* Аналитика и отчеты
* Система ролей и компаний
* Административная панель

***

## Основные разделы платформы

### Дашборд 

**Назначение:** Главный экран с обзором ключевых метрик

#### **Функциональность:**

* Статистика активных клиентов
* График динамики роста клиентов
* Последние транзакции
* Предстоящие напоминания
* Обзор лидов

#### **Метрики:**

* Количество активных клиентов
* Рост за месяц (%)
* Распределение клиентов по статусам
* Финансовые показатели

***

### Клиенты

**Назначение:** Управление базой клиентов

#### **Функциональность:**

* Просмотр списка клиентов (таблица)
* Фильтрация по статусу и категории
* Поиск по имени, email, телефону
* Создание нового клиента
* Редактирование информации
* Удаление клиента
* Настройка категорий клиентов
* Пользовательские поля (custom fields)

#### **Поля клиента:**

* Основная информация: имя, email, телефон, Telegram
* Статус: active, inactive, blocked
* Категория (настраиваемая)
* Пользовательские поля (динамические)
* Дата создания и обновления

***

### Чаты

**Назначение:** Коммуникация с клиентами через различные каналы

#### **Функциональность:**

* Список чатов с клиентами
* История переписки
* Отправка текстовых сообщений
* Отправка файлов (изображения, документы)
* Использование шаблонов
* Создание сделки из чата
* Поддержка Markdown форматирования
* Индикация непрочитанных сообщений

***

### Чат-бот

**Назначение:** Автоматизация общения через Telegram-ботов

#### **Экран "Сценарии чат-бота":**

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

#### **Элементы интерфейса:**

* Заголовок: "Сценарии чат-бота"
* Описание: "Управление сценариями работы вашего Telegram бота"
* Поле поиска с плейсхолдером "Поиск по названию или описанию..."
* Кнопка "+ Создать сценарий"

#### **Карточки сценариев:**

Каждый сценарий отображается в виде карточки с информацией:

* **Название сценария** - отображается крупным текстом
* **Триггеры** - показывает команды, которые запускают сценарий (например: `/start`, `/sell`)
* **Кнопки действий:**
  * ✏️ **Редактировать** - открывает визуальный редактор сценария
  * 📊 **Статистика** - показывает метрики использования сценария
  * 📋 **Дублировать** - создает копию сценария
  * 🗑️ **Удалить** - удаляет сценарий с подтверждением

#### **Функциональность списка сценариев:**

* Создание нового сценария
* Редактирование существующего
* Дублирование сценария
* Удаление сценария
* Активация/деактивация
* Поиск по названию и описанию
* Фильтрация по активности

#### [**Визуальный редактор:**](https://book.microcrm.online/konstruktor-chat-botov)

* Drag & Drop интерфейс для создания потоков
* [Палитра узлов](https://book.microcrm.online/konstruktor-chat-botov/tipy-uzlov) (триггеры, действия, условия)
* Редактор свойств узлов
* Валидация конфигурации
* Предупреждения о конфликтах триггеров
* Автоматическая раскладка узлов
* Zoom и панорамирование
* Экспорт/импорт JSON

#### [**AI Ассистент:**](https://book.microcrm.online/konstruktor-chat-botov/rabota-s-ii-pomoshnikom)

* Генерация сценариев по описанию
* Модификация существующих сценариев (в разработке)
* Объяснение логики узлов
* Предложения по улучшению

***

### Транзакции

**Назначение:** Учет финансовых операций

#### **Функциональность:**

* Список транзакций
* Создание новой транзакции
* Редактирование
* Удаление
* Фильтрация по типу (income/expense)
* Поиск по описанию
* Связь с клиентом

#### **Поля транзакции:**

* Тип (доход/расход)
* Сумма
* Валюта
* Категория
* Описание
* Клиент (опционально)
* Дата
* Статус

***

### Напоминания

**Назначение:** Автоматические уведомления и задачи

#### **Функциональность:**

* Список напоминаний
* Создание напоминания
* Редактирование
* Отметка как выполненное
* Удаление
* Фильтры по статусу
* Уведомления через Telegram

#### **Поля напоминания:**

* Заголовок
* Описание
* Дата и время
* Повторение (однократно/ежедневно/еженедельно)
* Связь с клиентом
* Назначенный пользователь
* Статус (pending/completed)

***

### Шаблоны

**Назначение:** Готовые шаблоны сообщений

#### **Функциональность:**

* Библиотека шаблонов
* Создание шаблона
* Редактирование
* Удаление
* Категории шаблонов
* Предпросмотр с подстановкой переменных
* Использование в чатах

#### **Переменные в шаблонах:**

* `{{client.name}}` - имя клиента
* `{{client.email}}` - email
* `{{client.phone}}` - телефон
* `{{company.name}}` - название компании
* `{{user.name}}` - имя отправителя

***

### Продажи

**Назначение:** Kanban-доска для управления сделками

#### **Функциональность:**

* Визуализация воронки продаж
* Drag & Drop перемещение сделок
* Создание сделки
* Редактирование сделки
* Настройка этапов (колонок)
* Настройка статусов сделок
* Фильтрация и поиск

#### **Этапы по умолчанию:**

* Новый лид
* Квалификация
* Предложение
* Переговоры
* Закрыто (успешно/неуспешно)

***

### Отчеты

**Назначение:** Аналитика и статистика

#### **Функциональность:**

* Отчет по клиентам
* Отчет по транзакциям
* Отчет по продажам
* Отчет по активности пользователей
* Графики и диаграммы
* Экспорт данных
* Временные фильтры

### Компания

**Назначение:** Управление компанией и командой

**Доступ:** Только для Владельца и Главного менеджера

#### **Вкладки:**

**1. Общие настройки**

* Название компании
* Описание
* Логотип
* Контактная информация

**2. Сотрудники**

* Список сотрудников компании
* Роли и права доступа
* Приглашение новых сотрудников (по email)
* Редактирование ролей
* Удаление сотрудников

***

### Настройки

**Назначение:** Личные настройки пользователя

#### **Вкладки:**

**1. Профиль**

* Имя пользователя
* Email
* Телефон
* Telegram ID (для связи с ботами)
* Часовой пояс
* Смена пароля

**2. Тема**

* Светлая
* Темная
* Системная

**3. Тарифный план**

* Текущий план
* Использование лимитов
* История платежей
* Обновление плана

 **4. Интеграции**

* Telegram Bot (токен)
* WhatsApp Business (в разработке)
* Webhook URL
* SMTP настройки для email

**4. AI провайдеры**

* Настройка API ключей для AI
* Выбор модели
* Тестирование подключения

***

## Интеграции

### Telegram

* Создание и управление ботами
* Отправка сообщений через Bot API
* Inline клавиатуры
* Медиа файлы

### WhatsApp Business (в разработке)

* Отправка сообщений
* Получение сообщений
* Шаблоны WhatsApp
* Медиа файлы

### Webhook

* Входящие webhook
* Обработка событий
* Логирование запросов

### Email (SMTP)

* Настройка SMTP сервера
* Отправка писем клиентам
* Приглашения в компанию
* Уведомления

***

## Безопасность

### Row Level Security (RLS)

* Все таблицы защищены RLS
* Пользователи видят только данные своих компаний
* Проверка на уровне базы данных

### Роли и права

* Владелец компании - полный доступ
* Главный менеджер - управление командой
* Менеджер - работа с клиентами
* Сотрудник - базовый функционал

### Контроль доступа к триггерам ботов

* Публичные триггеры - доступны всем
* Только сотрудники компании
* Конкретные роли
* Конкретный человек
* Настраиваемые сообщения при отказе