Полная документация по работе с заказами

Версия: 2.0
Дата: декабрь 2025
Протестировано: 4 декабря 2025

Содержание

1. Список заказов
2. Карточка заказа
3. Статусы и переходы
4. Права доступа по ролям
5. Бизнес-логика
6. Вкладки карточки
7. Уведомления
8. Ограничения и особенности

1. Список заказов

URL: /orders

1.1 Элементы интерфейса

1.2 Колонки таблицы

1.3 Действия в списке

2. Карточка заказа

URL: /order/edit/{id}

Карточка заказа содержит всю информацию о заказе с возможностью редактирования в зависимости от роли пользователя и статуса заказа.

Структура интерфейса

1. Заголовок

┌─────────────────────────────────────────────────────────────────┐
│ Заказ №2025_10_14 на сумму 204 700 руб         ОАО БухТех       │
│                                                (ссылка на дилера)│
└─────────────────────────────────────────────────────────────────┘

Элементы:

• Номер заказа — формат YYYY_MM_DD или порядковый номер
• Сумма — итоговая стоимость заказа в рублях
• Компания дилера — кликабельная ссылка на карточку дилера (скрыта для дилеров)

2. Статусы заказа

[Новый] [Ожидает подписания] [Ожидает оплаты] [На проверке] [В производстве] ...

Все статусы системы:

Логика переходов:

• Активные кнопки — доступные переходы для текущего пользователя
• Disabled кнопки — недоступные переходы
• Переходы зависят от роли и матрицы в /statuses

3. Вкладки

Карточка содержит 3 вкладки:

Вкладка "Общая информация"

Левая часть — Основные поля

Блок дат и номеров

Блок оплаты и доставки

Блок "Данные заказа"

Блок "Контактное лицо на объекте"

Блок "Файлы"

Правая часть — Документы и чаты

Генерация документов

Требования для генерации спецификации:

• Заполнена компания дилера
• Указан склад и его адрес
• Указан способ доставки
• Заполнен заказчик (ФИО)
• Указан телефон

Прикрепление документов

Чаты

Вкладка "Состав"

Управление позициями заказа.

Режимы отображения:

• Основные товары — станции, кессоны и т.д.
• Дополнительные товары — компрессоры, насосы и т.д.

Функции для каждой позиции:

Расчет цен:

Стоимость позиции = (Цена × Количество) + Наращивание + Опции
Итого дилеру = Сумма всех позиций с дилерской скидкой
Итого клиенту = Сумма всех позиций по розничной цене

Вкладка "История"

Таблица всех изменений заказа.

Фиксируются:

• Смена статуса заказа
• Изменения полей (если реализовано)
• Загрузка файлов

3. Статусы и переходы

3.1 Все статусы системы

3.2 Матрица переходов между статусами

Новый ──────────────────► Ожидает подписания [менеджер]
                                    │
                                    ▼
                          Ожидает оплаты [менеджер]
                                    │
                                    ▼
                            На проверке [менеджер]
                                    │
                                    ▼
                          В производстве [производство]
                           /        │        \
                          ▼         ▼         ▼
              Ожидает самовывоза  Доставка   Монтаж [производство]
                    │               │          │
                    └───────────────┼──────────┘
                                    ▼
                               Завершен [менеджер/производство]

3.3 Подробные переходы

4. Права доступа по ролям

4.1 Матрица прав по статусам

Легенда: 👁️ просмотр, ✏️ редактирование, 🗑️ удаление

4.2 Администратор (group_id = 1)

• ✅ Полный доступ ко всем заказам и полям
• ✅ Любые переходы между статусами
• ✅ Генерация всех документов
• ✅ Просмотр внутреннего чата
• ✅ Просмотр удалённых заказов (SoftDeletes)
• ✅ Impersonation (авторизация под другим пользователем)

4.3 Менеджер (group_id = 3)

• ✅ Просмотр/редактирование заказов своих дилеров (привязка через company_id)
• ✅ Переходы: Новый → Ожидает подписания → Ожидает оплаты → На проверке
• ✅ Завершение заказов из статусов Доставка/Самовывоз
• ✅ Генерация документов (Бланк, Спецификация)
• ✅ Внутренний чат + чат с дилером
• ❌ Заказы чужих дилеров

4.4 Дилер (group_id = 2)

