Таблица: users

Описание

Хранит данные о пользователях системы — администраторах, менеджерах и просмотрщиках.

Назначение

• Аутентификация и авторизация
• Разграничение прав доступа
• Аудит действий

Структура

Роли пользователей

Индексы

Связи

• clients — закрепленные менеджеры (manager_id)
• orders — созданные заказы (created_by)
• discount_history — изменения скидок (changed_by)
• order_status_history — изменения статусов (changed_by)
• activity_logs — логи действий (user_id)

Пример запроса

-- Получить всех активных менеджеров
SELECT * FROM users 
WHERE role = 'manager' 
  AND status = 'active' 
  AND is_active = 1;

-- Последние 10 входов в систему
SELECT full_name, email, last_login 
FROM users 
WHERE last_login IS NOT NULL 
ORDER BY last_login DESC 
LIMIT 10;

Примечания

• Пароли хешируются с помощью password_hash() (bcrypt)
• Удаление — мягкое (status = 'deleted')
• Деактивация — мягкая (status = 'inactive')

2. clients — Клиенты

Таблица: clients

Описание

Хранит информацию о клиентах/контрагентах компании.

Назначение

• Управление клиентской базой
• Индивидуальные условия (скидки, отсрочка)
• Авторизация клиентов в личном кабинете

Структура

Индексы

Связи

• users — закрепленный менеджер (многие к одному)
• client_phones — телефоны (один ко многим)
• delivery_addresses — адреса доставки (один ко многим)
• orders — заказы (один ко многим)
• discount_history — история скидок (один ко многим)
• notification_emails — уведомления (один ко многим)
• carts — корзины (один ко многим)

Пример запроса

-- Получить клиентов с наибольшей суммой заказов
SELECT 
    c.company_name,
    COUNT(o.id) as orders_count,
    SUM(o.total_amount) as total_spent
FROM clients c
LEFT JOIN orders o ON c.id = o.client_id
WHERE o.status != 'cancelled' AND o.status != 'sent'
GROUP BY c.id
ORDER BY total_spent DESC
LIMIT 10;

Примечания

• Клиенты могут входить в личный кабинет через email + password_hash
• Скидка применяется автоматически при создании заказа
• Если payment_delay не указан — используется значение из настроек

3. client_phones — Телефоны клиентов

Таблица: client_phones

Описание

Хранит телефоны клиентов. Поддерживает несколько номеров на одного клиента.

Назначение

• Хранение всех контактов клиента
• Выбор основного номера
• Типизация телефонов (рабочий, мобильный, домашний)

Структура

Индексы

Связи

• clients — клиент (многие к одному)

Пример запроса

-- Получить все телефоны клиента
SELECT phone, type, is_primary 
FROM client_phones 
WHERE client_id = 2 
ORDER BY is_primary DESC, type;

Примечания

• Если у клиента один телефон, он автоматически становится основным
• При добавлении нового телефона можно указать is_primary = 1

4. delivery_addresses — Адреса доставки

Таблица: delivery_addresses

Описание

Хранит адреса доставки клиентов. Один клиент может иметь несколько адресов.

Назначение

• Хранение всех адресов клиента
• Выбор адреса при создании заказа
• Активность/неактивность адресов

Структура

Индексы

Связи

• clients — клиент (многие к одному)
• orders — заказы (один ко многим) через delivery_address_id

Пример запроса

-- Получить все активные адреса клиента
SELECT address, contact_person, contact_phone 
FROM delivery_addresses 
WHERE client_id = 2 AND is_active = 1 
ORDER BY is_primary DESC;

Примечания

• Адреса можно деактивировать (is_active = 0), чтобы не показывать в выборе
• Основной адрес используется по умолчанию в заказах

5. products — Товары

Таблица: products

Описание

Хранит товары/продукцию компании (герметики, клеи и т.д.).

Назначение

• Управление ассортиментом
• Ценообразование
• Учет остатков
• Группировка товаров

Структура

Индексы

Связи

• order_items — позиции заказов (один ко многим)

Пример запроса

-- Товары с низким остатком (< 10)
SELECT 
    product_group,
    name,
    stock_quantity,
    price
FROM products
WHERE stock_quantity < 10 
  AND is_active = 1
ORDER BY stock_quantity ASC;

