# CRM «Каспий Опт» v4 — развёртывание на сервере

## Что это

Многопользовательская CRM для небольшой оптовой компании. Работает на **PHP 8.2 + SQLite**
(база — один файл, MySQL не нужен). Полностью редактируемые статусы, типы, приоритеты,
поля клиентов/задач/контента, корзина, групповые операции, подзадачи, контент-план.

## Что нового в v4

- **45 полей клиентов** по умолчанию (из выгрузки Каспий Опт) — ID, статус, тип, название, юр. название, контактное лицо, телефоны, email, ВКонтакте, ценовая категория, скидка, кредитный лимит, адреса доставки, ИНН/КПП/ОГРН, расчётные счета, менеджер, ответственный, бонусы, регион/город и др.
- **Переработанная модалка задачи**: чистые секции «Суть задачи» (название/описание/комментарий), «Подзадачи» (пустые изначально, добавление по «+», удаление, до 10, цвет точками), «Вложения», «Параметры и связи» (тип/статус/приоритет/ответственный/клиент/**начало/окончание/deadline**), «Повторяемость» (5 типов), «Дополнительные поля».
- **5 типов повторяемости**: Разовая / По календарю (дни недели) / По смещению (каждые N дней) / По дням месяца / Любая циклическая (интервал + единица).
- **Пресеты импорта**: сопоставили колонки один раз → сохранили как именованный пресет → при следующем импорте выбираете пресет вместо ручного сопоставления.
- **Умное авто-сопоставление** колонок при импорте (нормализация регистра/пробелов, частичное совпадение).
- **Видимость колонок клиентов**: кнопка «Колонки» — выбираете какие из 45 полей показывать в таблице (сохраняется в браузере).
- **Фильтр задач по клиенту** + поиск.
- **Счётчик символов** для описания и комментария.
- **Мобильная полноэкранная модалка**.

## Что входит

Всего **два файла**:

| Файл        | Назначение                                            |
|-------------|------------------------------------------------------|
| `admin.html`| Интерфейс CRM (одностраничное приложение)           |
| `api.php`   | Бэкенд: база SQLite, авторизация, загрузка файлов    |
| `.htaccess` | Защита папки data/ от прямого доступа                 |

Папки `data/` (база `crm.db`) и `data/uploads/` создаются автоматически.

## Установка (3 шага)

1. Скопируйте файлы в корень сайта:
   ```
   /var/www/admin/data/www/control.stix63.ru/admin.html
   /var/www/admin/data/www/control.stix63.ru/api.php
   /var/www/admin/data/www/control.stix63.ru/.htaccess
   ```

2. Дайте права на запись (для создания `data/`):
   ```bash
   chmod 755 /var/www/admin/data/www/control.stix63.ru
   # или создайте папку вручную:
   mkdir -p /var/www/admin/data/www/control.stix63.ru/data
   chmod 775 /var/www/admin/data/www/control.stix63.ru/data
   chown admin:admin /var/www/admin/data/www/control.stix63.ru/data
   ```

3. Откройте `https://control.stix63.ru/admin.html` и войдите:
   - **Логин:** `admin`
   - **Пароль:** `admin`
   
   ⚠️ **Сразу смените пароль** в Настройки → Организация!

## Возможности v3

### Полностью редактируемые справочники (в Настройках)
- **Статусы задач** — добавляйте/редактируйте/удаляйте, цвета, порядок, по умолчанию
- **Типы задач** — свои типы (Звонок, Встреча, Документ, Доставка…)
- **Приоритеты задач** — свои уровни срочности
- **Статусы контента** — для контент-плана
- **Платформы контента** — Instagram, ВК, Telegram, YouTube, Rutube, Сайт…
- **Поля клиентов** — любое количество полей с любыми названиями
- **Поля задач** — кастомные поля для задач (Бюджет, Источник…)
- **Поля контента** — кастомные поля для публикаций (Хэштеги, Ссылка…)

### Клиенты
- Карточки с любыми полями (названия и количество — на ваш выбор)
- **Сортировка по любой колонке** (клик по заголовку)
- Поиск
- **Групповые операции**: выбрать несколько → В корзину / Удалить / Изменить статус
- **Импорт CSV/Excel** любой кодировки (UTF-8, Windows-1251, KOI8-R)
- **Сопоставление колонок** при импорте
- Экспорт в CSV
- **Корзина**: восстановление, удаление навсегда, очистка

### Задачи (с подзадачами)
- **Фильтры**: по типу, статусу, приоритету, исполнителю + «только мои» + поиск
- **Подзадачи (Этапы)**: до 10 в каждой задаче
  - Цвет, перемещение вверх/вниз, удаление
  - Содержимое (что сделать) + Результат выполнения
  - Сворачивание под спойлер
- **Вложения**: файлы/картинки (drag-drop) + Rutube видео-ссылки
- **Повторение**: разовая / по календарю / смещение (дни)
- Автор задачи, ответственный, клиент, срок
- **Кастомные поля** задач
- **Групповые операции**: В корзину, изменить статус, назначить, приоритет
- **Корзина** для задач

### Контент-план (SMM)
- Календарь (7/14/21 дней) или список
- Фильтры: статус, платформа, исполнитель
- Сортировка по дате/названию/платформе
- **Кастомные поля** публикаций
- Групповые операции
- Корзина

### Заметки
- Цветные стикеры (7 цветов)

### Сотрудники (только админ)
- Создание/удаление пользователей
- **Смена логина** и пароля
- Две роли: Администратор / Сотрудник

### Корзина
- Отдельный раздел с вкладками: Клиенты / Задачи / Контент
- Восстановление, удаление навсегда, очистка корзины
- Бейдж с количеством в меню

### Дашборд
- Метрики: клиенты, задачи, контент, корзина
- Последние клиенты, ближайшие задачи

## Режимы работы

CRM автоматически определяет доступность PHP:
- **Серверный режим** (на PHP-сервере): SQLite, многопользовательский
- **Демо-режим** (без PHP): localStorage, однопользовательский

## Резервное копирование

Скопируйте папку `data/`:
```
data/crm.db       — база данных
data/uploads/     — загруженные файлы
```

## Технические детали

- **БД:** SQLite 3 (PDO), встроена в PHP
- **Авторизация:** PHP-сессии, bcrypt
- **Загрузка файлов:** до 25 МБ
- **Импорт:** CSV (автоопределение кодировки/разделителя), XLSX (ZipArchive)
- **Безопасность:** подготовленные запросы, проверка авторизации

## FAQ

**В: MySQL нужен?** О: Нет, SQLite в одном файле.

**В: Как сбросить пароль admin?** О: Удалите `data/crm.db` (база пересоздастся, данные удалятся).

**В: XLSX не импортируется?** О: Нужен PHP с расширением ZipArchive (обычно включено).
