fix: recover simulator cashflow and verify QA continuity and report assumptions

This commit is contained in:
2026-10-20 22:00:48 +02:00
parent a690c665fb
commit c22003a3da
20 changed files with 773 additions and 95 deletions
@@ -0,0 +1,34 @@
<?php
namespace Tests\Feature;
use App\Models\User;
use App\Services\VirtualDesk;
use App\Support\IsolatedQaDatabase;
use Illuminate\Foundation\Testing\DatabaseTransactions;
use Illuminate\Support\Str;
use Tests\TestCase;
class SimulatorCashflowContinuityTest extends TestCase
{
use DatabaseTransactions;
public function test_cashflow_snapshot_recovers_in_each_dossier_after_a_new_session_without_turning_unknown_tax_into_zero(): void
{
$this->assertTrue(IsolatedQaDatabase::allowsSchemaChanges());
config(['investor-path.enabled' => true]);
$owner = User::factory()->create(['name' => 'SINTETICO QA continuidade']);
$cases = [];
foreach (['77.01', '99.02'] as $cash) {
$case = app(VirtualDesk::class)->createCase($owner, ['title' => 'SINTETICO QA tesouraria '.$cash, 'client_key' => (string) Str::uuid(), 'reuse_consent' => true]);
$snapshot = json_encode(['version' => 1, 'taxMode' => 'schedule', 'inputs' => ['openingCash' => $cash, 'monthlyRevenue' => '200', 'monthlyOperatingCosts' => '150', 'monthlyDebtService' => '20', 'monthlyTaxAssessed' => '', 'monthlyTaxSchedule' => ['10', '', '20', ...array_fill(0, 9, '0')], 'vatCreditEstimated' => '0', 'vatRefundRequested' => '0', 'vatRefundRecognized' => '0', 'vatRefundExpectedReceipt' => '0', 'vatRefundExpectedMonth' => '']], JSON_THROW_ON_ERROR);
$this->actingAs($owner)->postJson('/api/v1/simulation-drafts', ['context' => $case->id, 'personal_snapshot' => [], 'economic_snapshot' => ['purpose' => 'simulate_only', 'journey_type' => 'small_business', 'cashflow_snapshot' => $snapshot]], ['Idempotency-Key' => (string) Str::uuid()])->assertCreated();
$cases[] = [$case->id, $snapshot];
}
$this->flushSession();
foreach ($cases as [$id,$snapshot]) {
$this->actingAs(User::findOrFail($owner->id))->getJson('/api/v1/simulation-drafts/current?context='.$id)->assertOk()->assertJsonPath('data.economic_snapshot.cashflow_snapshot', $snapshot);
}
$this->actingAs(User::factory()->create())->getJson('/api/v1/simulation-drafts/current?context='.$cases[0][0])->assertForbidden();
}
}
@@ -0,0 +1,16 @@
<?php
namespace Tests\Feature;
use Tests\TestCase;
class SimulatorReviewMessagesTest extends TestCase
{
public function test_missing_api_route_has_a_portuguese_message_without_changing_the_status(): void
{
config(['app.debug' => false]);
$this->getJson('/api/v1/synthetic-qa-route-not-installed')->assertNotFound()
->assertJsonPath('message', 'O registo não foi encontrado ou não está acessível nesta conta.')
->assertHeader('X-Correlation-ID');
}
}
@@ -11,6 +11,28 @@ use PHPUnit\Framework\TestCase;
final class SimulationTaxParameterResolverTest extends TestCase
{
#[Test]
public function synthetic_qa_versions_keep_historical_values_and_expose_a_period_transition_without_activating_rules(): void
{
$before = $this->publicVersion('2026-01-01', '2026-06-30', '7.5', 1);
$after = $this->publicVersion('2026-07-01', null, '9.25', 2);
$before['rule_code'] = $after['rule_code'] = 'QA.SYNTHETIC.NOT.LEGISLATION';
$before['source']['title'] = $after['source']['title'] = 'SINTETICO QA — nao e legislacao';
$before['source']['diploma'] = $after['source']['diploma'] = 'QA-FIXTURE-ONLY';
$resolver = new SimulationTaxParameterResolver;
$historical = $resolver->resolveAvailableParameters([$before], 'IVA', '2026-06-01', '2026-06-30', ['operation' => 'domestic']);
$frozen = json_encode($historical, JSON_THROW_ON_ERROR);
$current = $resolver->resolveAvailableParameters([$before, $after], 'IVA', '2026-07-01', '2026-07-31', ['operation' => 'domestic']);
self::assertSame('7.5', $historical[0]['value']);
self::assertSame('9.25', $current[0]['value']);
self::assertSame(2, $current[0]['rule_version']);
self::assertSame('indeterminate_period_change', $resolver->resolveAvailableParameters([$before, $after], 'IVA', '2026-01-01', '2026-12-31', ['operation' => 'domestic'])[0]['status']);
self::assertSame($frozen, json_encode($historical, JSON_THROW_ON_ERROR));
self::assertSame($historical, $resolver->resolveAvailableParameters([$before, $after], 'IVA', '2026-06-01', '2026-06-30', ['operation' => 'domestic']));
$after['source']['version_no'] = 2;
self::assertSame([], $resolver->resolveAvailableParameters([$after], 'IVA', '2026-07-01', '2026-07-31', ['operation' => 'domestic']));
}
#[Test]
public function it_selects_the_published_version_effective_on_the_requested_date_and_returns_its_source(): void
{
@@ -0,0 +1,197 @@
import assert from 'node:assert/strict';
import test from 'node:test';
import { forecastBusinessPlan } from '../../resources/js/lib/business-financial-plan.ts';
import { projectMonthlyCashflow } from '../../resources/js/lib/monthly-cashflow.ts';
import {
defaultCashflowDraftInputs,
serializeCashflowDraftSnapshot,
restoreCashflowDraftSnapshot,
} from '../../resources/js/lib/monthly-cashflow.ts';
import { serializeFinancialToolsSnapshot } from '../../resources/js/lib/financial-calculators.ts';
import { buildProjectDossierRows } from '../../resources/js/lib/project-dossier.ts';
import { createProjectDossierReport } from '../../resources/js/lib/project-dossier-report.ts';
test('cashflow draft recovery preserves unanswered months and invalid editable values without using zero', () => {
const inputs = {
...defaultCashflowDraftInputs(),
openingCash: '77.01',
monthlyTaxSchedule: ['10', '', '20', ...Array(9).fill('0')],
};
const stored = serializeCashflowDraftSnapshot('schedule', inputs);
const restored = restoreCashflowDraftSnapshot(stored);
assert.equal(restored.taxMode, 'schedule');
assert.deepEqual(restored.inputs, inputs);
assert.equal(restored.inputs.monthlyTaxSchedule[1], '');
const rows = buildProjectDossierRows({
currency: 'MZN',
cashflow_snapshot: stored,
});
assert.equal(
rows.find(
(row) => row[0] === 'Tesouraria' && row[1] === 'Saldo final total',
)[2],
'Indeterminado',
);
assert.ok(
rows
.find((row) => row[0] === 'Tesouraria' && row[1] === 'Mês 2')[2]
.includes('Imposto assumido: Indeterminado'),
);
const report = createProjectDossierReport(
{
currency: 'MZN',
cashflow_snapshot: stored,
},
{
selectedSections: new Set(['summary', 'finance']),
version: 'SINTETICO QA',
},
);
assert.equal(
report.sections
.find((section) => section.id === 'summary')
.rows.find(
(row) => row.field === 'Saldo final de tesouraria — 12 meses',
).value,
'Indeterminado',
);
const invalid = { ...inputs, monthlyRevenue: 'corrigir' };
assert.equal(
restoreCashflowDraftSnapshot(
serializeCashflowDraftSnapshot('fixed', invalid),
).inputs.monthlyRevenue,
'corrigir',
);
assert.equal(restoreCashflowDraftSnapshot('{"version":2}'), null);
assert.equal(
restoreCashflowDraftSnapshot(
stored.replace('"version":1', '"version":2'),
),
null,
);
});
test('credit report preserves the complete reproducible recipe alongside the result', () => {
const rows = buildProjectDossierRows({
purpose: 'simulate_only',
journey_type: 'small_business',
currency: 'MZN',
financial_tools_snapshot: serializeFinancialToolsSnapshot({
budgetPeriod: 'Mensal',
loan: {
principal: '1000',
rate: '12',
months: '12',
rateType: 'nominal',
periodMonths: '1',
gracePeriods: '0',
upfrontFee: '0',
recurringFee: '0',
},
breakEven: { fixed: '100', price: '20', variable: '10' },
funding: { total: '1000', secured: '0' },
incomes: [{ label: 'QA', amount: '100' }],
expenses: [{ label: 'QA', amount: '50' }],
}),
});
const recipe = rows.find(
(row) => row[1] === 'Método e pressupostos substituídos',
)[2];
for (const text of [
'1000 MZN',
'12% nominal anual',
'12 meses',
'periodicidade 1 meses',
'carência 0',
'comissão inicial 0 MZN',
'comissão periódica 0 MZN',
'duas casas decimais',
'metade para cima',
'saldo residual',
])
assert.ok(recipe.includes(text), text);
assert.equal(
rows.find((row) => row[1] === 'Prestação do primeiro período')[2],
'88.85 MZN',
);
});
// Synthetic QA control ledger, independently calculated before invoking the engines.
// Sales 200; variable expense 80; operations 20; payroll 10;
// depreciation 10; interest expense 5 => profit before tax 75/month.
// Cash: receipts 180; inventory 70; operations 25; payroll 10;
// interest paid 7; principal paid 12 => cash increases 56/month.
// Initial funding 1200; asset 600 + inventory 100 + receivables 50 - payables 20 = 730;
// opening cash 470 => closing 638 after three months. No tax rate is assumed.
test('independent three-month ledger separates profit working capital and cash', () => {
const result = forecastBusinessPlan({
currency: 'MZN',
openingCash: '0',
products: [
{
label: 'SINTETICO QA',
monthlyUnits: '10',
unitPrice: '20',
unitVariableCost: '8',
},
],
monthlyCollections: '180',
monthlyVariableCostPayments: '70',
monthlyInventoryPurchases: '70',
monthlyOperatingExpenses: '20',
monthlyOperatingPayments: '25',
monthlyPayrollExpense: '10',
monthlyPayrollPayments: '10',
assetInvestment: '600',
inventory: '100',
receivables: '50',
payables: '20',
equity: '1000',
shareholderLoans: '0',
bankLoanProceeds: '200',
grants: '0',
assetDepreciation: '600',
depreciationLifeMonths: 60,
monthlyInterestExpense: '5',
monthlyInterestPayment: '7',
monthlyPrincipalRepayment: '12',
periods: 3,
});
assert.equal(result.workingCapital, '130.00');
assert.equal(result.initialUses, '730.00');
assert.equal(result.openingCashAfterInitialUses, '470.00');
assert.equal(result.totalProfitBeforeTax, '225.00');
assert.equal(result.endingCash, '638.00');
assert.equal(result.totalCashCollections, '540.00');
});
test('independent cash ledger excludes VAT stages and preserves the unknown tax month', () => {
const input = {
currency: 'MZN',
openingCash: '100',
monthlyRevenue: '200',
monthlyOperatingCosts: '150',
monthlyDebtService: '20',
monthlyTaxSchedule: ['10', '', '20'],
vatCreditEstimated: '1000',
vatRefundRequested: '900',
vatRefundRecognized: '800',
vatRefundExpectedReceipt: '50',
vatRefundExpectedMonth: '2',
periods: 3,
};
const result = projectMonthlyCashflow(input);
// Known cash: 100 + 20 + 80 + 10 = 210; month 2 tax is unknown.
assert.equal(result.rows[0].closingCash, '120.00');
assert.equal(result.rows[1].closingCash, null);
assert.equal(result.endingCash, null);
assert.equal(result.endingCashBeforeUnassessedTax, '210.00');
assert.equal(
projectMonthlyCashflow({
...input,
monthlyTaxSchedule: ['10', '0', '20'],
}).endingCash,
'210.00',
);
assert.equal(input.monthlyTaxSchedule[1], '');
});