-- Топ-10 самых продаваемых товаров
SELECT 
    p.name,
    p.product_group,
    SUM(oi.quantity) as total_sold,
    p.price
FROM products p
JOIN order_items oi ON p.id = oi.product_id
JOIN orders o ON oi.order_id = o.id
WHERE o.status != 'cancelled'
GROUP BY p.id
ORDER BY total_sold DESC
LIMIT 10;

Примечания

• Группы товаров: Полиуретаны, Гибридные (MS полимер), Силиконы, GOM Клея
• Цена всегда указывается с НДС
• stock_quantity обновляется автоматически при создании заказов

6. orders — Заказы/счета

Таблица: orders

Описание

Хранит заказы/счета клиентов.

Назначение

• Управление заказами
• Формирование счетов
• Отслеживание статусов
• Расчет сумм со скидками

Структура

Статусы заказов

Индексы

Связи

• clients — клиент (многие к одному)
• delivery_addresses — адрес доставки (многие к одному)
• order_items — позиции заказа (один ко многим)
• order_status_history — история статусов (один ко многим)
• notification_log — уведомления (один ко многим)

Пример запроса

-- Заказы за последние 30 дней
SELECT 
    invoice_number,
    order_date,
    status,
    total_amount
FROM orders
WHERE order_date >= CURDATE() - INTERVAL 30 DAY
ORDER BY order_date DESC;

-- Сумма заказов по статусам
SELECT 
    status,
    COUNT(*) as count,
    SUM(total_amount) as total
FROM orders
GROUP BY status;

Примечания

• invoice_number генерируется автоматически: ORD-YYYYMM-XXXX
• subtotal_original — сумма без скидки (для истории)
• При обновлении скидки пересчитываются автоматически

7. order_items — Позиции заказа

Таблица: order_items

Описание

Хранит позиции заказа (товары, количество, цены).

Назначение

• Детализация заказа
• Фиксация цен на момент заказа
• Расчет НДС по каждой позиции

Структура

Индексы

Связи

• orders — заказ (многие к одному)
• products — товар (многие к одному)

Пример запроса

-- Детали заказа с товарами
SELECT 
    o.invoice_number,
    p.name as product_name,
    oi.quantity,
    oi.price_at_time,
    oi.total
FROM orders o
JOIN order_items oi ON o.id = oi.order_id
JOIN products p ON oi.product_id = p.id
WHERE o.id = 1;

Примечания

• Цены фиксируются на момент создания заказа
• При изменении цены товара — старые заказы не пересчитываются
• quantity проверяется на > 0 (CHECK constraint)

8. order_status_history — История статусов

Таблица: order_status_history

Описание

Хранит историю изменения статусов заказов.

Назначение

• Аудит изменений статусов
• Отслеживание времени каждого статуса
• Анализ цикла заказа

Структура

Индексы

Связи

• orders — заказ (многие к одному)
• users — пользователь (многие к одному)

Пример запроса

-- Весь жизненный цикл заказа
SELECT 
    new_status,
    comment,
    created_at
FROM order_status_history
WHERE order_id = 1
ORDER BY created_at ASC;

Примечания

• При создании заказа добавляется запись с new_status = 'sent'
• Каждое изменение статуса логируется
• old_status может быть NULL для первого статуса

9. carts — Корзины

Таблица: carts

Описание

Хранит корзины клиентов (временные данные).

Назначение

• Сохранение товаров до оформления заказа
• Поддержка сессий для неавторизованных пользователей
• Восстановление корзины при возврате

Структура

Индексы

Связи

• clients — клиент (многие к одному)

Пример запроса

-- Очистить просроченные корзины
DELETE FROM carts WHERE expires_at < NOW();

Примечания

• items — JSON-массив с товарами: [{"product_id": 1, "quantity": 2}]
• expires_at — корзины автоматически удаляются через 7 дней
• Для авторизованных клиентов корзина восстанавливается после входа

10. discount_history — История скидок

Таблица: discount_history

Описание

Хранит историю изменений скидок клиентов.

Назначение

• Аудит изменений скидок
• Отслеживание кто и когда менял скидку
• Анализ динамики скидок

Структура

Индексы

Связи

• clients — клиент (многие к одному)
• users — пользователь (многие к одному)

