strprfcrm/docs/spare-parts.md

Модуль запчастей

Модуль управления запчастями позволяет вести учёт запасных частей для обслуживания малых архитектурных форм (МАФ). Включает каталог, заказы, резервирование, списания и контроль дефицитов.

Содержание

1. Каталог запчастей
2. Заказы запчастей (партии)
3. Резервирование и дефициты
4. Списание запчастей
5. Движения запасов
6. Контроль наличия
7. Связь с рекламациями
8. Загрузка файлов по FTP

---

1. Каталог запчастей

Доступ

Меню: Запчасти → вкладка Каталог

Описание

Справочник всех доступных запчастей. Содержит информацию о наименовании, ценах и применении. Важно: каталог не хранит остатки напрямую — они рассчитываются автоматически на основе заказов и резервов.

Поля карточки запчасти

Поле	Описание
Артикул	Уникальный идентификатор запчасти
Где используется	Описание применения (какой МАФ)
Цена закупки	Закупочная цена (только для админов)
Цена для заказчика	Цена продажи
Цена экспертизы	Цена для экспертных работ
№ по ТСН	Номер по территориальным сметным нормам
Шифры расценки	Коды расценок (можно несколько)
Мин. остаток	Минимальный остаток на складе
Картинка	Фото запчасти

Вычисляемые остатки

Система автоматически рассчитывает:

• Физический остаток — сколько реально есть на складе
• Зарезервировано — сколько забронировано под рекламации
• Свободно — физический минус зарезервировано

Остатки ведутся раздельно:

• С документами — запчасти с полным пакетом документов
• Без документов — запчасти без документов

Действия

• Создать — добавить новую запчасть (админ)
• Редактировать — изменить данные запчасти
• Удалить — удалить запчасть (только если нет заказов)
• Экспорт — выгрузить каталог в Excel
• Импорт — загрузить данные из Excel

Фильтрация

• По применению (где используется)
• По диапазону цен
• По наличию ниже минимума

---

2. Заказы запчастей (партии)

Доступ

Меню: Запчасти → вкладка Заказы деталей

Описание

Каждый заказ — это партия запчастей с определённым количеством. Именно заказы формируют физические остатки на складе.

Жизненный цикл заказа

┌──────────┐      Поступило       ┌───────────┐      Всё списано      ┌───────────┐
│ Заказано │  ──────────────────► │ На складе │  ────────────────────► │ Отгружено │
│ (ordered)│                      │ (in_stock)│                        │ (shipped) │
└──────────┘                      └───────────┘                        └───────────┘
     ▲                                  │
     │                                  │
     │                                  ▼
   Создание                      Доступно для
   заказа                        резервирования

Поля заказа

Поле	Описание
Артикул	Какая запчасть
Источник	Откуда заказ (текстовое описание)
Заказано	Начальное количество
Остаток	Текущий остаток в партии
С документами	Флаг наличия документов
Статус	Заказано / На складе / Отгружено
Примечание	Дополнительная информация

Действия

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

Автоматика при поступлении

При переводе заказа в статус "На складе":

1. Система проверяет открытые дефициты по этой запчасти
2. Автоматически создаёт резервы под дефициты (FIFO — сначала старые)
3. Закрывает дефициты, если они полностью покрыты

---

3. Резервирование и дефициты

Что такое резерв?

Резерв — это бронирование запчасти под конкретную рекламацию. Резерв уменьшает свободный остаток, но не уменьшает физический до момента списания.

Статусы резерва

Статус	Описание
Активен	Запчасть забронирована
Списан	Запчасть отгружена
Отменён	Бронь отменена

Что такое дефицит?

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

Пример

1. Требуется 10 шт запчасти для рекламации
2. Свободно на складе только 3 шт
3. Система создаёт:
   • Резерв на 3 шт (из имеющихся)
   • Дефицит на 7 шт (не хватает)

Автоматическое закрытие дефицита

При поступлении новой партии запчасти:

