Changelog: Исправления бизнес-документации WMS

Дата: 2026-03-27 Источник: wms-autodoc (Docusaurus) vs кодовая база wms Цель: Привести бизнес-документацию в соответствие с реальным состоянием системы

Сводка изменений

Категория	Количество
Файлы изменены	7
Файлы скопированы без изменений	24 (все АРМы)
Новый файл	1 (CHANGELOG.md)
Добавлено типов документов	2
Добавлено справочников	6
Добавлено API endpoint'ов	8
Добавлено АРМов	3
Исправлено ссылок	20+
Исправлено фактических ошибок	5

Детальное описание по файлам

1. `README.md` (главная страница) — НОВЫЙ

Что: Создана главная страница документации. Зачем: В оригинале было дублирование между README.md и intro.md с разным содержимым.

2. `intro.md` — ИСПРАВЛЕН

Изменение	Было	Стало
Опечатка	"функциональнные"	"функциональные"
Раздел документации	Нет раздела "Интеграции" в списке	Добавлен

3. `00_Overview/README.md` — ДОПОЛНЕН

Изменение	Описание
Интеграции	Добавлены упоминания: ERP, курьерские службы (ApiShip), система маркировки (Честный Знак)
Складирование	Добавлен пункт "Управление контейнерами"
Новый раздел	"Маркировка и серийные номера" — работа с Честным Знаком, серийными номерами, пулом кодов
Уведомления	Добавлено упоминание системы уведомлений (мессенджеры)
Технологическая платформа	Расширено: веб + мобильный интерфейс, REST API, уведомления в реальном времени

4. `01_Entities/00_References/README.md` — ДОПОЛНЕН

Добавлены справочники в группу "Товарная информация":

Справочник	Описание	Почему отсутствовал
Упаковка товара	Варианты упаковки одного SKU (штука, коробка, палет)	Критически важный справочник, используется во всех операциях
Партия товара	Номер партии, дата производства, срок годности	Необходим для партионного учёта
Кондиция товара	Состояние товара (годный, брак, карантин)	Используется в регистрах учёта

Добавлена новая группа "7. Складская логика":

Справочник	Описание
Тип зоны	Назначение зоны (хранение, отбор, приёмка, отгрузка)
Рабочее пространство	Логическая зона работы сотрудника
Правила размещения	Алгоритмы выбора ячеек при размещении товара

5. `01_Entities/01_Documents/README.md` — ДОПОЛНЕН

Добавлены типы документов в блок "Склад":

Документ	Описание	Статус в коде
Дополнительная обработка	Маркировка, стикеровка, переупаковка товаров	Реализован (AdditionalProcessingDoc)
Распаковка упаковок	Разбор заводских упаковок на отдельные единицы товара	Реализован (SkuPackagingUnpackingDoc)

Общее количество типов документов: явно указано 33 (было неявно ~27-32).

Остальные типы, ранее считавшиеся пропущенными, были найдены в оригинале:

Документ несоответствий — был в блоке "Склад"
Эмиссия серийных номеров — был в блоке "Отгрузка"
План обработки контейнера — был в блоке "Отгрузка"
Рейс — был в блоке "Отгрузка"

6. `02_ARMs/README.md` — ПЕРЕРАБОТАН

Исправлены битые ссылки (20+):

Все ссылки на АРМы вели на несуществующие файлы (например, ./01_Receiving/ARM_Receiving_Main.md). Заменены на реальные файлы (./01_Receiving/receiving_arm.md).

Добавлены 3 отсутствующих АРМа:

АРМ	Раздел	Описание
Дополнительная обработка	Склад	Маркировка, стикеровка, переупаковка товаров
Мониторинг заказов	Отгрузка	Отслеживание статусов и прогресса обработки заказов
Управление транспортными местами	Отгрузка	Формирование и управление транспортными местами для погрузки

Удалены пустые категории:

Категории 04_Billing — 10_KPI ссылались на несуществующие файлы. Перенесены в раздел "Планируемые АРМы" как список планов на развитие.

7. `03_Reports/README.md` — ПЕРЕРАБОТАН

