fix(v12): complete currency schedule and import diagnostics

This commit is contained in:
2026-11-21 08:58:00 +02:00
parent 64601256d5
commit 4bb2fd670a
9 changed files with 411 additions and 10 deletions
@@ -1197,7 +1197,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
| V09 | PN P0073–0087 | Validação financeira | Aplicar todas as mensagens literais definidas em todos os formulários e consumidores | IMPLEMENTADO MAS NÃO VALIDADO | business-financial-plan.ts:25–34; complementary-report.ts; integral-financial-plan.tsx | 04d8db6c;4fb9296f | Mensagens locais existem; não há prova de cobertura literal integral de percentagens, datas, caixa e divergências. Validação funcional não comprova todos os textos exigidos. |
| V10 | PN P0081 | Validação financeira | Campo de prazo em dias e mensagem de intervalo 0–365 | INTEGRADO E VALIDADO | financial-plan-details.tsx; business-financial-plan.ts; financial-plan-warnings.ts | 9c34af04;19f06ddf | Campo opcional de prazo contratual em dias, persistido no snapshot 18; inteiro entre 0 e 365, com mensagem pedida para -1, 366, 30.5 e abc. Mantém-se a agenda mensal independente. Dependência indispensável do aviso exacto de crédito V08, não uma alteração da fórmula de caixa. E8: limites 0/30/90/91/365, recuperação e comparação exacta dos fluxos antes/depois. |
| V11 | PN P0083 | Validação financeira | Aviso de caixa negativa identifica o mês e valor | APROVADO E ENCERRADO EM QA | financial-plan-warnings.ts; monthly-negative-cash-warnings.test.mjs; componentes e relatório existentes | fe615e55; E16; prova-v11-caixa-mensal-20261120.json | Aceitação expressa do proprietário com base no relatório E16 do commit fe615e55, sem inspecção independente dos ficheiros locais. Cinco avisos Janeiro–Maio 2027 (-1720.00/-1340.00/-960.00/-580.00/-200.00 MZN), apesar do fecho anual +2460.00; cenário sem défices sem avisos indevidos; gravação e recuperação demonstradas em computador e móvel 390×844; seis testes específicos aprovados. Fórmulas financeiras preservadas. Encerramento exclusivamente documental, sem repetir testes ou modificar código; instalação, publicação e migrações não autorizadas. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | financial-issue-presentation.ts; financial-ratios-report.ts; integral-financial-report.ts; business-financial-plan.ts; componentes existentes do editor e relatório | 4ef5f58e; 74ba0bd0; f81306f1; E17–E21; prova-v12-mensagens-restantes-20261120.json | D1/D2/D3 aceites individualmente pelo proprietário, sem repetição. E21 demonstra aquisições, existências iniciais, falta de stock/reconciliação, impostos mensais, parcelas de abertura, recuperação de vendas, preços mensais e classificação corrente/rácio dependente, em computador e emulação móvel. Corrigidos apenas diagnósticos reproduzidos e recuperação editável de meses duplicados; rejeição financeira preservada. Gravação/recuperação no rascunho sintético existente, versão 79. Cinco testes focados e um teste directamente afectado aprovados; fórmulas preservadas. V12 permanece parcialmente validado e aberto: resolução da divergência de moeda do pessoal e ramos estruturais/agendas não percorridos conservam os limites exactos de E21. Restantes 87 linhas preservadas. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | DEMONSTRADO EM QA — PROPOSTO PARA ENCERRAMENTO | project-planning.tsx; simulation-form.tsx; simulation-business-plan.tsx; complementary-report.ts; business-financial-plan.ts; financial-plan-import-message.ts; componentes e relatórios existentes | 4ef5f58e; 74ba0bd0; f81306f1; 64601256; E17–E22; prova-v12-lacunas-finais-20261121.json | E21 e D1/D2/D3 aceites pelo proprietário, sem repetição. E22 conclui as três lacunas: moeda do pessoal no componente real, oito campos de agendas pendentes e ramos de importação (agenda curta, dois modos incompatíveis e mês fora do horizonte). Corrigidos apenas defeitos reproduzidos de contexto/mensagem; fórmulas e validações estritas preservadas. Mensagens, rejeição, remoção após correcção e recuperação demonstradas em computador e emulação móvel 390x844; rascunho final versão 137. Cinco testes específicos, tipos, lint e compilação QA aprovados; avisos de compilação documentados. Perda de sessão resolvida pela autenticação normal da mesma conta, sem perda do rascunho. Confronto com inventário E18 completo dentro do âmbito original; proposto para aceitação, sem encerramento automático nem novos ciclos. F20/F22 e restantes 87 linhas preservados. |
| V13 | PN P0086 | Validação financeira | Lista Falta preencher com ligação directa a cada campo por corrigir | NÃO IMPLEMENTADO | integral-financial-plan.tsx; simulation-business-plan.tsx | — | Existem erros e notas; não foi encontrada implementação completa do sumário com ligações por campo pedido. |
| V14 | PN P0098 | Validação financeira | Aviso específico sobre textos opcionais em falta (concorrência/SWOT) | NÃO IMPLEMENTADO | business-plan-guidance.ts; business-plan-warnings.tsx | — | Catálogo de avisos não inclui estes textos opcionais. |
| C01 | PN P0015; ME P0115 | Portal — actividades existentes | Análise agregada privada sem divulgar empresas/contactos individuais | INTEGRADO E VALIDADO | app/Services/InvestorContext.php; componentes de consulta agregada | base bae996e1 (histórico de incorporação no documento) | E7: provas agregadas e protecções documentadas; não é publicação de listas individuais. |
@@ -1984,3 +1984,71 @@ Verificação proporcional: cinco testes focados em `v12-remaining-messages.test
- Agendas com comprimento incompatível, meses fora do horizonte e modos de compras incompatíveis por importação: guardas/testes existentes preservados; não foram criados ficheiros malformados nem forçados valores inacessíveis nos selectores normais. A prevenção normal de modos foi observada, mas não substitui a prova de cada mensagem de rejeição da importação.
**Classificação: V12 PARCIALMENTE VALIDADO — ABERTO.** Os casos individuais acima ficam propostos para aceitação, com os limites expressos. Nenhuma mensagem obrigatória sem prova foi declarada concluída. Próximo recorte recomendado: apenas os ramos enumerados, reutilizando os cenários disponíveis; não repetir aquisições, existências, D1/D2/D3 ou os ensaios concluídos sem regressão. V11, F20/F22 e todas as restantes 87 linhas mantidos. Sem instalação, publicação, migrações ou alterações de fontes/dados activos.
## E22 — V12: conclusão concentrada das três lacunas — 21/11/2026
Base `64601256`, inventário fechado de E18 e limites de E21. O proprietário aceitou as correcções de E21; essas provas e D1/D2/D3 foram reutilizadas, sem nova execução. Esta intervenção não é uma auditoria dos 88 requisitos nem cria novas regras financeiras. Referências documentais conservadas: PN XML 57/61/62/63/89/91, já relacionadas em E18. Recibo individual: `prova-v12-lacunas-finais-20261121.json`.
QA isolado `http://127.0.0.3:18724`, base `main_reference_20261104_test:55441`, conta normal sintética 1407, rascunho existente `af6686b4-f210-4203-9ef1-0d85537426ae`. `/api/translate/languages` respondeu HTTP 200 no início; instalação de tradução intacta. Reutilizado D3, com variantes locais explícitas das agendas ainda por conferir. A linha de pessoal deriva do cenário E3: Operação/Operações, duas pessoas, remuneração mensal 100 e meses 1–2 para o horizonte existente de dois meses. São hipóteses sintéticas, sem contratação, pagamento ou dado real. Originais dos cenários e versão 12 preservados.
### 1. Divergência de moeda do pessoal
Defeito funcional reproduzido: moeda do projecto USD, plano financeiro MZN, mas `ProjectTeamPlanner` recebia apenas o snapshot de pessoal e o financeiro. O relatório local declarava MZN e chegava a apresentar a linha de reconciliação entre moedas diferentes. Leitura protegida confirmou USD no rascunho; observação do editor confirmou a omissão. A função de relatório já tinha a comparação correcta: a falha era a ausência do contexto na chamada.
Correcção localizada: passar a moeda existente do projecto ao componente/relatório e nomear na mensagem «Pessoal / Moeda das remunerações (USD)» e «Plano financeiro / Moeda (MZN)», com orientação para conferir a moeda e os montantes de origem. Nenhuma conversão ou cálculo salarial foi acrescentado.
No editor, computador e 390x844: mensagem presente com USD/MZN; folha salarial 200 por mês conserva a sua moeda USD; a diferença contra o plano MZN não é calculada. Importada pela interface normal a variante sintética cuja declaração do plano é USD, coerente com a hipótese do projecto: aviso desaparece, folha 200/200/400 e diferença 0/0/0. Isto é correcção de uma declaração sintética, **não conversão de valores MZN em USD** nem procedimento recomendado para dados reais em moedas distintas. A mensagem exige corrigir apenas campos incorrectos; moedas legitimamente diferentes permanecem indeterminadas.
Gravação confirmada na versão 136; recarregamento móvel recuperou a versão 137 com a mesma moeda, remuneração, quantidade e meses, sem aviso indevido. Hash final no recibo. Mensagem de causa e indicação de reconciliação indeterminada explicam estados diferentes; não foram eliminadas indiscriminadamente.
### 2. Agendas financeiras ainda não demonstradas
Em cada caso abaixo, apenas a célula do mês 2 foi esvaziada, a entrada inválida impediu previsão/CSV, e a reposição do valor indicado eliminou o aviso e devolveu os resultados. Observações de acessibilidade feitas separadamente nos dois formatos, com relatório aberto; não se presumiu cobertura por analogia entre células. Preços e impostos de E21 não foram repetidos.
| Campo/agenda | Valor reposto | Diagnóstico verificado | Resultado |
| --- | --- | --- | --- |
| Unidades do produto 1, mês 2 | 0 | Antes: apenas «Quantidade». Após correcção: «Previsão de Vendas / Unidades do produto 1, mês 2», quantidade não negativa até três casas e zero só quando aplicável | Defeito de precisão corrigido; prova pós-correcção nos dois formatos |
| Custo por unidade, mês 2 | 40 | Custo variável do produto 1, mês 2; montante não negativo, até duas casas | Existente adequado, sem alteração |
| Encomenda agregada para existências, mês 2 | 0 | Compras para existências, mês 2; montante não negativo, até duas casas | Existente adequado, sem alteração |
| Pagamento de compras/variáveis, mês 2 | 400 | Pagamentos de compras, mês 2 | Existente adequado, sem alteração |
| Despesas operacionais reconhecidas, mês 2 | 100 | Despesas operacionais, mês 2 | Existente adequado, sem alteração |
| Pagamento de despesas operacionais, mês 2 | 100 | Pagamentos operacionais, mês 2 | Existente adequado, sem alteração |
| Custo de pessoal reconhecido, mês 2 | 200 | Despesa com pessoal, mês 2 | Existente adequado, sem alteração |
| Pagamento de pessoal, mês 2 | 200 | Pagamentos de pessoal, mês 2 | Existente adequado, sem alteração |
As tabelas afectadas são listadas pelo agrupador existente. A correcção de quantidades apenas contextualiza a excepção do mesmo conversor; não substitui vazio por zero nem muda arredondamento, precisão ou sinal permitidos. Todos os valores das agendas corrigidas foram guardados no mesmo rascunho e recuperados, conforme recibos.
### 3. Ramos de importação identificados em E18/E21
Não se criou obrigação de rejeitar qualquer rascunho economicamente incompleto antes de o poder editar. A validação de formato continua distinta da validação financeira.
| Ramo concreto | Prova anterior à correcção | Resultado final e correcção demonstrada |
| --- | --- | --- |
| Agenda de unidades com comprimento 1 para horizonte 2 | Ficheiro recusado com aviso genérico de JSON não reconhecido | Mensagem nomeia Importação, Previsão de Vendas, produto/agenda, comprimento e horizonte, e indica corrigir o plano de origem. Computador/móvel conferidos. Versão 133 e hash exactamente iguais antes/depois da rejeição; ficheiro corrigido aceite e mensagem removida |
| Prazos de fornecedor sem stock por produto | Restauração estrita recusa o ficheiro; aviso genérico | Mensagem nomeia Fluxo de Caixa, «Calcular pagamentos pelo prazo do fornecedor» e «Planear stock por produto», com as duas correcções válidas de origem. Rejeição estrita mantida. Aviso conferido nos dois formatos; variante corrigida aceite e aviso removido |
| Compras agregadas e stock por produto simultâneos | Estrutura editável importável, previsão recusada | Aviso existente manda seleccionar um dos dois modos e lista tabelas afectadas. Conferido nos dois formatos; importação da variante com um modo remove aviso e recupera CSV. Nenhuma alteração necessária |
| Recuperação na linha 1, mês 3 para horizonte 2 | Previsão recusada, mas o aviso conjunto orientava sobretudo para mês repetido | Mantida exactamente a condição de rejeição; apenas ramo de mensagem distingue mês fora do horizonte, linha 1, valor 3 e intervalo 1–2. Prova nos dois formatos. Seleccionar mês 2 no editor remove aviso, recupera CSV e fica guardado. Ramo de duplicação aceite em E21 conserva a mensagem anterior e não foi reaberto |
O novo explicador de importação só é chamado **após** a restauração estrita rejeitar o ficheiro. Não aceita, corrige, trunca nem completa agendas. JSON/estrutura sem correspondência segura conserva aviso genérico com orientação para usar uma exportação reconhecida; não inventa tabela/campo financeiro para bytes que não representam um plano. Não se fez fuzzing nem se acrescentou esse objectivo aos requisitos originais.
### 4. Verificação e confronto com o inventário E18
Cinco regressões específicas aprovadas em `tests/frontend/v12-final-gaps.test.mjs`: quantidade mensal (sucesso/erro/limites), agenda curta, componente real de pessoal com moeda, recuperação fora do horizonte e dependência do fornecedor na importação. Executados inicialmente três casos; os dois casos acrescentados por defeitos posteriormente reproduzidos foram executados individualmente. Nenhum teste anteriormente aprovado foi repetido. Tipos e lint dos ficheiros afectados aprovados. Compilação QA final com saída 0, «built in 19.92s». Avisos preexistentes de `fontaine` opcional, dimensão de chunks e tempos de plugins mantidos nos registos; não são classificados como falhas funcionais, não se instalaram pacotes para os eliminar.
| Famílias do inventário E18 | Evidência suficiente reunida, sem repetição |
| --- | --- |
| Capital discriminado, reconciliação de abertura e divergência salarial por função | E17 e provas históricas aceites de E3 |
| Aquisições, existências iniciais, falta de stock e reconciliação por período | E21 aceite |
| Depreciação/reembolso, parcelas de fornecedor e arranque incompleto | D1/D2/D3, E19/E20, aceites |
| Moeda do pessoal | E22, componente real e percurso corrigido/recuperado |
| Rácios dependentes e classificações correntes | E21 aceite, complementando E4 |
| Agendas mensais e coerência temporal | E21 para preço/impostos; E22 para os oito campos pendentes e importação curta; testes temporais de E18 reutilizados |
| Modos de compras, parcelas de abertura e recuperação | E21 aceite; E22 para os dois modos incompatíveis e mês fora do horizonte |
| Relatório de estrutura desconhecida/fonte anual e conservação de erros desconhecidos | Salvaguardas E17 já aprovadas; não se atribuem campos inexistentes nem se impõe uma bateria ilimitada de ficheiros arbitrários |
Houve perda da sessão autenticada no fim da prova: PUT/GET do rascunho privado responderam 404 enquanto o navegador passou a «Entrar». Consulta protegida confirmou dono 1407, versão 135, sem eliminação/expiração. Retomada a autenticação normal da mesma conta de ensaio, sem alteração de credenciais, permissões, código de autenticação ou serviço. O mesmo rascunho foi recuperado e a declaração final guardada nas versões 136/137. Não se certifica o mecanismo exacto que terminou a sessão; não se atribui o incidente a cálculos ou infraestrutura sem prova. Nenhum dado foi perdido ou reposto artificialmente.
**Conclusão técnica:** as três lacunas delimitadas ficaram demonstradas e o confronto com as famílias obrigatórias de E18 não deixa pendência funcional identificada no âmbito original de V12. **Proposto para aceitação e encerramento em QA; não encerrado automaticamente.** Isto não certifica todos os conteúdos arbitrários de importação nem a conclusão dos 88 requisitos. Limites de dados/documentos, classificações indeterminadas legítimas e avisos económicos desfavoráveis não se transformam em defeitos ou novas obrigações. Não se inicia outra ronda automaticamente.
Só V12 foi actualizado na matriz; restantes 87 linhas e aprovações conservadas. F20/F22 continuam separados e pendentes. Nenhuma fórmula, taxa, saldo, movimento ou fonte original foi alterado. Sem instalação, publicação ou migrações.
@@ -0,0 +1,104 @@
{
"date_local": "2026-11-21",
"baseline_commit": "64601256",
"scope": [
"personnel currency mismatch",
"remaining schedules",
"identified invalid import branches"
],
"accepted_reused": [
"D1",
"D2",
"D3",
"E17",
"E20",
"E21"
],
"qa": {
"url": "http://127.0.0.3:18724",
"database": "main_reference_20261104_test:55441",
"actor": 1407,
"draft": "af6686b4-f210-4203-9ef1-0d85537426ae",
"translation_initial_http": 200,
"mobile": "Edge responsive 390x844, not physical device"
},
"proofs": {
"currency": {
"before": "Project USD / plan MZN: actual personnel component omitted project currency and falsely reconciled",
"after": "Project USD / synthetic plan USD: warning absent, remuneration 100, quantity 2, months 1–2, payroll 200/200/400 and difference 0/0/0",
"recovered": {
"version": 137,
"snapshot_sha256": "a297e6ccb3f45abb8429e17f5742c96b0b491ebc9626835efb20a15477e14854"
}
},
"schedules": [
"units",
"unit variable cost",
"aggregate inventory purchase",
"variable cost payment",
"operating expense",
"operating payment",
"payroll expense",
"payroll payment"
],
"imports": {
"short": {
"before": {
"version": 133,
"snapshot_sha256": "41c7f5db16b98dff32ca7d6bf9a120e1a203ca068b32f1d663aa266c55bad9b4"
},
"after": {
"version": 133,
"snapshot_sha256": "41c7f5db16b98dff32ca7d6bf9a120e1a203ca068b32f1d663aa266c55bad9b4"
},
"preserved": true
},
"incompatible_modes": "Both aggregate/product modes: forecast rejected; supplier without product stock: strict import rejected; corrected variant accepted",
"out_of_horizon": {
"invalid": "Recovery line 1, month 3, horizon 2",
"corrected_month": 2,
"saved": {
"version": 135,
"snapshot_sha256": "1cd36e634be04bd85bfb7556b0b41abb2a2422fb2a22839a6c2cfa005e56ea67"
}
}
}
},
"tests": {
"file": "tests/frontend/v12-final-gaps.test.mjs",
"passed": 5,
"execution": "3 initial new tests, 2 subsequent new tests individually; prior accepted tests not rerun",
"types": "passed",
"lint": "passed",
"build": {
"exit_code": 0,
"duration_seconds": 19.92,
"warnings": [
"optional fontaine",
"chunk sizes",
"plugin timings"
]
}
},
"session_incident": {
"http": 404,
"cause": "Authenticated session lost; private draft persisted at version 135, no deletion/expiry",
"recovery": "Normal UI login of existing synthetic account; no credentials/permissions/auth-code changes; save/reload successful at versions 136/137",
"termination_mechanism": "not established"
},
"evidence": "E22 individual tables plus native CUA accessibility/screenshots in execution transcript; no exported PNG claimed",
"matrix": {
"rows": 88,
"changed": [
"V12"
],
"preserved": 87
},
"financial_formulas_changed": false,
"active_data_changed": false,
"installs": false,
"publication": false,
"migrations": false,
"classification": "Demonstrated in original E18 scope; proposed for acceptance and QA closure, not automatically closed",
"functional_pending_in_original_scope": []
}
+6 -1
View File
@@ -87,10 +87,12 @@ export function ProjectTeamPlanner({
value,
onChange,
financialPlanSnapshot = '',
projectCurrency = '',
}: {
value: string;
onChange: (value: string) => void;
financialPlanSnapshot?: string;
projectCurrency?: string;
}) {
const rows = readRows<TeamNeed>(value, teamKeys);
const persist = (next: TeamNeed[]) => onChange(JSON.stringify(next));
@@ -297,7 +299,10 @@ export function ProjectTeamPlanner({
<InvestmentReportTables
tables={[
buildComplementaryTables(
{ project_team_snapshot: value },
{
project_team_snapshot: value,
currency: projectCurrency,
},
restoreBusinessPlanSnapshot(financialPlanSnapshot),
)[2],
]}
@@ -5,6 +5,7 @@ import {
businessPlanNumberError,
exportBusinessPlanCsv,
forecastBusinessPlan,
financialPlanImportMessage,
MAX_BUSINESS_PLAN_SNAPSHOT_LENGTH,
restoreBusinessPlanSnapshot,
serializeBusinessPlanSnapshot,
@@ -196,10 +197,7 @@ export function SimulationBusinessPlan({
try {
const source = await file.text();
const imported = restoreBusinessPlanSnapshot(source);
if (!imported)
throw new Error(
'O ficheiro não contém um plano JSON reconhecido pelo InvestMoz.',
);
if (!imported) throw new Error(financialPlanImportMessage(source));
savePlan(imported);
setSnapshotError('');
} catch (cause) {
@@ -3473,6 +3473,7 @@ export function SimulationForm() {
{current.id === 'team' && (
<>
<ProjectTeamPlanner
projectCurrency={String(draft.currency ?? '')}
financialPlanSnapshot={String(
draft.business_plan_snapshot ?? '',
)}
+16 -3
View File
@@ -1651,7 +1651,7 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) {
throw new Error('A agenda de recuperação deve ter até 60 parcelas.');
const recoveryMonths = new Set<number>();
const salesRecoveryRates = new Map<number, bigint>();
salesRecoverySchedule.forEach((entry) => {
salesRecoverySchedule.forEach((entry, index) => {
if (
!Number.isSafeInteger(entry.month) ||
entry.month < 1 ||
@@ -1659,7 +1659,11 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) {
recoveryMonths.has(entry.month)
)
throw new Error(
'Cada recuperação deve ter um mês único dentro do horizonte.',
Number.isSafeInteger(entry.month) &&
entry.month >= 1 &&
entry.month <= periods
? 'Cada recuperação deve ter um mês único dentro do horizonte.'
: `Fluxo de Caixa / Recuperação de vendas vencidas, linha ${index + 1} / Mês (${entry.month}): seleccione um mês inteiro entre 1 e ${periods}, dentro do horizonte do plano. Corrija este campo ou remova a linha inválida.`,
);
recoveryMonths.add(entry.month);
const rate = percentMicro(
@@ -1770,7 +1774,15 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) {
);
return {
units:
unitsByPeriod?.map(quantity) ??
unitsByPeriod?.map((value, month) => {
try {
return quantity(value);
} catch {
throw new Error(
`Previsão de Vendas / Unidades do produto ${index + 1}, mês ${month + 1}: preencha uma quantidade não negativa com até três casas decimais; indique zero apenas quando aplicável.`,
);
}
}) ??
Array.from({ length: periods }, (_, month) =>
projectedUnits(input, product, month),
),
@@ -3487,3 +3499,4 @@ export function exportBusinessPlanCsv(
.map((row) => row.map(csvCell).join(','))
.join('\r\n')}`;
}
export { financialPlanImportMessage } from './financial-plan-import-message.ts';
+1 -1
View File
@@ -119,7 +119,7 @@ export function buildComplementaryTables(
staff.notes.push(`Moeda das remunerações: ${declaredCurrency}.`);
if (!sameCurrency)
staff.issues.push(
'A moeda do projecto difere da moeda do plano financeiro. A reconciliação fica por determinar, sem conversão automática.',
`Pessoal / Moeda das remunerações (${declaredCurrency}) difere de Plano financeiro / Moeda (${plan?.currency}). Confira a moeda e os montantes de origem e corrija apenas os campos incorrectos. Enquanto forem moedas diferentes, a reconciliação fica por determinar, sem conversão automática.`,
);
market.notes.push(
'O total é a soma aritmética dos segmentos, sem deduplicação de clientes. Confirme eventuais sobreposições antes de o interpretar como dimensão única do mercado.',
@@ -0,0 +1,77 @@
/** Explain a rejected snapshot only; never relax the snapshot validator. */
export function financialPlanImportMessage(source: string): string {
const fallback =
'Importação / Plano financeiro: o ficheiro não contém um plano JSON reconhecido pelo InvestMoz. Seleccione um plano exportado pelo portal; o plano actual foi conservado.';
try {
const decoded = JSON.parse(source);
const plan = decoded?.plan;
if (
!plan ||
!Number.isSafeInteger(plan.periods) ||
plan.periods < 1 ||
plan.periods > 60
)
return fallback;
if (
plan.useSupplierPaymentTerms === true &&
plan.useProductInventorySchedule !== true
)
return 'Importação / Fluxo de Caixa / Calcular pagamentos pelo prazo do fornecedor: este modo exige «Planear stock por produto». Active o stock por produto ou desactive os prazos do fornecedor no plano de origem e volte a importar. O plano actual foi conservado.';
const schedules: [string, unknown][] = [
[
'Fluxo de Caixa / Compras para existências',
plan.inventoryPurchaseSchedule,
],
[
'Fluxo de Caixa / Pagamento de compras/variáveis',
plan.monthlyVariableCostPaymentsByPeriod,
],
[
'Lucros e Perdas / Despesas operacionais reconhecidas',
plan.monthlyOperatingExpensesByPeriod,
],
[
'Fluxo de Caixa / Pagamento de despesas operacionais',
plan.monthlyOperatingPaymentsByPeriod,
],
[
'Lucros e Perdas / Custo de pessoal reconhecido',
plan.monthlyPayrollExpenseByPeriod,
],
[
'Fluxo de Caixa / Pagamento de pessoal',
plan.monthlyPayrollPaymentsByPeriod,
],
];
if (Array.isArray(plan.products))
plan.products.forEach(
(product: Record<string, unknown>, index: number) => {
if (!product || typeof product !== 'object') return;
schedules.push(
[
`Previsão de Vendas / Unidades do produto ${index + 1}`,
product.monthlyUnitsByPeriod,
],
[
`Previsão de Vendas / Preço do produto ${index + 1}`,
product.unitPriceByPeriod,
],
[
`Lucros e Perdas / Custo variável do produto ${index + 1}`,
product.unitVariableCostByPeriod,
],
);
},
);
for (const [label, schedule] of schedules) {
if (
Array.isArray(schedule) &&
(schedule.length < plan.periods || schedule.length > 60)
)
return `Importação / ${label}: a agenda contém ${schedule.length} meses; deve cobrir os ${plan.periods} meses do horizonte e ter no máximo 60. Corrija a agenda no plano de origem e volte a importar. O plano actual foi conservado.`;
}
} catch {
return fallback;
}
return fallback;
}
+135
View File
@@ -0,0 +1,135 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import fs from 'node:fs';
import { createRequire } from 'node:module';
import { compileFunction } from 'node:vm';
import ts from 'typescript';
import React from 'react';
import { renderToStaticMarkup } from 'react-dom/server';
import { financialReportFixture } from './fixtures/integral-financial-plan.mjs';
import { complementaryFixture } from './fixtures/complementary-plan.mjs';
import * as business from '../../resources/js/lib/business-financial-plan.ts';
import * as dossier from '../../resources/js/lib/project-dossier.ts';
import * as complementary from '../../resources/js/lib/complementary-report.ts';
test('V12 final: supplier import without product stock identifies the incompatible controls without weakening rejection', () => {
const plan = financialReportFixture(2);
plan.useSupplierPaymentTerms = true;
plan.useProductInventorySchedule = false;
const raw = JSON.stringify({ version: 17, plan });
assert.equal(business.restoreBusinessPlanSnapshot(raw), null);
assert.match(
business.financialPlanImportMessage(raw),
/Fluxo de Caixa \/ Calcular pagamentos pelo prazo do fornecedor/,
);
assert.match(
business.financialPlanImportMessage(raw),
/Active o stock por produto ou desactive os prazos/,
);
});
test('V12 final: imported out-of-horizon recovery identifies exact line and range; correction restores calculation', () => {
const plan = financialReportFixture(2);
const before = business.forecastBusinessPlan(plan);
plan.salesRecoverySchedule = [{ month: 3, percent: '0' }];
const imported = business.restoreBusinessPlanSnapshot(
business.serializeBusinessPlanSnapshot(plan),
);
assert.ok(imported);
assert.throws(
() => business.forecastBusinessPlan(imported),
/linha 1 \/ Mês \(3\): seleccione um mês inteiro entre 1 e 2/,
);
imported.salesRecoverySchedule[0].month = 1;
assert.deepEqual(business.forecastBusinessPlan(imported), before);
});
test('V12 final: quantity cell diagnostic retains exact calculation and rejection rules', () => {
const plan = financialReportFixture(2);
plan.products[0].monthlyUnitsByPeriod = ['0', '0'];
const valid = business.forecastBusinessPlan(plan);
for (const value of ['', '-1', '1.0001']) {
plan.products[0].monthlyUnitsByPeriod[1] = value;
assert.throws(
() => business.forecastBusinessPlan(plan),
/Previsão de Vendas \/ Unidades do produto 1, mês 2: preencha/,
);
}
plan.products[0].monthlyUnitsByPeriod[1] = '0';
assert.deepEqual(business.forecastBusinessPlan(plan), valid);
});
test('V12 final: rejected short import names original agenda and never relaxes strict restore', () => {
const plan = financialReportFixture(2);
const valid = business.serializeBusinessPlanSnapshot(plan);
const snapshot = JSON.parse(valid);
snapshot.plan.products[0].monthlyUnitsByPeriod = ['0'];
const short = JSON.stringify(snapshot);
assert.equal(business.restoreBusinessPlanSnapshot(short), null);
assert.match(
business.financialPlanImportMessage(short),
/Previsão de Vendas \/ Unidades do produto 1: a agenda contém 1 meses; deve cobrir os 2/,
);
assert.match(
business.financialPlanImportMessage(short),
/plano actual foi conservado/,
);
assert.ok(business.restoreBusinessPlanSnapshot(valid));
assert.match(business.financialPlanImportMessage('{'), /JSON reconhecido/);
});
test('V12 final: actual personnel component receives currency, withholds reconciliation and removes warning after correction', () => {
const source = fs.readFileSync(
new URL(
'../../resources/js/components/project-planning.tsx',
import.meta.url,
),
'utf8',
);
const code = ts.transpileModule(source, {
compilerOptions: {
module: ts.ModuleKind.CommonJS,
target: ts.ScriptTarget.ES2022,
jsx: ts.JsxEmit.ReactJSX,
},
}).outputText;
const require = createRequire(import.meta.url),
module = { exports: {} };
const mocks = {
'@/lib/project-dossier': dossier,
'@/lib/business-financial-plan': business,
'@/lib/complementary-report': complementary,
'./investment-report-tables': {
InvestmentReportTables: ({ tables }) =>
React.createElement('div', null, JSON.stringify(tables)),
},
};
compileFunction(code, ['require', 'module', 'exports'])(
(key) => mocks[key] ?? require(key),
module,
module.exports,
);
const { plan, team } = complementaryFixture();
const snapshot = business.serializeBusinessPlanSnapshot(plan);
const props = {
value: JSON.stringify(team),
onChange: () => {},
financialPlanSnapshot: snapshot,
projectCurrency: 'USD',
};
const bad = renderToStaticMarkup(
React.createElement(module.exports.ProjectTeamPlanner, props),
);
assert.match(bad, /Moeda das remunerações \(USD\).*Moeda \(MZN\)/);
assert.match(bad, /sem conversão automática/);
assert.ok(!bad.includes('Diferença face à despesa de pessoal no plano'));
const fixed = renderToStaticMarkup(
React.createElement(module.exports.ProjectTeamPlanner, {
...props,
projectCurrency: 'MZN',
}),
);
assert.ok(!fixed.includes('difere de Plano financeiro'));
assert.ok(fixed.includes('Diferença face à despesa de pessoal no plano'));
assert.equal(business.serializeBusinessPlanSnapshot(plan), snapshot);
});