Files
Investidor-V2/resources/js/lib/investment-step-help.ts
T
2026-11-17 08:55:48 +02:00

169 lines
8.1 KiB
TypeScript

export type InvestmentHelp = {
code: string;
title: string;
instruction: string;
example: string;
purpose: string;
};
// Orientation only: the existing path continues to determine applicability and permissions.
const stageHelp: Record<string, [string, string, string]> = {
S01: [
'Descreva a ideia, o produto ou serviço e os clientes que pretende servir.',
'Produzir hortícolas para fornecer mercados locais.',
'Definir o investimento que irá preparar nas etapas seguintes.',
],
S02: [
'Reúna informação sobre o mercado, os recursos necessários e os principais riscos. Consulte as ferramentas disponíveis no dossier.',
'Compare procura, fornecedores, localização e custos previstos.',
'Identificar o que já sabe e a informação que ainda precisa de obter.',
],
S03: [
'Compare as receitas e os custos estimados e registe a sua conclusão sobre a viabilidade.',
'Teste como uma redução das vendas afecta o resultado estimado.',
'Apoiar a sua decisão com pressupostos explícitos. Uma simulação é uma estimativa.',
],
S04: [
'Organize os recursos, os participantes e o plano de realização do investimento.',
'Indique quem fará o quê e quais os recursos a mobilizar.',
'Transformar a ideia num plano de preparação e execução.',
],
S05: [
'Confira a situação da entidade e os elementos de constituição e registo aplicáveis. Reutilize os dados já disponíveis.',
'Se a empresa já existe, confira os seus dados antes de os voltar a preencher.',
'Preparar a identificação da entidade que realizará o investimento.',
],
S06: [
'Reúna os dados e associe os documentos indicados para este investimento. Reveja o que ainda falta.',
'Associe um documento já disponível no dossier ao requisito correspondente.',
'Organizar o dossier antes de preparar uma entrega.',
],
S07: [
'Confira o destinatário e os requisitos da entrega aplicável. Se já entregou, registe a referência e a evidência disponível.',
'Registe a data e o protocolo de uma entrega efectivamente realizada.',
'Acompanhar a entrega sem confundir preparação com submissão.',
],
S08: [
'Consulte as licenças indicadas para a actividade e localização. Prepare os elementos em falta e registe os actos já documentados.',
'Identifique a entidade competente e associe a licença recebida, quando disponível.',
'Acompanhar o licenciamento aplicável ao seu projecto.',
],
S09: [
'Indique se o investimento necessita de terra e explique a situação conhecida.',
'Indique se utilizará instalações existentes ou se precisa de uma nova área.',
'Adaptar a preparação da terra às necessidades do investimento.',
],
S10: [
'Reúna a informação da localização e os documentos relativos à regularização da terra indicados no percurso.',
'Associe o documento disponível e identifique a área a que se refere.',
'Organizar a preparação da terra sem presumir direitos ainda não documentados.',
],
S11: [
'Confira a regularização aplicável e registe o resultado com o respectivo fundamento.',
'Registe a referência e a data do documento que comprova a situação declarada.',
'Distinguir a preparação da confirmação documental da regularização.',
],
S12: [
'Compare os recursos próprios com o investimento previsto e indique se necessita de financiamento externo.',
'Separe o capital disponível do montante que ainda precisa de mobilizar.',
'Dimensionar a necessidade de financiamento do projecto.',
],
S13: [
'Prepare a informação pedida pelo potencial financiador e registe os pontos de negociação.',
'Organize projecções, documentos solicitados e condições em discussão.',
'Acompanhar a análise e a negociação do financiamento.',
],
S14: [
'Registe a decisão recebida do financiador e associe a evidência disponível.',
'Indique a referência da comunicação recebida e as condições nela apresentadas.',
'Conservar a decisão real, sem tratar uma candidatura como aprovação.',
],
S15: [
'Confira as condições de fecho e acompanhe os desembolsos efectivamente documentados.',
'Registe a referência e a data de uma disponibilização de fundos confirmada.',
'Acompanhar a concretização do financiamento e as condições pendentes.',
],
S16: [
'Organize as actividades de implementação e acompanhe os recursos e os prazos.',
'Crie uma tarefa para instalar equipamento com responsável e data prevista.',
'Acompanhar a execução do investimento.',
],
S17: [
'Prepare as inspecções e os testes aplicáveis e reúna os documentos para a operação.',
'Associe um relatório de inspecção ou a licença recebida à etapa correspondente.',
'Identificar o que falta antes do início de operação.',
],
S18: [
'Confira as condições indicadas no percurso e registe o início de operação quando estiver documentado.',
'Indique a data efectiva de início e a respectiva referência documental.',
'Distinguir a previsão de arranque do início efectivo da actividade.',
],
S19: [
'Actualize o acompanhamento do projecto e reveja as tarefas e os documentos que necessitam de atenção.',
'Registe uma tarefa de acompanhamento com responsável e prazo.',
'Manter o dossier útil ao longo da operação.',
],
};
export function investmentStageHelp(
code: string,
title: string,
): InvestmentHelp {
const [instruction, example, purpose] = stageHelp[code] ?? [
'Consulte as indicações desta etapa, confira os dados disponíveis e complete o que estiver em falta.',
'Registe uma referência documental que sustente a informação preenchida.',
'Acompanhar a preparação desta etapa no seu dossier.',
];
return { code, title, instruction, example, purpose };
}
export const preparationHelp: InvestmentHelp[] = [
{
code: 'help-choices',
title: 'Escolhas e dados do investimento',
instruction:
'Escolha a oportunidade, o sector e a localização que correspondem ao seu investimento. Confira os dados já recuperados.',
example:
'Seleccione uma oportunidade existente ou indique o sector e a localização da sua ideia.',
purpose: 'Adaptar o percurso ao investimento que pretende realizar.',
},
{
code: 'help-declarations',
title: 'Declarações deste investimento',
instruction:
'Complete apenas as declarações conhecidas e confira os documentos associados. Use as opções apresentadas conforme a sua situação.',
example:
'Indique a moeda do projecto e confira a situação da entidade.',
purpose:
'Preparar os dados do processo e identificar o que ainda precisa de esclarecimento.',
},
{
code: 'help-review',
title: 'Revisão e confirmação',
instruction:
'Clique em “Rever dados antes de guardar”. Compare as alterações apresentadas e confirme apenas quando corresponderem ao que pretende.',
example:
'Ao mudar a localização, confira os dados alterados e as etapas que precisam de revisão.',
purpose: 'Permitir que avalie o impacto antes de guardar as escolhas.',
},
];
export function helpPreferenceKey(user: string | number, flow: string): string {
return `investemoz:step-help:v1:${encodeURIComponent(String(user))}:${encodeURIComponent(flow)}`;
}
export function readHelpPreference(value: string | null): {
automatic: boolean;
seen: boolean;
} {
try {
const parsed = JSON.parse(value ?? 'null');
return {
automatic: parsed?.automatic !== false,
seen: parsed?.seen === true,
};
} catch {
return { automatic: true, seen: false };
}
}