commit12
This commit is contained in:
@@ -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.'];
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user