Clarify viability simulation purpose and preserve PEC cash-flow hypotheses
tests / ci (push) Canceled after 0s

This commit is contained in:
2026-11-11 10:37:33 +02:00
parent aae79c712d
commit a708f079b3
24 changed files with 754 additions and 42 deletions
@@ -342,6 +342,7 @@ export function SimulationIrpcAnnual({ draft, onChange }: Props) {
</fieldset>
<fieldset className="space-y-2 rounded border p-3">
<legend>PPC efectivamente pagos</legend>
<p>Simulação fiscal para avaliar a viabilidade do negócio e as necessidades de tesouraria. Os valores e meses previstos são estimativas; o portal não executa pagamentos nem submete declarações fiscais.</p>
<SimulationIrpcPecObligation book={b} onChange={pecObligation=>patch({pecObligation})}/>
<SimulationIrpcPpcObligation book={b} onChange={ppcObligation=>patch({ppcObligation})}/>
{group('ppc', 'PPC efectuados')}
@@ -1,3 +1,4 @@
import {SimulationIrpcPecPlan} from './simulation-irpc-pec-plan';
import {
newPecObligation,
calculatePecObligation,
@@ -17,7 +18,7 @@ export function SimulationIrpcPecObligation({
if (!p)
return (
<section className="rounded border p-3">
<h5>Obrigação PEC</h5>
<h5>Estimativa PEC</h5>
<p>
Preparar o total e os meses previstos conserva os
comprovativos pagos em separado.
@@ -28,7 +29,7 @@ export function SimulationIrpcPecObligation({
onChange(newPecObligation(book.subjectNuit, book.year))
}
>
Preparar obrigação PEC
Simular PEC
</button>
</section>
);
@@ -41,7 +42,7 @@ export function SimulationIrpcPecObligation({
patch = (changes: Partial<PecObligation>) =>
onChange({ ...p, ...changes });
const field = (
key: Exclude<keyof PecObligation, 'version' | 'scope'>,
key: Exclude<keyof PecObligation, 'version' | 'scope' | 'plan'>,
label: string,
) => (
<label className="block">
@@ -55,10 +56,10 @@ export function SimulationIrpcPecObligation({
);
return (
<section
aria-label="Preparação da obrigação PEC"
aria-label="Preparação da estimativa PEC"
className="rounded border p-3"
>
<h5>Obrigação PEC — preparação</h5>
<h5>Estimativa PEC — preparação</h5>
<label className="block">
Enquadramento PEC
<select
@@ -82,8 +83,8 @@ export function SimulationIrpcPecObligation({
</label>
{p.scope === 'ordinary_resident' && (
<>
{field('subjectNuit', 'NUIT — obrigação PEC')}
{field('year', 'Exercício — obrigação PEC')}
{field('subjectNuit', 'NUIT — estimativa PEC')}
{field('year', 'Exercício — estimativa PEC')}
{field(
'activityStartYear',
'Ano de início efectivo da actividade — PEC',
@@ -122,7 +123,7 @@ export function SimulationIrpcPecObligation({
) : (
<>
<p>
Obrigação total:{' '}
Total estimado:{' '}
{fractionPresentation(m.total!).decimal} MZN.
</p>
<ul>
@@ -130,13 +131,10 @@ export function SimulationIrpcPecObligation({
<li key={month}>{month}</li>
))}
</ul>
<p>
Repartição por prestação e opção de pagamento único por
preparar; não se presume dia limite nem arredondamento
do PPC para o PEC.
</p>
</>
)}
<SimulationIrpcPecPlan plan={p.plan} total={m.total} notApplicable={m.notApplicable} year={book.year} onChange={plan=>patch({plan})}/>
<p>
Guardar o rascunho conserva esta preparação. Calcular o fecho
anual inclui-a no relatório. Não regista pagamentos,cria
@@ -0,0 +1,135 @@
import {
newPecPlan,
calculatePecPlan,
pecPlanSource,
type PecPlan,
} from '@/lib/irpc-pec-plan';
import {
fractionPresentation,
type FiscalFraction,
} from '@/lib/fiscal-rational';
export function SimulationIrpcPecPlan({
plan,
total,
notApplicable,
year,
onChange,
}: {
plan?: PecPlan;
total: FiscalFraction | null;
notApplicable: boolean;
year: string;
onChange: (p: PecPlan) => void;
}) {
if (!plan)
return (
<div className="rounded border p-3">
<p>
Prepare os montantes por prestação ou a opção de pagamento
único,sem registar pagamento.
</p>
<button
type="button"
disabled={
!total || notApplicable || BigInt(total.numerator) <= 0n
}
onClick={() => onChange(newPecPlan())}
>
Simular tesouraria PEC
</button>
</div>
);
const m = calculatePecPlan(plan, total, notApplicable, year),
patch = (p: Partial<PecPlan>) => onChange({ ...plan, ...p });
const field = (
key: 'reference' | 'june' | 'august' | 'october',
label: string,
) => (
<label className="block">
{label}
<input
aria-label={label}
value={plan[key]}
onChange={(e) => patch({ [key]: e.target.value })}
/>
</label>
);
return (
<section
aria-label="Projecção de tesouraria PEC"
className="rounded border p-3"
>
<h6>Projecção PEC</h6>
{m.pending.length ? (
<p role="status">{m.pending.join(' ')}</p>
) : (
<p>
Soma reconciliada:{' '}
{m.rows
.map(
(r) =>
r.month +
': ' +
fractionPresentation(r.amount).decimal +
' MZN',
)
.join('; ')}
. Prazo legal não validado.
</p>
)}
<details open={m.pending.length > 0}>
<summary>Alterar projecção PEC</summary>
<label className="block">
Opção de preparação PEC
<select
aria-label="Opção de preparação PEC"
value={plan.mode}
onChange={(e) =>
patch({ mode: e.target.value as PecPlan['mode'] })
}
>
<option value="">Por escolher</option>
<option value="three">
Distribuir a estimativa por três meses
</option>
<option value="single">
Concentrar a estimativa num mês
</option>
</select>
</label>
{field('reference', 'Fundamento do projecção PEC')}
{plan.mode === 'three' && (
<>
{field('june', 'PEC Junho — MZN')}
{field('august', 'PEC Agosto — MZN')}
{field('october', 'PEC Outubro — MZN')}
</>
)}
{plan.mode === 'single' && (
<label className="block">
Mês previsto do PEC único
<input
aria-label="Mês previsto do PEC único"
type="month"
value={plan.singleMonth}
onChange={(e) =>
patch({ singleMonth: e.target.value })
}
/>
</label>
)}
</details>
<p>
O mês escolhido é uma hipótese de tesouraria para avaliar a
viabilidade. A reconciliação da soma não valida os prazos
legais,emite guia ou regista pagamento. Alterar a estimativa
exige reconferir o plano. Guarde pelo rascunho e recalcule o
fecho para actualizar o relatório.
</p>
<details>
<summary>Fonte do projecção PEC</summary>
<p>{pecPlanSource}</p>
</details>
</section>
);
}
@@ -17,7 +17,7 @@ export function SimulationIrpcPpcObligation({
if (!p)
return (
<section className="rounded border p-3">
<h5>Obrigação PPC</h5>
<h5>Estimativa PPC</h5>
<p>
Preparar a obrigação e os meses previstos não regista
pagamentos nem cria deduções na liquidação.
@@ -28,7 +28,7 @@ export function SimulationIrpcPpcObligation({
onChange(newPpcObligation(book.subjectNuit, book.year))
}
>
Preparar obrigação PPC
Simular PPC
</button>
</section>
);
@@ -62,10 +62,10 @@ export function SimulationIrpcPpcObligation({
);
return (
<section
aria-label="Preparação da obrigação PPC"
aria-label="Preparação da estimativa PPC"
className="rounded border p-3"
>
<h5>Obrigação PPC — exercício anterior</h5>
<h5>Estimativa PPC — exercício anterior</h5>
<p>
Reutiliza o titular e exercício ao iniciar. Complete a
liquidação anterior e as retenções documentadas; campos vazios
@@ -94,8 +94,8 @@ export function SimulationIrpcPpcObligation({
</label>
{p.scope === 'ordinary_resident' && (
<>
{field('subjectNuit', 'NUIT — obrigação PPC')}
{field('year', 'Exercício — obrigação PPC')}
{field('subjectNuit', 'NUIT — estimativa PPC')}
{field('year', 'Exercício — estimativa PPC')}
{field('previousYear', 'Exercício anterior — PPC')}
<label className="block">
Exercício anterior civil completo