Пример запроса

-- История скидок клиента
SELECT 
    c.company_name,
    dh.old_discount,
    dh.new_discount,
    u.full_name as changed_by,
    dh.reason,
    dh.created_at
FROM discount_history dh
JOIN clients c ON dh.client_id = c.id
LEFT JOIN users u ON dh.changed_by = u.id
WHERE dh.client_id = 2
ORDER BY dh.created_at DESC;

Примечания

• Записывается каждое изменение скидки
• reason — свободное поле для комментария менеджера

11. activity_logs — Лог активности

Таблица: activity_logs

Описание

Хранит логи действий пользователей в системе.

Назначение

• Аудит системы
• Отслеживание изменений
• Безопасность

Структура

Индексы

Связи

• users — пользователь (многие к одному)

Пример запроса

-- Последние 20 действий в системе
SELECT 
    u.full_name,
    action,
    entity_type,
    entity_id,
    created_at
FROM activity_logs al
LEFT JOIN users u ON al.user_id = u.id
ORDER BY created_at DESC
LIMIT 20;

Примечания

• Логируются все CRUD-операции
• old_values и new_values — JSON для сравнения

IP и User Agent помогают в расследованиях инцидентов

12. notification_emails — Email-уведомления

Таблица: notification_emails

Описание

Хранит email-адреса для уведомлений.

Назначение

• Рассылка уведомлений клиентам
• Дополнительные email для копий
• Управление подписками

Структура

Индексы

Связи

• clients — клиент (многие к одному)

Пример запроса

-- Получить все активные email для уведомлений
SELECT email, is_primary 
FROM notification_emails 
WHERE receive_notifications = 1 
  AND is_active = 1
  AND (client_id = 2 OR client_id IS NULL);

Примечания

• client_id = NULL — системные email (например, [email protected])
• is_primary — основной email для связи
• При отписке можно установить receive_notifications = 0

13. notification_log — Лог уведомлений

Таблица: notification_log

Описание

Хранит историю отправленных уведомлений (email, Telegram, системные).

Назначение

• Отслеживание доставки уведомлений
• Диагностика проблем с отправкой
• Аудит коммуникаций с клиентами

Структура

Типы уведомлений

Индексы

Связи

• orders — заказ (многие к одному)

Пример запроса

-- Получить все уведомления по заказу
SELECT * FROM notification_log 
WHERE order_id = 1 
ORDER BY created_at DESC;

Примечания

• status = 'success' — уведомление отправлено успешно
• status = 'failed' — ошибка при отправке (лог для отладки)
• status = 'pending' — в очереди на отправку
• Лог хранится для аудита и диагностики проблем с почтой

14. permissions — Права доступа

Таблица: permissions

Описание

Хранит права доступа для ролей пользователей.

Назначение

• Разграничение доступа к функционалу
• Гибкая настройка прав для ролей
• Аудит доступов

Структура

Права доступа

Индексы

Связи

• users — через поле role (логическая связь)

Пример запроса

-- Получить все права для роли admin
SELECT * FROM permissions WHERE role = 'admin';

-- Проверить, есть ли у менеджера право на управление клиентами
SELECT * FROM permissions 
WHERE role = 'manager' AND permission = 'manage_clients';

Примечания

• Права назначаются через админку
• При добавлении новой роли нужно явно указать права
• Удаление права автоматически отключает функционал у всех пользователей этой роли

15. settings — Настройки системы

Таблица: settings

Описание

Хранит настройки системы в формате ключ-значение.

Назначение

• Централизованное хранение конфигурации
• Гибкое управление через админку
• Поддержка разных типов данных

Структура

Основные настройки

Индексы

Пример запроса

-- Получить все настройки
SELECT * FROM settings;

-- Получить конкретную настройку
SELECT setting_value FROM settings WHERE setting_key = 'vat_rate';

-- Обновить настройку
UPDATE settings 
SET setting_value = '25', updated_at = NOW() 
WHERE setting_key = 'vat_rate';

Примечания

• Добавление новых настроек происходит через админку
• Тип json используется для хранения массивов
• При изменении настройки обновляется updated_at
• Настройки кешируются для быстрого доступа

🚀 Теперь полный список — 15 таблиц!

Теперь полный комплект! 🎉