diff --git a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md index 0535cfb3..6895b1b9 100644 --- a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md +++ b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md @@ -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. diff --git a/docs/investmoz/v2/auditoria-portal/prova-v12-lacunas-finais-20261121.json b/docs/investmoz/v2/auditoria-portal/prova-v12-lacunas-finais-20261121.json new file mode 100644 index 00000000..54be8c99 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/prova-v12-lacunas-finais-20261121.json @@ -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": [] +} diff --git a/resources/js/components/project-planning.tsx b/resources/js/components/project-planning.tsx index 8cc9af2e..e5d2a65d 100644 --- a/resources/js/components/project-planning.tsx +++ b/resources/js/components/project-planning.tsx @@ -87,10 +87,12 @@ export function ProjectTeamPlanner({ value, onChange, financialPlanSnapshot = '', + projectCurrency = '', }: { value: string; onChange: (value: string) => void; financialPlanSnapshot?: string; + projectCurrency?: string; }) { const rows = readRows(value, teamKeys); const persist = (next: TeamNeed[]) => onChange(JSON.stringify(next)); @@ -297,7 +299,10 @@ export function ProjectTeamPlanner({ (); const salesRecoveryRates = new Map(); - 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'; diff --git a/resources/js/lib/complementary-report.ts b/resources/js/lib/complementary-report.ts index 6146b732..c68671e1 100644 --- a/resources/js/lib/complementary-report.ts +++ b/resources/js/lib/complementary-report.ts @@ -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.', diff --git a/resources/js/lib/financial-plan-import-message.ts b/resources/js/lib/financial-plan-import-message.ts new file mode 100644 index 00000000..c032d89f --- /dev/null +++ b/resources/js/lib/financial-plan-import-message.ts @@ -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, 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; +} diff --git a/tests/frontend/v12-final-gaps.test.mjs b/tests/frontend/v12-final-gaps.test.mjs new file mode 100644 index 00000000..07f88d2c --- /dev/null +++ b/tests/frontend/v12-final-gaps.test.mjs @@ -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); +});