РАЗДЕЛ 01 · CORE.CONFIG
Общие
Идентичность фермы, часовой пояс и режим работы. От времени открытия зависят обещанные сроки: планировщик не назначает ручные операции на закрытую смену.
ФермаCORE.CONFIG
Название фермы
Выводится в письмах, счетах и на экране цеха.
farm_name
Часовой пояс
Все сроки, отчёты и расписание обслуживания считаются в нём.
farm_timezone
Смена открывается
Раньше этого часа ручные операции не планируются.
farm_open_hour
БЫЛО 9
час
Смена закрывается
Печать продолжается ночью, ручные операции — нет.
farm_close_hour
БЫЛО 21
час
Круглосуточная печать
Задания стартуют вне смены, если не требуют присутствия оператора.
unattended_printing
Представление
Валюта
Меняется только при пустой очереди — снимки тарифов хранят валюту внутри себя.
currency
Язык по умолчанию
Заказчик может переключить сам; это только начальное значение.
default_locale
Единицы измерения
Метрические — единственный поддерживаемый вариант в этой версии.
units
РАЗДЕЛ 02 · PRICING.RATESNAPSHOT
Ценообразование
Все ставки, которыми пользуется расчёт. Движок ничего не ищет сам — снимок передаётся ему целиком, поэтому цена воспроизводима спустя годы.
Сохранение создаёт новый снимок. Текущий
SNAP.8F41C2 останется привязан к уже оформленным заказам —
ни один из них не будет пересчитан.
ТрудLABOR.*
Ставка оператора
Основа для подготовки задания и надзора за печатью.
labor_rate_per_hour
БЫЛО 600
₽ / ч
Надзор на час печати
Доля часа оператора на каждый час печати. 0.05 = один оператор на двадцать машин.
labor_hours_per_print_hour
БЫЛО 0.05
ч / ч
Подготовка задания
Разово на заказ: раскладка на столе, старт, снятие, очистка.
labor_hours_per_job
ч
Инженерные работы при масштабировании
Начисляются один раз, если заказчик изменил размер модели.
engineering_hours_per_resize
ч
Ставка постобработки
Отдельная от операторской: шлифовка и окраска — другая квалификация.
postprocess_rate_per_hour
₽ / ч
ОборудованиеMACHINE.*
Тариф на электроэнергию
electricity_rate_per_kwh
₽ / кВт·ч
Потребление принтера
Среднее по парку. Индивидуальное значение задаётся в карточке машины.
printer_power_kw
кВт
Амортизация за час печати
Значение по умолчанию. Карточка принтера переопределяет его.
depreciation_per_printer_hour
₽ / ч
МатериалMATERIAL.*
Закупка отсутствующего материала
Разово на заказ, не на штуку: одна закупка покрывает весь тираж.
material_procurement_flat
₽
Продувка на каждый доп. цвет
AMS прочищает сопло при каждой смене. Это материал, который не попадёт в деталь.
multicolor_purge_grams_per_extra_color
БЫЛО 12
г
Накладные, риск и прибыльOVERHEAD · RISK · MARGIN
Накладные на час печати
Аренда, свет в цехе, связь, простаивающие машины.
overhead_per_print_hour
₽ / ч
Резерв на брак
Применяется только к производственной себестоимости, никогда к доставке.
failure_buffer_percent
%
Надбавка за срочность
rush_surcharge_percent
%
Прибыль
Тариф клиента может переопределить это значение.
margin_percent
БЫЛО 30
%
РАЗДЕЛ 03 · PRICING.DISCOUNTLADDER
Скидки
Лестница скидок за объём и персональные тарифы. Лестница проверяется на неинвертируемость при сохранении: больший заказ не может стоить дороже меньшего.
Лестница за объём4 СТУПЕНИ
| Ступень | От количества | Скидка | Цена за шт · пример | |
|---|---|---|---|---|
| 1 | шт | % | 571.52 ₽ | |
| 2 | шт | % | 529.41 ₽ | |
| 3 | шт | % | 493.31 ₽ | |
| 4 | шт | % | 457.22 ₽ |
ПРОВЕРКА :: ЛЕСТНИЦА НЕ ИНВЕРТИРУЕТСЯ
Защита от обрыва на пороге
Без неё 50 штук могут стоить дешевле, чем 49: ферма печатает лишнюю деталь и получает меньше денег. Выключайте, только если нужны «сырые» ступени.
guard_tier_cliffs
Тарифы клиентовPRICING.CUSTOMERTIER
| Код | Название | Скидка | Прибыль · переопределение | Клиентов |
|---|---|---|---|---|
| standard | Базовый | % | не задано | 27 |
| silver | Silver | % | не задано | 5 |
| gold | Gold | % | % | 2 |
СКИДКА КЛИЕНТА СКЛАДЫВАЕТСЯ СО СКИДКОЙ ЗА ОБЪЁМ
РАЗДЕЛ 04 · SCHEDULING.SCHEDULINGPOLICY
Планировщик
Как выбирается принтер, когда подходит несколько. Каждая составляющая — штраф от 0 до 1, умноженный на вес; побеждает машина с наименьшей суммой. Одно направление у всех весов: больше вес — сильнее избегаем.
Веса выбораШТРАФЫ, НЕ ДОСТОИНСТВА
Расход возможностей машины
Четырёхцветный AMS, потраченный на одноцветную деталь, — это мощность, которую ферма не сможет использовать.
weight_capability_waste
3
Запас материала в катушке
Закончиться посреди печати — потерять всю плиту и потраченные часы. Самый тяжёлый вес по умолчанию.
weight_material_headroom
4
Стоимость машины
Обычную работу — на дешёвые машины, дорогие держим свободными.
weight_amortization
1
Балансировка загрузки
Распределять работу, а не ставить всё в очередь на один принтер.
weight_load_balance
2
Нормировка и приоритет
Срочным считается заказ со сроком в пределах
Такие задания ставятся в начало очереди.
due_soon_hours
ч
«Полностью загружен» — это очередь в
Глубина очереди, принимаемая за 100% при нормировке балансировки.
load_horizon_minutes
мин
«Дорогая машина» — это
expensive_per_hour
₽ / ч
Комфортный запас материала
Во сколько раз остаток должен превышать потребность задания, чтобы перестать быть риском.
comfortable_headroom
×
Такт планировщика
Как часто пересматривается очередь.
scheduler_tick_seconds
с
Лист ожиданияПРИЧИНЫ И ПОВЕДЕНИЕ
Нет подходящего принтера
Требуется решение инженера. Заказчику срок не называется.
waitlist.no_capable_printer
Ждёт освобождения принтера
Обычная очередь. Заказчику показывается место и прогноз.
waitlist.awaiting_capacity
Материал не загружен
Никто не знает, когда человек поставит катушку, поэтому дата не обещается.
waitlist.material_not_loaded
РАЗДЕЛ 05 · ORDERING.SLAPOLICY
Сроки и SLA
Обещанный срок и что происходит, когда ферма из него выходит. Скидка за просрочку начисляется автоматически: заказчику не нужно её требовать, а ферме — обсуждать.
Обещанный срок
Запас поверх расчётного времени
Расчёт даёт чистое время печати; обещание должно пережить очередь и постобработку.
promise_buffer_percent
%
Минимальный срок
Ниже этого срок не обещается, даже если печать занимает 20 минут.
min_lead_hours
ч
Срок при срочном производстве
rush_lead_hours
ч
Скидка за просрочкуНАЧИСЛЯЕТСЯ АВТОМАТИЧЕСКИ
За каждые сутки просрочки
percent_per_day
БЫЛО 5
%
Потолок скидки
Дальше начисление останавливается — заказ не может стать бесплатным.
max_percent
%
Проверка просрочек
Как часто система обходит заказы и начисляет компенсацию.
sla_sweep_seconds
с
Возвращать деньги сразу
Иначе компенсация вычитается из суммы к доплате.
sla_auto_refund
Пересмотр цены
Допустимое отклонение факта от расчёта
Если фактическое время печати ушло дальше, заказ уходит в «Пересмотр цены», а не тихо дорожает.
price_variance_tolerance
БЫЛО 15
%
Кто утверждает пересмотр
price_review_role
РАЗДЕЛ 06 · INVENTORY
Склад
Пороги остатков, политика сушки и правила автозаказа. Отсюда берутся
предупреждения в таблице материалов и причина ожидания
waitlist.material_not_loaded.
Пороги остатков
Низкий остаток
Материал подсвечивается в таблице и не выбирается планировщиком для длинных заданий.
low_stock_grams
г
Критический остаток
Поднимается тревога, материал исключается из подбора.
critical_stock_grams
г
Автоматически предлагать закупку
Создаёт черновик заказа поставщику при пересечении низкого порога.
auto_reorder
Срок поставки по умолчанию
Используется для прогноза, пока поставщик не подтвердил дату.
default_lead_days
дн
Хранение и подготовка
Требовать сушку гигроскопичных материалов
PA, PETG-CF и TPU не уходят в печать без отметки о сушке.
require_drying
Срок годности отметки о сушке
После этого катушку нужно сушить заново.
drying_valid_hours
ч
Списывать остаток меньше
Хвост катушки, который не имеет смысла учитывать.
writeoff_below_grams
г
Учитывать партии отдельно
Разные партии одного материала могут отличаться по цвету. Выключение упрощает учёт, но теряет прослеживаемость.
track_lots
РАЗДЕЛ 07 · FLEET · DRIVERS
Сервис
Периодичность обслуживания по умолчанию и поведение драйверов. Периодичность считается по наработке, а не по календарю: машина, простоявшая месяц, не нуждается в замене сопла.
Периодичность по умолчаниюПРИМЕНЯЕТСЯ К НОВЫМ МАШИНАМ
| Операция | Код | Периодичность | Простой | Расход |
|---|---|---|---|---|
| Замена сопла | nozzle_change | ч | мин | 1 200 ₽ |
| Натяжение ремней | belt_tension | ч | мин | — |
| Смазка | lubrication | ч | мин | 80 ₽ |
| Калибровка стола | bed_level | ч | мин | — |
| Замена фильтра | filter_change | ч | мин | 450 ₽ |
| Глубокая чистка | deep_clean | ч | мин | — |
ПРОСТОЙ УЧИТЫВАЕТСЯ ПЛАНИРОВЩИКОМ КАК НЕДОСТУПНОСТЬ
Драйверы принтеровDRIVERS.*
Драйвер никогда не выдумывает данные. Отключённая машина
сообщает «не в сети» и поднимает тревогу. Это правило не настраивается —
ниже только таймауты, после которых машина считается потерянной.
Опрос телеметрии
telemetry_poll_seconds
с
Таймаут связи
Без ответа дольше этого — машина переходит в «не в сети».
driver_timeout_seconds
с
Повторных попыток отправки задания
driver_send_retries
раз
Автоматическая пауза при ошибке HMS
Останавливает печать и вызывает оператора вместо продолжения с браком.
pause_on_hms_error
Разрешить драйвер mock в продакшене
Mock-драйвер отказывается работать в продакшене by design. Переключатель существует только для стенда.
allow_mock_driver
РАЗДЕЛ 08 · PRICING.POSTPROCESS.*
Постобработка
Единственный этап, который остаётся ручным. Нормо-часы умножаются на ставку постобработки из раздела «Ценообразование».
Каталог операций
| Операция | Код | Нормо-часы · база | На см² поверхности | Доступна |
|---|---|---|---|---|
| Без обработки | postprocess.raw | — | — | |
| Шлифовка | postprocess.sanded | ч | ч | |
| Грунтовка | postprocess.primed | ч | ч | |
| Окраска | postprocess.painted | ч | ч |
НОВЫЙ КОД ТРЕБУЕТ RU И EN ПОДПИСИ — ИНАЧЕ CI НЕ ПРОПУСТИТ
Контроль качества обязателен
Заказ не может уйти в упаковку, минуя отметку контролёра.
require_quality_check
Фотофиксация перед упаковкой
Снимок прикладывается к заказу и виден заказчику.
photo_before_packing
РАЗДЕЛ 09 · LOGISTICS.*
Логистика
Упаковка и доставка. До указания адреса строка доставки в смете остаётся неопределённой — система не подставляет туда правдоподобное число.
Упаковка
Упаковка за единицу
packaging_per_unit
₽
Базовая доставка
Ставка по умолчанию, пока не сработала зона ниже.
shipping_flat
₽
Объёмный вес
Делитель для пересчёта габаритов в вес. 5000 — стандарт большинства перевозчиков.
volumetric_divisor
см³/кг
Бесплатная доставка от
Ноль — отключено.
free_shipping_threshold
₽
Зоны и перевозчики
| Зона | Перевозчик | Базовая | За кг | Срок | Активна |
|---|---|---|---|---|---|
| Самовывоз · цех | pickup | ₽ | — | 0 дн | |
| Москва · в пределах МКАД | courier.msk | ₽ | ₽ | 1 дн | |
| ЦФО | cdek.cfo | ₽ | ₽ | 2–3 дн | |
| Россия · остальное | cdek.ru | ₽ | ₽ | 4–7 дн | |
| Международная | intl | ₽ | ₽ | — |
ЗОНА ОПРЕДЕЛЯЕТСЯ ПО ИНДЕКСУ
РАЗДЕЛ 10 · PAYMENTS
Финансы
Налоги, приём платежей и возвраты. Реквизиты провайдера хранятся зашифрованными и никогда не показываются обратно.
Налоги и учёт
Система налогообложения
tax_regime
Ставка НДС
Учитывается только при ОСНО.
vat_percent
%
Цены включают налог
Влияет на то, как разложена смета, но не на итог.
prices_include_tax
Округление итога
rounding_step
Приём платежей
Провайдер
payment_provider
Идентификатор магазина
yookassa_shop_id
Секретный ключ
Хранится зашифрованным. Показать значение обратно невозможно — только заменить.
yookassa_secret_key
КЛЮЧ СОХРАНЁН
Предоплата
100% — заказ не уходит в производство до полной оплаты.
prepayment_percent
%
Оплата по счёту для юрлиц
invoice_payment
Срок оплаты счёта
invoice_due_days
раб. дн
Возвраты
Возврат до начала печати
Пока задание не ушло на принтер, ферма ничего не потратила.
refund_before_print_percent
%
Возврат после начала печати
refund_after_print_percent
%
Порог возврата без утверждения
Выше этой суммы возврат требует роли «Владелец».
refund_approval_threshold
₽
РАЗДЕЛ 11 · NOTIFICATIONS
Уведомления
Матрица «событие × канал». Строки — то, что происходит в системе; столбцы — куда об этом сообщать.
МатрицаЗАКАЗЧИК · ОПЕРАТОР · МЕНЕДЖЕР
| Событие | Код | Почта | Экран цеха | Telegram |
|---|---|---|---|---|
| Заказ оплачен | order.paid | |||
| Печать началась | order.printing | |||
| Печать завершена · нужен человек | print.finished | |||
| Ошибка принтера | printer.error | |||
| Низкий остаток материала | material.low | |||
| Пора обслужить машину | service.due | |||
| Риск просрочки SLA | order.sla_risk | |||
| Заказ отправлен | order.shipped |
Каналы
Отправитель писем
mail_from
SMTP-сервер
smtp_host
Telegram · чат цеха
telegram_chat_id
Тихие часы
Всё, кроме ошибок принтера, откладывается до утра.
quiet_hours
с
до
РАЗДЕЛ 12 · IDENTITY
Доступ
Сессии, пароли и ключи API. Права проверяются на сервере — эти настройки не влияют на то, что разрешено роли, только на то, как подтверждается личность.
Сессии и пароли
Время жизни сессии
session_ttl_hours
ч
Минимальная длина пароля
password_min_length
симв
Алгоритм хэширования
Смена алгоритма перехэширует пароли при следующем входе.
password_hasher
Двухфакторная аутентификация для управления
Обязательна для ролей «Менеджер» и «Владелец».
require_2fa_for_management
Блокировка после неудачных попыток
lockout_attempts
попыт
Ключи API2 АКТИВНЫХ
| Название | Префикс | Права | Создан | Использован | |
|---|---|---|---|---|---|
| Экран цеха | pk_live_8f41… | view_production | 12.03.2026 | сейчас | |
| Выгрузка в 1С | pk_live_2a0c… | view_all_orders | 04.05.2026 | сегодня 03:00 |
КЛЮЧ ПОКАЗЫВАЕТСЯ ОДИН РАЗ ПРИ СОЗДАНИИ
Аудит
Хранить журнал изменений
Кто, что и когда менял в настройках, ценах и заказах.
audit_retention_days
дн
РАЗДЕЛ 13 · INTEGRATIONS
Интеграции
Внешние системы, от которых зависит ферма. Каждая показывает своё фактическое состояние, а не то, что записано в настройках.
СлайсерРАСЧЁТ ВРЕМЕНИ И МАТЕРИАЛА
Движок
slicer_engine
Путь к исполняемому файлу
slicer_path
Профиль по умолчанию
slicer_profile
Таймаут нарезки
Модель, которая нарезается дольше, уходит инженеру вместо отказа заказчику.
slicer_timeout_seconds
с
ПринтерыDRIVERS.BAMBU
Режим подключения
Ферма работает в своей локальной сети. Облако — запасной путь для машин вне неё.
bambu_connection
Аккаунт Bambu Cloud
bambu_cloud_account
НЕ ПОДКЛЮЧЕН
Загрузка по MQTT / FTPS
bambu_transport
Webhooks
| Событие | URL | Состояние | |
|---|---|---|---|
| order.* | https://crm.local/hooks/printorian | Работает | |
| printer.error | https://alerts.local/pd | 4 ошибки подряд |
ПОДПИСЬ HMAC-SHA256 В ЗАГОЛОВКЕ X-PRINTORIAN-SIGNATURE
РАЗДЕЛ 14 · DIAGNOSTICS
Диагностика
Фактическое состояние подсистем. Ничего из этого не настраивается — страница показывает, что система думает о себе прямо сейчас.
ГотовностьOK14 ИЗ 15 ПРОВЕРОК
Аптайм41 ДС 29.06.2026
События в очереди0ШИНА СВОБОДНА
Предупреждений01СПАЙК BAMBU НЕ ВЫПОЛНЕН
ПроверкиОБНОВЛЕНО
База данных · PostgreSQL 16Доступна2 мс
Миграции · одна голова0004_fleet—
Шина событийРаботает0 мс
RedisДоступен1 мс
Планировщик · тактТикает30 с
Обход SLAРаботает300 с
Слайсер · Bambu Studio CLIОтвечает840 мс
Платёжный провайдер · ЮKassaДоступен120 мс
SMTPДоступен210 мс
Драйверы · 11 из 12 на связиP-08 не в сети4 ч
Спайк Bambu на реальной машинеНе выполнен—
Свободное место на диске312 ГБ78%
ПРОВЕРКИ ВЫПОЛНЯЮТСЯ ПО ЗАПРОСУ, НЕ КЭШИРУЮТСЯ
Версии
- Backend2.0.0 · 8f41c2b
- Движок расчётаENGINE_VERSION 1.0.0
- Схема БД0004_fleet
- Веб-клиент2.0.0
- Десктоп цеха2.0.0
ЖурналПОСЛЕДНИЕ ЗАПИСИ
LOGS/APP.JSONLУРОВЕНЬ :: WARNING+
19:12:04 WARNING driver.bambu P-08 offline for 4h12m, alert raised
18:40:31 WARNING inventory PETG-CF-RED below low_stock_grams (340 < 400)
14:22:07 INFO scheduling ORD-2147 assigned P-01 (score 0.31)
14:18:55 INFO ordering ORD-2147 -> printing
09:00:02 INFO maintenance backup completed, 1.2 GBРОТАЦИЯ :: 14 ДНЕЙ
РАЗДЕЛ 15 · SYSTEM.MAINTENANCE
Обслуживание
Резервные копии, хранение данных и необратимые операции.
Резервное копирование
Автоматические копии
backup_enabled
Время запуска
backup_hour
час
Хранить копий
backup_retention
шт
Каталог копий
backup_path
ПОСЛЕДНЯЯ :: СЕГОДНЯ 03:00 · 1.2 ГБ · УСПЕШНО
Хранение данных
Загруженные модели
Файлы завершённых заказов. Метаданные и смета сохраняются навсегда.
model_retention_days
дн
Телеметрия принтеров
telemetry_retention_days
дн
Режим обслуживания
Витрина закрывается, текущая печать продолжается до конца.
maintenance_mode
Каждая требует подтверждения вводом названия фермы и пишется в аудит с указанием, кто её выполнил.
Сбросить тарифы к значениям по умолчанию
Создаст новый снимок. Оформленные заказы не затрагиваются.
Очистить лист ожидания
Все ожидающие заказы вернутся в состояние «Подготовка».
Удалить телеметрию старше срока хранения
Освободит около 8 ГБ.
Журнал изменений настроекАУДИТ
| Время | Кто | Параметр | Было | Стало |
|---|---|---|---|---|
| 08.08 11:42 | boss@… | margin_percent | 28 | 30 |
| 05.08 16:20 | manager@… | rush_surcharge_percent | 20 | 25 |
| 01.08 09:05 | boss@… | discounts.tiers[3] | — | 100 шт · 24% |
| 28.07 14:11 | boss@… | guard_tier_cliffs | false | true |
ХРАНИТСЯ 365 ДНЕЙ