feat: apply owner warning decisions and add editable annual planning example
This commit is contained in:
@@ -10361,3 +10361,10 @@ Candidata isolada `qa/continuidade-investimento-20261120`, base servida `bae996e
|
|||||||
Verificações: 1 990 frontend, com 1 989 aprovados na ronda geral e o teste de manifesto aprovado depois com o caminho QA correcto; HTTP financeiro/planos/tesouraria 7/155 e comparação jurídica 10/193 na base nova `continuity_20261120_test:55441`; tipos/lint/Pint/build aprovados. Acesso visual bloqueado pelo conector e alternativa nativa; não declarar demonstração integral Hotel/Agronegócio. Novo relatório de onze tabelas, avisos, exemplo e CAE até nível 5 permanecem pendentes; três divergências concretas do anexo aguardam resposta.
|
Verificações: 1 990 frontend, com 1 989 aprovados na ronda geral e o teste de manifesto aprovado depois com o caminho QA correcto; HTTP financeiro/planos/tesouraria 7/155 e comparação jurídica 10/193 na base nova `continuity_20261120_test:55441`; tipos/lint/Pint/build aprovados. Acesso visual bloqueado pelo conector e alternativa nativa; não declarar demonstração integral Hotel/Agronegócio. Novo relatório de onze tabelas, avisos, exemplo e CAE até nível 5 permanecem pendentes; três divergências concretas do anexo aguardam resposta.
|
||||||
|
|
||||||
Incidente aberto: uma suite com RefreshDatabase reinicializou indevidamente a base sintética anterior `investor_intent_20261115_test`; zero utilizadores encontrados depois. Activo e ficheiros de provas anteriores preservados. Restauro exacto não demonstrado; não confundir scripts/JSON de fixtures com recuperação do histórico completo. A equipa foi informada e os testes seguintes passaram para a base nova. Detalhes, causas, saldo 4.1–4.9, oito prioridades do segundo anexo e limites em `../v2/auditoria-portal/apresentacao-contexto-qa-20261115.md`, aditamento 20/11. Matriz existente actualizada sem encerrar requisitos globais ou revogar provas anteriores.
|
Incidente aberto: uma suite com RefreshDatabase reinicializou indevidamente a base sintética anterior `investor_intent_20261115_test`; zero utilizadores encontrados depois. Activo e ficheiros de provas anteriores preservados. Restauro exacto não demonstrado; não confundir scripts/JSON de fixtures com recuperação do histórico completo. A equipa foi informada e os testes seguintes passaram para a base nova. Detalhes, causas, saldo 4.1–4.9, oito prioridades do segundo anexo e limites em `../v2/auditoria-portal/apresentacao-contexto-qa-20261115.md`, aditamento 20/11. Matriz existente actualizada sem encerrar requisitos globais ou revogar provas anteriores.
|
||||||
|
### 20/11/2026 — decisões recebidas e delta de avisos/exemplo
|
||||||
|
|
||||||
|
O proprietário respondeu às três divergências: financiamento insuficiente é aviso em todos os planos; crescimento >100% permitido com aviso; exemplo conserva totais anuais e identifica linhas mensais por reconciliar. Esta decisão substitui as três pendências anteriores, sem reabrir aprovações.
|
||||||
|
|
||||||
|
Implementados avisos dispensáveis e não bloqueantes, meta de crescimento no mesmo snapshot/relatório e cenário anual de exemplo editável. Cálculos exactos de arranque/activos/financiamento/margens/resultados/caixa; ponto de equilíbrio com valores sem arredondamento intermédio; primeiro ano sem erros bloqueantes e com avisos de prejuízo e vendas abaixo do equilíbrio. O cenário é uma demonstração local: não substitui nem grava automaticamente os dados do investimento e não activa taxas. O selector comum deixa de mostrar UUIDs de escolhas antigas, preservando valores e assinalando a designação por recuperar. Sem equivalência CAE presumida.
|
||||||
|
|
||||||
|
96 testes frontend focados e API 1/9 aprovados, tipos/lint/Pint aprovados; build QA em decisions-build.log. Relatório integral de onze tabelas, todas as recolhas/validações, CAE de nível 5 e conferência visual continuam pendentes. Limites de avisos parametrizáveis em código, sem editor persistente de configuração na interface. Incidente do QA anterior mantém-se aberto. Sem instalação ou nova migração. Detalhes e provas no aditamento de mesma data em apresentacao-contexto-qa-20261115.md; matriz existente actualizada.
|
||||||
@@ -415,3 +415,20 @@ Uma execução incluiu indevidamente `CompanyComparisonTest`, com `RefreshDataba
|
|||||||
Não foi localizado um backup exacto nas localizações consultadas. Não se declara restauro nem se recriam histórias como se fossem originais. A recuperação exacta permanece por resolver; as fixtures antigas em JSON/scripts não bastam para certificar o histórico completo. A equipa foi informada. Testes posteriores passaram a usar exclusivamente a base nova `continuity_20261120_test`; o router QA foi vinculado a essa identidade. Bootstrap explícito garante que a junction de vendor partilha dependências, sem carregar classes App/Tests da pasta principal. A primeira ronda que carregou classes antigas por essa junction foi invalidada, diagnosticada e repetida com as fontes correctas.
|
Não foi localizado um backup exacto nas localizações consultadas. Não se declara restauro nem se recriam histórias como se fossem originais. A recuperação exacta permanece por resolver; as fixtures antigas em JSON/scripts não bastam para certificar o histórico completo. A equipa foi informada. Testes posteriores passaram a usar exclusivamente a base nova `continuity_20261120_test`; o router QA foi vinculado a essa identidade. Bootstrap explícito garante que a junction de vendor partilha dependências, sem carregar classes App/Tests da pasta principal. A primeira ronda que carregou classes antigas por essa junction foi invalidada, diagnosticada e repetida com as fontes correctas.
|
||||||
|
|
||||||
**Estado final deste recorte:** parcialmente implementado e testado em QA, sem instalação. Matriz existente actualizada nas linhas pertinentes. Pendentes: recuperação exacta do QA anterior, três decisões concretas, implementação dos restantes requisitos e conferência integral dos percursos antes de qualquer autorização de entrega.
|
**Estado final deste recorte:** parcialmente implementado e testado em QA, sem instalação. Matriz existente actualizada nas linhas pertinentes. Pendentes: recuperação exacta do QA anterior, três decisões concretas, implementação dos restantes requisitos e conferência integral dos percursos antes de qualquer autorização de entrega.
|
||||||
|
## 20/11/2026 — decisões respondidas: avisos e cenário anual
|
||||||
|
|
||||||
|
As três perguntas do aditamento anterior foram respondidas expressamente pelo proprietário. Substituem apenas os pontos contraditórios identificados; não são pendências de decisão nem exigem nova confirmação:
|
||||||
|
|
||||||
|
1. **Financiamento insuficiente é aviso em todos os planos.** Pode prosseguir e produzir o relatório, preservando o montante por financiar; não se presume financiamento mobilizado.
|
||||||
|
2. **Crescimento anual superior a 100% é permitido, com aviso não bloqueante.** A validação de percentagens limitadas a 100% continua aplicável às percentagens cuja natureza o exige, não a esta meta de crescimento.
|
||||||
|
3. **O cenário conserva os totais anuais explicitamente definidos.** As linhas mensais divergentes ficam por reconciliar; não preencher diferenças ou distribuir valores presumidos pelos meses.
|
||||||
|
|
||||||
|
Implementação nesta continuação: avisos financeiros distintos dos erros, dispensáveis e reexibidos quando os pressupostos mudam; falta de financiamento e crescimento elevado não desactivam o cálculo ou o relatório. Limites de orientação parametrizáveis no helper comum, com os valores iniciais do anexo; ainda sem editor de configuração persistente na interface. A meta anual é editável, guardada no mesmo snapshot e apresentada no dossier/CSV, sem sobrescrever agendas mensais deliberadas. O teste HTTP conserva 250% numa nova sessão.
|
||||||
|
|
||||||
|
No plano financeiro, «Carregar cenário anual de exemplo» abre uma demonstração editável. Usa os montantes anuais fornecidos, sem assumir a moeda nem substituir os dados do investimento. Calcula arranque 1.325.000, activos 500.250, necessidade 1.825.250 e montante disponível zero; em 2025, margem bruta 1.999, despesas operacionais 2.415, resultado −416, fluxo líquido 756 e caixa final 90.756. Em 2026/2027, lucros líquidos 1.456/1.631 e caixa final 91.763/93.498. Ponto de equilíbrio inicial calculado com a fracção sem arredondamento intermédio: 1.463,517… (1.464 em unidades inteiras). A demonstração inicial apresenta os avisos exigidos e nenhum erro bloqueante. Campos inválidos conservam as edições e mostram erros. Totais e indicadores dependentes actualizam-se a partir dos mesmos dados.
|
||||||
|
|
||||||
|
Limite concreto: o exemplo é um ensaio local, não uma simulação fiscal oficial, nem um preenchimento automático do dossier; as edições da demonstração não são persistidas como plano do investimento. Este incremento não entrega ainda o relatório integral de onze tabelas, o balanço/rácios completos, a estrutura guiada de todos os dados ou as séries mensais por reconciliar. Não atribui os números da Tempo à oportunidade Hotel ou Agronegócio do investidor. Impostos são os montantes expressos no exemplo, não taxas activadas por importação.
|
||||||
|
|
||||||
|
Correcção adicional do padrão citado no anexo: o selector comum conserva um valor antigo sem expor o seu UUID ou texto de depuração. Quando não consegue recuperar a designação, mostra «Escolha guardada — designação por recuperar». Não elimina a escolha nem inventa uma equivalência CAE. A auto-associação hoteleira até nível 5 continua por implementar/demonstrar com correspondências documentadas.
|
||||||
|
|
||||||
|
Verificações do delta: 96 testes frontend focados, incluindo os novos testes de fórmulas do exemplo, limiares, avisos dispensáveis, ausência de erros iniciais, metas >100%, continuidade das edições, relatório e protecção dos agregados. Um teste HTTP/9 asserções de gravação e recuperação dos dois dossiers com meta de 250%, em `continuity_20261120_test:55441`, com rollback. Tipos/lint focado/Pint aprovados; compilação registada separadamente em `outputs/continuity-20261120/decisions-build.log`. Não se repetiu a bateria geral aceite de 1.990 testes. Estes ensaios não substituem o navegador, cujo impedimento anterior não foi ultrapassado. Incidente do QA antigo continua aberto, sem alegação de restauro. Sem instalação, nova migração ou alterações no activo.
|
||||||
File diff suppressed because one or more lines are too long
@@ -0,0 +1,53 @@
|
|||||||
|
import { useState } from 'react';
|
||||||
|
import {
|
||||||
|
businessPlanWarnings,
|
||||||
|
type PlanWarningMetrics,
|
||||||
|
type PlanWarningLimits,
|
||||||
|
} from '@/lib/business-plan-guidance';
|
||||||
|
|
||||||
|
export function BusinessPlanWarnings({
|
||||||
|
metrics,
|
||||||
|
limits,
|
||||||
|
}: {
|
||||||
|
metrics: PlanWarningMetrics;
|
||||||
|
limits?: PlanWarningLimits;
|
||||||
|
}) {
|
||||||
|
const [dismissed, setDismissed] = useState<string[]>([]);
|
||||||
|
const scope = JSON.stringify(metrics);
|
||||||
|
const warnings = businessPlanWarnings(metrics, limits).filter(
|
||||||
|
(warning) => !dismissed.includes(`${scope}:${warning.id}`),
|
||||||
|
);
|
||||||
|
if (!warnings.length) return null;
|
||||||
|
return (
|
||||||
|
<aside
|
||||||
|
aria-label="Avisos de planeamento"
|
||||||
|
className="my-3 space-y-2 rounded border border-amber-400 bg-amber-50 p-3 text-sm text-amber-950"
|
||||||
|
>
|
||||||
|
<h4 className="font-semibold">Avisos — pode continuar</h4>
|
||||||
|
{warnings.map((warning) => (
|
||||||
|
<div
|
||||||
|
key={warning.id}
|
||||||
|
className="flex items-start justify-between gap-3"
|
||||||
|
>
|
||||||
|
<p role="status">
|
||||||
|
<span aria-hidden="true">⚠ </span>
|
||||||
|
{warning.message}
|
||||||
|
</p>
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className="shrink-0 underline"
|
||||||
|
aria-label={`Dispensar aviso: ${warning.message}`}
|
||||||
|
onClick={() =>
|
||||||
|
setDismissed((previous) => [
|
||||||
|
...previous,
|
||||||
|
`${scope}:${warning.id}`,
|
||||||
|
])
|
||||||
|
}
|
||||||
|
>
|
||||||
|
Dispensar
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</aside>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -43,7 +43,7 @@ export default function CatalogueChoiceSelect({
|
|||||||
id: value,
|
id: value,
|
||||||
name:
|
name:
|
||||||
selected?.label ??
|
selected?.label ??
|
||||||
`${value} — valor anterior; confirme a selecção`,
|
'Escolha guardada — designação por recuperar',
|
||||||
}
|
}
|
||||||
: undefined
|
: undefined
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,311 @@
|
|||||||
|
import { useState } from 'react';
|
||||||
|
import {
|
||||||
|
calculateAnnualReferencePlan,
|
||||||
|
newAnnualReferencePlan,
|
||||||
|
type AnnualReferencePlan,
|
||||||
|
} from '@/lib/business-plan-guidance';
|
||||||
|
import { businessPlanNumberError } from '@/lib/business-financial-plan';
|
||||||
|
import { BusinessPlanWarnings } from './business-plan-warnings';
|
||||||
|
|
||||||
|
const annualLabels = {
|
||||||
|
sales: 'Vendas previstas',
|
||||||
|
directCosts: 'Custo directo das vendas',
|
||||||
|
payroll: 'Folha de pagamento',
|
||||||
|
payrollCharges: 'Encargos da folha de pagamento',
|
||||||
|
otherOperatingExpenses: 'Outras despesas operacionais',
|
||||||
|
interest: 'Juros',
|
||||||
|
taxes: 'Impostos estimados do exemplo',
|
||||||
|
cashReceived: 'Caixa recebida',
|
||||||
|
cashSpent: 'Caixa gasta',
|
||||||
|
} as const;
|
||||||
|
const openingLabels = {
|
||||||
|
openingCash: 'Caixa necessária',
|
||||||
|
otherCurrentAssets: 'Outros activos correntes',
|
||||||
|
longTermAssets: 'Activos de longo prazo',
|
||||||
|
ownerCapital: 'Capital do proprietário disponível',
|
||||||
|
investorCapital: 'Capital do investidor disponível',
|
||||||
|
loans: 'Empréstimos disponíveis',
|
||||||
|
additionalMoney: 'Dinheiro adicional angariado',
|
||||||
|
} as const;
|
||||||
|
function ExampleNumber({
|
||||||
|
label,
|
||||||
|
value,
|
||||||
|
onChange,
|
||||||
|
}: {
|
||||||
|
label: string;
|
||||||
|
value: string;
|
||||||
|
onChange: (value: string) => void;
|
||||||
|
}) {
|
||||||
|
const error = businessPlanNumberError(value);
|
||||||
|
return (
|
||||||
|
<label className="grid gap-1 text-sm">
|
||||||
|
{label}
|
||||||
|
<input
|
||||||
|
type="number"
|
||||||
|
min="0"
|
||||||
|
step="0.01"
|
||||||
|
className="min-w-0 rounded border p-2"
|
||||||
|
value={value}
|
||||||
|
aria-invalid={!!error}
|
||||||
|
onChange={(event) => onChange(event.target.value)}
|
||||||
|
/>
|
||||||
|
{error && (
|
||||||
|
<span role="alert" className="text-red-800">
|
||||||
|
{error}
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
|
</label>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
export function SimulationAnnualExample({ currency }: { currency: string }) {
|
||||||
|
const [plan, setPlan] = useState<AnnualReferencePlan>(
|
||||||
|
newAnnualReferencePlan,
|
||||||
|
);
|
||||||
|
let result: ReturnType<typeof calculateAnnualReferencePlan> | undefined;
|
||||||
|
let error = '';
|
||||||
|
try {
|
||||||
|
result = calculateAnnualReferencePlan(plan);
|
||||||
|
} catch (cause) {
|
||||||
|
error =
|
||||||
|
cause instanceof Error
|
||||||
|
? cause.message
|
||||||
|
: 'Reveja os campos do exemplo.';
|
||||||
|
}
|
||||||
|
const amount = (value: string | number | null) =>
|
||||||
|
value === null
|
||||||
|
? 'Por determinar'
|
||||||
|
: Number(value).toLocaleString('pt-MZ', {
|
||||||
|
minimumFractionDigits: 2,
|
||||||
|
maximumFractionDigits: 2,
|
||||||
|
});
|
||||||
|
return (
|
||||||
|
<section
|
||||||
|
aria-label="Cenário anual de exemplo"
|
||||||
|
className="my-4 space-y-4 rounded border border-sky-400 bg-sky-50 p-4"
|
||||||
|
>
|
||||||
|
<h4 className="text-lg font-semibold">
|
||||||
|
Cenário anual de exemplo — editável
|
||||||
|
</h4>
|
||||||
|
<p className="text-sm">
|
||||||
|
Valores fornecidos no plano de referência. Moeda de
|
||||||
|
apresentação: {currency || 'por seleccionar no plano'}. As
|
||||||
|
edições deste ensaio ficam nesta demonstração; os dados do
|
||||||
|
investimento continuam no seu formulário.
|
||||||
|
</p>
|
||||||
|
<p className="rounded border border-amber-400 p-3 text-sm">
|
||||||
|
Linhas mensais por reconciliar. Conservam-se os totais anuais
|
||||||
|
definidos pelo proprietário; não se distribuem valores pelos
|
||||||
|
meses nem se completam linhas em falta. Os impostos são
|
||||||
|
montantes do exemplo, sem activar taxas fiscais.
|
||||||
|
</p>
|
||||||
|
<details open>
|
||||||
|
<summary className="font-semibold">
|
||||||
|
Despesas e activos iniciais
|
||||||
|
</summary>
|
||||||
|
<div className="mt-3 grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
|
||||||
|
{plan.startupExpenses.map((row, index) => (
|
||||||
|
<ExampleNumber
|
||||||
|
key={row.label}
|
||||||
|
label={row.label}
|
||||||
|
value={row.amount}
|
||||||
|
onChange={(value) =>
|
||||||
|
setPlan((previous) => ({
|
||||||
|
...previous,
|
||||||
|
startupExpenses:
|
||||||
|
previous.startupExpenses.map(
|
||||||
|
(entry, i) =>
|
||||||
|
i === index
|
||||||
|
? {
|
||||||
|
...entry,
|
||||||
|
amount: value,
|
||||||
|
}
|
||||||
|
: entry,
|
||||||
|
),
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
))}
|
||||||
|
{Object.entries(openingLabels).map(([key, label]) => (
|
||||||
|
<ExampleNumber
|
||||||
|
key={key}
|
||||||
|
label={label}
|
||||||
|
value={plan[key as keyof typeof openingLabels]}
|
||||||
|
onChange={(value) =>
|
||||||
|
setPlan((previous) => ({
|
||||||
|
...previous,
|
||||||
|
[key]: value,
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
</details>
|
||||||
|
{plan.years.map((year, index) => (
|
||||||
|
<details key={year.year}>
|
||||||
|
<summary className="font-semibold">
|
||||||
|
Pressupostos anuais — {year.year}
|
||||||
|
</summary>
|
||||||
|
<div className="mt-3 grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
|
||||||
|
{Object.entries(annualLabels).map(([key, label]) => (
|
||||||
|
<ExampleNumber
|
||||||
|
key={key}
|
||||||
|
label={label}
|
||||||
|
value={year[key as keyof typeof annualLabels]}
|
||||||
|
onChange={(value) =>
|
||||||
|
setPlan((previous) => ({
|
||||||
|
...previous,
|
||||||
|
years: previous.years.map((entry, i) =>
|
||||||
|
i === index
|
||||||
|
? { ...entry, [key]: value }
|
||||||
|
: entry,
|
||||||
|
),
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
</details>
|
||||||
|
))}
|
||||||
|
{error && (
|
||||||
|
<p
|
||||||
|
role="alert"
|
||||||
|
className="rounded border border-red-400 bg-red-50 p-3 text-red-900"
|
||||||
|
>
|
||||||
|
{error} Os valores introduzidos permanecem nos campos.
|
||||||
|
</p>
|
||||||
|
)}
|
||||||
|
{result && (
|
||||||
|
<>
|
||||||
|
<dl className="grid gap-3 sm:grid-cols-2">
|
||||||
|
{[
|
||||||
|
[
|
||||||
|
'Despesas totais de arranque',
|
||||||
|
result.startupExpenses,
|
||||||
|
],
|
||||||
|
['Total de activos iniciais', result.assets],
|
||||||
|
[
|
||||||
|
'Financiamento total requerido',
|
||||||
|
result.requiredFunding,
|
||||||
|
],
|
||||||
|
[
|
||||||
|
'Financiamento disponível',
|
||||||
|
result.availableFunding,
|
||||||
|
],
|
||||||
|
].map(([label, value]) => (
|
||||||
|
<div key={label}>
|
||||||
|
<dt>{label}</dt>
|
||||||
|
<dd className="font-semibold">
|
||||||
|
{amount(value)} {currency}
|
||||||
|
</dd>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</dl>
|
||||||
|
<div className="overflow-x-auto">
|
||||||
|
<table className="w-full text-left text-sm">
|
||||||
|
<caption className="py-2 text-left font-semibold">
|
||||||
|
Resultados anuais do exemplo{' '}
|
||||||
|
{currency && `(${currency})`}
|
||||||
|
</caption>
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Resultado</th>
|
||||||
|
{result.years.map((year) => (
|
||||||
|
<th key={year.year}>{year.year}</th>
|
||||||
|
))}
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
{(
|
||||||
|
[
|
||||||
|
'sales',
|
||||||
|
'directCosts',
|
||||||
|
'grossMargin',
|
||||||
|
'grossMarginPercent',
|
||||||
|
'operatingExpenses',
|
||||||
|
'operatingProfit',
|
||||||
|
'netProfit',
|
||||||
|
'monthlyFixedCosts',
|
||||||
|
'monthlyBreakEven',
|
||||||
|
'cashFlow',
|
||||||
|
'closingCash',
|
||||||
|
] as const
|
||||||
|
).map((key) => (
|
||||||
|
<tr key={key}>
|
||||||
|
<th className="py-1 font-medium">
|
||||||
|
{
|
||||||
|
{
|
||||||
|
sales: 'Vendas',
|
||||||
|
directCosts:
|
||||||
|
'Custo directo das vendas',
|
||||||
|
grossMargin: 'Margem bruta',
|
||||||
|
grossMarginPercent:
|
||||||
|
'Margem bruta (%)',
|
||||||
|
operatingExpenses:
|
||||||
|
'Despesas operacionais',
|
||||||
|
operatingProfit:
|
||||||
|
'Lucro antes de juros e impostos',
|
||||||
|
netProfit: 'Lucro líquido',
|
||||||
|
monthlyFixedCosts:
|
||||||
|
'Custo fixo mensal estimado',
|
||||||
|
monthlyBreakEven:
|
||||||
|
'Ponto de equilíbrio mensal',
|
||||||
|
cashFlow:
|
||||||
|
'Fluxo líquido de caixa',
|
||||||
|
closingCash:
|
||||||
|
'Saldo de caixa',
|
||||||
|
}[key]
|
||||||
|
}
|
||||||
|
</th>
|
||||||
|
{result.years.map((year) => (
|
||||||
|
<td key={year.year}>
|
||||||
|
{amount(year[key])}
|
||||||
|
</td>
|
||||||
|
))}
|
||||||
|
</tr>
|
||||||
|
))}
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
{result.years.map((year, index) => (
|
||||||
|
<div key={year.year}>
|
||||||
|
<h5 className="font-semibold">
|
||||||
|
Avisos — {year.year}
|
||||||
|
</h5>
|
||||||
|
<BusinessPlanWarnings
|
||||||
|
metrics={{
|
||||||
|
currency,
|
||||||
|
fundingGap:
|
||||||
|
index === 0
|
||||||
|
? Number(result.fundingGap)
|
||||||
|
: undefined,
|
||||||
|
netProfit: Number(year.netProfit),
|
||||||
|
sales: Number(year.sales),
|
||||||
|
directCosts: Number(year.directCosts),
|
||||||
|
monthlyBreakEven: year.monthlyBreakEven,
|
||||||
|
monthlyExpenses:
|
||||||
|
Number(year.operatingExpenses) / 12,
|
||||||
|
cash: Number(year.closingCash),
|
||||||
|
growthPercent:
|
||||||
|
year.growthPercent ?? undefined,
|
||||||
|
ownAndInvestorCapital:
|
||||||
|
index === 0
|
||||||
|
? Number(plan.ownerCapital) +
|
||||||
|
Number(plan.investorCapital)
|
||||||
|
: undefined,
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
<p className="text-sm">
|
||||||
|
Margem bruta = vendas − custo directo. Lucro líquido =
|
||||||
|
margem bruta − despesas operacionais − juros − impostos.
|
||||||
|
Ponto de equilíbrio = (despesas operacionais ÷ 12) ÷
|
||||||
|
(margem bruta ÷ vendas), sem arredondar os valores
|
||||||
|
intermédios. Caixa final = caixa anterior + recebimentos
|
||||||
|
− pagamentos.
|
||||||
|
</p>
|
||||||
|
</>
|
||||||
|
)}
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -18,6 +18,8 @@ import {
|
|||||||
simulationCurrencyOptions,
|
simulationCurrencyOptions,
|
||||||
} from '@/lib/simulation-contract';
|
} from '@/lib/simulation-contract';
|
||||||
import { buildFinancialFiscalBridge } from '@/lib/financial-fiscal-bridge';
|
import { buildFinancialFiscalBridge } from '@/lib/financial-fiscal-bridge';
|
||||||
|
import { BusinessPlanWarnings } from '@/components/business-plan-warnings';
|
||||||
|
import { SimulationAnnualExample } from '@/components/simulation-annual-example';
|
||||||
|
|
||||||
const emptyPlan: BusinessFinancialPlanInput = {
|
const emptyPlan: BusinessFinancialPlanInput = {
|
||||||
currency: '',
|
currency: '',
|
||||||
@@ -76,16 +78,19 @@ function MoneyInput({
|
|||||||
onChange,
|
onChange,
|
||||||
allowNegative = false,
|
allowNegative = false,
|
||||||
step = '0.01',
|
step = '0.01',
|
||||||
|
optional = false,
|
||||||
}: {
|
}: {
|
||||||
label: string;
|
label: string;
|
||||||
value: string;
|
value: string;
|
||||||
onChange: (value: string) => void;
|
onChange: (value: string) => void;
|
||||||
allowNegative?: boolean;
|
allowNegative?: boolean;
|
||||||
step?: string;
|
step?: string;
|
||||||
|
optional?: boolean;
|
||||||
}) {
|
}) {
|
||||||
const errorId = useId();
|
const errorId = useId();
|
||||||
const [touched, setTouched] = useState(false);
|
const [touched, setTouched] = useState(false);
|
||||||
const error = touched
|
const error =
|
||||||
|
touched && (!optional || value.trim() !== '')
|
||||||
? businessPlanNumberError(value, { allowNegative })
|
? businessPlanNumberError(value, { allowNegative })
|
||||||
: '';
|
: '';
|
||||||
return (
|
return (
|
||||||
@@ -139,6 +144,7 @@ export function SimulationBusinessPlan({
|
|||||||
);
|
);
|
||||||
const [workingPlan, setWorkingPlan] =
|
const [workingPlan, setWorkingPlan] =
|
||||||
useState<BusinessFinancialPlanInput | null>(null);
|
useState<BusinessFinancialPlanInput | null>(null);
|
||||||
|
const [showExample, setShowExample] = useState(false);
|
||||||
useEffect(() => setWorkingPlan(null), [snapshot]);
|
useEffect(() => setWorkingPlan(null), [snapshot]);
|
||||||
if (hasOversizedStoredSnapshot) {
|
if (hasOversizedStoredSnapshot) {
|
||||||
return (
|
return (
|
||||||
@@ -914,6 +920,16 @@ export function SimulationBusinessPlan({
|
|||||||
separados. Não calcula impostos, não converte moedas e não
|
separados. Não calcula impostos, não converte moedas e não
|
||||||
substitui um plano contabilístico validado.
|
substitui um plano contabilístico validado.
|
||||||
</p>
|
</p>
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className="rounded border px-3 py-2 text-sm"
|
||||||
|
onClick={() => setShowExample((previous) => !previous)}
|
||||||
|
>
|
||||||
|
{showExample
|
||||||
|
? 'Fechar cenário de exemplo'
|
||||||
|
: 'Carregar cenário anual de exemplo'}
|
||||||
|
</button>
|
||||||
|
{showExample && <SimulationAnnualExample currency={currency} />}
|
||||||
<div className="my-3 flex flex-wrap items-end gap-3 rounded border p-3">
|
<div className="my-3 flex flex-wrap items-end gap-3 rounded border p-3">
|
||||||
<label className="grid gap-1 text-sm">
|
<label className="grid gap-1 text-sm">
|
||||||
Importar plano financeiro InvestMoz (.json, até 60 KB)
|
Importar plano financeiro InvestMoz (.json, até 60 KB)
|
||||||
@@ -957,6 +973,17 @@ export function SimulationBusinessPlan({
|
|||||||
}
|
}
|
||||||
/>
|
/>
|
||||||
</label>
|
</label>
|
||||||
|
<MoneyInput
|
||||||
|
optional
|
||||||
|
label="Crescimento anual pretendido (%)"
|
||||||
|
value={plan.annualGrowthPercent ?? ''}
|
||||||
|
onChange={(value) => update('annualGrowthPercent', value)}
|
||||||
|
/>
|
||||||
|
<p className="text-sm">
|
||||||
|
A meta de crescimento pode exceder 100%, com aviso. É uma
|
||||||
|
hipótese declarada; as agendas de vendas introduzidas mantêm
|
||||||
|
os seus valores.
|
||||||
|
</p>
|
||||||
|
|
||||||
<p className="text-sm text-slate-700">
|
<p className="text-sm text-slate-700">
|
||||||
O plano financeiro aceita moedas ISO suportadas com duas
|
O plano financeiro aceita moedas ISO suportadas com duas
|
||||||
@@ -2498,12 +2525,18 @@ export function SimulationBusinessPlan({
|
|||||||
>
|
>
|
||||||
Exportar plano em CSV
|
Exportar plano em CSV
|
||||||
</button>
|
</button>
|
||||||
|
<BusinessPlanWarnings
|
||||||
|
metrics={{
|
||||||
|
currency,
|
||||||
|
fundingGap: Number(result.fundingGap),
|
||||||
|
growthPercent: plan.annualGrowthPercent?.trim()
|
||||||
|
? Number(plan.annualGrowthPercent)
|
||||||
|
: undefined,
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
{result.fundingStatus !== 'shortfall' && (
|
||||||
<p
|
<p
|
||||||
role={
|
role="status"
|
||||||
result.fundingStatus === 'balanced'
|
|
||||||
? 'status'
|
|
||||||
: 'alert'
|
|
||||||
}
|
|
||||||
className={
|
className={
|
||||||
result.fundingStatus === 'balanced'
|
result.fundingStatus === 'balanced'
|
||||||
? 'rounded bg-emerald-50 p-3 text-sm'
|
? 'rounded bg-emerald-50 p-3 text-sm'
|
||||||
@@ -2512,10 +2545,9 @@ export function SimulationBusinessPlan({
|
|||||||
>
|
>
|
||||||
{result.fundingStatus === 'balanced'
|
{result.fundingStatus === 'balanced'
|
||||||
? 'As fontes de financiamento reconciliam com os usos iniciais.'
|
? 'As fontes de financiamento reconciliam com os usos iniciais.'
|
||||||
: result.fundingStatus === 'shortfall'
|
|
||||||
? `Falta financiar ${result.fundingGap} ${currency} dos usos iniciais.`
|
|
||||||
: `As fontes excedem os usos iniciais em ${result.fundingGap.replace('-', '')} ${currency}.`}
|
: `As fontes excedem os usos iniciais em ${result.fundingGap.replace('-', '')} ${currency}.`}
|
||||||
</p>
|
</p>
|
||||||
|
)}
|
||||||
<dl className="grid gap-2 sm:grid-cols-2 lg:grid-cols-3">
|
<dl className="grid gap-2 sm:grid-cols-2 lg:grid-cols-3">
|
||||||
{[
|
{[
|
||||||
['Fundo de maneio líquido', result.workingCapital],
|
['Fundo de maneio líquido', result.workingCapital],
|
||||||
|
|||||||
@@ -83,6 +83,7 @@ function validCurrency(value: string): boolean {
|
|||||||
|
|
||||||
export type BusinessFinancialPlanInput = {
|
export type BusinessFinancialPlanInput = {
|
||||||
currency: string;
|
currency: string;
|
||||||
|
annualGrowthPercent?: string;
|
||||||
presentationCurrency?: string;
|
presentationCurrency?: string;
|
||||||
fxRate?: string;
|
fxRate?: string;
|
||||||
fxDate?: string;
|
fxDate?: string;
|
||||||
@@ -523,6 +524,7 @@ export function restoreBusinessPlanSnapshot(
|
|||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
for (const field of [
|
for (const field of [
|
||||||
|
'annualGrowthPercent',
|
||||||
'presentationCurrency',
|
'presentationCurrency',
|
||||||
'fxRate',
|
'fxRate',
|
||||||
'fxDate',
|
'fxDate',
|
||||||
@@ -1252,6 +1254,15 @@ export function compareBusinessScenarios(input: BusinessFinancialPlanInput) {
|
|||||||
|
|
||||||
/** Forecast separates invoiced sales, collections, accounting expenses and cash payments. */
|
/** Forecast separates invoiced sales, collections, accounting expenses and cash payments. */
|
||||||
export function forecastBusinessPlan(input: BusinessFinancialPlanInput) {
|
export function forecastBusinessPlan(input: BusinessFinancialPlanInput) {
|
||||||
|
if (input.annualGrowthPercent?.trim()) {
|
||||||
|
if (
|
||||||
|
percentMicro(
|
||||||
|
input.annualGrowthPercent,
|
||||||
|
'Crescimento anual pretendido',
|
||||||
|
) < 0n
|
||||||
|
)
|
||||||
|
throw new Error('Este valor não pode ser negativo.');
|
||||||
|
}
|
||||||
if (!validCurrency(input.currency))
|
if (!validCurrency(input.currency))
|
||||||
throw new Error('Seleccione um código de moeda ISO suportado.');
|
throw new Error('Seleccione um código de moeda ISO suportado.');
|
||||||
const periods = input.periods ?? 12;
|
const periods = input.periods ?? 12;
|
||||||
@@ -2748,6 +2759,9 @@ export function exportBusinessPlanCsv(
|
|||||||
],
|
],
|
||||||
['Data de exportação', generatedAt],
|
['Data de exportação', generatedAt],
|
||||||
['Horizonte', `${input.periods ?? 12} meses`],
|
['Horizonte', `${input.periods ?? 12} meses`],
|
||||||
|
...(input.annualGrowthPercent?.trim()
|
||||||
|
? [['Crescimento anual pretendido (%)', input.annualGrowthPercent]]
|
||||||
|
: []),
|
||||||
['Moeda de cálculo', result.currency],
|
['Moeda de cálculo', result.currency],
|
||||||
['Moeda de apresentação', result.presentationCurrency],
|
['Moeda de apresentação', result.presentationCurrency],
|
||||||
[
|
[
|
||||||
|
|||||||
@@ -0,0 +1,295 @@
|
|||||||
|
export type PlanWarningLimits = {
|
||||||
|
grossMarginPercent: number;
|
||||||
|
cashExpenseMonths: number;
|
||||||
|
annualGrowthPercent: number;
|
||||||
|
creditDays: number;
|
||||||
|
debtAssetsPercent: number;
|
||||||
|
};
|
||||||
|
export const defaultPlanWarningLimits: PlanWarningLimits = {
|
||||||
|
grossMarginPercent: 15,
|
||||||
|
cashExpenseMonths: 1,
|
||||||
|
annualGrowthPercent: 100,
|
||||||
|
creditDays: 90,
|
||||||
|
debtAssetsPercent: 70,
|
||||||
|
};
|
||||||
|
export type PlanWarning = { id: string; message: string };
|
||||||
|
export type PlanWarningMetrics = {
|
||||||
|
fundingGap?: number;
|
||||||
|
currency?: string;
|
||||||
|
netProfit?: number;
|
||||||
|
sales?: number;
|
||||||
|
directCosts?: number;
|
||||||
|
monthlyBreakEven?: number | null;
|
||||||
|
monthlyExpenses?: number;
|
||||||
|
cash?: number;
|
||||||
|
growthPercent?: number;
|
||||||
|
creditDays?: number;
|
||||||
|
liabilities?: number;
|
||||||
|
assets?: number;
|
||||||
|
ownAndInvestorCapital?: number;
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Guidance only: warnings never change the inputs or determine validity. */
|
||||||
|
export function businessPlanWarnings(
|
||||||
|
metrics: PlanWarningMetrics,
|
||||||
|
limits: PlanWarningLimits = defaultPlanWarningLimits,
|
||||||
|
): PlanWarning[] {
|
||||||
|
const warnings: PlanWarning[] = [];
|
||||||
|
const add = (id: string, message: string) => warnings.push({ id, message });
|
||||||
|
if ((metrics.fundingGap ?? 0) > 0)
|
||||||
|
add(
|
||||||
|
'funding',
|
||||||
|
`O financiamento indicado não cobre o investimento necessário. Faltam ${metrics.fundingGap!.toLocaleString('pt-MZ', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}${metrics.currency ? ` ${metrics.currency}` : ''}.`,
|
||||||
|
);
|
||||||
|
if (metrics.netProfit !== undefined && metrics.netProfit < 0)
|
||||||
|
add(
|
||||||
|
'loss',
|
||||||
|
'Neste ano o negócio dá prejuízo. Reveja as vendas ou os custos, ou confirme que é o esperado.',
|
||||||
|
);
|
||||||
|
if (
|
||||||
|
metrics.sales !== undefined &&
|
||||||
|
metrics.sales > 0 &&
|
||||||
|
metrics.directCosts !== undefined
|
||||||
|
) {
|
||||||
|
if (
|
||||||
|
(100 * (metrics.sales - metrics.directCosts)) / metrics.sales <
|
||||||
|
limits.grossMarginPercent
|
||||||
|
)
|
||||||
|
add(
|
||||||
|
'margin',
|
||||||
|
'A margem bruta é baixa e deixa pouca folga para cobrir as despesas.',
|
||||||
|
);
|
||||||
|
if (
|
||||||
|
metrics.monthlyBreakEven != null &&
|
||||||
|
metrics.monthlyBreakEven > metrics.sales / 12
|
||||||
|
)
|
||||||
|
add(
|
||||||
|
'break-even',
|
||||||
|
'As vendas mensais médias não atingem o ponto de equilíbrio. O negócio só cobre os custos com mais vendas.',
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (
|
||||||
|
metrics.cash !== undefined &&
|
||||||
|
metrics.monthlyExpenses !== undefined &&
|
||||||
|
metrics.cash < metrics.monthlyExpenses * limits.cashExpenseMonths
|
||||||
|
)
|
||||||
|
add(
|
||||||
|
'cash',
|
||||||
|
'A caixa disponível cobre menos de um mês de despesas. Considere reforçar o financiamento.',
|
||||||
|
);
|
||||||
|
if (
|
||||||
|
metrics.growthPercent !== undefined &&
|
||||||
|
metrics.growthPercent > limits.annualGrowthPercent
|
||||||
|
)
|
||||||
|
add(
|
||||||
|
'growth',
|
||||||
|
'O crescimento indicado é muito elevado. Confirme que é realista.',
|
||||||
|
);
|
||||||
|
if (
|
||||||
|
metrics.creditDays !== undefined &&
|
||||||
|
metrics.creditDays > limits.creditDays
|
||||||
|
)
|
||||||
|
add(
|
||||||
|
'credit',
|
||||||
|
'Prazos de recebimento longos pressionam a caixa. Confirme o prazo indicado.',
|
||||||
|
);
|
||||||
|
if (
|
||||||
|
metrics.assets !== undefined &&
|
||||||
|
metrics.assets > 0 &&
|
||||||
|
metrics.liabilities !== undefined &&
|
||||||
|
(metrics.liabilities / metrics.assets) * 100 > limits.debtAssetsPercent
|
||||||
|
)
|
||||||
|
add(
|
||||||
|
'debt',
|
||||||
|
'O peso das dívidas é elevado e pode dificultar o acesso a crédito.',
|
||||||
|
);
|
||||||
|
if (metrics.ownAndInvestorCapital === 0)
|
||||||
|
add(
|
||||||
|
'capital',
|
||||||
|
'Não indicou capital próprio nem de investidor. Todo o financiamento vem de empréstimos ou fica por definir.',
|
||||||
|
);
|
||||||
|
return warnings;
|
||||||
|
}
|
||||||
|
|
||||||
|
export type AnnualReferencePlan = {
|
||||||
|
startupExpenses: { label: string; amount: string }[];
|
||||||
|
openingCash: string;
|
||||||
|
otherCurrentAssets: string;
|
||||||
|
longTermAssets: string;
|
||||||
|
ownerCapital: string;
|
||||||
|
investorCapital: string;
|
||||||
|
loans: string;
|
||||||
|
additionalMoney: string;
|
||||||
|
years: {
|
||||||
|
year: number;
|
||||||
|
sales: string;
|
||||||
|
directCosts: string;
|
||||||
|
payroll: string;
|
||||||
|
payrollCharges: string;
|
||||||
|
otherOperatingExpenses: string;
|
||||||
|
interest: string;
|
||||||
|
taxes: string;
|
||||||
|
cashReceived: string;
|
||||||
|
cashSpent: string;
|
||||||
|
}[];
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Values explicitly supplied by the owner; currency must be chosen in the form. */
|
||||||
|
export function newAnnualReferencePlan(): AnnualReferencePlan {
|
||||||
|
return {
|
||||||
|
startupExpenses: [
|
||||||
|
{ label: 'Constituição da sociedade', amount: '25000' },
|
||||||
|
{ label: 'Material de escritório', amount: '50000' },
|
||||||
|
{ label: 'Seguros', amount: '0' },
|
||||||
|
{ label: 'Rendas', amount: '0' },
|
||||||
|
{ label: 'Computadores', amount: '250000' },
|
||||||
|
{ label: 'Desenvolvimento do portal', amount: '1000000' },
|
||||||
|
],
|
||||||
|
openingCash: '90000',
|
||||||
|
otherCurrentAssets: '150000',
|
||||||
|
longTermAssets: '260250',
|
||||||
|
ownerCapital: '0',
|
||||||
|
investorCapital: '0',
|
||||||
|
loans: '0',
|
||||||
|
additionalMoney: '0',
|
||||||
|
years: [
|
||||||
|
{
|
||||||
|
year: 2025,
|
||||||
|
sales: '14537',
|
||||||
|
directCosts: '12538',
|
||||||
|
payroll: '2100',
|
||||||
|
payrollCharges: '315',
|
||||||
|
otherOperatingExpenses: '0',
|
||||||
|
interest: '0',
|
||||||
|
taxes: '0',
|
||||||
|
cashReceived: '16539',
|
||||||
|
cashSpent: '15783',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
year: 2026,
|
||||||
|
sales: '21500',
|
||||||
|
directCosts: '16200',
|
||||||
|
payroll: '2800',
|
||||||
|
payrollCharges: '420',
|
||||||
|
otherOperatingExpenses: '0',
|
||||||
|
interest: '0',
|
||||||
|
taxes: '624',
|
||||||
|
cashReceived: '24930',
|
||||||
|
cashSpent: '23923',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
year: 2027,
|
||||||
|
sales: '23875',
|
||||||
|
directCosts: '18325',
|
||||||
|
payroll: '2800',
|
||||||
|
payrollCharges: '420',
|
||||||
|
otherOperatingExpenses: '0',
|
||||||
|
interest: '0',
|
||||||
|
taxes: '699',
|
||||||
|
cashReceived: '27857',
|
||||||
|
cashSpent: '26122',
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function money(value: string): bigint {
|
||||||
|
if (value.length > 40 || !/^\d+(?:\.\d{1,2})?$/.test(value.trim()))
|
||||||
|
throw new Error(
|
||||||
|
value.trim() === ''
|
||||||
|
? 'Preencha este campo para continuar.'
|
||||||
|
: Number(value) < 0
|
||||||
|
? 'Este valor não pode ser negativo.'
|
||||||
|
: 'Introduza apenas números (ex.: 25.000).',
|
||||||
|
);
|
||||||
|
const [whole, fraction = ''] = value.trim().split('.');
|
||||||
|
return BigInt(whole) * 100n + BigInt(fraction.padEnd(2, '0'));
|
||||||
|
}
|
||||||
|
function decimal(value: bigint): string {
|
||||||
|
const abs = value < 0n ? -value : value;
|
||||||
|
return `${value < 0n ? '-' : ''}${abs / 100n}.${String(abs % 100n).padStart(2, '0')}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function calculateAnnualReferencePlan(plan: AnnualReferencePlan) {
|
||||||
|
const startupExpenses = plan.startupExpenses.reduce(
|
||||||
|
(sum, row) => sum + money(row.amount),
|
||||||
|
0n,
|
||||||
|
);
|
||||||
|
const openingCash = money(plan.openingCash);
|
||||||
|
const assets =
|
||||||
|
openingCash +
|
||||||
|
money(plan.otherCurrentAssets) +
|
||||||
|
money(plan.longTermAssets);
|
||||||
|
const requiredFunding = startupExpenses + assets;
|
||||||
|
const availableFunding =
|
||||||
|
money(plan.ownerCapital) +
|
||||||
|
money(plan.investorCapital) +
|
||||||
|
money(plan.loans) +
|
||||||
|
money(plan.additionalMoney);
|
||||||
|
let cash = openingCash;
|
||||||
|
const years = plan.years.map((year, index) => {
|
||||||
|
const sales = money(year.sales),
|
||||||
|
costs = money(year.directCosts);
|
||||||
|
if (sales === 0n && costs > 0n)
|
||||||
|
throw new Error(
|
||||||
|
'Indique as vendas previstas para calcular a margem e o ponto de equilíbrio.',
|
||||||
|
);
|
||||||
|
if (sales > 0n && costs >= sales)
|
||||||
|
throw new Error(
|
||||||
|
'Com este custo variável não há margem para cobrir os custos fixos. Reveja o custo variável ou o preço.',
|
||||||
|
);
|
||||||
|
const grossMargin = sales - costs;
|
||||||
|
const operatingExpenses =
|
||||||
|
money(year.payroll) +
|
||||||
|
money(year.payrollCharges) +
|
||||||
|
money(year.otherOperatingExpenses);
|
||||||
|
const operatingProfit = grossMargin - operatingExpenses;
|
||||||
|
const netProfit =
|
||||||
|
operatingProfit - money(year.interest) - money(year.taxes);
|
||||||
|
const cashFlow = money(year.cashReceived) - money(year.cashSpent);
|
||||||
|
cash += cashFlow;
|
||||||
|
// Keep the unrounded gross-margin fraction in the break-even formula.
|
||||||
|
const monthlyBreakEven =
|
||||||
|
grossMargin > 0n
|
||||||
|
? (Number(operatingExpenses) * Number(sales)) /
|
||||||
|
(1200 * Number(grossMargin))
|
||||||
|
: null;
|
||||||
|
const previousSales =
|
||||||
|
index > 0 ? money(plan.years[index - 1].sales) : null;
|
||||||
|
const growthPercent =
|
||||||
|
previousSales !== null && previousSales > 0n
|
||||||
|
? (Number(sales - previousSales) / Number(previousSales)) * 100
|
||||||
|
: null;
|
||||||
|
return {
|
||||||
|
year: year.year,
|
||||||
|
sales: decimal(sales),
|
||||||
|
directCosts: decimal(costs),
|
||||||
|
grossMargin: decimal(grossMargin),
|
||||||
|
grossMarginPercent:
|
||||||
|
sales > 0n ? (Number(grossMargin) / Number(sales)) * 100 : null,
|
||||||
|
operatingExpenses: decimal(operatingExpenses),
|
||||||
|
operatingProfit: decimal(operatingProfit),
|
||||||
|
netProfit: decimal(netProfit),
|
||||||
|
netMarginPercent:
|
||||||
|
sales > 0n ? (Number(netProfit) / Number(sales)) * 100 : null,
|
||||||
|
cashFlow: decimal(cashFlow),
|
||||||
|
closingCash: decimal(cash),
|
||||||
|
monthlyFixedCosts: Number(operatingExpenses) / 1200,
|
||||||
|
monthlyBreakEven,
|
||||||
|
growthPercent,
|
||||||
|
};
|
||||||
|
});
|
||||||
|
return {
|
||||||
|
startupExpenses: decimal(startupExpenses),
|
||||||
|
assets: decimal(assets),
|
||||||
|
requiredFunding: decimal(requiredFunding),
|
||||||
|
availableFunding: decimal(availableFunding),
|
||||||
|
fundingGap: decimal(
|
||||||
|
requiredFunding > availableFunding
|
||||||
|
? requiredFunding - availableFunding
|
||||||
|
: 0n,
|
||||||
|
),
|
||||||
|
years,
|
||||||
|
monthlyStatus: 'por reconciliar' as const,
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -127,7 +127,7 @@ export function formatDossierReportValue(
|
|||||||
}
|
}
|
||||||
if (field === 'Reconciliação do financiamento') {
|
if (field === 'Reconciliação do financiamento') {
|
||||||
const states: Record<string, string> = {
|
const states: Record<string, string> = {
|
||||||
shortfall: 'Financiamento insuficiente',
|
shortfall: 'Financiamento insuficiente — aviso não bloqueante',
|
||||||
surplus: 'Fontes superiores aos usos previstos',
|
surplus: 'Fontes superiores aos usos previstos',
|
||||||
balanced: 'Fontes e usos equilibrados',
|
balanced: 'Fontes e usos equilibrados',
|
||||||
unknown: 'Informação insuficiente',
|
unknown: 'Informação insuficiente',
|
||||||
|
|||||||
@@ -561,6 +561,14 @@ export function buildProjectDossierRows(
|
|||||||
const forecast = forecastBusinessPlan(businessPlan);
|
const forecast = forecastBusinessPlan(businessPlan);
|
||||||
const source =
|
const source =
|
||||||
'Estimativa calculada pelo plano financeiro a partir de pressupostos declarados; não é demonstração contabilística nem resultado confirmado';
|
'Estimativa calculada pelo plano financeiro a partir de pressupostos declarados; não é demonstração contabilística nem resultado confirmado';
|
||||||
|
if (businessPlan.annualGrowthPercent?.trim()) {
|
||||||
|
rows.push([
|
||||||
|
'Plano financeiro',
|
||||||
|
'Crescimento anual pretendido',
|
||||||
|
`${businessPlan.annualGrowthPercent}%`,
|
||||||
|
'Meta declarada pelo utilizador; não substitui as agendas de vendas introduzidas',
|
||||||
|
]);
|
||||||
|
}
|
||||||
rows.push(
|
rows.push(
|
||||||
[
|
[
|
||||||
'Plano financeiro',
|
'Plano financeiro',
|
||||||
|
|||||||
@@ -23,7 +23,7 @@ final class BusinessPlanDraftContinuityTest extends TestCase
|
|||||||
$cases = [];
|
$cases = [];
|
||||||
foreach (['Hotel sintético QA' => '250.50', 'Agronegócio sintético QA' => '375.25'] as $title => $price) {
|
foreach (['Hotel sintético QA' => '250.50', 'Agronegócio sintético QA' => '375.25'] as $title => $price) {
|
||||||
$case = app(VirtualDesk::class)->createCase($owner, ['title' => $title, 'client_key' => (string) Str::uuid(), 'reuse_consent' => true]);
|
$case = app(VirtualDesk::class)->createCase($owner, ['title' => $title, 'client_key' => (string) Str::uuid(), 'reuse_consent' => true]);
|
||||||
$snapshot = json_encode(['version' => 17, 'plan' => ['currency' => 'MZN', 'products' => [['label' => $title, 'monthlyUnits' => '25', 'unitPrice' => $price, 'unitVariableCost' => '100.50']], 'monthlyOperatingExpenses' => '500.25', 'salesCollectionPercent' => '', 'openingReceivablesCollectionPercent' => '']], JSON_THROW_ON_ERROR);
|
$snapshot = json_encode(['version' => 17, 'plan' => ['currency' => 'MZN', 'annualGrowthPercent' => '250', 'products' => [['label' => $title, 'monthlyUnits' => '25', 'unitPrice' => $price, 'unitVariableCost' => '100.50']], 'monthlyOperatingExpenses' => '500.25', 'salesCollectionPercent' => '', 'openingReceivablesCollectionPercent' => '']], JSON_THROW_ON_ERROR);
|
||||||
$this->actingAs($owner)->postJson('/api/v1/simulation-drafts', ['context' => $case->id, 'personal_snapshot' => [], 'economic_snapshot' => ['purpose' => 'simulate_only', 'journey_type' => 'small_business', 'business_plan_snapshot' => $snapshot]], ['Idempotency-Key' => (string) Str::uuid()])->assertCreated();
|
$this->actingAs($owner)->postJson('/api/v1/simulation-drafts', ['context' => $case->id, 'personal_snapshot' => [], 'economic_snapshot' => ['purpose' => 'simulate_only', 'journey_type' => 'small_business', 'business_plan_snapshot' => $snapshot]], ['Idempotency-Key' => (string) Str::uuid()])->assertCreated();
|
||||||
$cases[] = [$case->id, $snapshot];
|
$cases[] = [$case->id, $snapshot];
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -65,13 +65,19 @@ function editor(initialSnapshot) {
|
|||||||
}).outputText;
|
}).outputText;
|
||||||
compileFunction(code, ['require', 'module', 'exports'])(
|
compileFunction(code, ['require', 'module', 'exports'])(
|
||||||
(name) =>
|
(name) =>
|
||||||
({
|
(name === '@/components/business-plan-warnings'
|
||||||
|
? { BusinessPlanWarnings: () => null }
|
||||||
|
: name === '@/components/simulation-annual-example'
|
||||||
|
? { SimulationAnnualExample: () => null }
|
||||||
|
: undefined) ??
|
||||||
|
{
|
||||||
react: hooks,
|
react: hooks,
|
||||||
'@/components/currency-select': { CurrencySelect: () => null },
|
'@/components/currency-select': { CurrencySelect: () => null },
|
||||||
'@/lib/business-financial-plan': business,
|
'@/lib/business-financial-plan': business,
|
||||||
'@/lib/simulation-contract': contract,
|
'@/lib/simulation-contract': contract,
|
||||||
'@/lib/financial-fiscal-bridge': bridge,
|
'@/lib/financial-fiscal-bridge': bridge,
|
||||||
})[name] ?? require(name),
|
}[name] ??
|
||||||
|
require(name),
|
||||||
module,
|
module,
|
||||||
module.exports,
|
module.exports,
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -0,0 +1,131 @@
|
|||||||
|
import assert from 'node:assert/strict';
|
||||||
|
import test from 'node:test';
|
||||||
|
import fs from 'node:fs';
|
||||||
|
import { createRequire } from 'node:module';
|
||||||
|
import { compileFunction } from 'node:vm';
|
||||||
|
import React from 'react';
|
||||||
|
import { renderToStaticMarkup } from 'react-dom/server';
|
||||||
|
import ts from 'typescript';
|
||||||
|
import * as guidance from '../../resources/js/lib/business-plan-guidance.ts';
|
||||||
|
import * as business from '../../resources/js/lib/business-financial-plan.ts';
|
||||||
|
import * as catalogue from '../../resources/js/lib/catalogue-choice.ts';
|
||||||
|
const require = createRequire(import.meta.url);
|
||||||
|
function load(name, mocks) {
|
||||||
|
const source = fs.readFileSync(
|
||||||
|
new URL(`../../resources/js/components/${name}.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 module = { exports: {} };
|
||||||
|
compileFunction(code, ['require', 'module', 'exports'])(
|
||||||
|
(key) => mocks[key] ?? require(key),
|
||||||
|
module,
|
||||||
|
module.exports,
|
||||||
|
);
|
||||||
|
return module.exports;
|
||||||
|
}
|
||||||
|
function nodes(tree) {
|
||||||
|
if (Array.isArray(tree)) return tree.flatMap(nodes);
|
||||||
|
return tree && typeof tree === 'object'
|
||||||
|
? [tree, ...nodes(tree.props?.children)]
|
||||||
|
: [];
|
||||||
|
}
|
||||||
|
|
||||||
|
void test('a saved catalogue choice retains its exact value without exposing an internal identifier', () => {
|
||||||
|
const { default: Select } = load('catalogue-choice-select', {
|
||||||
|
react: {
|
||||||
|
useId: () => 'test-choice',
|
||||||
|
useState: (initial) => [initial, () => {}],
|
||||||
|
},
|
||||||
|
'./territory-search-select': () => null,
|
||||||
|
'@/lib/catalogue-choice': catalogue,
|
||||||
|
});
|
||||||
|
const id = 'a2000000-0000-4000-8000-000000000013';
|
||||||
|
let chosen;
|
||||||
|
const element = Select({
|
||||||
|
label: 'Actividade a comparar',
|
||||||
|
value: id,
|
||||||
|
options: [],
|
||||||
|
onChange: (value) => {
|
||||||
|
chosen = value;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
assert.equal(element.props.selected.id, id);
|
||||||
|
assert.equal(
|
||||||
|
element.props.selected.name,
|
||||||
|
'Escolha guardada — designação por recuperar',
|
||||||
|
);
|
||||||
|
assert.ok(!element.props.selected.name.includes(id));
|
||||||
|
element.props.onChange({ id, name: 'Designação recuperada' });
|
||||||
|
assert.equal(chosen, id);
|
||||||
|
assert.equal(
|
||||||
|
Select({
|
||||||
|
label: 'Actividade',
|
||||||
|
value: id,
|
||||||
|
options: [{ value: id, label: 'Hotelaria documentada' }],
|
||||||
|
onChange() {},
|
||||||
|
}).props.selected.name,
|
||||||
|
'Hotelaria documentada',
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
void test('warning dismissal is local, never blocks a form, and changed assumptions reveal the warning again', () => {
|
||||||
|
let dismissed = [];
|
||||||
|
const { BusinessPlanWarnings } = load('business-plan-warnings', {
|
||||||
|
react: {
|
||||||
|
...React,
|
||||||
|
useState: () => [
|
||||||
|
dismissed,
|
||||||
|
(next) => {
|
||||||
|
dismissed = next(dismissed);
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
'@/lib/business-plan-guidance': guidance,
|
||||||
|
});
|
||||||
|
const metrics = { fundingGap: 100, currency: 'MZN' };
|
||||||
|
const tree = BusinessPlanWarnings({ metrics });
|
||||||
|
assert.ok(nodes(tree).some((node) => node.props?.role === 'status'));
|
||||||
|
assert.equal(
|
||||||
|
nodes(tree).some((node) => node.props?.role === 'alert'),
|
||||||
|
false,
|
||||||
|
);
|
||||||
|
const button = nodes(tree).find((node) => node.type === 'button');
|
||||||
|
assert.equal(button.props.type, 'button');
|
||||||
|
assert.equal(button.props.disabled, undefined);
|
||||||
|
button.props.onClick();
|
||||||
|
assert.equal(BusinessPlanWarnings({ metrics }), null);
|
||||||
|
assert.ok(
|
||||||
|
BusinessPlanWarnings({ metrics: { ...metrics, fundingGap: 200 } }),
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
void test('annual example renders expected results and source gaps without blocking errors or inferred monthly rows', () => {
|
||||||
|
const warningModule = load('business-plan-warnings', {
|
||||||
|
'@/lib/business-plan-guidance': guidance,
|
||||||
|
});
|
||||||
|
const { SimulationAnnualExample } = load('simulation-annual-example', {
|
||||||
|
'@/lib/business-plan-guidance': guidance,
|
||||||
|
'@/lib/business-financial-plan': business,
|
||||||
|
'./business-plan-warnings': warningModule,
|
||||||
|
});
|
||||||
|
const html = renderToStaticMarkup(
|
||||||
|
React.createElement(SimulationAnnualExample, { currency: 'MZN' }),
|
||||||
|
);
|
||||||
|
assert.match(html, /Linhas mensais por reconciliar/);
|
||||||
|
assert.match(html, /Avisos — pode continuar/);
|
||||||
|
assert.match(html, /Neste ano o negócio dá prejuízo/);
|
||||||
|
assert.match(
|
||||||
|
html,
|
||||||
|
/As vendas mensais médias não atingem o ponto de equilíbrio/,
|
||||||
|
);
|
||||||
|
assert.match(html, /não se distribuem valores pelos meses/);
|
||||||
|
assert.doesNotMatch(html, /role="alert"|aria-invalid="true"|disabled=/);
|
||||||
|
assert.match(html.replace(/[\s\u00a0\u202f]/g, ''), /1325000[.,]00/);
|
||||||
|
});
|
||||||
@@ -0,0 +1,163 @@
|
|||||||
|
import assert from 'node:assert/strict';
|
||||||
|
import test from 'node:test';
|
||||||
|
import {
|
||||||
|
businessPlanWarnings,
|
||||||
|
defaultPlanWarningLimits,
|
||||||
|
newAnnualReferencePlan,
|
||||||
|
calculateAnnualReferencePlan,
|
||||||
|
} from '../../resources/js/lib/business-plan-guidance.ts';
|
||||||
|
import {
|
||||||
|
forecastBusinessPlan,
|
||||||
|
serializeBusinessPlanSnapshot,
|
||||||
|
restoreBusinessPlanSnapshot,
|
||||||
|
} from '../../resources/js/lib/business-financial-plan.ts';
|
||||||
|
import { validateSimulationDraft } from '../../resources/js/lib/simulation-form.ts';
|
||||||
|
import { createProjectDossierReport } from '../../resources/js/lib/project-dossier-report.ts';
|
||||||
|
|
||||||
|
function businessPlan() {
|
||||||
|
const amounts = [
|
||||||
|
'monthlyCollections',
|
||||||
|
'monthlyVariableCostPayments',
|
||||||
|
'monthlyInventoryPurchases',
|
||||||
|
'monthlyOperatingExpenses',
|
||||||
|
'monthlyOperatingPayments',
|
||||||
|
'monthlyPayrollExpense',
|
||||||
|
'monthlyPayrollPayments',
|
||||||
|
'inventory',
|
||||||
|
'receivables',
|
||||||
|
'payables',
|
||||||
|
'equity',
|
||||||
|
'shareholderLoans',
|
||||||
|
'bankLoanProceeds',
|
||||||
|
'grants',
|
||||||
|
'assetDepreciation',
|
||||||
|
'monthlyInterestExpense',
|
||||||
|
'monthlyInterestPayment',
|
||||||
|
'monthlyPrincipalRepayment',
|
||||||
|
];
|
||||||
|
return {
|
||||||
|
...Object.fromEntries(amounts.map((key) => [key, '0'])),
|
||||||
|
currency: 'MZN',
|
||||||
|
openingCash: '1000',
|
||||||
|
assetInvestment: '200',
|
||||||
|
products: [
|
||||||
|
{
|
||||||
|
label: 'Serviço sintético',
|
||||||
|
monthlyUnits: '10',
|
||||||
|
unitPrice: '100',
|
||||||
|
unitVariableCost: '40',
|
||||||
|
},
|
||||||
|
],
|
||||||
|
depreciationLifeMonths: 60,
|
||||||
|
periods: 12,
|
||||||
|
annualGrowthPercent: '250',
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
void test('insufficient funding and growth above 100 percent remain valid, saved assumptions with nonblocking warnings', () => {
|
||||||
|
const plan = businessPlan();
|
||||||
|
const snapshot = serializeBusinessPlanSnapshot(plan);
|
||||||
|
const restored = restoreBusinessPlanSnapshot(snapshot);
|
||||||
|
assert.equal(restored.annualGrowthPercent, '250');
|
||||||
|
const result = forecastBusinessPlan(restored);
|
||||||
|
assert.equal(result.fundingGap, '200.00');
|
||||||
|
assert.equal(result.totalRevenue, '12000.00', 'a growth target must not overwrite declared sales');
|
||||||
|
assert.equal(
|
||||||
|
validateSimulationDraft(
|
||||||
|
{ business_plan_snapshot: snapshot },
|
||||||
|
'financial',
|
||||||
|
).business_plan_snapshot,
|
||||||
|
undefined,
|
||||||
|
);
|
||||||
|
const warnings = businessPlanWarnings({
|
||||||
|
fundingGap: Number(result.fundingGap),
|
||||||
|
growthPercent: Number(restored.annualGrowthPercent),
|
||||||
|
currency: 'MZN',
|
||||||
|
});
|
||||||
|
assert.deepEqual(
|
||||||
|
warnings.map((warning) => warning.id),
|
||||||
|
['funding', 'growth'],
|
||||||
|
);
|
||||||
|
const report = createProjectDossierReport(
|
||||||
|
{ business_plan_snapshot: snapshot },
|
||||||
|
{
|
||||||
|
selectedSections: new Set(['finance']),
|
||||||
|
generatedAt: '2026-11-20T08:00:00Z',
|
||||||
|
},
|
||||||
|
);
|
||||||
|
assert.match(JSON.stringify(report), /aviso não bloqueante/);
|
||||||
|
assert.match(JSON.stringify(report), /Crescimento anual pretendido/);
|
||||||
|
assert.match(JSON.stringify(report), /250%/);
|
||||||
|
});
|
||||||
|
|
||||||
|
void test('owner annual reference reconciles exact startup, margins, profits, cash and unrounded break-even', () => {
|
||||||
|
const source = newAnnualReferencePlan(),
|
||||||
|
before = JSON.stringify(source);
|
||||||
|
const result = calculateAnnualReferencePlan(source),
|
||||||
|
first = result.years[0];
|
||||||
|
assert.equal(result.startupExpenses, '1325000.00');
|
||||||
|
assert.equal(result.assets, '500250.00');
|
||||||
|
assert.equal(result.requiredFunding, '1825250.00');
|
||||||
|
assert.equal(result.availableFunding, '0.00');
|
||||||
|
assert.equal(result.fundingGap, '1825250.00');
|
||||||
|
assert.equal(first.grossMargin, '1999.00');
|
||||||
|
assert.equal(first.operatingExpenses, '2415.00');
|
||||||
|
assert.equal(first.operatingProfit, '-416.00');
|
||||||
|
assert.equal(first.netProfit, '-416.00');
|
||||||
|
assert.equal(first.cashFlow, '756.00');
|
||||||
|
assert.equal(first.closingCash, '90756.00');
|
||||||
|
assert.equal(Math.round(first.monthlyBreakEven), 1464);
|
||||||
|
assert.ok(
|
||||||
|
Math.abs(first.monthlyBreakEven - 2415 / 12 / (1999 / 14537)) < 1e-10,
|
||||||
|
);
|
||||||
|
assert.equal(result.years[1].netProfit, '1456.00');
|
||||||
|
assert.equal(result.years[2].netProfit, '1631.00');
|
||||||
|
assert.equal(result.years[2].closingCash, '93498.00');
|
||||||
|
assert.equal(result.monthlyStatus, 'por reconciliar');
|
||||||
|
assert.equal('monthlyRows' in result, false);
|
||||||
|
const warnings = businessPlanWarnings({
|
||||||
|
fundingGap: Number(result.fundingGap),
|
||||||
|
netProfit: Number(first.netProfit),
|
||||||
|
sales: Number(first.sales),
|
||||||
|
directCosts: Number(first.directCosts),
|
||||||
|
monthlyBreakEven: first.monthlyBreakEven,
|
||||||
|
});
|
||||||
|
assert.ok(warnings.some((warning) => warning.id === 'loss'));
|
||||||
|
assert.ok(warnings.some((warning) => warning.id === 'break-even'));
|
||||||
|
assert.equal(JSON.stringify(source), before);
|
||||||
|
});
|
||||||
|
|
||||||
|
void test('reference edits update dependent totals and preserve data when an input is invalid', () => {
|
||||||
|
const source = newAnnualReferencePlan();
|
||||||
|
source.startupExpenses[0].amount = '25000.25';
|
||||||
|
assert.equal(
|
||||||
|
calculateAnnualReferencePlan(source).requiredFunding,
|
||||||
|
'1825250.25',
|
||||||
|
);
|
||||||
|
source.years[0].sales = '';
|
||||||
|
assert.throws(
|
||||||
|
() => calculateAnnualReferencePlan(source),
|
||||||
|
/Preencha este campo para continuar/,
|
||||||
|
);
|
||||||
|
assert.equal(source.startupExpenses[0].amount, '25000.25');
|
||||||
|
source.years[0].sales = '0';
|
||||||
|
assert.throws(
|
||||||
|
() => calculateAnnualReferencePlan(source),
|
||||||
|
/Indique as vendas previstas/,
|
||||||
|
);
|
||||||
|
source.years[0].sales = '100';
|
||||||
|
assert.throws(() => calculateAnnualReferencePlan(source), /não há margem/);
|
||||||
|
});
|
||||||
|
|
||||||
|
void test('warning limits are configurable and equality at the threshold is not a warning', () => {
|
||||||
|
assert.deepEqual(businessPlanWarnings({ growthPercent: 100 }), []);
|
||||||
|
assert.deepEqual(
|
||||||
|
businessPlanWarnings(
|
||||||
|
{ growthPercent: 250 },
|
||||||
|
{ ...defaultPlanWarningLimits, annualGrowthPercent: 300 },
|
||||||
|
),
|
||||||
|
[],
|
||||||
|
);
|
||||||
|
assert.equal(businessPlanWarnings({ creditDays: 91 })[0].id, 'credit');
|
||||||
|
assert.deepEqual(businessPlanWarnings({ creditDays: 90 }), []);
|
||||||
|
});
|
||||||
Reference in New Issue
Block a user