Изменение	Описание
Убраны emoji	Убраны значки из заголовков разделов
Google Sheets ссылка	Заменена на примечание о переносе в документацию
Бизнес-описания	Добавлены краткие описания назначения каждой группы отчётов

8. `07_Integration/README.md` — СУЩЕСТВЕННО ДОПОЛНЕН

Добавлены отсутствующие endpoint'ы Merchant API:

Группа	Метод	URL	Описание
Возвраты	GET	/merchant-api/returning	Получить список возвратов
Возвраты	POST	/merchant-api/returning	Создать возврат
Перемещения	GET	/merchant-api/movement	Получить движения товаров
Доставка	GET	/merchant-api/delivery	Информация о доставке
Наборы	GET	/merchant-api/bundle	Информация о наборах

Добавлены описания новых endpoint'ов (разделы 4.8-4.11):

4.8 Возвраты — полный цикл возвратов через API
4.9 Перемещения — получение информации о движениях товаров
4.10 Доставка — статусы и информация о доставке
4.11 Наборы — комплекты и наборы товаров

Исправлен раздел "Честный Знак" (раздел 5):

Было	Стало
"Блок не актуален, по причине пересмотра алгоритма. На данный момент алгоритм активно переписывается."	Убрана пометка. Функционал реализован и работает в коде

Добавлен раздел "Прочие интеграции" (раздел 6):

Интеграция с ERP-системами
Интеграция с курьерскими службами (ApiShip)
Система уведомлений (мессенджеры)
Печать документов и этикеток (PDF, штрихкоды, термоэтикетки)

Файлы скопированные без изменений (24 АРМа)

Все файлы АРМов скопированы из wms-autodoc без изменений, так как их содержание в целом корректно описывает бизнес-процессы:

Приёмка (5 файлов):

unloading_arm.md — АРМ Разгрузка
receiving_arm.md — АРМ Приёмка
placing_arm.md — АРМ Размещение
QualityControl.md — АРМ Контроль качества
ReceivingReturnsARM.md — АРМ Приёмка возвратов

Склад (11 файлов):

inventory_arm.md — АРМ Инвентаризация
moving_arm.md — АРМ Перемещение
blocking_arm.md — АРМ Блокировка
topology_arm.md — АРМ Топология
processing_arm.md — АРМ Обработка
set_packing_arm.md — АРМ Обработка наборов
kto.md — АРМ Контроль товарных остатков
print_stickers_arm.md — АРМ Печать стикеров
arm_tsd_info.md — Информация ТСД
instruction_creation_arm.md — АРМ Создание инструкций
uproshchennaya_obrabotka_naborov_arm.md / V2 — Упрощённая обработка наборов

Отгрузка (7 файлов):

picking_arm.md — АРМ Отбор
batch_arm.md — АРМ Формирование батчей
packing_arm.md — АРМ Упаковка
sorting_arm.md — АРМ Сортировка
shipping_arm.md — АРМ Отгрузка
replenishment_arm.md — АРМ Подпитка
creating_tl_arm.md — АРМ Создание транспортных мест

Что НЕ изменено и почему

Раздел	Причина
Содержимое АРМов	Бизнес-описания процессов в целом корректны
Mermaid-диаграммы	Корректно отражают бизнес-процессы
Структура frontmatter	Сохранена совместимость с Docusaurus
quality_rating	Не пересчитан — требует отдельной процедуры оценки

Changelog: Исправления бизнес-документации WMS

Сводка изменений​

Детальное описание по файлам​

1. README.md (главная страница) — НОВЫЙ​

2. intro.md — ИСПРАВЛЕН​

3. 00_Overview/README.md — ДОПОЛНЕН​

4. 01_Entities/00_References/README.md — ДОПОЛНЕН​

5. 01_Entities/01_Documents/README.md — ДОПОЛНЕН​

6. 02_ARMs/README.md — ПЕРЕРАБОТАН​

7. 03_Reports/README.md — ПЕРЕРАБОТАН​

8. 07_Integration/README.md — СУЩЕСТВЕННО ДОПОЛНЕН​

Файлы скопированные без изменений (24 АРМа)​

Что НЕ изменено и почему​

Рекомендации на будущее​