fix(v12): complete currency schedule and import diagnostics
This commit is contained in:
@@ -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": []
|
||||
}
|
||||
@@ -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 ?? '',
|
||||
)}
|
||||
|
||||
@@ -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';
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
@@ -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);
|
||||
});
|
||||
Reference in New Issue
Block a user