@fc/prev-tc

Calculadora de benefícios previdenciários — tempo de contribuição (TC) e renda mensal inicial (RMI), servida em porta dedicada de desenvolvimento.

O site estende diretamente @fc/base-prev; por essa cadeia alcança as camadas de cálculo, de persistência online e de interface. Para compreender melhor o conceito de camadas, veja Authoring Nuxt Layers.

Este projeto tem as seguintes características:

1 - Caminho público base tc.

2 - Prefixo de importação local @app/ e aliases nominais das camadas, como @base-ui/ e @base-prev/, no exemplo abaixo:

import { r, s, t } from '@base-ui/app/composables'
import type { d, e, f } from '@app/components'

3 - Importação de Carta de Concessão e CNIS desativada no arquivo app.config.ts. A importação de tempo de contribuição é possibilitada de modo mais amplo pelo componente TcImportar, que usa os plugins Processo, MeuINSS, CnisCompleto, CnisVinculos e TempoContribuicao (plugins de @fc/calculos-previdenciarios, sobre o analisador de @fc/parsers).

Quando o cálculo administrativo (RDCTC) identifica aposentadoria PCD, a calculadora avisa logo após a importação que os períodos e graus de deficiência precisam ser conferidos e preenchidos manualmente. Se o tempo calculado continuar divergente da contagem administrativa, o aviso do cálculo reforça a mesma orientação. Sem os intervalos e graus no documento, não há base segura para inferi-los.

O mesmo cuidado é aplicado quando o RDCTC declara tempos bruto e líquido diferentes sem informar as datas desconsideradas. A calculadora mantém os intervalos como apresentados e abre um aviso logo após a importação, pois a mera diferença em dias não permite inferir um recorte seguro.

4 - Comandos disponíveis:

• pnpm build: gerar os arquivos de produção com servidor node ativado (modo full-stack);
• pnpm dev: executar a aplicação em modo desenvolvimento full-stack (development server);
• pnpm dev:estatico: executar em modo desenvolvimento estático;
• pnpm dev:prepare:estatico: gerar tipos do Nuxt no modo estático;
• pnpm generate: gerar a versão estática (.output/public) — sempre em modo estático, usando .env.estatico; comando necessário para publicação em CDNs, como o serviço GitHub Pages;
• pnpm generate:demo: idem ao anterior, mas usando .env.demo (vitrine no GitHub Pages);
• pnpm preview: executar a aplicação em modo de produção, mas no servidor local;
• pnpm typecheck / typecheck:estatico: verificar tipos no modo full-stack ou estático;
• pnpm postinstall: redefine tipos e auto-imports usados pelo Typescript; normalmente roda automaticamente em build, dev, preview e install;
• lint: verifica a qualidade do código com o Eslint em modo dry run;
• lint:fix: corrige automaticamente o que for possível;
• lint:style: verifica a qualidade do css/scss com o Stylelint.

Ferramentas de desenvolvimento

Em ambiente de execução dev, as telas de cálculo de Tempo e RMI exibem um botão de comparação E2E. A ferramenta é carregada somente no primeiro acionamento, exige usuário autenticado, encaminha o .calc atual para a prev-api ou rmi-api e mostra em modal o progresso, o veredito e eventuais diferenças entre o resultado do worker web e o resultado da API. O fluxo de diagnóstico fica indisponível nos demais ambientes, não faz parte da API pública e não aparece em Swagger/OpenAPI.

Importação PREVJUD online

A TC expõe uma importação autenticada do Dossiê Previdenciário via PREVJUD quando o usuário está logado no SSO PDPJ-br e o cálculo possui número CNJ válido. O navegador nunca chama o gateway diretamente: o fluxo passa por rotas internas autenticadas, que intermediam a consulta. Quem valida o acesso ao dossiê é o próprio PREVJUD.

A mesma consulta que lista as partes do processo recupera também os dados de identificação — autor, protocolo, citação, trânsito em julgado e valor da causa. Eles são oferecidos com caixas de seleção na confirmação, para o usuário escolher o que entra na calculadora: o que está vazio vem marcado, o que já está preenchido vem desmarcado, e valores deduzidos de outro ato vêm sempre desmarcados, com a procedência à vista.