• ✅ Просмотр только своих заказов
• ✅ Редактирование в статусах: Новый, Ожидает подписания
• ✅ Загрузка файлов: Подтверждение оплаты, Доверенность, Документы от дилера
• ✅ Чат с менеджером
• ❌ Внутренний чат (не видит)
• ❌ Поле "Номер спецификации"
• ❌ Поле "Отсрочка платежа"
• ❌ Кнопка "Бланк"
• ❌ Заказы в статусе "Отменен"

4.5 Производство (group_id = 4)

• ✅ Просмотр заказов в статусах: Новый, Ожидает оплаты, На проверке, В производстве, Доставка, Завершен, Отменен
• ✅ Редактирование в статусах: На проверке, В производстве, Доставка
• ✅ Переходы: На проверке → В производстве → Доставка/Самовывоз/Монтаж → Завершен
• ✅ Добавление серийного номера
• ❌ Чат с дилером
• ❌ Изменение конфигурации товара

Пошаговая работа с заказом

Сценарий: Обработка нового заказа (Менеджер)

1. Открыть заказ из списка /orders
2. Проверить данные на вкладке "Общая информация"
3. Скачать спецификацию → кнопка "Спецификация"
4. Отправить дилеру на подпись
5. Получить подписанную → загрузить в "Спецификация"
6. Сменить статус → "Ожидает подписания"
7. Получить оплату → загрузить в "Подтверждение оплаты"
8. Сменить статус → "Ожидает оплаты" → "На проверке"
9. Передать в производство → "В производстве"

Сценарий: Добавление серийного номера (Производство)

1. Открыть заказ в статусе "В производстве"
2. Перейти на вкладку "Состав"
3. Нажать на поле SN у позиции
4. Ввести серийный номер
5. Сохранить
6. Сменить статус → "Доставка" или "Ожидает самовывоза"

Автосохранение

Все изменения полей сохраняются автоматически при:

• Потере фокуса поля (onBlur)
• Изменении toggle-переключателей (live)

Статус изменяется сразу при клике на кнопку статуса с перезагрузкой страницы.

5. Бизнес-логика

5.1 Создание заказа

При создании заказа автоматически:

1. Генерируется номер в формате YYYY_MM_N (год_месяц_порядковый номер)
2. Генерируется номер спецификации на основе компании дилера:
   • Берётся specification_start_number из компании
   • Прибавляется количество существующих заказов компании

5.2 Система скидок дилера

Источник скидок

Скидки хранятся в таблице category_company:

Пример скидок для компании:

ТВЕРЬ LITE    → 25%
ТВЕРЬ CLASSIC → 30%
ТВЕРЬ AERO    → 35%
КЕССОНЫ       → 20%
ПОГРЕБА       → 20%
ТВЕРЬ PRO     → 35%

Применение скидки

// Метод calculateDealerPrice() в Compound.php:

// 1. Для ОСНОВНЫХ товаров — скидка компании по категории:
$category = $product->categories->first()->getTopLevelParent();
$discount = $dealer->discount($category->id);  // из category_company
$priceDealer = $price * (1 - $discount / 100);

// 2. Для ДОПОЛНИТЕЛЬНЫХ товаров — фиксированная дилерская цена:
$priceDealer = $product->dealer_price;  // из справочника products

Индивидуальная скидка

Дополнительная скидка на конкретную позицию заказа (0-100%):

// Применяется ПОСЛЕ скидки компании:
$finalPrice = $priceDealer * (1 - $individualDiscount / 100);

Доступность: только для Менеджера и Администратора (дилер не видит поле).

5.3 Расчёт стоимости

Стоимость позиции = (Цена товара × Количество) + Наращивание + Опции
Дилерская цена = Розничная цена × (1 - Скидка компании) × (1 - Инд. скидка)
Итого заказа = Сумма всех позиций + Дополнительные товары

Наращивание горловины:

• Шаг: 100мм
• Максимум: 500мм (50см)
• Цена за шаг: указана в товаре (step_price, step_price_dealer)

Опции входов:

• Первый вход — бесплатно
• Каждый последующий — по цене опции
• Типы: Торцевой, Левый, Правый (110мм)

5.4 Удаление заказа

При удалении заказа:

1. Статус меняется на canceled
2. Срабатывает SoftDelete (запись не удаляется физически)
3. Товары со склада освобождаются (in_stock = true)
4. Pivot-связи с ProductStock отвязываются

