|
|
|
@@ -0,0 +1,115 @@
|
|
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace Tempo\Purchasing\Supply;
|
|
|
|
|
|
|
|
|
|
use Brick\Math\BigDecimal;
|
|
|
|
|
use Brick\Math\RoundingMode;
|
|
|
|
|
use Carbon\CarbonImmutable;
|
|
|
|
|
|
|
|
|
|
/** Quantities use integer thousandths, consistently with the existing stock ledger. */
|
|
|
|
|
final class ReplenishmentProjection
|
|
|
|
|
{
|
|
|
|
|
/** @param array<string,mixed> $policy
|
|
|
|
|
* @param list<array{date:string,quantity:int,additional?:bool}> $reservations
|
|
|
|
|
* @param list<array{date:string,quantity:int,confirmed:bool}> $receipts
|
|
|
|
|
* @param list<array{date:string,quantity:int}> $fulfilledNeeds
|
|
|
|
|
* @param list<array{quantity:int,last_usable_on:?string}>|null $lotBuckets
|
|
|
|
|
* @return array<string,mixed>
|
|
|
|
|
*/
|
|
|
|
|
public function calculate(array $policy, int $physical, string $start, array $reservations = [], array $receipts = [], int $consumedToday = 0, array $fulfilledNeeds = [], ?array $lotBuckets = null): array
|
|
|
|
|
{
|
|
|
|
|
$day = CarbonImmutable::parse($start)->startOfDay();
|
|
|
|
|
$daily = $policy['daily_milli'] ?? null;
|
|
|
|
|
$rate = $policy['daily_rate'] ?? null;
|
|
|
|
|
if ($rate !== null) {
|
|
|
|
|
if (! is_int($rate['numerator_milli']) || $rate['numerator_milli'] < 0 || ! is_int($rate['denominator_days']) || $rate['denominator_days'] < 1) {
|
|
|
|
|
throw new \InvalidArgumentException('A média histórica exige numerador não negativo e denominador positivo.');
|
|
|
|
|
}
|
|
|
|
|
$daily = 0;
|
|
|
|
|
}
|
|
|
|
|
if ($daily === null && $reservations === []) {
|
|
|
|
|
return ['available' => false, 'reason' => 'Previsão indisponível: configure consumo manual ou histórico validado.'];
|
|
|
|
|
}
|
|
|
|
|
$knownOnly = $daily === null;
|
|
|
|
|
$daily ??= 0;
|
|
|
|
|
$balance = $physical;
|
|
|
|
|
$risk = null;
|
|
|
|
|
$shortage = null;
|
|
|
|
|
$before = null;
|
|
|
|
|
$series = [];
|
|
|
|
|
$safety = $policy['safety_milli'];
|
|
|
|
|
if ($balance <= $safety) {
|
|
|
|
|
$risk = $day->toDateString();
|
|
|
|
|
$before = $balance;
|
|
|
|
|
}
|
|
|
|
|
for ($offset = 0; $offset < $policy['horizon_days']; $offset++) {
|
|
|
|
|
$date = $day->addDays($offset)->toDateString();
|
|
|
|
|
$expired = 0;
|
|
|
|
|
if ($lotBuckets !== null) {
|
|
|
|
|
foreach ($lotBuckets as &$bucket) {
|
|
|
|
|
if ($bucket['last_usable_on'] !== null && $bucket['last_usable_on'] < $date) {
|
|
|
|
|
$expired += $bucket['quantity'];
|
|
|
|
|
$bucket['quantity'] = 0;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
unset($bucket);
|
|
|
|
|
}
|
|
|
|
|
$incoming = array_sum(array_column(array_filter($receipts, fn ($r) => $r['confirmed'] && $r['date'] === $date), 'quantity'));
|
|
|
|
|
$known = array_filter($reservations, fn ($r) => $r['date'] === $date);
|
|
|
|
|
$substitutes = array_sum(array_column(array_filter($known, fn ($r) => ! ($r['additional'] ?? false)), 'quantity'));
|
|
|
|
|
$additional = array_sum(array_column(array_filter($known, fn ($r) => $r['additional'] ?? false), 'quantity'));
|
|
|
|
|
$satisfied = array_sum(array_column(array_filter($fulfilledNeeds, fn ($n) => $n['date'] === $date), 'quantity'));
|
|
|
|
|
$expected = $daily;
|
|
|
|
|
if ($rate !== null) {
|
|
|
|
|
$cumulative = BigDecimal::of($rate['numerator_milli'])->multipliedBy($offset + 1)->dividedBy($rate['denominator_days'], 0, RoundingMode::Ceiling)->toInt();
|
|
|
|
|
$previous = BigDecimal::of($rate['numerator_milli'])->multipliedBy($offset)->dividedBy($rate['denominator_days'], 0, RoundingMode::Ceiling)->toInt();
|
|
|
|
|
$expected = $cumulative - $previous;
|
|
|
|
|
}
|
|
|
|
|
$residualForecast = max(0, $expected - $satisfied - ($offset === 0 ? $consumedToday : 0));
|
|
|
|
|
$demand = max($residualForecast, $substitutes) + $additional;
|
|
|
|
|
$balance += $incoming - $demand - $expired;
|
|
|
|
|
if ($lotBuckets !== null) {
|
|
|
|
|
$remaining = $demand;
|
|
|
|
|
foreach ($lotBuckets as &$bucket) {
|
|
|
|
|
$take = min($remaining, $bucket['quantity']);
|
|
|
|
|
$bucket['quantity'] -= $take;
|
|
|
|
|
$remaining -= $take;
|
|
|
|
|
}
|
|
|
|
|
unset($bucket);
|
|
|
|
|
}
|
|
|
|
|
if ($risk === null && $balance <= $safety) {
|
|
|
|
|
$risk = $date;
|
|
|
|
|
$before = $balance;
|
|
|
|
|
}
|
|
|
|
|
if ($shortage === null && $balance < 0) {
|
|
|
|
|
$shortage = $date;
|
|
|
|
|
}
|
|
|
|
|
$series[] = ['date' => $date, 'balance_milli' => $balance, 'incoming_milli' => $incoming, 'demand_milli' => $demand, ...($lotBuckets !== null ? ['expired_milli' => $expired] : [])];
|
|
|
|
|
}
|
|
|
|
|
$base = $before === null ? 0 : max(0, $policy['target_milli'] - $before);
|
|
|
|
|
$quantity = $base === 0 ? 0 : max($base, $policy['minimum_milli']);
|
|
|
|
|
$multiple = $policy['pack_milli'];
|
|
|
|
|
$quantity = $quantity === 0 ? 0 : intdiv($quantity + $multiple - 1, $multiple) * $multiple;
|
|
|
|
|
$excess = $before === null ? 0 : max(0, $before + $quantity - $policy['maximum_milli']);
|
|
|
|
|
$futureExcess = 0;
|
|
|
|
|
if ($risk !== null && $quantity > 0) {
|
|
|
|
|
foreach ($series as $point) {
|
|
|
|
|
if ($point['date'] >= $risk) {
|
|
|
|
|
$futureExcess = max($futureExcess, $point['balance_milli'] + $quantity - $policy['maximum_milli']);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$mean = $rate === null ? $daily : (string) BigDecimal::of($rate['numerator_milli'])->dividedBy($rate['denominator_days'], 6, RoundingMode::HalfUp);
|
|
|
|
|
$reorder = $rate === null ? $daily * $policy['lead_days'] + $safety : BigDecimal::of($rate['numerator_milli'])->multipliedBy($policy['lead_days'])->dividedBy($rate['denominator_days'], 0, RoundingMode::Ceiling)->plus($safety)->toInt();
|
|
|
|
|
|
|
|
|
|
return ['available' => true, 'method' => $knownOnly ? 'known_needs_only' : ($rate === null ? 'manual_calendar_days' : 'historical_mean_calendar_days'), 'demand_complete' => ! $knownOnly, 'physical_milli' => $physical,
|
|
|
|
|
'daily_milli' => $mean, 'reorder_point_milli' => $reorder,
|
|
|
|
|
'risk_date' => $risk, 'shortage_date' => $shortage,
|
|
|
|
|
'order_date' => $risk === null ? null : CarbonImmutable::parse($risk)->subDays($policy['lead_days'])->toDateString(),
|
|
|
|
|
'request_date' => $risk === null ? null : CarbonImmutable::parse($risk)->subDays($policy['lead_days'] + $policy['approval_days'])->toDateString(),
|
|
|
|
|
'base_milli' => $base, 'quantity_milli' => $quantity, 'excess_milli' => $excess,
|
|
|
|
|
'future_excess_milli' => $futureExcess, 'requires_exception' => $excess > 0 || $futureExcess > 0, 'series' => $series,
|
|
|
|
|
'convention' => 'Stock inicial na abertura; entradas confirmadas de manhã; consumo e nova reposição no fim do dia.'];
|
|
|
|
|
}
|
|
|
|
|
}
|