1. Доступ и начало работы

Экземпляр представляет собой веб-приложение. Для работы требуется браузер и учётная запись. Адрес развёрнутого экземпляра, логин и пароль предоставляет администратор. Контрольный локальный экземпляр запускается по адресу http://127.0.0.1:8097; этот адрес доступен только с компьютера, на котором работает сервис.

Шаг	Действие
1	Откройте адрес экземпляра. На странице входа должны отображаться название ArhiPlanning и поля «Логин» и «Пароль».
2	Введите реквизиты и нажмите «Войти». Откроется раздел «Рабочая среда».
3	Выберите одно из направлений: «Балансовое планирование», «Календарное планирование» или «Доступные объёмы».
4	Откройте «Данные» и скачайте учебный пример. Для первого расчёта можно использовать уже установленный учебный набор.
5	Перейдите в «Новый расчёт», выберите набор данных, при необходимости сценарий, задайте лимит времени и нажмите «Рассчитать план».

Учётные записи

Планировщик видит свои данные, сценарии и расчёты, а также общие учебные примеры. Администратор имеет доступ ко всем объектам рабочей среды. Пароли не включаются в эксплуатационную документацию. После завершения работы используйте кнопку «Выйти».

Подготовка исходных данных

Для каждого направления используется собственная структура примера. Не меняйте названия обязательных листов и полей. Проверьте справочники, единицы, даты и связи объектов. Для файлов JSON периоды нумеруются с 0, в книге балансового планирования — с 1. Максимальный размер загружаемого файла — 64 МБ.

2. Балансовое планирование

В разделе «Новый расчёт» выберите «Балансовое планирование». Для контрольного запуска используйте набор «Балансовое планирование — учебный пример» либо скачайте supply.xlsx через кнопку «Скачать пример».

Группа данных	Содержание книги
Поставщики и транспорт	Объёмы приобретения, цены, транспорт от поставщиков и между складами и производством.
Сырьё и полуфабрикаты	Остатки, ограничения и стоимость хранения сырья, входящих и исходящих полуфабрикатов.
Производство	Листы BOM и мощностей для производственных этапов; расход материалов и полуфабрикатов на выпуск.
Готовая продукция	Остатки и хранение, транспорт с производства на склады и со складов потребителям.
Спрос	Периоды, клиенты, продукция, минимальные и максимальные потребности, приоритеты и цены реализации.

Учебная книга содержит 19 листов и 10 периодов. В принятом табличном формате идентификаторы содержат числовой код: например, «Поставщик 1», «Материал 12». Сохраняйте согласованность кодов во всех связанных листах. Для каждой позиции производственной мощности должна существовать соответствующая рецептура.

Порядок расчёта и результаты

Выберите набор, задайте лимит времени и запустите расчёт. После завершения откройте таблицы закупок, производства, перемещений, реализации и хранения. Показатель «Экономический результат» относится к ценам, затратам и штрафам выбранной модели.

Для принятого контрольного примера значение целевой функции составляет приблизительно 13 115 526 689,486 условных денежных единиц. Это результат учебного набора, а не оценка эффекта внедрения. При изменении данных показатели пересчитываются.

Скачайте «Отчёт Excel» для получения всех таблиц расчёта в одной книге. «Скачать JSON» сохраняет машинное представление результата. Конкретное распределение потоков может различаться при нескольких равноценных решениях.

3. Календарное планирование

Выберите направление «Календарное планирование» и учебный набор. Нейтральный пример calendar.json описывает источники, склады, продукцию, маршруты, запасы, графики доступности, спрос и партии в пути.

Параметры	Правила заполнения
Горизонт	periods — упорядоченные названия периодов; dispatch_periods — число периодов отгрузки в пределах общего горизонта.
Маршруты	lanes задаёт source, warehouse, product, lead_time, lot_size и transport. Для rail объёмы кратны размеру партии; road использует целые единицы объёма.
Ресурсы	source_allocations — лимит за горизонт; source_dispatch — график собственных источников; external_dispatch — обязательные внешние поставки; vehicle_limits — лимиты транспортных единиц.
Склады и спрос	stocks задаёт вместимость, остатки, нормативы и отпуск. demand содержит склад, продукт, период, объём и основной или вторичный канал.
В пути	in_transit задаёт партии, объёмы и периоды прибытия. receipt_units_per_period ограничивает ресурс приёмки.

Все объёмы нейтрального календарного формата — целые единицы. Идентификаторы источников, складов и продукции должны совпадать в связанных записях. Поддерживаются также совместимые Excel- и ZIP-форматы календарного компонента; для них требуется сохранение исходной структуры полей.

Проверка результата

Откройте таблицы «Поставки», «Запасы», «Спрос» и «Партии в пути». Проверьте даты отгрузки и приёмки, выполнение спроса и отклонения нормативов. В контрольном прогоне учебного примера сформировано 38 транспортных единиц и 760 единиц объёма поставок; дефициты основного и вторичного каналов равны нулю.

