import { buildIntegralFinancialTables, displayReportMoney, isReportAssumptions, type InvestmentReportTable, } from './integral-financial-report.ts'; import type { BusinessFinancialPlanInput } from './business-financial-plan.ts'; import { calculateStartupAssetRequirements } from './startup-asset-requirements.ts'; /** The local startup editor owns this error when report tables are unavailable. */ export function startupErrorMessage(plan: BusinessFinancialPlanInput): string { if (plan.startupAssetRequirements) try { calculateStartupAssetRequirements(plan); } catch (cause) { return cause instanceof Error ? cause.message : 'Confira os dados de arranque.'; } return ''; } /** Do not hide a forecast error when the report editor itself cannot show the tables. */ export function forecastErrorShownInReport( plan: BusinessFinancialPlanInput, error: string, ) { return ( plan.reportSource !== 'annual_example' && (!plan.reportAssumptions || isReportAssumptions(plan.reportAssumptions)) && buildIntegralFinancialTables(plan).some((table) => table.issues.includes(error), ) ); } /** Presentation only: preserve the validation result, source issue and every financial value. */ export function financialIssueMessage(issue: string): string { if ( issue === 'O capital discriminado não corresponde ao capital introduzido. Confira os campos de financiamento.' ) return 'Financiamento — Capital próprio: este valor não coincide com a soma de Capital do proprietário, Capital do investidor e Capital adicional angariado. Corrija o Capital próprio ou a discriminação em «Crescimento, despesas discriminadas, capital e dividendos».'; if ( issue === 'A soma das existencias iniciais por produto deve coincidir com as existencias iniciais do plano.' ) return 'Balanço / Existências iniciais: este valor não coincide com a soma das existências iniciais por produto em «Planear stock por produto». Corrija o total do plano ou as linhas dos produtos.'; if ( issue === 'As aquisições do cenário não correspondem às necessidades de activos. Confira os valores e adopte as aquisições calculadas.' ) return 'Arranque / Aquisição de activos: este valor não coincide com as aquisições calculadas em «Caixa e activos necessários ao arranque». Confira os activos requeridos e disponíveis e adopte as aquisições calculadas, ou corrija os pressupostos.'; const opening = /^Saldos de abertura não reconciliados: diferença (-?\d+\.\d{2})\./.exec( issue, ); if (opening) return `Balanço projectado / Saldos de abertura: diferença ${displayReportMoney(opening[1])}. Confira «Capital e resultados anteriores» face aos saldos anteriores de caixa, activos, existências, valores a receber e valores a pagar. A diferença não permite identificar automaticamente qual saldo está errado; corrija os campos de origem, sem compensação automática.`; if ( issue === 'O mapa de pessoal diverge da despesa de pessoal do plano. Reveja os pressupostos; nenhum valor financeiro foi sobrescrito.' ) return 'Mapa de pessoal / Folha salarial prevista: este valor não coincide com «Pessoal» em Lucros e perdas («Custo mensal de pessoal» no editor). Confira quantidade, remuneração mensal e meses activos de cada função, ou a despesa de pessoal do plano. Consulte a linha «Diferença face à despesa de pessoal no plano»; nenhum valor financeiro foi sobrescrito.'; return issue; } /** Group identical issues across tables; callers keep the original issues for validity checks. */ export function financialIssuesForDisplay(tables: InvestmentReportTable[]) { const groups = new Map(); for (const table of tables) { for (const issue of table.issues) { if ( issue === 'Existem períodos não reconciliados; reveja as rubricas indicadas.' && table.issues.some((detail) => detail.startsWith( 'Saldos de abertura não reconciliados: diferença ', ), ) ) continue; const message = financialIssueMessage(issue); const group = groups.get(message) ?? { message, tables: [] }; if (!group.tables.includes(table.title)) group.tables.push(table.title); groups.set(message, group); } } return [...groups.values()]; }