@@ -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()]);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user