На вкладке «Приоритеты» показаны отклонения по уровням расчёта. Отсутствие дефицита не означает, что все нормативы запасов достигнуты: контрольный пример имеет ненулевое отклонение целевых запасов.

4. Расчёт доступных объёмов

Выберите «Доступные объёмы» и учебный пример availability.json. Основные разделы: periods, nodes, routes, demand, receipts, fleets и delivery_limits. Дополнительный раздел product_dispatch_limits задаёт мощность отпуска отдельных видов продукции.

Сущность	Основные параметры
Узел и запас	Роль узла, приёмка, отпуск, общая вместимость; по продукции — initial, capacity, unavailable, locked, release_period, safety и target.
Маршрут	Откуда, куда, продукт, lead_time, capacity, lot_size, cost и необязательный общий ресурс fleet.
Поступление	Получатель, продукт, earliest и latest, quantity, признак indivisible, стоимость задержки delay_cost.
Спрос	Узел, продукция, period, quantity и priority. Меньший номер соответствует более высокому приоритету.
Лимит поставки	Маршрут, начальный и конечный периоды, minimum и maximum. Для фиксированного объёма задайте равные границы.

Остаток unavailable и ещё не высвобождённая часть locked исключаются из доступного отпуска. Неделимое поступление принимается целиком в одном из разрешённых периодов. Груз по маршруту поступает получателю через lead_time периодов; отправления с прибытием за пределами горизонта не формируются.

Контрольный пример

В примере представлены распределительный склад, два потребителя, две позиции продукции, два поступления и общий ресурс транспорта. Совокупный спрос — 280 единиц, выполненный объём — 270, дефицит — 10. Недостаток возникает у потребителя в первом периоде, до поступления доставки с положительным сроком перевозки.

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

5. Сценарии, сравнение и связь горизонтов

Вариант исходных данных

Откройте «Данные», выберите нейтральный JSON-набор и нажмите «Просмотреть». Измените нужные значения в редакторе и нажмите «Сохранить вариант». Платформа проверит структуру и создаст новый набор. Исходный набор сохранится. Для Excel скачайте книгу, внесите изменения и загрузите её новым файлом.

Параметры сценария и сравнение

В разделе «Сценарии» укажите название и лимит времени на приоритет, затем сохраните параметры. При новом запуске выберите сценарий. Для сравнения бизнес-условий используются разные наборы данных; сам сценарий не подменяет спрос, мощности и запасы.

В разделе «Сравнение» выберите направление и до трёх завершённых расчётов. Сопоставьте показатели. Перед выводами убедитесь, что единицы, горизонты и смысл показателей у вариантов согласованы.

Передача календарного плана

В завершённом календарном расчёте нажмите «Передать в доступные объёмы». Передача поддерживается для нейтрального calendar.json. Появится новый набор доступных объёмов с фиксированными поступлениями по календарному результату, исходными запасами, спросом и мощностями отпуска. Запустите его отдельным расчётом.

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

Состояния и отмена

Состояние	Значение
В очереди / Рассчитывается	Задание сохранено и ожидает обработки либо выполняется. Переход между разделами не отменяет его.
Завершён	Получен проверенный план. Отдельное сообщение показывает, подтверждена ли оптимальность всех приоритетов.
Ошибка	Допустимое решение не получено либо входные данные или среда требуют исправления. Изучите сообщение и запустите новый расчёт.
Отменён	Отмена выполнена. Активный расчёт останавливается после текущего приоритета; для однокритериального расчёта — после завершения текущего решения.

6. Программный доступ и эксплуатация

Интерактивная спецификация API доступна по пути /docs относительно адреса экземпляра. Методы работы с данными и расчётами требуют Bearer-токен, полученный при авторизации. Успешное получение статуса и результата возвращает HTTP 200.

Метод и путь	Назначение
POST /api/auth	Вход по username и password; получение access_token.
GET /api/datasets	Доступные пользователю наборы данных.
POST /api/datasets?module=…	Загрузка multipart-поля file. module: supply, calendar или availability.
POST /api/runs	Запуск: dataset_id, max_time_s; при необходимости scenario_id и параметры совместимого календарного формата.
GET /api/runs/{id}	Состояние, параметры, прогресс и сообщение об ошибке.
GET /api/runs/{id}/result	Результат: статус решения, показатели, таблицы и сведения о проверке.
GET /api/runs/{id}/export.xlsx	Сводная книга отчётов.
POST /api/runs/{id}/cancel	Запрос кооперативной отмены.

Типовые ситуации

При HTTP 401 проверьте учётные данные или выполните вход повторно. HTTP 404 для набора или расчёта означает, что объект отсутствует либо недоступен вашей учётной записи. Ошибка структуры данных требует исправления полей, ссылок, диапазонов или рецептур. Если за лимит времени план не получен, оцените данные и увеличьте бюджет расчёта.

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

Порядок установки, настройки ArhiPlanning, запуска и восстановления приведён в README поставки. Утилита scripts/backup.py сохраняет данные и ключи, проверяет контрольные суммы и переносит пути при восстановлении в другой пустой каталог. Публикация выполняется администратором с назначением адреса, HTTPS и управлением доступом.