5.5 Отмена заказа

При переходе в статус canceled:

• Вызывается метод releaseStocks()
• Все привязанные товары со склада возвращаются в наличие
• Серийные номера обнуляются

6. Вкладки карточки (детально)

6.1 Вкладка "Общая информация"

Левая колонка — основные поля:

Блок "Данные заказа":

Правая колонка:

• Генерация документов: Бланк (Excel), Спецификация (Excel)
• Прикрепление: Спецификация, Счёт, Подтверждение оплаты, Доверенность
• Чаты: Внутренний (без дилера), С дилером

6.2 Вкладка "Состав" — Подвкладка "Основные товары"

Компонент: App\Livewire\Order\Compound (режим mode = 'main')
Blade: resources/views/livewire/order/compound.blade.php

Источники данных

Структура позиции основного товара

┌─────────────────────────────────────────────────────────────────┐
│ [Фото] Тверь CLASSIC 0,8НПН    Серийный №: —                    │
│        Септик                   [Прикрепить серийный номер]     │
├─────────────────────────────────────────────────────────────────┤
│ Количество    Стоимость позиции    Инд. скидка, %   Высота      │
│ [-] 1 [+]     189 300 руб.         [__0___]         [-] 0 М [+] │
├─────────────────────────────────────────────────────────────────┤
│ Итого по товару: 190 800 руб.                                   │
├─────────────────────────────────────────────────────────────────┤
│ ┌─ Входы ─────────────────────────────────────────────────────┐ │
│ │ [✓] Вход торцевой ДУ 110 (+1 500 р.)                        │ │
│ │ [✓] Вход слева ДУ 110 (+1 500 р.)                           │ │
│ │ [ ] Вход справа ДУ 110 (+1 500 р.)                          │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ ┌─ Опции ─────────────────────────────────────────────────────┐ │
│ │ [ ] Дополнительный самотечный выход ДУ 110 (+1 500 р.)      │ │
│ │ [ ] Дополнительный самотечный ввод левый (+1 500 р.)        │ │
│ │ [ ] Дополнительный самотечный ввод правый (+1 500 р.)       │ │
│ └─────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

Кнопки и действия

Логика расчёта цен

// Для каждой позиции (recalculateItem):
$price = $product->price;                    // Розничная цена товара
$priceDealer = calculateDealerPrice($product, $indDisc);  // С учётом скидок

// Наращивание (если step_size > 0):
$stepPrice = $product->step_price * ($item->step_size / $product->step_size);
$stepPriceDealer = $product->step_price_dealer * ($item->step_size / $product->step_size);

// Опции:
// - Входы (enter): первый бесплатный, последующие платные
// - Одиночные (single): все платные
$priceOptions = calculateItemOptionsPrice($item) * $count;

// Итого позиции:
$cost = ($price * $count) + $stepPrice + $priceOptions;
$costDealer = ($priceDealer * $count) + $stepPriceDealer + $priceOptions;

Откуда берутся опции (входы и одиночные)

1. Справочник опций — таблица options:

   • product_id — привязка к товару
   • group — тип: enter (входы) или single (одиночные)
   • type — подтип входа: end (торцевой), left (слева), right (справа)
   • name — название опции
   • price — цена опции

2. При добавлении товара в заказ (метод addMainProductAction):

   foreach ($product->options as $opt) {
       OrderItemOption::create([
           'order_item_id' => $item->id,
           'option_id' => $opt->id,
           'group' => $opt->group,
           'type' => $opt->type,
           'value' => false,  // изначально выключено
           'price' => $opt->price,
       ]);
   }

3. Отображение опций — из order_item_options через связь $item->options

Правила входов

Поддержание актуальности данных

1. Изменение справочника опций (options):

   • Новые опции появятся только для новых заказов
   • Существующие заказы хранят копии опций в order_item_options

2. Изменение цен товаров (products.price):

   • Влияет только на новые заказы
   • Существующие позиции хранят цену на момент добавления в order_items.price

3. Пересчёт — вызывается автоматически при любом изменении:

   • recalculateItem() → recalculateTotals() → $order->update()

6.3 Вкладка "Состав" — Подвкладка "Доп. опции"

Компонент: App\Livewire\Order\Compound (режим mode = 'extras')

Источники данных

Структура интерфейса