1. Система находит открытые дефициты (по FIFO — старые первыми)
2. Автоматически резервирует новые запчасти под дефициты
3. Закрывает дефициты при полном покрытии

Статусы дефицита

Статус	Описание
Открыт	Есть недостача, ожидает поступления
Закрыт	Полностью покрыт резервами

---

4. Списание запчастей

Способы списания

1. Списание через резерв (основной способ)

Используется при работе с рекламациями:

1. Запчасть резервируется под рекламацию
2. При отгрузке нажимается кнопка "Списать"
3. Резерв закрывается, остаток партии уменьшается

Где: Карточка заказа → блок "Резервы" → кнопка "Списать"

2. Прямое списание (ручное)

Для ситуаций без рекламации:

1. Открыть карточку заказа
2. Нажать "Прямое списание"
3. Указать количество и причину

Где: Карточка заказа → кнопка "Списать"

3. Списание через рекламацию

При удалении запчасти из рекламации можно выбрать:

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

Списание всех резервов рекламации

В карточке рекламации можно списать все запчасти одной кнопкой:

• Списать все — списывает все активные резервы рекламации

---

5. Движения запасов

Описание

Каждая операция с запчастями записывается в журнал движений. Это обеспечивает полный аудит и историю.

Типы движений

Тип	Описание	Влияние на остаток
Поступление	Партия пришла на склад	+остаток
Резервирование	Забронировано под рекламацию	Нет (только свободный)
Списание	Отгрузка со склада	−остаток
Отмена резерва	Бронь отменена	Нет (освобождает свободный)
Коррекция (+)	Увеличение при инвентаризации	+остаток
Коррекция (−)	Уменьшение при инвентаризации	−остаток

Источники операций

• Рекламация — операция вызвана работой с рекламацией
• Ручная — ручная операция пользователя
• Закрытие дефицита — автоматическое резервирование при поступлении
• Инвентаризация — коррекция остатков

Просмотр истории

Где: Карточка заказа → блок "История движений"

Показывает:

• Дата и время операции
• Тип операции
• Количество
• Примечание
• Кто выполнил

---

6. Контроль наличия

Доступ

Меню: Запчасти → вкладка Контроль наличия

Описание

Дашборд для мониторинга запасов и управления дефицитами.

Блоки дашборда

Критические дефициты

Запчасти с открытыми дефицитами. Требуют срочного заказа.

Информация	Описание
Запчасть	Артикул и название
Рекламация	Для какой рекламации
Требуется	Сколько нужно всего
Зарезервировано	Сколько уже есть
Не хватает	Сколько нужно заказать
Покрытие	Процент обеспеченности

Ниже минимума

Запчасти, свободный остаток которых ниже установленного минимума.

Рекомендуемые действия

1. Открыть дефицит → узнать для какой рекламации
2. Создать заказ на недостающее количество
3. При поступлении → дефицит закроется автоматически

---

7. Связь с рекламациями

Добавление запчасти в рекламацию

1. Открыть карточку рекламации
2. Перейти в раздел "Запчасти"
3. Выбрать запчасть из каталога
4. Указать количество и тип документов
5. Сохранить

При сохранении:

• Система пытается зарезервировать запчасти
• Если не хватает — создаётся дефицит
• Показывается информация о статусе резервирования

Изменение количества

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

• Если увеличение → дорезервируется (или увеличивается дефицит)
• Если уменьшение → освобождается часть резерва

Удаление запчасти из рекламации

Варианты:

1. Отменить резерв — запчасть возвращается в свободный остаток
2. Списать — запчасть списывается со склада

При удалении также закрывается связанный дефицит (если был).

Списание запчастей по рекламации

В карточке рекламации:

• Списать запчасть — списать конкретную запчасть
• Списать все — списать все зарезервированные запчасти

---

Приложение: Схема работы системы

FIFO-резервирование

При резервировании система выбирает партии в порядке их создания (старые первыми):

Партия 1 (создана 01.01): 5 шт ──► Резервируется первой
Партия 2 (создана 15.01): 3 шт ──► Резервируется второй
Партия 3 (создана 01.02): 10 шт ──► Резервируется последней

