24. Manufacture KPI: Выполнение плана производства

Date: 2026-03-10

Status

Accepted

Context

Требуется зафиксировать в системе оплаты мотивацию за выполнение плана смены по объёму и номенклатуре выпуска. Метрика привязана к производственным позициям смены и документу производства; расчёт должен выполняться автоматически при закрытии смены.

Decision

• В справочнике KPICatalog заведена метрика с pk=1, название «Выполнение плана производства», тип percentage, min/max 10/24, calculation_timing=realtime, function_name=full_fillment_of_the_production_plan.
• Критерий выполнения: документ первой производственной позиции смены считается выполненным с допуском 2% (ManufacturePositions.is_document_completed, tolerance=0.02). Реализация в app/manufacture/service/kpi_check_functions.py.
• При выполнении создаётся KPIRecord с source_type='auto'; сумма входит в расчёт смены через calculate_kpi() и sync_kpi_records().
• Документация по критериям и формуле: metrics/001-vypolnenie-plana-proizvodstva.md.

Consequences

• Метрика участвует в автоматическом расчёте только при наличии у смены manufactured_position_list; при отсутствии позиций KPI не выполняется (False).
• Общий поток расчёта и начисления описан в ADR 0023.