feat(qa): complete market milestones and personnel report tables

This commit is contained in:
2026-11-20 12:45:14 +02:00
parent f3148d1674
commit 4fb9296f70
14 changed files with 1041 additions and 7 deletions
@@ -5,6 +5,7 @@ namespace App\Http\Requests;
use App\Services\CountryCatalogue;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\Rule;
use Illuminate\Validation\Validator;
class StoreSimulationFormDraftRequest extends FormRequest
@@ -137,7 +138,7 @@ class StoreSimulationFormDraftRequest extends FormRequest
'economic_snapshot.public_fields_confirmation' => ['nullable', 'in:yes,no'],
'economic_snapshot.validation_acknowledged' => ['nullable', 'in:yes,no'],
'economic_snapshot.investment_budget_min' => ['nullable', 'numeric', 'min:0'],
'economic_snapshot.investment_budget_max' => ['nullable', 'numeric', 'min:0', \Illuminate\Validation\Rule::when($this->filled('economic_snapshot.investment_budget_min'), 'gte:economic_snapshot.investment_budget_min')],
'economic_snapshot.investment_budget_max' => ['nullable', 'numeric', 'min:0', Rule::when($this->filled('economic_snapshot.investment_budget_min'), 'gte:economic_snapshot.investment_budget_min')],
'economic_snapshot.currency' => ['nullable', 'string', 'regex:/^[A-Z]{3}$/'],
'economic_snapshot.opportunity_currency' => ['nullable', 'string', 'regex:/^[A-Z]{3}$/'],
'economic_snapshot.rate' => ['nullable', 'numeric', 'between:0,100'],
@@ -217,11 +218,13 @@ class StoreSimulationFormDraftRequest extends FormRequest
foreach ([
'project_team_snapshot' => [
'keys' => ['competency', 'state', 'action', 'estimated_cost', 'due_date'],
'optional' => ['department', 'quantity', 'monthly_salary', 'start_month', 'end_month'],
'states' => ['available', 'gap', 'unknown'],
'amounts' => ['estimated_cost'],
'amounts' => ['estimated_cost', 'monthly_salary'],
],
'project_execution_snapshot' => [
'keys' => ['title', 'due_date', 'status', 'planned_amount', 'actual_amount'],
'optional' => ['start_date', 'responsible', 'department'],
'states' => ['planned', 'in_progress', 'completed'],
'amounts' => ['planned_amount', 'actual_amount'],
],
@@ -232,7 +235,7 @@ class StoreSimulationFormDraftRequest extends FormRequest
$rows = json_decode((string) $economic[$field], true);
$valid = is_array($rows) && count($rows) <= 100;
foreach (is_array($rows) ? $rows : [] as $row) {
if (! is_array($row) || array_diff(array_keys($row), $schema['keys']) !== []
if (! is_array($row) || array_diff(array_keys($row), array_merge($schema['keys'], $schema['optional'])) !== []
|| array_diff($schema['keys'], array_keys($row)) !== []
|| array_filter($row, fn ($value) => ! is_string($value) || mb_strlen($value) > 500) !== []) {
$valid = false;
@@ -244,12 +247,19 @@ class StoreSimulationFormDraftRequest extends FormRequest
break;
}
foreach ($schema['amounts'] as $amountKey) {
if ($row[$amountKey] !== '' && (! is_numeric($row[$amountKey]) || (float) $row[$amountKey] < 0)) {
if (isset($row[$amountKey]) && $row[$amountKey] !== '' && ($amountKey === 'monthly_salary'
? ! preg_match('/^\d+(?:\.\d{1,2})?$/', $row[$amountKey])
: (! is_numeric($row[$amountKey]) || (float) $row[$amountKey] < 0))) {
$valid = false;
}
}
foreach (['due_date'] as $dateKey) {
if ($row[$dateKey] !== '' && ! preg_match('/^\d{4}-\d{2}-\d{2}$/', $row[$dateKey])) {
foreach (['quantity', 'start_month', 'end_month'] as $integerKey) {
if (isset($row[$integerKey]) && $row[$integerKey] !== '' && (! preg_match('/^\d+$/', $row[$integerKey]) || (float) $row[$integerKey] > ($integerKey === 'quantity' ? 1000000 : 60) || ($integerKey !== 'quantity' && (int) $row[$integerKey] < 1))) {
$valid = false;
}
}
foreach (['due_date', 'start_date'] as $dateKey) {
if (isset($row[$dateKey]) && $row[$dateKey] !== '' && ! preg_match('/^\d{4}-\d{2}-\d{2}$/', $row[$dateKey])) {
$valid = false;
}
}
@@ -10425,3 +10425,9 @@ Referência722322f9: Word/PDF existentes conferidos por rasterização Poppler l
### Encerramento formal do Pacote 1 — aceitação do proprietário
Pacote 1 da Etapa 2 APROVADO EM QA E ENCERRADO, por decisão expressa do proprietário sobre a implementação `722322f9` e as evidências `20998b89`. Aceites as sete tabelas, Word/PDF de onze páginas, interface em computador e telemóvel emulado, persistência e isolamento; nenhuma regressão reportada. Aceitação baseada no relatório, sem inspecção directa dos ficheiros ou hashes pelo proprietário. Relatório integral NÃO APTO; Pacote 2 NÃO INICIADO; restantes pacotes pendentes; instalação e publicação NÃO AUTORIZADAS. Etapa 1 encerrada preservada e pendências de histórico QA/tradução independentes. Actualização apenas documental, sem código, testes ou início de outro pacote. Matriz e aditamento de aceitação existentes actualizados.
### Pacote2 — implementação QA de Mercado, Marcos e Pessoal
Pedido posterior de avanço executado exclusivamente em QA, base `f3148d16`. Três tabelas integradas nos planeadores/dossier/Word/impressão, com campos obrigatórios/opcionais explícitos. Mercado persiste no snapshot financeiro existente; pessoal e marcos reutilizam os respectivos snapshots, com extensões opcionais compatíveis com dados antigos. Projecções de clientes não alteram receitas; orçamentos não se tornam pagamentos; diferenças salariais são avisos sem sobrescrita do plano ou conversão monetária. Registos malformados não produzem totais parciais enganosos.
Sete testes novos, integração HTTP201/200/422/404, tipos/lint/Pint e buildQA aprovados. UI em1440×1000 e390×844, edição/gravação/recuperação101clientes, Word4páginas e impressão4páginas conferidos. Provas, hashes e matriz individual no aditamento de `apresentacao-contexto-qa-20261115.md` e `outputs/controlled-5f7db7cd-20261120/package2/acceptance.json`. Resultado técnico APTO em QA, por aceitar pelo proprietário. Etapa1/Pacote1 preservados, sem repetição das suas baterias aprovadas. Relatório11tabelas NÃO APTO; Pacotes3–5 não iniciados nesta execução. Sem instalação/publicação/migrações.
@@ -807,3 +807,40 @@ Pendências do Pacote1: nenhuma identificada nos critérios desta conferência;
| Instalação e publicação | NÃO AUTORIZADAS |
Este registo substitui a proposta de encerramento anterior pela aceitação expressa, preservando as provas e o histórico. Etapa 1 permanece APROVADA E ENCERRADA; histórico perdido do QA e tradução HTTP 503 permanecem independentes. Execução exclusivamente documental: sem alterações de código, repetição de testes ou início de outros pacotes. A recomendação do próximo passo não constitui autorização para o iniciar nesta execução.
### Pacote 2 — Mercado, Marcos e Pessoal, implementação e verificação em QA
Base: encerramento `f3148d16`. Pedido posterior do proprietário para avançar apenas com o Pacote2 em QA. **Resultado técnico: APTO em QA, por aceitar pelo proprietário.** Não reabre a Etapa1 ou o Pacote1; não inicia Rácios, relatório consolidado final ou CAE. O relatório integral de11tabelas continua NÃO APTO.
| Tabela | Dados necessários para completar | Opcionais / limites | Cálculo e evidência |
| --- | --- | --- | --- |
| Análise de Mercado | Ano-base, horizonte2–10anos, segmento, clientes potenciais inteiros, crescimento e fonte ou hipótese identificada | Narrativa de mercado existente e fonte/data adicional continuam opcionais; segmentos não são automaticamente deduplicados nem convertidos em vendas | Projecção anual com arredondamento à pessoa em aritmética inteira; crescimento composto do primeiro ao último ano, denominador zero indeterminado. Fixture100→110→121;10,00%. Crescimento150% aceite com aviso não bloqueante |
| Marcos | Título, início/término válidos e ordenados, responsável funcional, departamento e orçamento | Realizado opcional; vazio permanece por determinar, nunca zero presumido | Soma exacta em centavos; fixture100,25 de orçamento. Não soma os marcos automaticamente ao investimento ou à caixa |
| Pessoal | Função, departamento, quantidade inteira, remuneração mensal por pessoa e meses inicial/final no horizonte | Competência, disponibilidade, resposta, custo de formação/contratação e prazo preservados; não são salários por inferência | Quantidade×remuneração por mês activo, somas anuais e ano parcial; fixture2×100,00 gera200,00/mês e2.400,00/200,00 por ano. Diferença face à despesa financeira0,00; editar para100,01 mostra divergência sem sobrescrever o plano. Moedas diferentes impedem comparação automática |
Persistência reutilizada: mercado em `business_plan_snapshot` existente (versão17, propriedade opcional); pessoal em `project_team_snapshot`; marcos em `project_execution_snapshot`. A validação admite somente os novos campos previstos, como extensões opcionais das linhas antigas; conserva limites existentes e rejeita quantidade fraccionária, remuneração inválida e campos não previstos. Sem novas tabelas, migrações, armazenamento paralelo, permissões ou dependências. Registos antigos mantêm os campos originais; complementos ausentes ficam visíveis. Estruturas não reconhecidas não são substituídas pelo editor e não geram totais parciais aparentemente completos.
Integração: reutilizados os planeadores `project-planning.tsx`, o plano financeiro e o componente partilhado de tabelas. Mercado disponível no plano detalhado; Pessoal e Marcos na etapa de equipa/execução. As três tabelas integram as secções correspondentes do dossier, pré-visualização, Word e impressão. Os campos narrativos existentes foram conservados. Em conjunto com o Pacote1, a prova de integração contém10tabelas; Rácios permanece fora deste pacote.
**Verificações executadas:** sete testes frontend novos aprovados (`complementary-report.test.mjs`): clientes/crescimento/limites, datas/centavos, folha mensal/anual e divergências, moedas diferentes, compatibilidade com linhas antigas, estruturas malformadas e roundtrip/exportações. Tipos TypeScript, lint/formatação dos ficheiros afectados, sintaxe PHP, Pint e buildQA aprovados. A primeira captura leu o estado antes de a recuperação terminar; a prova final aguarda o resultado derivado e a resposta de recuperação. Pedido PUT e leitura API contêm101clientes, e o campo recuperado mostra101. Não houve alteração funcional para esse atraso. O build termina com código0; avisos preexistentes de fonte opcional e chunks não foram convertidos em falha. Não repetidos92testes da Etapa1 nem o conjunto aprovado do Pacote1.
Prova HTTP (`package2/http.json`): criação201, recuperação200com os três snapshots exactos,422para quantidade fraccionária e chave inesperada,404noutra sessão. QA isolado `http://127.0.0.3:18720`, baseguardada pelo router existente. Só foram escritos rascunhos sintéticos desta verificação; não se substituiu histórico perdido.
| Conferência visual | Resultado | Prova em `outputs/controlled-5f7db7cd-20261120/package2/` |
| --- | --- | --- |
| Mercado, Marcos e Pessoal em1440×1000 | APROVADO, sem erro JavaScript ou transbordo da página | `1440-{market,milestones,staff}-{left,right}.png` e `visual.json` |
| Mercado, Marcos e Pessoal em390×844 | APROVADO, colunas anuais acessíveis por deslocamento interno | `390-{market,milestones,staff}-{left,right}.png` |
| Word: página1 | Mercado e projecções legíveis | `word-1.png` |
| Word: página2 | Pessoal Janeiro–Agosto, cabeçalhos e remunerações | `word-2.png` |
| Word: página3 | Pessoal Setembro–Janeiro/anos, contexto e início dos marcos | `word-3.png` |
| Word: página4 | Continuação dos marcos, orçamento100,25 e realizado indeterminado | `word-4.png` |
| Impressão: página1 | Mercado, séries e pressupostos | `print-1.png` |
| Impressão: página2 | Pessoal e primeira continuação | `print-2.png` |
| Impressão: página3 | Pessoal anual e título/contexto dos marcos | `print-3.png` |
| Impressão: página4 | Marcos e totais | `print-4.png` |
Word aberto na aplicação nativa e convertido localmente para PDF; impressão gerada pelo mecanismo HTML existente com Chromium já instalado. Ambos com4páginas, todas rasterizadas com Poppler e examinadas. Sem cortes de conteúdo ou sobreposições; continuações mantêm os cabeçalhos. Todas as células do DOCX estão presentes no PDF Word. [Recibo e hashes](../../../../outputs/controlled-5f7db7cd-20261120/package2/acceptance.json), [Word](../../../../outputs/controlled-5f7db7cd-20261120/package2/report.docx), [PDF Word](../../../../outputs/controlled-5f7db7cd-20261120/package2/report.pdf), [PDF de impressão](../../../../outputs/controlled-5f7db7cd-20261120/package2/report-print.pdf).
Ficheiros funcionais afectados: novos `complementary-report.ts` e `market-analysis-plan.tsx`; extensões localizadas de `project-planning.tsx`, `simulation-business-plan.tsx`, `simulation-form.tsx`, tipos em `business-financial-plan.ts`/`project-dossier.ts`, integração em `project-dossier-report.ts` e validação em `StoreSimulationFormDraftRequest.php`. Acrescentados teste e fixture sintética específicos; actualizadas apenas esta documentação, manual e matriz existentes.
Pendências concretas do Pacote2: nenhuma identificada nos critérios acima; aceitação formal cabe ao proprietário. Permanecem Pacotes3–5, relatório integral NÃO APTO, histórico QA perdido e tradução503 independentes. Nenhuma instalação, publicação, migração operacional ou alteração de fórmula financeira aprovada. Próxima tarefa recomendada: aceitar o Pacote2 e decidir sobre Rácios, sem os iniciar nesta execução.
File diff suppressed because one or more lines are too long
@@ -0,0 +1,153 @@
import type { BusinessFinancialPlanInput } from '@/lib/business-financial-plan';
import {
buildComplementaryTables,
isMarketAnalysis,
} from '@/lib/complementary-report';
import { InvestmentReportTables } from './investment-report-tables';
export function MarketAnalysisPlan({
plan,
onChange,
}: {
plan: BusinessFinancialPlanInput;
onChange: (p: BusinessFinancialPlanInput) => void;
}) {
const a = plan.marketAnalysis ?? {
baseYear: plan.reportAssumptions?.startYear ?? '',
years: '3',
segments: [],
};
if (!isMarketAnalysis(a))
return (
<p role="alert">
A análise de mercado guardada tem uma estrutura desconhecida.
Foi preservada; reveja o ficheiro antes de editar.
</p>
);
const update = (patch: Partial<typeof a>) =>
onChange({ ...plan, marketAnalysis: { ...a, ...patch } });
const input = (
label: string,
value: string,
change: (v: string) => void,
type = 'text',
) => (
<label className="grid min-w-0 gap-1 text-sm">
{label}
<input
className="min-w-0 rounded border p-2"
type={type}
step={type === 'number' ? 'any' : undefined}
value={value}
onChange={(e) => change(e.target.value)}
/>
</label>
);
return (
<details className="my-4 rounded border p-3">
<summary>Análise de Mercado — segmentos e hipóteses</summary>
<p className="my-2 text-sm">
Obrigatório para completar esta tabela: ano-base, horizonte de 2
a 10 anos e, por segmento, nome, clientes potenciais inteiros,
crescimento anual e fonte ou hipótese identificada. Não são
vendas nem procura confirmada. O horizonte sugerido de três anos
é editável; não representa dados económicos.
</p>
<div className="grid gap-3 sm:grid-cols-2">
{input(
'Ano-base de mercado',
a.baseYear,
(v) => update({ baseYear: v }),
'number',
)}
{input(
'Horizonte de mercado (anos)',
a.years,
(v) => update({ years: v }),
'number',
)}
</div>
{a.segments.map((s, i) => (
<fieldset
key={i}
className="my-3 grid gap-3 rounded border p-3 sm:grid-cols-2"
>
<legend>Segmento {i + 1}</legend>
{(
[
['label', 'Nome do segmento', 'text'],
[
'customers',
'Clientes potenciais no ano-base',
'number',
],
[
'growthPercent',
'Crescimento anual do segmento (%)',
'number',
],
[
'basis',
'Fonte e data, ou hipótese ilustrativa',
'text',
],
] as const
).map(([key, label, type]) => (
<div className="min-w-0" key={key}>
{input(
label,
s[key],
(v) =>
update({
segments: a.segments.map((r, j) =>
j === i ? { ...r, [key]: v } : r,
),
}),
type,
)}
</div>
))}
<button
type="button"
className="rounded border p-2"
onClick={() =>
update({
segments: a.segments.filter((_, j) => j !== i),
})
}
>
Remover segmento {i + 1}
</button>
</fieldset>
))}
<button
type="button"
className="my-2 rounded border p-2"
disabled={a.segments.length >= 100}
onClick={() =>
update({
segments: [
...a.segments,
{
label: '',
customers: '',
growthPercent: '',
basis: '',
},
],
})
}
>
Adicionar segmento de mercado
</button>
<InvestmentReportTables
tables={[
buildComplementaryTables(
{},
{ ...plan, marketAnalysis: a },
)[0],
]}
/>
</details>
);
}
@@ -3,6 +3,9 @@ import {
type ProjectMilestone,
type TeamNeed,
} from '@/lib/project-dossier';
import { restoreBusinessPlanSnapshot } from '@/lib/business-financial-plan';
import { buildComplementaryTables } from '@/lib/complementary-report';
import { InvestmentReportTables } from './investment-report-tables';
const teamKeys = [
'competency',
@@ -28,15 +31,84 @@ function update<T extends Record<string, string>>(
return rows.map((row, i) => (i === index ? { ...row, [key]: value } : row));
}
function unreadable(value: string, rows: unknown[], optional: string[]) {
try {
const parsed: unknown = JSON.parse(value || '[]');
return (
!Array.isArray(parsed) ||
parsed.length !== rows.length ||
parsed.length > 100 ||
parsed.some((row) =>
optional.some(
(key) => key in row && typeof row[key] !== 'string',
),
)
);
} catch {
return true;
}
}
function SupplementaryFields({
row,
fields,
change,
}: {
row: Record<string, string | undefined>;
fields: readonly (readonly [string, string, string])[];
change: (key: string, value: string) => void;
}) {
return (
<>
{fields.map(([key, label, type]) => (
<label className="grid min-w-0 gap-1 text-sm" key={key}>
{label}
<input
className="min-w-0 rounded border p-2"
type={type}
min={type === 'number' ? 0 : undefined}
step={
type === 'number'
? key === 'monthly_salary'
? '0.01'
: '1'
: undefined
}
value={row[key] ?? ''}
onChange={(e) => change(key, e.target.value)}
/>
</label>
))}
</>
);
}
export function ProjectTeamPlanner({
value,
onChange,
financialPlanSnapshot = '',
}: {
value: string;
onChange: (value: string) => void;
financialPlanSnapshot?: string;
}) {
const rows = readRows<TeamNeed>(value, teamKeys);
const persist = (next: TeamNeed[]) => onChange(JSON.stringify(next));
if (
unreadable(value, rows, [
'department',
'quantity',
'monthly_salary',
'start_month',
'end_month',
])
)
return (
<p role="alert">
O plano de equipa guardado contém linhas não reconhecidas. O
original foi preservado e não será substituído por este editor.
</p>
);
return (
<section
className="space-y-4"
@@ -47,6 +119,12 @@ export function ProjectTeamPlanner({
custo e prazo. Não é uma certificação nem uma correspondência
automática a prestadores.
</p>
<p className="text-sm">
Para o mapa de pessoal: função, departamento, quantidade,
remuneração mensal e meses inicial/final são necessários. Os
restantes campos são opcionais; não confundir custo de formação
ou contratação com salário.
</p>
{rows.map((row, index) => (
<fieldset
key={index}
@@ -55,6 +133,42 @@ export function ProjectTeamPlanner({
<legend className="font-medium">
Necessidade {index + 1}
</legend>
<SupplementaryFields
row={row}
fields={[
[
'department',
'Departamento (mapa de pessoal)',
'text',
],
[
'quantity',
'Quantidade de pessoas (inteiro)',
'number',
],
[
'monthly_salary',
'Remuneração mensal por pessoa (moeda do projecto)',
'number',
],
[
'start_month',
'Mês inicial no plano (1 = Janeiro do ano inicial)',
'number',
],
['end_month', 'Mês final no plano', 'number'],
]}
change={(key, value) =>
persist(
update(
rows,
index,
key as keyof TeamNeed,
value,
),
)
}
/>
<label className="text-sm">
Competência ou função
<input
@@ -180,6 +294,14 @@ export function ProjectTeamPlanner({
>
Adicionar competência ou lacuna
</button>
<InvestmentReportTables
tables={[
buildComplementaryTables(
{ project_team_snapshot: value },
restoreBusinessPlanSnapshot(financialPlanSnapshot),
)[2],
]}
/>
</section>
);
}
@@ -194,6 +316,13 @@ export function ProjectMilestonePlanner({
const rows = readRows<ProjectMilestone>(value, milestoneKeys);
const persist = (next: ProjectMilestone[]) =>
onChange(JSON.stringify(next));
if (unreadable(value, rows, ['start_date', 'responsible', 'department']))
return (
<p role="alert">
O plano de marcos guardado contém linhas não reconhecidas. O
original foi preservado e não será substituído por este editor.
</p>
);
return (
<section className="space-y-4" aria-label="Marcos de execução">
<p className="text-sm text-slate-700">
@@ -201,12 +330,35 @@ export function ProjectMilestonePlanner({
valores são declarados; não alteram automaticamente o plano
financeiro.
</p>
<p className="text-sm">
Para completar o relatório, indique título, início, término,
responsável, departamento e orçamento. O montante realizado é
opcional.
</p>
{rows.map((row, index) => (
<fieldset
key={index}
className="grid gap-3 rounded border p-3 sm:grid-cols-2"
>
<legend className="font-medium">Marco {index + 1}</legend>
<SupplementaryFields
row={row}
fields={[
['start_date', 'Data de início', 'date'],
['responsible', 'Responsável pelo marco', 'text'],
['department', 'Departamento do marco', 'text'],
]}
change={(key, value) =>
persist(
update(
rows,
index,
key as keyof ProjectMilestone,
value,
),
)
}
/>
<label className="text-sm">
Marco ou resultado
<input
@@ -334,6 +486,14 @@ export function ProjectMilestonePlanner({
>
Adicionar marco
</button>
<InvestmentReportTables
tables={[
buildComplementaryTables(
{ project_execution_snapshot: value },
null,
)[1],
]}
/>
</section>
);
}
@@ -21,6 +21,7 @@ import { buildFinancialFiscalBridge } from '@/lib/financial-fiscal-bridge';
import { BusinessPlanWarnings } from '@/components/business-plan-warnings';
import { SimulationAnnualExample } from '@/components/simulation-annual-example';
import { IntegralFinancialPlan } from '@/components/integral-financial-plan';
import { MarketAnalysisPlan } from '@/components/market-analysis-plan';
const emptyPlan: BusinessFinancialPlanInput = {
currency: '',
@@ -940,6 +941,7 @@ export function SimulationBusinessPlan({
/>
)}
<IntegralFinancialPlan plan={plan} onChange={savePlan} />
<MarketAnalysisPlan plan={plan} onChange={savePlan} />
<div className="my-3 flex flex-wrap items-end gap-3 rounded border p-3">
<label className="grid gap-1 text-sm">
Importar plano financeiro InvestMoz (.json, até 60 KB)
@@ -3473,6 +3473,9 @@ export function SimulationForm() {
{current.id === 'team' && (
<>
<ProjectTeamPlanner
financialPlanSnapshot={String(
draft.business_plan_snapshot ?? '',
)}
value={String(draft.project_team_snapshot ?? '')}
onChange={(value) =>
change('project_team_snapshot', value)
@@ -82,6 +82,16 @@ function validCurrency(value: string): boolean {
}
export type BusinessFinancialPlanInput = {
marketAnalysis?: {
baseYear: string;
years: string;
segments: {
label: string;
customers: string;
growthPercent: string;
basis: string;
}[];
};
reportAssumptions?: {
startYear: string;
openingFixedAssets: string;
+433
View File
@@ -0,0 +1,433 @@
import {
forecastBusinessPlan,
type BusinessFinancialPlanInput,
} from './business-financial-plan.ts';
import {
reportMoney,
displayReportMoney,
type InvestmentReportTable,
} from './integral-financial-report.ts';
import {
readRows,
type ProjectMilestone,
type TeamNeed,
} from './project-dossier.ts';
const unknown = 'Por determinar';
function structuredRows<T>(raw: string, keys: string[], optional: string[]) {
const rows = readRows<T>(raw, keys).filter((r) =>
optional.every(
(k) =>
!(k in (r as object)) ||
typeof (r as Record<string, unknown>)[k] === 'string',
),
);
try {
const parsed: unknown = JSON.parse(raw || '[]');
return {
rows,
valid:
Array.isArray(parsed) &&
parsed.length === rows.length &&
rows.length <= 100,
};
} catch {
return { rows, valid: false };
}
}
const amount = (s: string | undefined) => {
if (!s || !/^\d+(?:\.\d{1,2})?$/.test(s))
throw Error(
'Indique montantes não negativos com até duas casas decimais.',
);
const [a, b = ''] = s.split('.');
return BigInt(a) * 100n + BigInt(b.padEnd(2, '0'));
};
const integer = (s: string | undefined, min: number, max: number) => {
if (
!s ||
!/^\d+$/.test(s) ||
!Number.isSafeInteger(Number(s)) ||
Number(s) < min ||
Number(s) > max
)
throw Error(`Indique um inteiro entre ${min} e ${max}.`);
return Number(s);
};
const date = (s: string) =>
/^\d{4}-\d{2}-\d{2}$/.test(s) &&
Number.isFinite(Date.parse(s)) &&
new Date(s).toISOString().slice(0, 10) === s;
const table = (
id: string,
title: string,
headers: string[],
): InvestmentReportTable => ({
id,
title,
headers,
rows: [],
issues: [],
notes: [
'Informação declarada ou hipótese identificada pelo investidor; não confirma procura, contratação ou execução.',
],
});
export function isMarketAnalysis(
value: unknown,
): value is NonNullable<BusinessFinancialPlanInput['marketAnalysis']> {
if (!value || typeof value !== 'object' || Array.isArray(value))
return false;
const m = value as Record<string, unknown>;
return (
typeof m.baseYear === 'string' &&
typeof m.years === 'string' &&
Array.isArray(m.segments) &&
m.segments.length <= 100 &&
m.segments.every(
(s) =>
s &&
typeof s === 'object' &&
['label', 'customers', 'growthPercent', 'basis'].every(
(k) => typeof s[k] === 'string' && s[k].length <= 2000,
),
)
);
}
export function buildComplementaryTables(
draft: Record<string, string | string[]>,
plan: BusinessFinancialPlanInput | null,
) {
const market = table('market-analysis', 'Análise de Mercado', ['Segmento']);
const milestones = table('milestones', 'Marcos', [
'Marco',
'Início',
'Término',
'Responsável',
'Departamento',
'Orçamento',
'Realizado',
]);
const staff = table('personnel', 'Pessoal', ['Função / departamento']);
const m = plan?.marketAnalysis;
const declaredCurrency =
String(draft.currency ?? '') || plan?.currency || unknown;
const sameCurrency =
!draft.currency || !plan?.currency || draft.currency === plan.currency;
milestones.notes.push(`Moeda dos montantes: ${declaredCurrency}.`);
staff.notes.push(`Moeda das remunerações: ${declaredCurrency}.`);
if (!sameCurrency)
staff.issues.push(
'A moeda do projecto difere da moeda do plano financeiro. A reconciliação fica por determinar, sem conversão automática.',
);
market.notes.push(
'O total é a soma aritmética dos segmentos, sem deduplicação de clientes. Confirme eventuais sobreposições antes de o interpretar como dimensão única do mercado.',
);
try {
if (!isMarketAnalysis(m) || !m.segments.length)
throw Error(
'Indique segmentos, clientes potenciais, crescimento e fonte ou hipótese para completar a análise; os dados guardados não serão substituídos automaticamente.',
);
const year = integer(m.baseYear, 1900, 9999),
years = integer(m.years, 2, 10);
if (year + years - 1 > 9999)
throw Error('O horizonte de mercado excede o ano 9999.');
market.headers.push(
...Array.from({ length: years }, (_, i) => String(year + i)),
'Crescimento anual composto',
);
const totals = Array(years).fill(0) as number[];
for (const [i, s] of m.segments.entries()) {
try {
if (!s.label?.trim() || !s.basis?.trim())
throw Error('Indique nome e fonte ou hipótese.');
let clients = integer(s.customers, 0, Number.MAX_SAFE_INTEGER);
if (
typeof s.growthPercent !== 'string' ||
!/^-?\d+(?:\.\d{1,4})?$/.test(s.growthPercent) ||
!Number.isFinite(Number(s.growthPercent)) ||
Number(s.growthPercent) < -100
)
throw Error(
'Indique crescimento igual ou superior a −100%.',
);
const growth = Number(s.growthPercent),
series = [clients];
const [whole, fraction = ''] = s.growthPercent
.replace('-', '')
.split('.');
const growthUnits =
(BigInt(whole) * 10000n + BigInt(fraction.padEnd(4, '0'))) *
(s.growthPercent.startsWith('-') ? -1n : 1n);
for (let y = 1; y < years; y++) {
const next =
(BigInt(clients) * (1000000n + growthUnits) + 500000n) /
1000000n;
clients = Number(next);
if (!Number.isSafeInteger(clients))
throw Error(
'A projecção excede a precisão de clientes inteiros.',
);
series.push(clients);
}
series.forEach((n, y) => (totals[y] += n));
if (totals.some((n) => !Number.isSafeInteger(n)))
throw Error(
'O total excede a precisão de clientes inteiros.',
);
const cagr =
series[0] === 0
? unknown
: (
((series.at(-1)! / series[0]) **
(1 / (years - 1)) -
1) *
100
)
.toFixed(2)
.replace('.', ',') + '%';
market.rows.push([s.label, ...series.map(String), cagr]);
market.notes.push(`${s.label}: ${s.basis}`);
if (growth > 100)
market.notes.push(
`${s.label}: crescimento superior a 100%; aviso não bloqueante.`,
);
} catch (e) {
market.issues.push(
`Segmento ${i + 1}: ${(e as Error).message}`,
);
market.rows.push([
s?.label || `Segmento ${i + 1}`,
...Array(years + 1).fill(unknown),
]);
}
}
const complete = market.issues.length === 0;
const cagr =
complete && totals[0] > 0
? (
((totals.at(-1)! / totals[0]) ** (1 / (years - 1)) - 1) *
100
)
.toFixed(2)
.replace('.', ',') + '%'
: unknown;
market.rows.push([
'Total de clientes potenciais',
...totals.map((n) => (complete ? String(n) : unknown)),
cagr,
]);
market.notes.push(
'Clientes potenciais não são vendas. Projecção anual por segmento: ano anterior × (1 + crescimento/100), arredondada à pessoa; crescimento composto calculado entre primeiro e último ano. Nenhuma transferência automática para receitas.',
);
} catch (e) {
market.issues.push((e as Error).message);
}
const raw = String(draft.project_execution_snapshot ?? '');
const milestoneData = structuredRows<ProjectMilestone>(
raw,
['title', 'due_date', 'status', 'planned_amount', 'actual_amount'],
['start_date', 'responsible', 'department'],
);
const rows = milestoneData.rows;
let budget = 0n,
actual = 0n,
budgetComplete = rows.length > 0 && milestoneData.valid,
actualComplete = rows.length > 0 && milestoneData.valid;
if (!milestoneData.valid)
milestones.issues.push(
'Há linhas de marcos não reconhecidas; os totais permanecem por determinar. O original foi preservado.',
);
if (!rows.length)
milestones.issues.push(
raw && raw !== '[]'
? 'O plano de marcos não tem uma estrutura reconhecida; conserve e reveja o original.'
: 'Adicione os marcos aplicáveis para completar a tabela.',
);
for (const [i, r] of rows.entries()) {
let planned = unknown,
realised = unknown;
try {
budget += amount(r.planned_amount);
planned = reportMoney(amount(r.planned_amount));
} catch {
budgetComplete = false;
milestones.issues.push(
`Marco ${i + 1}: orçamento em falta ou inválido.`,
);
}
if (r.actual_amount !== '') {
try {
actual += amount(r.actual_amount);
realised = reportMoney(amount(r.actual_amount));
} catch {
actualComplete = false;
milestones.issues.push(`Marco ${i + 1}: realizado inválido.`);
}
} else actualComplete = false;
if (
!r.title.trim() ||
!r.responsible?.trim() ||
!r.department?.trim() ||
!date(r.start_date ?? '') ||
!date(r.due_date) ||
r.start_date! > r.due_date
)
milestones.issues.push(
`Marco ${i + 1}: complete título, responsável, departamento e datas de início/término válidas e ordenadas.`,
);
milestones.rows.push([
r.title || unknown,
r.start_date || unknown,
r.due_date || unknown,
r.responsible || unknown,
r.department || unknown,
planned,
realised,
]);
}
milestones.rows.push([
'Total',
'',
'',
'',
'',
budgetComplete ? reportMoney(budget) : unknown,
actualComplete ? reportMoney(actual) : unknown,
]);
milestones.notes.push(
'Título, datas, responsável, departamento e orçamento são necessários para completar cada marco; realizado é opcional e vazio não significa zero. Orçamentos não são somados automaticamente ao investimento nem à tesouraria.',
);
const teamData = structuredRows<TeamNeed>(
String(draft.project_team_snapshot ?? ''),
['competency', 'state', 'action', 'estimated_cost', 'due_date'],
[
'department',
'quantity',
'monthly_salary',
'start_month',
'end_month',
],
);
const team = teamData.rows;
const periods = plan?.periods ?? 12;
const year = Number(plan?.reportAssumptions?.startYear);
const calendar =
Number.isInteger(year) &&
year >= 1900 &&
year + Math.floor((periods - 1) / 12) <= 9999;
const labels = Array.from({ length: periods }, (_, i) =>
calendar
? `${year + Math.floor(i / 12)}-${String((i % 12) + 1).padStart(2, '0')}`
: `Mês ${i + 1}`,
);
const years = [
...new Set(
labels.map((l, i) =>
calendar ? l.slice(0, 4) : `Ano ${Math.floor(i / 12) + 1}`,
),
),
];
staff.headers.push(
...labels,
...years.map((y, i) => (periods < (i + 1) * 12 ? `${y} (parcial)` : y)),
);
const totals = Array(periods).fill(0n) as bigint[];
let complete = team.length > 0 && teamData.valid,
headcount = 0;
if (!teamData.valid)
staff.issues.push(
'Há linhas de pessoal não reconhecidas; os totais permanecem por determinar. O original foi preservado.',
);
if (!plan)
staff.issues.push(
'O plano financeiro não está disponível para definir o horizonte e reconciliar a despesa de pessoal.',
);
if (!team.length)
staff.issues.push(
'Adicione funções e respectivas quantidades/remunerações para completar o mapa de pessoal.',
);
for (const [i, r] of team.entries()) {
try {
if (!r.competency.trim() || !r.department?.trim())
throw Error('Indique função e departamento.');
const count = integer(r.quantity, 0, 1000000),
salary = amount(r.monthly_salary),
start = integer(r.start_month, 1, periods),
end = integer(r.end_month, 1, periods);
if (start > end) throw Error('O mês final precede o mês inicial.');
headcount += count;
const values = totals.map((_, j) =>
j + 1 >= start && j + 1 <= end ? salary * BigInt(count) : 0n,
);
values.forEach((v, j) => (totals[j] += v));
const annual = years.map((_, y) =>
values.slice(y * 12, y * 12 + 12).reduce((a, b) => a + b, 0n),
);
staff.rows.push([
`${r.competency} / ${r.department} (${count} pessoas × ${displayReportMoney(reportMoney(salary))}/mês; meses ${start}–${end})`,
...values.map(reportMoney),
...annual.map(reportMoney),
]);
} catch (e) {
complete = false;
staff.issues.push(`Função ${i + 1}: ${(e as Error).message}`);
staff.rows.push([
r.competency || `Função ${i + 1}`,
...Array(periods + years.length).fill(unknown),
]);
}
}
const annual = years.map((_, y) =>
totals.slice(y * 12, y * 12 + 12).reduce((a, b) => a + b, 0n),
);
staff.rows.push([
'Folha salarial prevista',
...[...totals, ...annual].map((v) =>
complete ? reportMoney(v) : unknown,
),
]);
staff.notes.push(
`Postos declarados nas linhas: ${complete ? headcount : unknown}; não representa pessoas únicas nem postos simultâneos. Remuneração mensal por pessoa × quantidade × meses activos; sem encargos presumidos. Competências, resposta, custo de formação/contratação e prazo são opcionais para este mapa e não substituem salários.`,
);
staff.notes.push(
calendar
? 'Calendário: Janeiro do ano inicial do plano financeiro.'
: 'Ano inicial do plano em falta: meses relativos, sem datas presumidas.',
);
if (plan && complete && sameCurrency) {
try {
const f = forecastBusinessPlan(plan);
const expected = f.rows.map((month) =>
amount(month.payrollExpense),
);
const differences = totals.map((v, i) => v - expected[i]);
staff.rows.push([
'Diferença face à despesa de pessoal no plano',
...differences.map(reportMoney),
...years.map((_, y) =>
reportMoney(
differences
.slice(y * 12, y * 12 + 12)
.reduce((a, b) => a + b, 0n),
),
),
]);
if (differences.some((v) => v !== 0n))
staff.issues.push(
'O mapa de pessoal diverge da despesa de pessoal do plano. Reveja os pressupostos; nenhum valor financeiro foi sobrescrito.',
);
} catch {
staff.issues.push(
'Não foi possível reconciliar com o plano financeiro; reveja os dados do plano.',
);
}
} else
staff.issues.push(
'Reconciliação com o plano financeiro por determinar.',
);
return [market, milestones, staff];
}
@@ -1,4 +1,5 @@
import { displayValue } from './display-value.ts';
import { buildComplementaryTables } from './complementary-report.ts';
import {
buildIntegralFinancialTables,
displayReportMoney,
@@ -523,6 +524,11 @@ function makeSections(
const financialPlan = restoreBusinessPlanSnapshot(
text(draft, 'business_plan_snapshot'),
);
const complementaryTables = buildComplementaryTables(draft, financialPlan);
for (const [i, id] of ['market', 'execution', 'team'].entries()) {
const section = sections.get(id as DossierReportSectionId);
if (section) section.tables = [complementaryTables[i]];
}
if (finance && financialPlan?.reportAssumptions) {
finance.tables = buildIntegralFinancialTables(financialPlan);
const periods = financialPlan.periods ?? 12;
+8
View File
@@ -74,6 +74,11 @@ import {
} from './project-readiness.ts';
export type TeamNeed = {
department?: string;
quantity?: string;
monthly_salary?: string;
start_month?: string;
end_month?: string;
competency: string;
state: 'available' | 'gap' | 'unknown';
action: string;
@@ -82,6 +87,9 @@ export type TeamNeed = {
};
export type ProjectMilestone = {
start_date?: string;
responsible?: string;
department?: string;
title: string;
due_date: string;
status: 'planned' | 'in_progress' | 'completed';
@@ -0,0 +1,197 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import JSZip from 'jszip';
import { complementaryFixture } from './fixtures/complementary-plan.mjs';
import { buildComplementaryTables } from '../../resources/js/lib/complementary-report.ts';
import { buildIntegralFinancialTables } from '../../resources/js/lib/integral-financial-report.ts';
import {
restoreBusinessPlanSnapshot,
serializeBusinessPlanSnapshot,
} from '../../resources/js/lib/business-financial-plan.ts';
import {
partitionSimulationDraft,
restoreSimulationDraft,
} from '../../resources/js/lib/simulation-form.ts';
import {
createProjectDossierReport,
createProjectDossierPrintHtml,
generateProjectDossierDocx,
} from '../../resources/js/lib/project-dossier-report.ts';
void test('personnel in a different currency remains unreconciled without automatic conversion', () => {
const { plan, draft } = complementaryFixture();
const staff = buildComplementaryTables(
{ ...draft, currency: 'USD' },
plan,
)[2];
assert.match(staff.issues.join(' '), /moeda/);
assert.ok(
!staff.rows.some(
(r) => r[0] === 'Diferença face à despesa de pessoal no plano',
),
);
});
void test('malformed rows never produce misleading partial totals or erase original data', () => {
const { plan, draft, team, milestones } = complementaryFixture();
const input = {
...draft,
project_team_snapshot: JSON.stringify([...team, { bad: 'row' }]),
project_execution_snapshot: JSON.stringify([
...milestones,
{ ...milestones[0], responsible: 42 },
]),
};
const before = JSON.stringify(input);
const t = buildComplementaryTables(input, plan);
assert.ok(t[1].issues.length);
assert.equal(t[1].rows.at(-1).at(-2), 'Por determinar');
assert.ok(t[2].issues.length);
assert.equal(t[2].rows.at(-1)[1], 'Por determinar');
assert.equal(JSON.stringify(input), before);
plan.marketAnalysis.segments = [null];
assert.ok(buildComplementaryTables(draft, plan)[0].issues.length);
});
void test('market projects integer customers and CAGR, never replaces sales; high growth is a warning', () => {
const { plan, draft } = complementaryFixture();
const before = buildIntegralFinancialTables(plan);
let t = buildComplementaryTables(draft, plan)[0];
assert.deepEqual(t.rows[0], [
'Segmento ilustrativo',
'100',
'110',
'121',
'10,00%',
]);
assert.equal(t.issues.length, 0);
plan.marketAnalysis.segments[0].growthPercent = '150';
t = buildComplementaryTables(draft, plan)[0];
assert.deepEqual(t.rows[0].slice(1, 4), ['100', '250', '625']);
assert.equal(t.issues.length, 0);
assert.match(t.notes.join(' '), /não bloqueante/);
assert.deepEqual(buildIntegralFinancialTables(plan), before);
plan.marketAnalysis.segments[0].customers = '0';
assert.equal(
buildComplementaryTables(draft, plan)[0].rows[0].at(-1),
'Por determinar',
);
plan.marketAnalysis.segments[0].growthPercent = '-100';
assert.equal(buildComplementaryTables(draft, plan)[0].issues.length, 0);
plan.marketAnalysis.segments[0].customers = '1.5';
assert.ok(buildComplementaryTables(draft, plan)[0].issues.length);
plan.marketAnalysis.segments[0].customers = '100';
plan.marketAnalysis.segments[0].basis = '';
assert.ok(buildComplementaryTables(draft, plan)[0].issues.length);
});
void test('milestone totals distinguish optional unknown actuals, invalid dates and exact centavos', () => {
const { plan, draft, milestones } = complementaryFixture();
let t = buildComplementaryTables(draft, plan)[1];
assert.equal(t.issues.length, 0);
assert.deepEqual(t.rows.at(-1).slice(-2), ['100.25', 'Por determinar']);
milestones[0].actual_amount = '0';
milestones[0].start_date = '2027-02-30';
draft.project_execution_snapshot = JSON.stringify(milestones);
t = buildComplementaryTables(draft, plan)[1];
assert.ok(t.issues.length);
assert.equal(t.rows.at(-1).at(-1), '0.00');
milestones[0].start_date = '2027-03-01';
assert.match(
buildComplementaryTables(
{
...draft,
project_execution_snapshot: JSON.stringify(milestones),
},
plan,
)[1].issues.join(' '),
/ordenadas/,
);
});
void test('personnel reconciles 13 months and partial years, preserves financial figures on mismatch', () => {
const { plan, draft, team } = complementaryFixture();
const before = buildIntegralFinancialTables(plan);
let t = buildComplementaryTables(draft, plan)[2];
assert.equal(t.issues.length, 0);
assert.deepEqual(
t.rows.find((r) => r[0] === 'Folha salarial prevista').slice(-2),
['2400.00', '200.00'],
);
assert.ok(
t.rows
.at(-1)
.slice(1)
.every((x) => x === '0.00'),
);
team[0].monthly_salary = '100.01';
draft.project_team_snapshot = JSON.stringify(team);
t = buildComplementaryTables(draft, plan)[2];
assert.equal(t.rows.at(-1)[1], '0.02');
assert.match(t.issues.join(' '), /diverge/);
assert.deepEqual(buildIntegralFinancialTables(plan), before);
team[0].quantity = '1.5';
assert.ok(
buildComplementaryTables(
{ ...draft, project_team_snapshot: JSON.stringify(team) },
plan,
)[2].issues.length,
);
});
void test('legacy rows remain preserved and missing supplements remain explicit, not zero', () => {
const { plan, draft, team, milestones } = complementaryFixture();
delete plan.marketAnalysis;
for (const k of [
'department',
'quantity',
'monthly_salary',
'start_month',
'end_month',
])
delete team[0][k];
for (const k of ['department', 'responsible', 'start_date'])
delete milestones[0][k];
const old = {
...draft,
project_team_snapshot: JSON.stringify(team),
project_execution_snapshot: JSON.stringify(milestones),
};
const t = buildComplementaryTables(old, plan);
assert.ok(t.every((x) => x.issues.length));
assert.equal(t[2].rows[0][1], 'Por determinar');
assert.equal(team[0].estimated_cost, '');
assert.equal(t[1].rows[0].at(-2), '100.25');
});
void test('economic draft roundtrip and existing Word/print exports include three complementary tables', async () => {
const { plan, draft } = complementaryFixture();
const parts = partitionSimulationDraft(draft);
const restored = restoreSimulationDraft(
parts.personal_snapshot,
parts.economic_snapshot,
);
assert.equal(restored.project_team_snapshot, draft.project_team_snapshot);
assert.equal(
restored.project_execution_snapshot,
draft.project_execution_snapshot,
);
const recovered = restoreBusinessPlanSnapshot(
serializeBusinessPlanSnapshot(plan),
);
assert.deepEqual(recovered.marketAnalysis, plan.marketAnalysis);
assert.deepEqual(
buildComplementaryTables(restored, recovered),
buildComplementaryTables(draft, plan),
);
const report = createProjectDossierReport(draft, {
selectedSections: new Set(['market', 'team', 'execution', 'finance']),
});
assert.equal(report.sections.flatMap((s) => s.tables ?? []).length, 10);
const html = await createProjectDossierPrintHtml(report, []);
for (const title of ['Análise de Mercado', 'Marcos', 'Pessoal'])
assert.ok(html.includes(title));
const doc = await generateProjectDossierDocx(report, []);
const zip = await JSZip.loadAsync(
doc instanceof Blob ? await doc.arrayBuffer() : doc,
);
const xml = await zip.file('word/document.xml').async('string');
for (const title of ['Análise de Mercado', 'Marcos', 'Pessoal'])
assert.ok(xml.includes(title));
});
@@ -0,0 +1,9 @@
import { financialReportFixture } from './integral-financial-plan.mjs';
import { serializeBusinessPlanSnapshot } from '../../../resources/js/lib/business-financial-plan.ts';
export function complementaryFixture() {
const plan=financialReportFixture(13);
plan.marketAnalysis={baseYear:'2027',years:'3',segments:[{label:'Segmento ilustrativo',customers:'100',growthPercent:'10',basis:'Hipótese sintética de QA; não é procura observada.'}]};
const team=[{competency:'Operação',department:'Operações',quantity:'2',monthly_salary:'100.00',start_month:'1',end_month:'13',state:'gap',action:'',estimated_cost:'',due_date:''}];
const milestones=[{title:'Preparação ilustrativa',start_date:'2027-01-01',due_date:'2027-02-01',responsible:'Responsável sintético',department:'Operações',status:'planned',planned_amount:'100.25',actual_amount:''}];
return {plan,team,milestones,draft:{currency:'MZN',project_title:'QA complementar sintético',business_plan_snapshot:serializeBusinessPlanSnapshot(plan),project_team_snapshot:JSON.stringify(team),project_execution_snapshot:JSON.stringify(milestones)}};
}