Разделение по типам документов

Остатки "с документами" и "без документов" учитываются раздельно:

Запрос: 5 шт с документами

Партия A (без документов): 10 шт ──► Не подходит
Партия B (с документами): 3 шт  ──► Резерв 3 шт
Партия C (с документами): 5 шт  ──► Резерв 2 шт

Итого: Резерв 5 шт, дефицит 0

Автозакрытие дефицитов

1. Дефицит открыт: нужно 7 шт с документами
   ↓
2. Поступает партия: 10 шт с документами, статус → "На складе"
   ↓
3. Observer срабатывает автоматически
   ↓
4. Создаётся резерв на 7 шт из новой партии
   ↓
5. Дефицит закрывается
   ↓
6. Остаток партии: 3 шт свободно

---

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

Действие	Админ	Менеджер	Бригадир
Просмотр каталога	✓	✓	✓
Создание/редактирование запчасти	✓	✗	✗
Удаление запчасти	✓	✗	✗
Импорт/экспорт каталога	✓	✗	✗
Создание заказа	✓	✓	✗
Списание	✓	✓	✗
Коррекция остатков	✓	✗	✗
Удаление заказа	✓	✗	✗
Просмотр цены закупки	✓	✗	✗

---

Загрузка файлов по FTP

По FTP доступна папка public/images/. В ней находятся три каталога:

Структура папок

public/images/
├── main/              ← картинки каталога МАФ
├── spare_parts/       ← картинки запчастей
└── tech-docs/         ← техническая документация (схемы сборки, габариты и т.д.)

1. Картинки каталога МАФ (main/)

Формат имени файла: {артикул}.0000.0000.jpg

Примеры: 0001.0000.0000.jpg, 1112.0000.0000.jpg

Поддерживаются форматы: jpg, jpeg, png.

2. Картинки запчастей (spare_parts/)

Файлы кладутся в корень папки (без подпапок).

Имя файла должно начинаться с артикула запчасти. Допускается суффикс после артикула (например, вариант размера).

Примеры:

• 0000.0000.0041.jpg — артикул 0000.0000.0041
• 0000.0000.0483_50.jpg — артикул 0000.0000.0483, вариант 50
• BR08.050.jpg — артикул BR08.050

Поддерживаются форматы: jpg, jpeg, png.

Картинки кешируются на 1 час. После загрузки новых файлов они появятся в системе в течение часа.

3. Техническая документация (tech-docs/)

Файлы раскладываются по подпапкам с артикулом изделия.

Структура:

tech-docs/
├── 1112/
│   ├── 1112.0000.0000 – Габаритные размеры.pdf
│   ├── 1112.0000.0000 – Инструкция по сборке (Бетон. СУПП).pdf
│   ├── 1112.0000.0000 – Схема скважин (Бетон. СУПП).pdf
│   └── 1112.0000.0000 – Схемы установки опор (Бетон. СУПП).pdf
├── 4005/
│   └── ...

Типичные документы в папке артикула:

• Габаритные размеры
• Инструкция по сборке
• Схема скважин
• Схемы установки опор

Формат: PDF.

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

---

Часто задаваемые вопросы

Почему не могу удалить запчасть?

Запчасть нельзя удалить, если есть связанные заказы. Сначала нужно удалить все заказы.

Почему не могу удалить заказ?

Заказ нельзя удалить, если есть активные резервы. Сначала отмените или спишите резервы.

Как исправить ошибку в остатке?

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

Почему свободный остаток меньше физического?

Часть запчастей зарезервирована под рекламации. Посмотрите блок "Резервы" в карточке заказа.

Как узнать, для каких рекламаций зарезервированы запчасти?

В карточке заказа блок "Резервы" показывает список рекламаций с количеством.

Дефицит не закрылся автоматически при поступлении — почему?

Проверьте:

1. Тип документов должен совпадать (с документами / без документов)
2. Заказ должен быть переведён в статус "На складе"
3. Дефицит должен быть в статусе "Открыт"