commit de armazens
tests / ci (push) Canceled after 0s

This commit is contained in:
2026-11-04 09:40:26 +02:00
parent e753f7a0a4
commit 63d20b10fc
245 changed files with 10847 additions and 230 deletions
+7
View File
@@ -0,0 +1,7 @@
# Commitment cancellation capability
Additive local development capability for integral issued-order cancellation. Does not replace or modify the installed budget-control or payables artifacts, and is not installed in SGF.
The host must hold its company lock, authenticate an independent finance actor, validate the published policy, confirm absence of receipts/invoices/payments and open the encompassing transaction. The writer appends a reversal of the original wholly available commitment in the canonical budget_entries ledger. The host binds the reversal entry to its decision in the same transaction and audit.
MZN only. Verify source SHA-256 against config/order_cancellation.php before execution. No transport, bank operations, invoice cancellation, partial cancellation, activation or grants. The capability is disabled in the local pilot; validation uses disposable databases.
@@ -0,0 +1,47 @@
<?php
namespace Tempo\Finance\OrderCancellation;
use Brick\Math\BigDecimal;
use Illuminate\Database\ConnectionInterface;
use LogicException;
use Tempo\Finance\Budget\BudgetContext;
/** Additive finance capability: the original commitment is never changed. */
final class CommitmentReversal
{
public function reverse(ConnectionInterface $db, BudgetContext $context, int $origin, int $order): ?int
{
if ($db->transactionLevel() < 1) {
throw new LogicException('Reversal requires the host transaction and company lock.');
}
$entries = $db->table('budget_entries')->where($context->scope)->where('requisition_id', $origin)->orderBy('id')->lockForUpdate()->get();
if ($entries->isEmpty()) {
return null;
}
$commit = $entries->where('kind', 'commit');
if ($commit->count() !== 1) {
throw new LogicException('Exactly one original commitment required.');
}
$source = $commit->first();
$amount = BigDecimal::of((string) $source->committed_minor)->toInt();
$kind = 'order-cancel-'.$order;
$old = $entries->firstWhere('kind', $kind);
if ($old) {
if ((int) $old->committed_minor !== -$amount || (int) $old->reserved_minor !== 0 || $old->budget_id !== $source->budget_id) {
throw new LogicException('Invalid prior reversal.');
}
return (int) $old->id;
}
$budget = $db->table('budgets')->where($context->scope)->where('id', $source->budget_id)->lockForUpdate()->first();
if (! $budget || ! $budget->approved_by || $amount <= 0 || $entries->contains(fn ($e) => $e->budget_id !== $source->budget_id)
|| BigDecimal::of((string) $entries->sum('reserved_minor'))->toInt() !== 0
|| BigDecimal::of((string) $entries->sum('committed_minor'))->toInt() !== $amount) {
throw new LogicException('Commitment is not wholly available for reversal.');
}
return $db->table('budget_entries')->insertGetId([...$context->scope, 'budget_id' => $source->budget_id, 'requisition_id' => $origin,
'created_by' => $context->actorId, 'kind' => $kind, 'reserved_minor' => 0, 'committed_minor' => -$amount, 'created_at' => now()]);
}
}