Como o processamento pode levar de segundos a horas, o fluxo é assíncrono, com modal de progresso e opção de desistir. O dossiê recebido entra pelo mesmo caminho de um arquivo PREVJUD local.

A mesma importação está disponível na calculadora de atrasados.

Dados do processo pela PDPJ-br

No bloco Identificação do Processo, usuários autenticados podem usar o botão PDPJ-br para consultar autor, protocolo, citação, trânsito em julgado e valor da causa no Data Lake. Se o número do processo ainda não estiver preenchido, o botão permite informá-lo antes da consulta e também o grava na identificação do cálculo. A tela mostra a origem de cada dado e permite escolher o que preencher ou substituir. Dados ausentes vêm marcados; dados já preenchidos vêm desmarcados e mostram o valor que será substituído. Essa consulta é independente da importação do dossiê e não acessa o PREVJUD.

Simulação por Totais

Quem tem o total de tempo apurado pelo INSS até a DER — e não os períodos que o compõem — pode ligar o Modo Simulação por Totais na aba de mesmo nome, entre Salários e Cálculo Tempo: informa os totais absolutos até cada marco temporal (tempo em anos, meses e dias, por modalidade, e carência em contribuições; só o total na DER é obrigatório) e acrescenta só os períodos que faltam, cada um contado inteiro ou só pelo acréscimo da conversão. Com um RDCTC importado, a linha da DER nasce preenchida com os totais dele.

Com o modo ligado, um chip na barra acusa o estado e leva à aba; Períodos, Salários e Cálculo RMI ficam desabilitadas, porque sem competências não há salário-de-benefício. Em Cálculo Tempo, o painel mostra o demonstrativo Simulação de Benefícios por Totais: os totais informados, os marcos temporais não informados, as regras que ficaram não apuráveis por dependerem deles e, por espécie, os períodos adicionados, os totais por marco e as fichas de benefícios. Imprime com permalink e copia o resultado estruturado. Desligar não apaga nada: interruptor, totais e períodos adicionados são gravados juntos no arquivo .calc, e arquivo anterior abre como sempre abriu.

Quadro Resumo

Na aba Ferramentas de Análise, entre Simulação por Totais e Cálculo Tempo: a lista dos benefícios que cumprem requisitos, em todos os grupos (espécie e tipo de segurado): na DER, na DER reafirmada e nas datas de possível reafirmação propostas pelo motor até hoje, uma linha por fundamento e hipótese de RMI, com a origem da DIB. A análise roda ao abrir a aba e só é refeita quando os dados de Dados do Caso e Parâmetros Gerais mudam. O botão Calcular Valores apura, linha a linha, a RMI do fundamento, a renda mensal reajustada até a data de referência (hoje, ou a última competência coberta pelos índices) e, com elas, o valor da causa — parcelas vencidas até o protocolo mais doze vincendas, com correção e juros pelos padrões da Fábrica —, com a situação frente ao limite de alçada, o limite e o excedente. Parar interrompe; qualquer alteração nos dados apaga os valores; pendências (índices, protocolo e citação, DER) aparecem na célula com a ação que as resolve. As colunas de RMI, renda mensal e valor da causa ordenam a lista. Cada linha abre o demonstrativo do benefício em Cálculo Tempo, já filtrado para ele, e o demonstrativo da RMI calculada em Cálculo RMI. A aba fica desabilitada no Modo Simulação por Totais.

