fix: reconcile annual example ledger and illustrative months in QA

This commit is contained in:
2026-11-20 11:01:28 +02:00
parent e27b354192
commit 65a52aa3c9
10 changed files with 935 additions and 7 deletions
@@ -10381,4 +10381,13 @@ Após a primeira avaliação, o proprietário autorizou QA novo sintético compa
Inventário individual e obrigatoriedade dos dados das onze tabelas registados no aditamento existente de apresentacao-contexto-qa-20261115.md. Nenhuma tabela está integralmente pronta. Nova divergência aritmética da fonte2025: activos501475, passivos1642+capital499834=501476; diferença1,00. Proprietário limitou a correcção aos centavos. Implementada reconciliação exacta sem tolerância de0,01 ou acerto presumido; cinco rácios dependem de balanço equilibrado e denominadores zero ficam indeterminados. Valores da fonte/totais anuais preservados; os centavos originais não foram fornecidos. Fórmulas ainda não integradas no relatório integral.
100 testes frontend focados aprovados, incluindo quatro novos de integridade; tipos/lint/Pint/build QA verificados. Não correram suites com RefreshDatabase nas fixtures novas. Etapas1substituta/2 realizadas; etapa3 parcial; recolha/CAE/visual/relatório persistido não concluídos. Classificação NÃO APTO: inconsistência da fonte, integração/tabelas/dados pendentes e perda anterior ainda registada. Sem instalação/publicação/migrações operacionais. A autorização nova substitui o bloqueio de sequência anterior apenas quanto à base QA, não declara integridade do histórico perdido.
100 testes frontend focados aprovados, incluindo quatro novos de integridade; tipos/lint/Pint/build QA verificados. Não correram suites com RefreshDatabase nas fixtures novas. Etapas1substituta/2 realizadas; etapa3 parcial; recolha/CAE/visual/relatório persistido não concluídos. Classificação NÃO APTO: inconsistência da fonte, integração/tabelas/dados pendentes e perda anterior ainda registada. Sem instalação/publicação/migrações operacionais. A autorização nova substitui o bloqueio de sequência anterior apenas quanto à base QA, não declara integridade do histórico perdido.
### 20/11/2026 — diagnóstico exclusivo após e27b3541, fonte por reconciliar
Auditor financeiro rastreou a diferença1,00 até ao subtotal anual gasto: 13.311+2.471=15.782, mas a fonte apresenta15.783; isso reduz caixa90.757 para90.756 e activos501.476 para501.475. Recomposição é diagnóstico, não correcção aplicada, porque o total anual15.783 deve ser preservado e faltam os valores internos/fórmulas de origem. Nenhuma rubrica de acerto foi criada.
Vendas14.537, custos12.538, margem1.999 e folha2.100 reconciliam entre totais mensais/anuais. A operação expressa175×15%=26,25 permite recompor despesas201,25 e resultado anual−416 preservando os anuais; a soma dos resultados mensais impressos é−413. Há ainda divergências nos recebimentos/pagamentos/fluxo, linhas de vendas/custos incompletas e rótulo duplicado “Novo Investimento Recebido”. Tudo discriminado com linhas/hash no aditamento existente de apresentacao-contexto-qa-20261115.md.
O diagnóstico inicial da fonte passou 14 testes. A conclusão de bloquear também o modelo criado pelo Codex foi revista após o proprietário exigir a sua correcção. O modelo anual editável passa a derivar recebíveis, obrigações operacionais, IVA de caixa e balanços dos mesmos dados: em 2025, obrigações 1.641,00 e capital 499.834,00 fecham activos 501.475,00; em 2027, recebíveis derivados são 771,00. Preservados os totais anuais. Não há rubrica de acerto nem financiamento confirmado inventado: os 1.825.250,00 por mobilizar são pressuposto explícito do balanço projectado, conservando disponível zero e aviso não bloqueante.
Consulta: abrir o cenário anual editável no simulador. Os três balanços e as distribuições mensais ilustrativas aparecem abaixo dos resultados. Meses usam perfil sazonal agregado, despesas fixas iguais e maiores restos em centavos; são projecções próprias, não recuperação dos meses da fonte. Montantes de IVA são editáveis; recebimentos/pagamentos inferiores ao IVA têm erro específico. Documentação detalhada e valores antes/depois no aditamento existente de apresentacao-contexto-qa-20261115.md. Referência original e histórico QA permanecem intactos e com pendências identificadas. Sem operações de base, instalação, publicação, migrações ou avanço à Etapa 2. Relatório integral continua NÃO APTO; esta correcção da Etapa 1 não constitui aceitação das onze tabelas.
@@ -519,4 +519,115 @@ Implementados e testados `checkDecisionBalance` e `calculateDecisionRatios`: som
Etapa 1 substituta: realizada nos limites autorizados, com perda exacta anterior ainda aberta. Etapa 2: inventário realizado. Etapa 3: parcial, com divergência da fonte e integração por concluir. Etapas 4–7: não declaradas concluídas; não se avançou para recolha nova, validação CAE ou conferência visual/recuperação do relatório integral enquanto a sequência financeira permanecer por fechar. O recorte de testes dirigido ao cálculo não equivale à execução completa da etapa 7.
**Classificação actual: NÃO APTO.** Há um balanço de referência por reconciliar, tabelas/recolha/integração em falta e ausência de demonstração integral dos relatórios. O QA novo e o seu backup/restauro não eliminam essas pendências nem a perda histórica anterior. Sem instalação, publicação, migrações operacionais ou alteração de fórmulas/avisos/totais aprovados. A tarefa permanece incompleta.
Salvaguarda adicional desta preparação: chave de encriptação exclusiva do QA de testes arquivada em ficheiro privado ignorado pelo Git junto do dump novo, sem valor exposto em documentação. A recusa de schema já existente foi efectivamente ensaiada e preservou um actor/dois dossiers. Foi corrigido somente o auxiliar QA para devolver código de saída não zero nas recusas, pois o tratamento global de excepções da aplicação imprimia a recusa com saída zero. O segundo ensaio confirmou a recusa e a preservação; recibo `rejected-existing-schema.log`. Nenhuma mudança no tratamento de erros do produto.
Salvaguarda adicional desta preparação: chave de encriptação exclusiva do QA de testes arquivada em ficheiro privado ignorado pelo Git junto do dump novo, sem valor exposto em documentação. A recusa de schema já existente foi efectivamente ensaiada e preservou um actor/dois dossiers. Foi corrigido somente o auxiliar QA para devolver código de saída não zero nas recusas, pois o tratamento global de excepções da aplicação imprimia a recusa com saída zero. O segundo ensaio confirmou a recusa e a preservação; recibo `rejected-existing-schema.log`. Nenhuma mudança no tratamento de erros do produto.
## 20/11/2026 — Etapa 1 exclusiva após e27b3541: diagnóstico financeiro BLOQUEADO
Origem: instrução imediata do proprietário, limitada ao balanço, fluxo de caixa, vendas e demonstração de resultados. Não foram desenvolvidas tabelas, recolhas, CAE ou outras funcionalidades. Não houve consultas/escritas em bases, instalação, publicação ou migrações nesta execução. A investigação do histórico QA não foi reaberta e não se declara recuperado.
### Fontes e limites de procura
Fonte numérica disponível: texto integral fornecido pelo proprietário em `a13e6c47-8641-452c-9660-12d94a4a65c8/Pasted text.txt`, SHA256 `93630807245726aa782825c7ee8d3b744ca413eb9500f6374ba3ce5d801d75a8`. O hash permaneceu igual após o diagnóstico. Números do código `newAnnualReferencePlan`, `calculateAnnualReferencePlan`, `checkDecisionBalance` e apresentação do exemplo confrontados com essa fonte.
Duas pesquisas por fonte de precisão adicional nas pastas de anexos, storage e Documents: a primeira devolveu sobretudo nomes de código/logs com “business”; refinada para documentos/folhas de cálculo e projectos do plano financeiro, excluindo dependências e arquivos de código. Nenhum original financeiro com valores não arredondados foi localizado nessa procura delimitada. Não se presume inexistência fora dessas pastas nem se prolongou a pesquisa depois dessas duas tentativas sem obter a fonte necessária.
### Origem aritmética de 501.475 versus 501.476
| Operação com os valores fornecidos | Resultado |
| --- | ---: |
| Caixa de abertura + total anual recebido − total anual gasto: 90.000 + 16.539 − 15.783 | 90.756 |
| Caixa + recebíveis + outros activos correntes: 90.756 + 469 + 150.000 | 241.225 |
| Activos correntes + longo prazo: 241.225 + 260.250 | **501.475** |
| Capital pago − perdas iniciais − resultado do período: 1.825.250 − 1.325.000 − 416 | 499.834 |
| Passivos + capital: 1.642 + 499.834 | **501.476** |
O ponto de divergência rastreável está no subtotal anual de saídas de caixa de 2025: operações 13.311 + imposto recebido/pago do exemplo 2.471 + restantes saídas indicadas zero = **15.782**, enquanto o subtotal apresentado é **15.783** (linhas507,510,517 da fonte). Usar apenas a soma das rubricas produziria fluxo líquido757, caixa90.757 e activos501.476, que coincidiriam com passivos+capital. **Isto é uma recomposição contrafactual de diagnóstico, não uma correcção efectuada:** substituir15.783 alteraria o total anual expressamente preservado. Nenhum valor do investimento, do exemplo aprovado ou da fonte foi substituído.
Assim, a diferença de1,00 tem um percurso aritmético demonstrado através do subtotal de saídas, caixa e activos. **A causa última desse subtotal — arredondamento de valores internos, transcrição ou parcela não visível — não é determinável pelo texto arredondado.** Não há base para corrigir contas a pagar para1.641, alterar capital ou criar uma rubrica de ajuste.
### Reconciliação mensal/anual de 2025
Diferença abaixo = soma dos valores mensais impressos menos valor anual fornecido.
| Grandeza | Anual preservado | Soma mensal impressa | Diferença |
| --- | ---: | ---: | ---: |
| Vendas totais | 14.537,00 | 14.537,00 | 0,00 |
| Custos directos totais | 12.538,00 | 12.538,00 | 0,00 |
| Margem bruta | 1.999,00 | 1.999,00 | 0,00 |
| Folha de pagamento | 2.100,00 | 2.100,00 | 0,00 |
| Encargos da folha | 315,00 | 312,00 | −3,00 |
| Despesas operacionais | 2.415,00 | 2.412,00 | −3,00 |
| Lucro líquido | −416,00 | −413,00 | +3,00 |
| Recebimentos de contas a receber | 3.165,00 | 3.167,00 | +2,00 |
| Subtotal recebido das operações | 14.068,00 | 14.069,00 | +1,00 |
| Imposto recebido do exemplo | 2.471,00 | 2.472,00 | +1,00 |
| Pagamentos de contas | 11.211,00 | 11.210,00 | −1,00 |
| Subtotal gasto em operações | 13.311,00 | 13.310,00 | −1,00 |
| Imposto pago do exemplo | 2.471,00 | 2.472,00 | +1,00 |
| Total gasto | 15.783,00 | 15.782,00 | −1,00 |
| Fluxo líquido | 756,00 | 755,00 | −1,00 |
As oito séries individuais de vendas/custos apresentadas para Publicidade, Intermediação, Commodities e Formação somam os respectivos valores anuais. Contudo, a soma das linhas anuais listadas não explica os subtotais:
| Ano | Vendas listadas / total | Diferença | Custos listados / total | Diferença |
| --- | --- | ---: | --- | ---: |
| 2025 | 10.885 / 14.537 | −3.652 | 10.295 / 12.538 | −2.243 |
| 2026 | 13.250 / 21.500 | −8.250 | 13.300 / 16.200 | −2.900 |
| 2027 | 14.525 / 23.875 | −9.350 | 14.675 / 18.325 | −3.650 |
Estas diferenças não se explicam por arredondamento de centavos. Faltam linhas ou uma versão que demonstre como os subtotais foram formados; não foi criada uma linha fictícia para a diferença. Nos meses de Janeiro/Abril/Maio/Junho/Outubro/Dezembro, as rubricas impressas do balanço também diferem entre activos e passivos+capital por −1/+1/−1/+1/+1/−1, respectivamente. Os restantes seis meses fecham pelos números apresentados.
O fluxo mensal contém duas linhas chamadas “Novo Investimento Recebido”: uma com zeros e outra cuja soma é16.538. A segunda tem comportamento de agregado, mas o rótulo não permite confirmar a sua natureza; não foi reclassificada nem apresentada como investimento mobilizado. Mesmo tratada apenas como candidata a agregado, difere do total anual recebido16.539 em−1.
### Precisão: o que é demonstrável e o que não foi recuperado
- No código do exemplo, montantes são lidos/operados como inteiros de centavos (BigInt) e devolvidos com duas casas. O balanço não aplica tolerância de0,01. A apresentação usa duas casas; quocientes de equilíbrio/rácios são aproximados apenas para apresentação. Não foi demonstrado erro de fórmula ou perda binária que explique1,00 nestes montantes do simulador.
- A fonte impressa mostra montantes mensais em unidades inteiras. A regra exacta do programa que os produziu e os valores internos não vieram no anexo. Não se afirma ter recuperado essa precisão.
- Há uma recomposição **demonstrável pela operação explicitada no exemplo**: folha175 ×15% =26,25 mensais; despesas175+26,25=201,25. A tabela mostra26 e201. Mantendo as restantes despesas, juros e impostos indicados zero, os valores em centavos produzem anuais315,00 e2.415,00 e resultado−416,00. Setembro resulta em−0,25, que a fonte apresenta como“(0)”. Isso explica a diferença de3,00 desta soma de resultados mensais impressos, **sem alterar os anuais**.
- A recomposição não prova quais eram todos os valores internos do programa de origem nem resolve a diferença1,00 da caixa. A percentagem15% foi lida somente como pressuposto deste exemplo; não foi introduzida como regra fiscal do portal.
### Alterações, testes e valores antes/depois
Acrescentados apenas um auditor de fonte financeira, um excerto de dados financeiros do anexo para regressão, testes e este registo na documentação/matriz existentes. Fórmulas do produto e dados históricos não alterados. Antes/depois efectivos: saídas15.783,00→15.783,00; caixa90.756,00→90.756,00; activos501.475,00→501.475,00; passivos+capital501.476,00→501.476,00. Diferença−1,00 permanece explícita.
Recomposição de apresentação no diagnóstico, sem escrever na fonte/plano: encargos mensais26→26,25; despesas201→201,25; soma do resultado mensal impresso−413→resultado recomposto−416. São valores calculados da operação declarada, não montantes inventados para fechar o balanço.
14 testes relevantes aprovados: seis novos de leitura monetária/sinais/normalização, percurso da diferença1,00, reconciliação de totais e linhas, recomposição de centavos, divergências de caixa/rótulo ambíguo e ausência de rubricas sem substituição por zero; oito testes existentes de integridade e referência anual reconferidos. Lint/formatação dos ficheiros verificados; execução do auditor sobre o anexo original concluída com código2, que significa **fonte bloqueada por divergências**, não erro de execução. Código1 fica reservado a erro de leitura/estrutura. `git diff --quiet e27b3541 -- app resources database routes config` confirmou ausência de alterações na aplicação. Não houve nova compilação ou suites amplas por rotina, pois não há delta funcional do produto.
Auditor: `tools/financial-reference-reconciliation.mjs`. Execução reproduzível: `node tools/financial-reference-reconciliation.mjs <texto-fonte> <destino-json-distinto-da-fonte>`. Resultado com referências às linhas e SHA em `outputs/controlled-5f7db7cd-20261120/financial-source-reconciliation.json`; testes em `reconciliation-tests.log`. O excerto versionado preserva os montantes impressos e identifica o hash da fonte; não é dado operacional nem substituto do QA perdido.
### BLOQUEADO — elementos exactamente em falta
1. Ficheiro de origem ou exportação completa com valores não arredondados, por rubrica e mês, sobretudo operações pagas, imposto pago, total das saídas, recebimentos, caixa de fecho, recebíveis, contas a pagar e capital/resultados de2025.
2. Fórmulas/regras do programa de origem: precisão interna e monetária, regra e momento do arredondamento (por célula/mês ou só na apresentação/total anual).
3. Linhas completas de vendas e custos que sustentem os subtotais anuais e mensais; identificação correcta da segunda linha “Novo Investimento Recebido”.
Sem estes elementos, não é possível escolher uma correcção documental única da fonte preservando todos os anuais. Esta limitação documental mantém-se. A conclusão inicial de bloquear também o cenário criado pelo Codex foi corrigida após a orientação seguinte do proprietário, conforme aditamento abaixo.
### Correcção do cenário criado pelo Codex — Etapa 1
O proprietário esclareceu que os dados da simulação foram criados pelo Codex e exigiu a resolução desse cenário. A pendência da fonte não justifica conservar saldos derivados incompatíveis no exemplo editável. Não se alterou o anexo, a sua cópia de teste ou dados históricos.
**Causa corrigida:** faltava derivar saldos a receber e obrigações a partir das mesmas vendas, despesas e movimentos de caixa. Usar o saldo impresso 1.642 com pagamentos anuais 15.783 conserva uma divergência de 1,00. O modelo passa a calcular, em inteiros de centavos:
- Recebíveis finais = anteriores + vendas − (recebimentos − IVA recebido).
- Obrigações operacionais finais = anteriores + custos + despesas + juros + impostos − (pagamentos − IVA pago).
- Saldo de IVA = anterior + IVA recebido − IVA pago; incluído separadamente no passivo projectado, podendo ser credor ou devedor.
- Capital projectado = recursos previstos sem empréstimos − despesas de arranque + resultados acumulados. A parcela ainda por mobilizar é identificada expressamente; financiamento disponível permanece zero e gera aviso não bloqueante.
Pressupostos limitados ao exemplo: recebíveis e obrigações iniciais zero; activos fixos/outros activos e empréstimos constantes; inexistência de movimentos de capital posteriores. IVA recebido/pago de 2.471/3.655/4.059 por ano provém do exemplo, sem inferência de taxa nem regra fiscal nova. Campos de IVA passam a ser editáveis e validados contra os totais de caixa.
| Ano | Caixa preservada | Recebíveis derivados | Obrigações operacionais derivadas | Activos | Passivos | Capital projectado | Diferença |
| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| 2025 | 90.756,00 | 469,00 | 1.641,00 | 501.475,00 | 1.641,00 | 499.834,00 | 0,00 |
| 2026 | 91.763,00 | 694,00 | 1.417,00 | 502.707,00 | 1.417,00 | 501.290,00 | 0,00 |
| 2027 | 93.498,00 | 771,00 | 1.598,00 | 504.519,00 | 1.598,00 | 502.921,00 | 0,00 |
Antes/depois do saldo secundário 2025: 1.642,00 impresso → 1.641,00 derivado; recebíveis 2027: 770,00 impresso → 771,00 derivado. Isto não é um desconto de 1,00 por conveniência: decorre das operações acima, sem rubrica de ajustamento. Preservados todos os valores anuais de vendas, custos, despesas, resultados, recebimentos, pagamentos e caixa aprovados.
A **distribuição mensal ilustrativa** é separada da fonte: usa o perfil agregado de vendas/custos de 2025, repete os pesos nos anos seguintes, reparte despesas fixas por igual e distribui recebimentos/pagamentos sem IVA proporcionalmente às vendas/despesas reconhecidas. Divisões usam maiores restos em centavos, com desempate pela ordem dos meses. Cada mês deriva caixa, recebíveis, obrigações, IVA e capital da mesma sequência. As 36 diferenças de balanço são zero; as cinco séries mensais de vendas/custos/resultado/recebimentos/pagamentos somam exactamente os respectivos anuais. Não se fabricaram actividades para completar as linhas omitidas da fonte.
O rótulo «Linhas mensais por reconciliar» continua a referir-se aos meses originais. A projecção criada não é recuperação desses meses ou do histórico QA. A interface mostra balanços e meses calculados, pressupostos e capital por mobilizar. Trata-se de demonstração local já existente, sem gravação na base ou integração nova nas onze tabelas.
**Âmbito:** correcção numérica da Etapa 1 demonstrada em testes; relatório integral continua NÃO APTO e instalação bloqueada. Não avançou a Etapa 2. A precisão interna e linhas omitidas do documento original continuam pendências documentais, sem bloquear esta correcção do modelo próprio.
**Verificação final:** 92 testes aprovados nas oito suites focadas (auditoria da fonte, integridade, cenário anual, interface do cenário, motor financeiro, edição, formulário e relatório do dossier). Incluem soma exacta dos meses, 36 balanços mensais e três anuais, edição de centavos, financiamento excedente, IVA recebido diferente do pago, rejeição de IVA superior à caixa e ausência de mutação dos dados. Tipos TypeScript e lint/formatação dos cinco ficheiros de aplicação/teste afectados aprovados. Compilação QA aprovada; persistem avisos existentes de dimensão dos chunks e dependência opcional de fontes. Conferência visual em navegador não executada nesta etapa; renderização dos componentes verificada pelos testes. Não foram executados testes de base de dados ou substituídos dados existentes. Evidências locais: outputs/controlled-5f7db7cd-20261120/reconciliation-tests.log e reconciliation-build.log.
File diff suppressed because one or more lines are too long
@@ -17,6 +17,8 @@ const annualLabels = {
taxes: 'Impostos estimados do exemplo',
cashReceived: 'Caixa recebida',
cashSpent: 'Caixa gasta',
vatReceived: 'IVA incluído nos recebimentos (montante do exemplo)',
vatPaid: 'IVA incluído nos pagamentos (montante do exemplo)',
} as const;
const openingLabels = {
openingCash: 'Caixa necessária',
@@ -95,8 +97,9 @@ export function SimulationAnnualExample({ currency }: { currency: string }) {
<p className="rounded border border-amber-400 p-3 text-sm">
Linhas mensais por reconciliar. Conservam-se os totais anuais
definidos pelo proprietário; não se distribuem valores pelos
meses nem se completam linhas em falta. Os impostos são
montantes do exemplo, sem activar taxas fiscais.
meses da fonte nem se completam as suas linhas em falta. A
projecção mensal ilustrativa abaixo é um cálculo separado. Os
impostos são montantes do exemplo, sem activar taxas fiscais.
</p>
<details open>
<summary className="font-semibold">
@@ -268,6 +271,81 @@ export function SimulationAnnualExample({ currency }: { currency: string }) {
</div>
{result.years.map((year, index) => (
<div key={year.year}>
<p>
Balanço projectado: activos{' '}
{amount(year.closingAssets)}, passivos{' '}
{amount(year.closingLiabilities)} e capital{' '}
{amount(year.closingCapital)}. Diferença:{' '}
{amount(year.balanceDifference)} {currency}.
Valores a receber: {amount(year.receivables)};
obrigações operacionais:{' '}
{amount(year.operatingLiabilities)}.
</p>
<details>
<summary>
Distribuição mensal ilustrativa —{' '}
{year.year}
</summary>
<p>
Esta simulação distribui os totais anuais
pelo perfil sazonal agregado do exemplo.
Despesas fixas são repartidas por igual;
recebimentos e pagamentos sem IVA seguem
vendas e despesas, respectivamente. Os
centavos remanescentes são distribuídos
pelas maiores fracções. Não representa
recuperação dos meses da referência.
</p>
<div className="overflow-x-auto">
<table className="w-full text-left text-sm">
<caption>
Projecção mensal ({currency})
</caption>
<thead>
<tr>
{[
'Mês',
'Vendas',
'Custos directos',
'Lucro líquido',
'Recebimentos',
'Pagamentos',
'Caixa',
'Diferença do balanço',
].map((label) => (
<th key={label}>{label}</th>
))}
</tr>
</thead>
<tbody>
{year.illustrativeMonths.map(
(month) => (
<tr key={month.month}>
<th>{month.month}</th>
{(
[
'sales',
'directCosts',
'netProfit',
'cashReceived',
'cashSpent',
'closingCash',
'balanceDifference',
] as const
).map((key) => (
<td key={key}>
{amount(
month[key],
)}
</td>
))}
</tr>
),
)}
</tbody>
</table>
</div>
</details>
<h5 className="font-semibold">
Avisos — {year.year}
</h5>
@@ -296,6 +374,17 @@ export function SimulationAnnualExample({ currency }: { currency: string }) {
/>
</div>
))}
<p className="text-sm">
O balanço pressupõe mobilizar{' '}
{amount(result.capitalToMobilise)} {currency} de capital
ainda em falta. Não é financiamento confirmado. Os
saldos iniciais a receber e de obrigações operacionais
são zero neste cenário; activos e empréstimos mantêm-se
constantes. As obrigações incluem custos, despesas,
juros e impostos reconhecidos e ainda não pagos. Os
montantes de IVA são dados do exemplo, sem inferência de
taxas fiscais.
</p>
<p className="text-sm">
Margem bruta = vendas − custo directo. Lucro líquido =
margem bruta − despesas operacionais − juros − impostos.
+181 -1
View File
@@ -131,6 +131,8 @@ export type AnnualReferencePlan = {
taxes: string;
cashReceived: string;
cashSpent: string;
vatReceived: string;
vatPaid: string;
}[];
};
@@ -164,6 +166,8 @@ export function newAnnualReferencePlan(): AnnualReferencePlan {
taxes: '0',
cashReceived: '16539',
cashSpent: '15783',
vatReceived: '2471',
vatPaid: '2471',
},
{
year: 2026,
@@ -176,6 +180,8 @@ export function newAnnualReferencePlan(): AnnualReferencePlan {
taxes: '624',
cashReceived: '24930',
cashSpent: '23923',
vatReceived: '3655',
vatPaid: '3655',
},
{
year: 2027,
@@ -188,6 +194,8 @@ export function newAnnualReferencePlan(): AnnualReferencePlan {
taxes: '699',
cashReceived: '27857',
cashSpent: '26122',
vatReceived: '4059',
vatPaid: '4059',
},
],
};
@@ -296,6 +304,31 @@ export function calculateDecisionRatios(
};
}
/** Illustrative allocation, in cents; never a reconstruction of historical months. */
function allocateMonths(total: bigint, weights: bigint[]) {
const denominator = weights.reduce((sum, value) => sum + value, 0n);
const effective = denominator === 0n ? weights.map(() => 1n) : weights;
const divisor = denominator === 0n ? BigInt(weights.length) : denominator;
const rows = effective.map((weight, index) => ({
index,
amount: (total * weight) / divisor,
remainder: (total * weight) % divisor,
}));
let remaining = total - rows.reduce((sum, row) => sum + row.amount, 0n);
for (const row of [...rows].sort((a, b) =>
a.remainder === b.remainder
? a.index - b.index
: a.remainder > b.remainder
? -1
: 1,
)) {
if (remaining === 0n) break;
row.amount += 1n;
remaining -= 1n;
}
return rows.map((row) => row.amount);
}
export function calculateAnnualReferencePlan(plan: AnnualReferencePlan) {
const startupExpenses = plan.startupExpenses.reduce(
(sum, row) => sum + money(row.amount),
@@ -312,7 +345,19 @@ export function calculateAnnualReferencePlan(plan: AnnualReferencePlan) {
money(plan.investorCapital) +
money(plan.loans) +
money(plan.additionalMoney);
let cash = openingCash;
// A projection of the required capital is not confirmation of financing.
const capitalToMobilise =
requiredFunding > availableFunding
? requiredFunding - availableFunding
: 0n;
const projectedCapital =
availableFunding + capitalToMobilise - money(plan.loans);
let cash =
openingCash + availableFunding + capitalToMobilise - requiredFunding;
let receivables = 0n;
let operatingLiabilities = 0n;
let vatBalance = 0n;
let accumulatedResults = -startupExpenses;
const years = plan.years.map((year, index) => {
const sales = money(year.sales),
costs = money(year.directCosts);
@@ -333,7 +378,131 @@ export function calculateAnnualReferencePlan(plan: AnnualReferencePlan) {
const netProfit =
operatingProfit - money(year.interest) - money(year.taxes);
const cashFlow = money(year.cashReceived) - money(year.cashSpent);
const openingYearCash = cash;
const openingReceivables = receivables;
const openingLiabilities = operatingLiabilities;
const openingResults = accumulatedResults;
const openingVatBalance = vatBalance;
const vatReceived = money(year.vatReceived);
const vatPaid = money(year.vatPaid);
if (
vatReceived > money(year.cashReceived) ||
vatPaid > money(year.cashSpent)
)
throw new Error(
'O IVA de caixa não pode exceder os respectivos recebimentos ou pagamentos.',
);
receivables += sales - (money(year.cashReceived) - vatReceived);
operatingLiabilities +=
costs +
operatingExpenses +
money(year.interest) +
money(year.taxes) -
(money(year.cashSpent) - vatPaid);
accumulatedResults += netProfit;
vatBalance += vatReceived - vatPaid;
cash += cashFlow;
const closingAssets =
cash +
receivables +
money(plan.otherCurrentAssets) +
money(plan.longTermAssets);
const closingCapital = projectedCapital + accumulatedResults;
const closingLiabilities =
operatingLiabilities + money(plan.loans) + vatBalance;
// Explicit model assumptions: repeat the example's aggregate seasonal
// profile; allocate cash net of VAT proportionally to accrued amounts.
const salesWeights = [
680n,
748n,
824n,
905n,
990n,
1095n,
1203n,
1324n,
1458n,
1604n,
1765n,
1941n,
];
const costWeights = [
586n,
644n,
710n,
781n,
860n,
945n,
1038n,
1142n,
1257n,
1383n,
1520n,
1672n,
];
const monthlySales = allocateMonths(sales, salesWeights);
const monthlyCosts = allocateMonths(costs, costWeights);
const equalWeights = salesWeights.map(() => 1n);
const monthlyExpenses = [
year.payroll,
year.payrollCharges,
year.otherOperatingExpenses,
year.interest,
year.taxes,
].map((value) => allocateMonths(money(value), equalWeights));
const accrued = monthlyCosts.map(
(value, i) =>
value + monthlyExpenses.reduce((sum, row) => sum + row[i], 0n),
);
const receipts = allocateMonths(
money(year.cashReceived) - vatReceived,
monthlySales,
);
const payments = allocateMonths(
money(year.cashSpent) - vatPaid,
accrued,
);
const vatReceipts = allocateMonths(vatReceived, salesWeights);
const vatPayments = allocateMonths(vatPaid, salesWeights);
let monthCash = openingYearCash,
monthReceivables = openingReceivables,
monthLiabilities = openingLiabilities,
monthResults = openingResults;
let monthVatBalance = openingVatBalance;
const illustrativeMonths = monthlySales.map((revenue, i) => {
const profit = revenue - accrued[i];
const received = receipts[i] + vatReceipts[i];
const spent = payments[i] + vatPayments[i];
monthCash += received - spent;
monthReceivables += revenue - receipts[i];
monthLiabilities += accrued[i] - payments[i];
monthResults += profit;
monthVatBalance += vatReceipts[i] - vatPayments[i];
const monthAssets =
monthCash +
monthReceivables +
money(plan.otherCurrentAssets) +
money(plan.longTermAssets);
return {
month: i + 1,
sales: decimal(revenue),
directCosts: decimal(monthlyCosts[i]),
netProfit: decimal(profit),
cashReceived: decimal(received),
cashSpent: decimal(spent),
closingCash: decimal(monthCash),
receivables: decimal(monthReceivables),
operatingLiabilities: decimal(monthLiabilities),
balanceDifference: decimal(
monthAssets -
monthLiabilities -
monthVatBalance -
money(plan.loans) -
projectedCapital -
monthResults,
),
};
});
// Keep the unrounded gross-margin fraction in the break-even formula.
const monthlyBreakEven =
grossMargin > 0n
@@ -360,6 +529,16 @@ export function calculateAnnualReferencePlan(plan: AnnualReferencePlan) {
sales > 0n ? (Number(netProfit) / Number(sales)) * 100 : null,
cashFlow: decimal(cashFlow),
closingCash: decimal(cash),
receivables: decimal(receivables),
operatingLiabilities: decimal(operatingLiabilities),
closingAssets: decimal(closingAssets),
closingCapital: decimal(closingCapital),
closingLiabilities: decimal(closingLiabilities),
vatBalance: decimal(vatBalance),
balanceDifference: decimal(
closingAssets - closingLiabilities - closingCapital,
),
illustrativeMonths,
monthlyFixedCosts: Number(operatingExpenses) / 1200,
monthlyBreakEven,
growthPercent,
@@ -370,6 +549,7 @@ export function calculateAnnualReferencePlan(plan: AnnualReferencePlan) {
assets: decimal(assets),
requiredFunding: decimal(requiredFunding),
availableFunding: decimal(availableFunding),
capitalToMobilise: decimal(capitalToMobilise),
fundingGap: decimal(
requiredFunding > availableFunding
? requiredFunding - availableFunding
@@ -126,6 +126,10 @@ void test('annual example renders expected results and source gaps without block
/As vendas mensais médias não atingem o ponto de equilíbrio/,
);
assert.match(html, /não se distribuem valores pelos meses/);
assert.match(html, /Balanço projectado/);
assert.match(html, /Distribuição mensal ilustrativa/);
assert.match(html, /Não é financiamento confirmado/);
assert.equal((html.match(/Projecção mensal/g) ?? []).length, 3);
assert.doesNotMatch(html, /role="alert"|aria-invalid="true"|disabled=/);
assert.match(html.replace(/[\s\u00a0\u202f]/g, ''), /1325000[.,]00/);
});
+76 -1
View File
@@ -61,7 +61,11 @@ void test('insufficient funding and growth above 100 percent remain valid, saved
assert.equal(restored.annualGrowthPercent, '250');
const result = forecastBusinessPlan(restored);
assert.equal(result.fundingGap, '200.00');
assert.equal(result.totalRevenue, '12000.00', 'a growth target must not overwrite declared sales');
assert.equal(
result.totalRevenue,
'12000.00',
'a growth target must not overwrite declared sales',
);
assert.equal(
validateSimulationDraft(
{ business_plan_snapshot: snapshot },
@@ -115,6 +119,50 @@ void test('owner annual reference reconciles exact startup, margins, profits, ca
assert.equal(result.years[2].closingCash, '93498.00');
assert.equal(result.monthlyStatus, 'por reconciliar');
assert.equal('monthlyRows' in result, false);
assert.deepEqual(
result.years.map((year) => year.operatingLiabilities),
['1641.00', '1417.00', '1598.00'],
);
assert.deepEqual(
result.years.map((year) => year.receivables),
['469.00', '694.00', '771.00'],
);
assert.deepEqual(
result.years.map((year) => year.closingAssets),
['501475.00', '502707.00', '504519.00'],
);
assert.equal(result.capitalToMobilise, '1825250.00');
const cents = (value) => BigInt(value.replace('.', ''));
for (const [index, year] of result.years.entries()) {
assert.equal(year.balanceDifference, '0.00');
assert.equal(year.illustrativeMonths.length, 12);
for (const key of [
'sales',
'directCosts',
'netProfit',
'cashReceived',
'cashSpent',
]) {
const expected =
key === 'netProfit' ? year[key] : source.years[index][key];
assert.equal(
year.illustrativeMonths.reduce(
(sum, row) => sum + cents(row[key]),
0n,
),
cents(Number(expected).toFixed(2)),
);
}
for (const month of year.illustrativeMonths)
assert.equal(month.balanceDifference, '0.00');
const last = year.illustrativeMonths.at(-1);
for (const key of [
'closingCash',
'receivables',
'operatingLiabilities',
])
assert.equal(last[key], year[key]);
}
const warnings = businessPlanWarnings({
fundingGap: Number(result.fundingGap),
netProfit: Number(first.netProfit),
@@ -127,6 +175,33 @@ void test('owner annual reference reconciles exact startup, margins, profits, ca
assert.equal(JSON.stringify(source), before);
});
void test('derived ledger reconciles edited cents and surplus funding without altering annual inputs', () => {
const plan = newAnnualReferencePlan();
plan.ownerCapital = '2000000.01';
plan.years[0].sales = '14537.01';
plan.years[0].cashSpent = '15783.01';
plan.years[0].payrollCharges = '315.01';
plan.years[0].vatPaid = '2470.99';
const before = JSON.stringify(plan);
const result = calculateAnnualReferencePlan(plan);
assert.equal(result.capitalToMobilise, '0.00');
assert.equal(result.years[0].closingCash, '265506.00');
assert.equal(result.years[0].receivables, '469.01');
assert.equal(result.years[0].vatBalance, '0.01');
for (const year of result.years) {
assert.equal(year.balanceDifference, '0.00');
for (const month of year.illustrativeMonths)
assert.equal(month.balanceDifference, '0.00');
assert.equal(
year.illustrativeMonths.at(-1).closingCash,
year.closingCash,
);
}
assert.equal(JSON.stringify(plan), before);
plan.years[0].vatReceived = '16539.01';
assert.throws(() => calculateAnnualReferencePlan(plan), /IVA/);
});
void test('reference edits update dependent totals and preserve data when an input is invalid', () => {
const source = newAnnualReferencePlan();
source.startupExpenses[0].amount = '25000.25';
@@ -0,0 +1,124 @@
import assert from 'node:assert/strict';
import fs from 'node:fs';
import test from 'node:test';
import {
printedCents,
reconcileFinancialReference,
} from '../../tools/financial-reference-reconciliation.mjs';
import { newAnnualReferencePlan } from '../../resources/js/lib/business-plan-guidance.ts';
const source = fs.readFileSync(
new URL('./fixtures/financial-reference-2025.txt', import.meta.url),
'utf8',
);
const report = reconcileFinancialReference(source);
const item = (id) => {
const record = report.checks.find((check) => check.id === id);
assert.ok(record, id);
return record;
};
void test('printed amounts retain thousands, decimal cents and parentheses without floating-point rounding', () => {
assert.equal(printedCents('1.234,56'), 123456n);
assert.equal(printedCents('(416)'), -41600n);
assert.equal(printedCents('0,01'), 1n);
assert.equal(printedCents('501.475'), 50147500n);
for (const invalid of ['', '1,234', '1.00', 'unknown', '17%'])
assert.throws(() => printedCents(invalid));
});
void test('the one-unit imbalance is traced through the printed cash-spending subtotal without changing annual data', () => {
const approvedBefore = JSON.stringify(newAnnualReferencePlan());
assert.deepEqual(report.oneUnitTrace, {
approvedCashSpent: '15783.00',
componentCashSpent: '15782.00',
approvedClosingCash: '90756.00',
componentOnlyClosingCash: '90757.00',
approvedAssets: '501475.00',
componentOnlyAssets: '501476.00',
liabilitiesAndCapital: '501476.00',
componentOnlyIsDiagnosticNotCorrection: true,
});
assert.equal(item('cash.2025_spending_components').difference, '-1.00');
assert.equal(
item('balance.2025_assets_vs_liabilities_capital').difference,
'-1.00',
);
assert.equal(report.annualTotalsChanged, false);
assert.equal(report.applicationFormulasChanged, false);
assert.equal(JSON.stringify(newAnnualReferencePlan()), approvedBefore);
});
void test('sales, direct costs, gross margin and payroll reconcile at total level but listed revenue and cost lines are incomplete', () => {
for (const id of [
'sales.months_to_2025',
'direct_costs.months_to_2025',
'gross_margin.months_to_2025',
'payroll.months_to_2025',
])
assert.equal(item(id).matches, true);
assert.equal(item('sales.listed_lines.2025').difference, '-3652.00');
assert.equal(item('costs.listed_lines.2025').difference, '-2243.00');
assert.equal(item('sales.listed_lines.2026').difference, '-8250.00');
assert.equal(item('sales.listed_lines.2027').difference, '-9350.00');
for (const record of report.checks.filter(
(check) =>
check.id.startsWith('sales.line.') ||
check.id.startsWith('costs.line.'),
))
assert.equal(record.matches, true);
});
void test('the stated reference rate reconstructs cent precision and preserves annual payroll charges and profit', () => {
const precise = report.payrollRecomposition;
assert.equal(precise.rate, '15%');
assert.deepEqual(precise.monthlyCharges, Array(12).fill('26.25'));
assert.deepEqual(precise.monthlyOperating, Array(12).fill('201.25'));
assert.equal(precise.monthlyNetProfit[8], '-0.25');
assert.equal(precise.chargesAnnualCheck.calculated, '315.00');
assert.equal(precise.operatingAnnualCheck.calculated, '2415.00');
assert.equal(precise.profitAnnualCheck.calculated, '-416.00');
assert.ok(
precise.chargesAnnualCheck.matches &&
precise.operatingAnnualCheck.matches &&
precise.profitAnnualCheck.matches,
);
assert.equal(precise.scope, 'reference_arithmetic_only_not_a_fiscal_rule');
assert.equal(
item('net_profit.printed_months_to_2025').calculated,
'-413.00',
);
});
void test('cash discrepancies and ambiguous duplicate labels remain explicit rather than being reclassified as investment', () => {
assert.equal(
item('cash.Caixa proveniente de contas a receber').difference,
'2.00',
);
assert.equal(item('cash.Subtotal de Dinheiro Gasto').difference, '-1.00');
assert.equal(item('cash.Fluxo de Caixa Líquido').calculated, '755.00');
assert.equal(report.balanceMonths.at(-1).componentDifference, '-1.00');
assert.deepEqual(
report.ambiguousCashLabel.map((row) => row.sum),
['0.00', '16538.00'],
);
assert.equal(report.status, 'BLOCKED_SOURCE_PRECISION_OR_COMPLETENESS');
assert.equal(report.missing.length, 4);
});
void test('normalised labels preserve the same numerical conclusions and missing source rows do not become zeros', () => {
assert.deepEqual(
reconcileFinancialReference(source.normalize('NFD')).checks,
report.checks,
);
assert.throws(
() =>
reconcileFinancialReference(
source.replaceAll(
'Caixa proveniente de contas a receber',
'Rubrica retirada',
),
),
/Rubrica em falta/,
);
});
@@ -0,0 +1,173 @@
# Extract of user-supplied financial reference; no operational data.
# NFC labels; original printed amounts preserved. No unrounded amounts available.
# Original SHA256: 93630807245726aa782825c7ee8d3b744ca413eb9500f6374ba3ce5d801d75a8
Tabela: Previsão de Vendas
Vendas 2025 2026 2027
Publicidade 2.137 3.000 3.500
Intermediação Comercial 5.336 6.000 6.500
Comercialização de Commodities 3.211 4.000 4.250
Formação 201 250 275
Vendas Totais 14.537 21.500 23.875
Custo Direto das Vendas 2025 2026 2027
Publicidade 1.595 2.500 3.000
Intermediação Comercial 4.273 5.500 6.000
Comercialização de Commodities 3.211 3.750 4.000
Formação 139 450 475
Marketing 1.077 1.100 1.200
Subtotal Direct Cost of Sales 12.538 16.200 18.325
Tabela: Previsão de Vendas
Publicidade 100 110 121 133 140 161 177 195 215 237 261 287
Intermediação Comercial 250 275 302 332 365 402 442 486 535 588 647 712
Comercialização de Commodities 150 165 182 200 220 242 266 293 322 354 389 428
Formação 10 11 12 13 14 15 16 18 20 22 24 26
Vendas Totais 680 748 824 905 990 1.095 1.203 1.324 1.458 1.604 1.765 1.941
Publicidade 75 82 90 99 109 120 132 145 160 176 194 213
Intermediação Comercial 200 220 242 266 293 322 354 389 428 471 518 570
Comercialização de Commodities 150 165 182 200 220 242 266 293 322 354 389 428
Formação 6 7 8 9 10 11 12 13 14 15 16 18
Subtotal Custo Direto das Vendas 586 644 710 781 860 945 1.038 1.142 1.257 1.383 1.520 1.672
Tabela: Lucros e Perdas
2025 2026 2027
Vendas 14.537 21.500 23.875
Custo Direto das Vendas 12.538 16.200 18.325
Outros custos de vendas 0 0 0
Custo Total das Vendas 12.538 16.200 18.325
Margem bruta 1.999 5.300 5.550
Folha de pagamento 2.100 2.800 2.800
Marketing/Promoção 0 0 0
Depreciação 0 0 0
Rendas 0 0 0
Utilidades 0 0 0
Seguros 0 0 0
Impostos sobre Folhas de Pagamento 315 420 420
Outros 0 0 0
Despesas Operacionais Totais 2.415 3.220 3.220
Lucro antes de juros e impostos (416) 2.080 2.330
EBITDA (416) 2.080 2.330
Despesa com juros 0 0 0
Impostos Incorridos 0 624 699
Lucro Líquido (416) 1.456 1.631
Tabela: Lucros e Perdas
Vendas 680 748 824 905 990 1.095 1.203 1.324 1.458 1.604 1.765 1.941
Custo Direto das Vendas 586 644 710 781 860 945 1.038 1.142 1.257 1.383 1.520 1.672
Outros custos de vendas 0 0 0 0 0 0 0 0 0 0 0 0
Custo Total das Vendas 586 644 710 781 860 945 1.038 1.142 1.257 1.383 1.520 1.672
Margem bruta 94 104 114 124 130 150 165 182 201 221 245 269
Folha de pagamento 175 175 175 175 175 175 175 175 175 175 175 175
Marketing/Promoção 0 0 0 0 0 0 0 0 0 0 0 0
Depreciação 0 0 0 0 0 0 0 0 0 0 0 0
Aluguer 0 0 0 0 0 0 0 0 0 0 0 0
Serviços públicos 0 0 0 0 0 0 0 0 0 0 0 0
Seguros 0 0 0 0 0 0 0 0 0 0 0 0
Impostos sobre Folhas de Pagamento 15% 26 26 26 26 26 26 26 26 26 26 26 26
Outros 0 0 0 0 0 0 0 0 0 0 0 0
Despesas Operacionais Totais 201 201 201 201 201 201 201 201 201 201 201 201
Lucro antes de juros e impostos (107) (97) (87) (77) (71) (51) (36) (19) (0) 20 44 68
EBITDA (107) (97) (87) (77) (71) (51) (36) (19) (0) 20 44 68
Despesa com juros 0 0 0 0 0 0 0 0 0 0 0 0
Impostos Incorridos 0 0 0 0 0 0 0 0 0 0 0 0
Lucro Líquido (107) (97) (87) (77) (71) (51) (36) (19) (0) 20 44 68
Tabela: Fluxo de Caixa
2025 2026 2027
Vendas em Dinheiro 10.903 16.125 17.906
Caixa proveniente de contas a receber 3.165 5.150 5.892
Subtotal de Caixa Proveniente das Operações 14.068 21.275 23.798
Imposto sobre vendas, IVA, HST/GST recebidos 2.471 3.655 4.059
Novo Endividamento Corrente 0 0 0
Novos Outros Passivos (sem juros) 0 0 0
Novos Passivos de Longo Prazo 0 0 0
Vendas de Outros Activos Correntes 0 0 0
Vendas de Activos de Longo Prazo 0 0 0
Novo Investimento Recebido 0 0 0
Subtotal de Dinheiro Recebido 16.539 24.930 27.857
Despesas 2025 2026 2027
Gastos em Dinheiro 2.100 2.800 2.800
Pagamentos de Contas 11.211 17.468 19.263
Subtotal gasto em operações 13.311 20.268 22.063
Imposto sobre vendas, IVA, HST/GST pagos 2.471 3.655 4.059
Reembolso do principal de empréstimos correntes 0 0 0
Reembolso do principal de outros passivos 0 0 0
Reembolso do principal de passivos de longo prazo 0 0 0
Comprar Outros Activos Correntes 0 0 0
Comprar Activos de longo prazo 0 0 0
Dividends 0 0 0
Subtotal de Dinheiro Gasto 15.783 23.923 26.122
Fluxo de Caixa Líquido 756 1.007 1.735
Cash Balance 90.756 91.763 93.498
Tabela: Fluxo de Caixa
Vendas em Dinheiro 510 561 618 679 742 821 902 993 1.094 1.203 1.324 1.456
Caixa proveniente de contas a receber 6 171 188 207 227 248 275 302 332 366 402 443
Subtotal de Caixa Proveniente das Operações 516 732 806 885 969 1.070 1.177 1.295 1.426 1.569 1.726 1.898
Imposto sobre vendas, IVA, HST/GST recebidos 17,00% 116 127 140 154 168 186 205 225 248 273 300 330
Novo Endividamento Corrente 0 0 0 0 0 0 0 0 0 0 0 0
Novos Outros Passivos (sem juros) 0 0 0 0 0 0 0 0 0 0 0 0
Novos Passivos de Longo Prazo 0 0 0 0 0 0 0 0 0 0 0 0
Vendas de Outros Activos Correntes 0 0 0 0 0 0 0 0 0 0 0 0
Vendas de Activos de Longo Prazo 0 0 0 0 0 0 0 0 0 0 0 0
Novo Investimento Recebido 0 0 0 0 0 0 0 0 0 0 0 0
Novo Investimento Recebido 631 859 946 1.039 1.138 1.256 1.381 1.520 1.673 1.841 2.026 2.228
Despesas provenientes das Operações 175 175 175 175 175 175 175 175 175 175 175 175
Pagamentos de Contas 20 614 672 739 810 889 974 1.068 1.172 1.287 1.414 1.551
Subtotal gasto em operações 195 789 847 914 985 1.064 1.149 1.243 1.347 1.462 1.589 1.726
Imposto sobre vendas, IVA, HST/GST pagos 116 127 140 154 168 186 205 225 248 273 300 330
Reembolso do principal do empréstimo corrente 0 0 0 0 0 0 0 0 0 0 0 0
Outros passivos Reembolso do principal 0 0 0 0 0 0 0 0 0 0 0 0
Reembolso de Principal de Passivos a Longo Prazo 0 0 0 0 0 0 0 0 0 0 0 0
Reembolso de Principal de Passivos a Longo Prazo 0 0 0 0 0 0 0 0 0 0 0 0
Comprar Activos de longo prazo 0 0 0 0 0 0 0 0 0 0 0 0
Dividendos 0 0 0 0 0 0 0 0 0 0 0 0
Subtotal de Dinheiro Gasto 311 916 988 1.067 1.153 1.250 1.354 1.468 1.595 1.735 1.889 2.056
Fluxo de Caixa Líquido 320 (58) (42) (28) (16) 5 28 52 79 106 137 172
Saldo de Caixa 90.320 90.263 90.221 90.193 90.177 90.183 90.210 90.262 90.341 90.447 90.584 90.756
Tabela: Balanço
Ativos 2025 2026 2027
Dinheiro 90.756 91.763 93.498
Contas a receber 469 694 770
Outros ativos correntes 150.000 150.000 150.000
Total de ativos correntes 241.225 242.457 244.269
Ativos de Longo Prazo 260.250 260.250 260.250
Depreciação acumulada 0 0 0
Total de Activos a Longo Prazo 260.250 260.250 260.250
Total de Activos 501.475 502.707 504.519
Passivos e Capital 2025 2026 2027
Contas a pagar 1.642 1.417 1.598
Empréstimos Correntes 0 0 0
Outros passivos correntes 0 0 0
Subtotais Passivos Correntes 1.642 1.417 1.598
Passivos de Longo Prazo 0 0 0
Total de Passivos 1.642 1.417 1.598
Capital pago 1.825.250 1.825.250 1.825.250
Lucros Retidos (1.325.000) (1.325.416) (1.323.960)
Rendimentos (416) 1.456 1.631
Total Capital 499.834 501.290 502.921
Total de Passivos e Capital 501.475 502.707 504.519
Património Líquido 499.834 501.290 502.921
Tabela: Balanço
Dinheiro 90.000 90.320 90.263 90.221 90.193 90.177 90.183 90.210 90.262 90.341 90.447 90.584 90.756
Contas a receber 0 164 181 199 219 239 265 291 320 352 388 427 469
Outros Activos correntes 150.000 150.000 150.000 150.000 150.000 150.000 150.000 150.000 150.000 150.000 150.000 150.000 150.000
Total de activos correntes 240.000 240.485 240.443 240.420 240.411 240.416 240.447 240.501 240.582 240.693 240.835 241.011 241.225
Activos de Longo Prazo 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250
Activos de Longo Prazo 0 0 0 0 0 0 0 0 0 0 0 0 0
Total de Activos a Longo Prazo 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250 260.250
Total de Activos 500.250 500.735 500.693 500.670 500.661 500.666 500.697 500.751 500.832 500.943 501.085 501.261 501.475
Contas a pagar 0 592 648 712 780 857 939 1.029 1.129 1.240 1.362 1.495 1.642
Empréstimos Correntes 0 0 0 0 0 0 0 0 0 0 0 0 0
Outros passivos correntes 0 0 0 0 0 0 0 0 0 0 0 0 0
Subtotais Passivos Correntes 0 592 648 712 780 857 939 1.029 1.129 1.240 1.362 1.495 1.642
Passivos de Longo Prazo 0 0 0 0 0 0 0 0 0 0 0 0 0
Total de Passivos 0 592 648 712 780 857 939 1.029 1.129 1.240 1.362 1.495 1.642
Capital pago 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250 1.825.250
Lucros Retidos (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000) (1.325.000)
Rendimentos 0 (107) (205) (292) (369) (440) (492) (528) (547) (547) (528) (484) (416)
Total Capital 500.250 500.143 500.046 499.958 499.881 499.810 499.758 499.722 499.703 499.703 499.722 499.766 499.834
Total de Passivos e Capital Próprio 500.250 500.735 500.693 500.670 500.661 500.666 500.697 500.751 500.832 500.943 501.085 501.261 501.475
Património Líquido 500.250 500.143 500.046 499.958 499.881 499.810 499.758 499.722 499.703 499.703 499.722 499.766 499.834
@@ -0,0 +1,163 @@
import fs from 'node:fs';
import { createHash } from 'node:crypto';
import { resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
/** Printed Portuguese monetary values, not JavaScript floating-point inputs. */
export function printedCents(value) {
const text = value.trim();
if (!/^(?:-?\d+(?:\.\d{3})*(?:,\d{1,2})?|\(\d+(?:\.\d{3})*(?:,\d{1,2})?\))$/.test(text))
throw new Error(`Montante impresso não reconhecido: ${text}`);
const negative = text.startsWith('(') || text.startsWith('-');
const [whole, fraction = ''] = text.replace(/[().-]/g, '').split(',');
const amount = BigInt(whole) * 100n + BigInt(fraction.padEnd(2, '0'));
return negative ? -amount : amount;
}
const decimal = value => `${value < 0n ? '-' : ''}${(value < 0n ? -value : value) / 100n}.${String((value < 0n ? -value : value) % 100n).padStart(2, '0')}`;
const sum = values => values.reduce((total, value) => total + value, 0n);
export function financialTable(text, title, occurrence, width) {
const lines = text.normalize('NFC').split(/\r?\n/);
const starts = lines.flatMap((line, index) => line.trim() === title ? [index] : []);
const start = occurrence === 'last' ? starts.at(-1) : starts[occurrence];
if (start === undefined) throw new Error(`Tabela em falta: ${title}`);
let end = lines.findIndex((line, index) => index > start && (line.trim().startsWith('Tabela:') || /^\d+\.\d+\s/.test(line.trim())));
if (end < 0) end = lines.length;
const rows = [];
for (let index = start + 1; index < end; index++) {
const cells = lines[index].split('\t').map(cell => cell.trim());
const numbers = cells.slice(1).filter(cell => /^\(?-?\d[\d.,]*\)?$/.test(cell));
if (numbers.length >= width) rows.push({ label: cells[0], line: index + 1, values: numbers.slice(-width).map(printedCents), printed: numbers.slice(-width), rates: cells.slice(1).filter(cell => cell.endsWith('%')) });
}
return rows;
}
function row(table, label, occurrence = 0) {
const record = table.filter(entry => entry.label === label)[occurrence];
if (!record) throw new Error(`Rubrica em falta: ${label}`);
return record;
}
function check(id, reported, calculated, references) {
return { id, reported: decimal(reported), calculated: decimal(calculated), difference: decimal(calculated - reported), matches: calculated === reported, references };
}
export function financialReferenceTables(text) {
return [
{ key: 'annualSales', title: 'Tabela: Previsão de Vendas', occurrence: 0, width: 3 },
{ key: 'monthlySales', title: 'Tabela: Previsão de Vendas', occurrence: 'last', width: 12 },
{ key: 'annualProfit', title: 'Tabela: Lucros e Perdas', occurrence: 0, width: 3 },
{ key: 'monthlyProfit', title: 'Tabela: Lucros e Perdas', occurrence: 'last', width: 12 },
{ key: 'annualCash', title: 'Tabela: Fluxo de Caixa', occurrence: 0, width: 3 },
{ key: 'monthlyCash', title: 'Tabela: Fluxo de Caixa', occurrence: 'last', width: 12 },
{ key: 'annualBalance', title: 'Tabela: Balanço', occurrence: 0, width: 3 },
{ key: 'monthlyBalance', title: 'Tabela: Balanço', occurrence: 'last', width: 13 },
].map(specification => ({ ...specification, rows: financialTable(text, specification.title, specification.occurrence, specification.width) }));
}
export function reconcileFinancialReference(text) {
const { annualSales, monthlySales, annualProfit, monthlyProfit, annualCash, monthlyCash, annualBalance, monthlyBalance } = Object.fromEntries(financialReferenceTables(text).map(table => [table.key, table.rows]));
const checks = [];
const compare = (id, annualTable, annualLabel, monthlyTable, monthlyLabel, occurrence = 0) => {
const annual = row(annualTable, annualLabel), monthly = row(monthlyTable, monthlyLabel, occurrence);
checks.push(check(id, annual.values[0], sum(monthly.values), [annual.line, monthly.line]));
};
compare('sales.months_to_2025', annualProfit, 'Vendas', monthlyProfit, 'Vendas');
compare('direct_costs.months_to_2025', annualProfit, 'Custo Direto das Vendas', monthlyProfit, 'Custo Direto das Vendas');
compare('gross_margin.months_to_2025', annualProfit, 'Margem bruta', monthlyProfit, 'Margem bruta');
compare('payroll.months_to_2025', annualProfit, 'Folha de pagamento', monthlyProfit, 'Folha de pagamento');
compare('payroll_charges.printed_months_to_2025', annualProfit, 'Impostos sobre Folhas de Pagamento', monthlyProfit, 'Impostos sobre Folhas de Pagamento');
compare('operating_expenses.printed_months_to_2025', annualProfit, 'Despesas Operacionais Totais', monthlyProfit, 'Despesas Operacionais Totais');
compare('net_profit.printed_months_to_2025', annualProfit, 'Lucro Líquido', monthlyProfit, 'Lucro Líquido');
for (const [annualLabel, monthlyLabel] of [
['Vendas em Dinheiro', 'Vendas em Dinheiro'],
['Caixa proveniente de contas a receber', 'Caixa proveniente de contas a receber'],
['Subtotal de Caixa Proveniente das Operações', 'Subtotal de Caixa Proveniente das Operações'],
['Imposto sobre vendas, IVA, HST/GST recebidos', 'Imposto sobre vendas, IVA, HST/GST recebidos'],
['Pagamentos de Contas', 'Pagamentos de Contas'],
['Subtotal gasto em operações', 'Subtotal gasto em operações'],
['Imposto sobre vendas, IVA, HST/GST pagos', 'Imposto sobre vendas, IVA, HST/GST pagos'],
['Subtotal de Dinheiro Gasto', 'Subtotal de Dinheiro Gasto'],
['Fluxo de Caixa Líquido', 'Fluxo de Caixa Líquido'],
]) compare(`cash.${annualLabel}`, annualCash, annualLabel, monthlyCash, monthlyLabel);
const labels = ['Publicidade', 'Intermediação Comercial', 'Comercialização de Commodities', 'Formação'];
const totals = row(annualSales, 'Vendas Totais');
const directTotals = row(annualSales, 'Subtotal Direct Cost of Sales');
for (let year = 0; year < 3; year++) {
checks.push(check(`sales.listed_lines.${2025 + year}`, totals.values[year], sum(labels.map(label => row(annualSales, label).values[year])), [totals.line, ...labels.map(label => row(annualSales, label).line)]));
const costRows = labels.map(label => row(annualSales, label, 1)).concat(row(annualSales, 'Marketing'));
checks.push(check(`costs.listed_lines.${2025 + year}`, directTotals.values[year], sum(costRows.map(entry => entry.values[year])), [directTotals.line, ...costRows.map(entry => entry.line)]));
}
for (const label of labels) {
compare(`sales.line.${label}`, annualSales, label, monthlySales, label);
const annual = row(annualSales, label, 1), monthly = row(monthlySales, label, 1);
checks.push(check(`costs.line.${label}`, annual.values[0], sum(monthly.values), [annual.line, monthly.line]));
}
const cashReceived = row(annualCash, 'Subtotal de Dinheiro Recebido');
const cashSpent = row(annualCash, 'Subtotal de Dinheiro Gasto');
const operatingPaid = row(annualCash, 'Subtotal gasto em operações');
const vatPaid = row(annualCash, 'Imposto sobre vendas, IVA, HST/GST pagos');
const initialCash = row(monthlyBalance, 'Dinheiro').values[0];
const nonCashAssets = row(annualBalance, 'Contas a receber').values[0] + row(annualBalance, 'Outros ativos correntes').values[0] + row(annualBalance, 'Total de Activos a Longo Prazo').values[0];
const capital = row(annualBalance, 'Total Capital').values[0];
const liabilities = row(annualBalance, 'Total de Passivos').values[0];
const assets = row(annualBalance, 'Total de Activos').values[0];
const componentCashSpent = operatingPaid.values[0] + vatPaid.values[0];
checks.push(check('cash.2025_spending_components', cashSpent.values[0], componentCashSpent, [cashSpent.line, operatingPaid.line, vatPaid.line]));
checks.push(check('balance.2025_assets_vs_liabilities_capital', liabilities + capital, assets, [row(annualBalance, 'Total de Activos').line, row(annualBalance, 'Total de Passivos').line, row(annualBalance, 'Total Capital').line]));
const balanceMonths = [];
const cashRow = row(monthlyBalance, 'Dinheiro'), arRow = row(monthlyBalance, 'Contas a receber'), otherRow = row(monthlyBalance, 'Outros Activos correntes'), fixedRow = row(monthlyBalance, 'Total de Activos a Longo Prazo'), liabilityRow = row(monthlyBalance, 'Total de Passivos'), capitalRow = row(monthlyBalance, 'Total Capital'), assetRow = row(monthlyBalance, 'Total de Activos');
for (let month = 1; month <= 12; month++) {
const computedAssets = cashRow.values[month] + arRow.values[month] + otherRow.values[month] + fixedRow.values[month];
const computedFunds = liabilityRow.values[month] + capitalRow.values[month];
balanceMonths.push({ month, printedAssets: decimal(assetRow.values[month]), componentAssets: decimal(computedAssets), componentLiabilitiesCapital: decimal(computedFunds), componentDifference: decimal(computedAssets - computedFunds) });
}
const payroll = row(monthlyProfit, 'Folha de pagamento'), charges = row(monthlyProfit, 'Impostos sobre Folhas de Pagamento');
if (charges.rates.length !== 1) throw new Error('Taxa de referência da folha não identificada univocamente');
const basisPoints = printedCents(charges.rates[0].slice(0, -1));
const exactCharges = payroll.values.map(value => {
const product = value * basisPoints;
if (product % 10000n !== 0n) throw new Error('Precisão adicional necessária para os encargos da folha');
return product / 10000n;
});
const otherExpenses = ['Marketing/Promoção', 'Depreciação', 'Aluguer', 'Serviços públicos', 'Seguros', 'Outros'].map(label => row(monthlyProfit, label));
const interest = row(monthlyProfit, 'Despesa com juros'), taxes = row(monthlyProfit, 'Impostos Incorridos');
const exactOperating = payroll.values.map((value, index) => value + exactCharges[index] + sum(otherExpenses.map(entry => entry.values[index])));
const gross = row(monthlyProfit, 'Margem bruta').values;
const exactNetProfit = gross.map((value, index) => value - exactOperating[index] - interest.values[index] - taxes.values[index]);
const payrollRecomposition = {
scope: 'reference_arithmetic_only_not_a_fiscal_rule', rate: charges.rates[0],
monthlyCharges: exactCharges.map(decimal), monthlyOperating: exactOperating.map(decimal), monthlyNetProfit: exactNetProfit.map(decimal),
chargesAnnualCheck: check('payroll_charges.cent_recomposition', row(annualProfit, 'Impostos sobre Folhas de Pagamento').values[0], sum(exactCharges), [charges.line, payroll.line]),
operatingAnnualCheck: check('operating_expenses.cent_recomposition', row(annualProfit, 'Despesas Operacionais Totais').values[0], sum(exactOperating), [charges.line, payroll.line]),
profitAnnualCheck: check('net_profit.cent_recomposition', row(annualProfit, 'Lucro Líquido').values[0], sum(exactNetProfit), [charges.line, payroll.line, row(monthlyProfit, 'Margem bruta').line]),
};
return {
status: 'BLOCKED_SOURCE_PRECISION_OR_COMPLETENESS', annualTotalsChanged: false, applicationFormulasChanged: false,
checks, balanceMonths, payrollRecomposition,
oneUnitTrace: {
approvedCashSpent: decimal(cashSpent.values[0]), componentCashSpent: decimal(componentCashSpent),
approvedClosingCash: decimal(initialCash + cashReceived.values[0] - cashSpent.values[0]),
componentOnlyClosingCash: decimal(initialCash + cashReceived.values[0] - componentCashSpent),
approvedAssets: decimal(assets), componentOnlyAssets: decimal(initialCash + cashReceived.values[0] - componentCashSpent + nonCashAssets),
liabilitiesAndCapital: decimal(liabilities + capital), componentOnlyIsDiagnosticNotCorrection: true,
},
ambiguousCashLabel: monthlyCash.filter(entry => entry.label === 'Novo Investimento Recebido').map(entry => ({ line: entry.line, sum: decimal(sum(entry.values)), printed: entry.printed })),
missing: ['Valores monetários de origem sem arredondamento por mês e por rubrica', 'Regras do programa de origem: arredondamento de apresentação versus cálculo e momento do arredondamento', 'Linhas de vendas e custos omitidas ou uma versão completa que explique os subtotais', 'Identificação correcta da segunda linha Novo Investimento Recebido no fluxo mensal'],
};
}
if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
try {
if (!process.argv[2]) throw new Error('Indique o caminho do texto financeiro fornecido.');
const source = fs.readFileSync(process.argv[2]);
const report = { sourceSha256: createHash('sha256').update(source).digest('hex'), ...reconcileFinancialReference(source.toString('utf8')) };
const output = JSON.stringify(report, null, 2) + '\n';
if (process.argv[3]) {
if (resolve(process.argv[3]) === resolve(process.argv[2])) throw new Error('O diagnóstico não pode sobrescrever a fonte.');
fs.writeFileSync(process.argv[3], output);
} else process.stdout.write(output);
process.exitCode = 2;
} catch (error) {
process.stderr.write(`${error.message}\n`);
process.exitCode = 1;
}
}