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 { const shortage = /^Mês (\d+): existências insuficientes para as vendas declaradas\.$/.exec( issue, ); if (shortage) return `Balanço Projectado / Existências — mês ${shortage[1]}: stock insuficiente para as vendas declaradas. Confira «Existências iniciais», «Encomenda», «Prazo de recepcao» e «Unidades por mes» em «Planear stock por produto», ou as compras agregadas quando esse for o modo escolhido. Consulte a falta por produto no mapa de existências e corrija os pressupostos; as vendas não são reduzidas automaticamente.`; if ( issue === 'Existem períodos não reconciliados; reveja as rubricas indicadas.' ) return 'Balanço Projectado / Diferença do balanço: existem períodos não reconciliados. Consulte os meses desta linha e os diagnósticos específicos apresentados, incluindo existências, depreciação e dívida. Corrija os campos de origem indicados; a diferença, por si só, não identifica um único campo errado e não é compensada automaticamente.'; if ( issue === 'A soma das cobranças declaradas de recebíveis de abertura não pode exceder 100%.' ) return 'Fluxo de Caixa / Parcelas adicionais de recebíveis de abertura: a soma excede 100%. Corrija os campos «Percentagem do saldo inicial» das parcelas; inclua também a percentagem da cobrança única, se seleccionada. Não altere o saldo inicial apenas para fazer coincidir a distribuição.'; if ( issue === 'A soma das liquidações declaradas de valores a pagar não pode exceder 100%.' ) return 'Fluxo de Caixa / Liquidação de valores a pagar de abertura: a soma excede 100%. Corrija os campos «Percentagem do saldo inicial» dos pagamentos; o total não pode exceder 100%.'; if (issue === 'Cada recuperação deve ter um mês único dentro do horizonte.') return 'Fluxo de Caixa / Recuperação de vendas vencidas: confira os campos «Mês». Cada recuperação deve ter um mês diferente, dentro do horizonte do plano. Corrija o mês repetido ou remova a linha duplicada; as percentagens são aplicadas ao saldo vencido, não somadas como parcelas do saldo inicial.'; 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()]; }