A aba tem duas pílulas. Benefícios é o quadro acima. Vida contributiva é uma consulta independente do histórico previdenciário do segurado: ao abrir, a série mensal do grupo de contagem escolhido (o do caso, ou outro apurado pela análise) é calculada competência a competência — tempo simples e convertido, carência, carência de não programados (com a regra de perda e recuperação da qualidade), idade e qualidade de segurado (contribuindo, em período de graça ou sem qualidade), com os mesmos totais do demonstrativo. Um panorama mostra a qualidade de segurado numa trilha no topo e os vínculos e períodos de deficiência como faixas no tempo (excluídos hachurados, pendências do CNIS sinalizadas), com o cursor na competência consultada — a bolinha no topo do cursor se arrasta com o mouse; os marcos (EC 20, Lei 9.876/99, LC 142, EC 103, DER, reafirmação, primeira filiação, as perdas e recuperações da qualidade, as 120 contribuições sem perda e o fato gerador do caso — DII, data do óbito ou da prisão, conforme a espécie) levam à competência. As duas ferramentas da aba são experimentais: um aviso acima das pílulas aponta para os canais de sugestão de melhorias e comunicação de bugs. O grupo consultado acompanha a espécie e o tipo de segurado do caso: ao escolher incapacidade, auxílio-reclusão ou pensão em Dados do Caso, a consulta muda para esse grupo, para analisar a qualidade de segurado no fato gerador. O registro selecionado é o que o cursor cruza: levar o cursor sobre um período o seleciona, e clicar num período traz o cursor até ele. O painel de detalhe traz os números da competência, os registros nela e o registro selecionado, com os indicadores do CNIS e o botão Ir ao registro, que abre a linha na planilha de Períodos. A competência aceita MM/AAAA, setas e teclado; Aproximar 10 anos recorta o panorama; Pendências filtra; Lista textual é o equivalente acessível do panorama. Nada disso recalcula; a série é refeita só quando os dados de Períodos, Dados do Caso ou Parâmetros Gerais mudam.

Filtro do demonstrativo de tempo

Em Cálculo Tempo, o botão Filtrar demonstrativo da barra de ações restringe o que o demonstrativo mostra, sem recalcular: escolhem-se, em seleções múltiplas cumulativas, os grupos (espécie e tipo de segurado), os fundamentos e o resultado (cumpridos, não cumpridos, possível reafirmação), sempre com as listas completas do Cálculo Tempo. Os grupos fora do filtro são omitidos — ou, desligando "Omitir os grupos não selecionados", ficam só recolhidos — e as fichas de benefício se limitam aos fundamentos e resultados escolhidos, o que permite emitir um demonstrativo individualizado de um benefício. A contagem de tempo e os totais continuam os do cálculo integral, e o impresso declara a restrição numa nota. O filtro vale enquanto o mesmo cálculo estiver aberto (sobrevive a recalcular por DER, DER reafirmada ou Hoje) e é limpo ao abrir ou criar um cálculo.

Correção guiada do erro do cálculo de tempo

Quando o motor recusa o cálculo (dado faltando para a análise de recolhimentos, DER ou nascimento inválidos, parâmetro fora do esperado), um diálogo mostra a mensagem e, quando ela aponta um campo, o link "Revisar…": seguir o link abre a aba certa, rola até o bloco e foca o campo, com um realce breve; o diálogo se recolhe para o canto e some sozinho quando o campo apontado é corrigido. O mesmo erro repetido fica só com o chip vermelho da barra.

PDFs dos demonstrativos

O demonstrativo principal de RMI, o demonstrativo de Cálculos a Cada Descarte e o demonstrativo de Tempo são salvos em PDF pela impressão do navegador, preservando a identidade visual única dos demonstrativos da Fábrica de Cálculos.

O antigo comando Baixar PDF simplificado, que gerava um documento com formato visual próprio, foi retirado para manter um único formato de demonstrativo.

Modo estático

A app pode ser construída em dois perfis:

• Full-stack (padrão): o Nitro serve rotas de servidor, a autenticação Keycloak/PDPJ-br fica ativa e os modais de cálculos em nuvem são renderizados.
• Estático: o preset Nitro vira static e o bundle resultante é totalmente executado no navegador. Os componentes e composables que dependem do servidor são desativados de forma segura.

O extends é o mesmo nos dois perfis (['../base-prev']); mudam apenas o preset do Nitro e a capacidade pública registrada pela camada base-online, alcançada por herança. O comando de geração seleciona o perfil estático automaticamente.