@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:
Os aliases apontam para arquivos concretos: @app para o código da aplicação e o alias da camada para seus módulos. Importe o arquivo que declara o símbolo; esses diretórios não são barrels.
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.
Ao abrir um link de importação que inclua ordem judicial do PrevJud/PJe, a espécie e a DIB válidas da ordem prevalecem sobre os documentos. A DIB preenche a data de apuração no campo DER e limpa uma DER reafirmada anterior. A RMI não é obrigatória para esse preenchimento; a DIP é utilizada apenas pela calculadora de Atrasados. Uma ordem sem espécie ou DIB válida é sinalizada no resumo e preserva os demais dados recebidos.
4 - Comandos disponíveis:
pnpm build: gerar os arquivos de produção com servidornodeativado (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çoGitHub 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 embuild,dev,previeweinstall;CI=true pnpm lint: verifica a qualidade do código com oEslintem modo dry run;CI=true pnpm lint:fix: corrige automaticamente o que for possível;pnpm lint:styles: verifica a qualidade do css/scss com oStylelint.
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 é refeita quando os dados relevantes de Períodos, Dados do Caso ou 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 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 três 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 três 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.
Baixa renda
Terceira pílula da aba Ferramentas de Análise: a apuração do requisito de baixa renda do segurado recolhido à prisão, para o auxílio-reclusão, a partir da espécie 25 e da Data da Prisão de Dados do Caso (com os demais campos obrigatórios da aba, como a DER, já preenchidos). Escolhe o regime pela data da prisão (antes da EC 20/98, não se aplica; até a MP 871/2019, a renda na competência da prisão; depois, a média dos salários de contribuição das 12 competências anteriores ao mês da prisão, dividida pelas competências com salário ou sempre por 12, à escolha), compara com o limite da portaria vigente na data e mostra o enquadramento, a memória de apuração competência a competência, o critério aplicado, os fundamentos e os pontos controvertidos que ficam para a decisão do usuário. Não concede o benefício nem substitui os demais requisitos. Copiar resultado entrega o parecer pronto para colar ("O instituidor é/não é segurado de baixa renda, porque …", com a flexão de gênero do segurado), com ou sem a memória de apuração em tabela, e as escolhas podem ser salvas como padrão.
Modos e memória de RMI
- Descarte Manual permite escolher as competências descartadas e sua ordem, separadamente da otimização automática. Desligar o modo não apaga a lista escolhida. O demonstrativo de Cálculos a Cada Descarte mostra a evolução da RMI e a interrupção quando a hipótese deixa de cumprir os requisitos.
- RMI desvinculada usa todas as fontes da aba Salários — Ano Civil, períodos, Independentes e Benefícios —, além do tempo e do coeficiente informados. A seção abre com um banner com atalho para essa aba; Dados da RMI traz os checkboxes Direito adquirido e Atividades concomitantes, e este último, marcado, avisa com o mesmo atalho que os salários da atividade principal são os consolidados da aba Salários. O marco opcional de direito adquirido limita o PBC às regras vigentes na data escolhida quando ela é anterior à DIB; uma DIB anterior ao marco ignora essa opção. Na barra de comandos, uma carta com atividades secundárias e a opção de concomitância ligada permite importar os salários consolidados ou separados por atividade; a forma separada substitui os independentes e as secundárias, após confirmação quando já houver secundárias. A confirmação da carta oferece preencher o coeficiente e o tempo dela em Dados da RMI, mesmo com o modo desligado. Na planilha de cada secundária, o importador aceita carta, CNIS e PrevJud: cada salário entra na coluna da sua origem, somado ao que a competência já tinha, e a observação registra como a soma se compôs.
- Atividades concomitantes anteriores à Lei 13.846/2019 separam principal e secundárias para compor o salário de benefício; no regime posterior à alteração de 2019, os salários das atividades são somados conforme a regra aplicável. O demonstrativo discrimina a composição e seus avisos.
- A ficha de cada benefício expõe o coeficiente e a fundamentação apurados. Os históricos de B31/B91 e pensão com dependentes têm exemplos no guia do usuário. Quando o benefício fica sem RMI por falta de dado — a pensão anterior à Lei 9.032/1995 sem o número de dependentes, por exemplo —, o cartão da RMI mais vantajosa mostra a nota que explica o motivo.
A RMI desvinculada com DIB de 11/06/1973 a 05/10/1988 usa motor próprio, para as espécies 31, 32, 41, 42, 46 e 57 (esta a partir de 30/06/1981). O formulário recebe coeficiente, critério de correção, grupos acima do menor valor-teto e, quando aplicável, salário mínimo local. O demonstrativo traz PBC e memória histórica, RMI na DIB e equivalência salarial; os requisitos não são analisados e a evolução fica em Atrasados. Os campos são preservados no .calc. As rotas específicas de RMI desvinculada da API ainda não expõem esse contrato histórico.
Os contratos estruturados de entrada e saída estão nas páginas públicas de @fc/prev-api e @fc/rmi-api; a interface Web acrescenta edição, avisos e demonstrativos.
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.
O ciclo visual e o foco são compartilhados por @fc/base-calculadora; o TC mantém localmente o dicionário que conhece as mensagens do seu motor.
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
statice 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.