/** 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; }