┌─────────────────────────────────────────────────────────────────┐
│                      [+ Добавить]                               │
├─────────────────────────────────────────────────────────────────┤
│ [Фото] Насос Belamos DWP 750   [-] 1 [+]   13 900   [Удалить]   │
│        (фекальный насос)                                        │
├─────────────────────────────────────────────────────────────────┤
│                                     Итого: 13 900 руб.          │
└─────────────────────────────────────────────────────────────────┘

Кнопки и действия

Откуда берутся дополнительные товары

1. Категория с флагом additional = true (ID: 55 "Дополнительные товары")

2. Метод getAdditionalCategoriesWithProducts():

   $categories = Category::where('additional', true)->get();
   foreach ($categories as $category) {
       $products = $products->merge($category->allProducts());
   }
   // Фильтруем только активные (active = 1)

3. Типы дополнительных товаров:

   • Компрессоры (Hiblow, Secoh)
   • Насосы (фекальные, дренажные)
   • Комплектующие

Расчёт дилерской цены для доп. товаров

// Для дополнительных товаров используется dealer_price из справочника:
if ($product->isAdditionalProduct()) {
    return $product->dealer_price;  // готовая дилерская цена
}

Различие от основных товаров:

• Основные товары: dealer_price = price * (1 - скидка_дилера%)
• Дополнительные: dealer_price — фиксированное значение из справочника

Поддержание актуальности

1. Добавление новых доп. товаров:

   • Добавить товар в таблицу products
   • Привязать к категории с additional = true через category_product
   • Установить active = 1
   • Заполнить price и dealer_price

2. Изменение цен:

   • Существующие записи в order_product хранят цену на момент добавления
   • Новые добавления используют актуальные цены из справочника

6.4 Блок "Стоимость" (правая панель)

Компонент: resources/views/components/order/costs.blade.php

Отображается на обеих подвкладках (Основные товары и Доп. опции).

Структура блока

┌─ Стоимость ──────────────────────────────┐
│ Цена                      189 300 руб.   │
│ Стоимость опций             1 500 руб.   │
│ Доп. опции                 13 900 руб.   │
│ Цена дилерская            132 510 руб.   │
├──────────────────────────────────────────┤
│ Итого для дилера          147 910 руб.   │
│ Итого для клиента         204 700 руб.   │
└──────────────────────────────────────────┘

Расшифровка полей

6.5 Вкладка "История"

Таблица order_histories через компонент Order/History.php.

7. Уведомления

7.1 Telegram-уведомления

Настраиваются в таблице statuses для каждого статуса:

Формат сообщения:

Заказ - №2025_10_14.
В статусе - В производстве
Ссылка - https://lk.septiki-tver.ru/order/edit/282

7.2 Уведомление при загрузке файла дилером

Когда дилер загружает файл (files_dealer, payment_order, letter_attorney):

• Менеджер компании получает Telegram-уведомление
• Текст: "К заказу №... дилер прикрепил файл"

8. Ограничения и особенности

8.1 Технические ограничения

8.2 Валидация спецификации

Для генерации спецификации обязательны:

• Компания дилера
• Склад и его адрес
• Способ доставки
• ФИО заказчика
• Телефон
• Адрес (если доставка)

8.3 Особенности интерфейса

1. Автосохранение — все поля сохраняются при потере фокуса
2. Производство disabled — выбирается автоматически по складу
3. Статусы как radio — доступные подсвечены, недоступные disabled
4. Вкладки Filament — переключение через Alpine.js
5. Чаты — real-time через Laravel Reverb/WebSocket

8.4 Известные проблемы

Приложение: SQL-структура ключевых таблиц

Таблица orders

- id, number, specification_number
- product_id, dealer_id, status_key
- manufacture_id, stock_id
- date_make, date_made, date_delivery, date_payment
- receiver, phone, email, address
- payment, delivery, install, deferred_payment
- comment, contact_name, contact_phone, address_make
- price, price_dealer, price_options, price_products, price_install
- cost, cost_dealer, count
- step_size, step_price, step_price_dealer
- sn, product_stock_id
- files, files_dealer, files_manager (JSON)
- specification, invoice, payment_order, letter_attorney
- created_at, updated_at, deleted_at

Таблица status_transitions

- id, parent_status_id, child_status_id
- required_fields, forced_fields (JSON)
- dealer_can, dealers_can
- manager_can, managers_can
- production_can, productions_can