Skip to content

Arquitetura Geral ​

A Fábrica de Cálculos é um monorepo organizado em duas dimensões: apps (interfaces web e APIs) e packages (lógica de domínio pura).

Diagrama geral ​

As setas partem do que é consumido para quem consome: a camada aponta para quem a estende e o package aponta para a app ou o package que o importa — a mesma convenção da hierarquia de camadas. Linhas sem seta indicam integração com sistemas externos.

graph TD
  subgraph ext["Externo"]
    BACEN[API SGS/BACEN]
    IBGE[API SIDRA/IBGE]
    CNJ[SSO institucional / OAuth2]
  end

  subgraph calc["Apps - Calculadoras"]
    TC[prev-tc]
    RVT[prev-rvt]
    ATRASADOS[prev-atrasados]
    RPPS[prev-rpps]
  end

  subgraph apis["Apps - APIs"]
    PREVAPI[prev-api]
    RMIAPI[rmi-api]
    PREVDOC[prev-documentos]
    INDAPI[backoffice]
    MCP[mcp]
  end

  subgraph nuxt["Camadas Nuxt"]
    BASE[base]
    BASEUI[base-ui]
    BASESERV[base-servicos]
    BASEONLINE[base-online]
    BASECALC[base-calculadora]
    BASEPREV[base-prev]
  end

  subgraph pkgs["Packages de Dominio"]
    CP[calculos-previdenciarios]
    RG[calculos-rgps]
    CR[calculos-rpps]
    CJ[calculos-judiciais]
    IND[indices]
    PA[parsers]
    CM[comum]
    UT[utils]
  end

  BASE --> BASEUI
  BASEUI --> BASESERV
  BASESERV --> BASEONLINE
  BASEONLINE --> BASECALC
  BASECALC --> BASEPREV
  BASEPREV --> TC & RVT & ATRASADOS & RPPS
  BASESERV --> INDAPI

  RG --> TC & RVT & ATRASADOS
  CR --> RPPS
  RG --> PREVAPI & RMIAPI
  PA --> PREVDOC
  PREVAPI & RMIAPI & PREVDOC & INDAPI --> MCP
  IND --> INDAPI

  UT --> CM --> IND --> CJ --> CP
  CP --> RG & CR
  RG -->|importação e peças de demonstrativos| CR
  UT --> PA --> CP & CR & IND

  BACEN --- INDAPI
  IBGE --- INDAPI
  CNJ --- BASESERV

Camadas Nuxt — composição via extends ​

As apps não duplicam configuração. Cada camada herda automaticamente componentes, composables, plugins e configurações da camada pai:

graph TD
  base --> base-ui["base-ui (Quasar · Pinia · VueUse · playground)"]
  base-ui --> base-servicos["base-servicos (JWT/JWK via nuxt-auth-utils · serviços internos)"]
  base-servicos --> backoffice["backoffice<br/>Painel admin + API de índices + persistência (Drizzle + Postgres)"]
  base-servicos --> pdpj["pdpj<br/>Integração PDPJ-br"]
  base-servicos --> base-online["base-online (arquivos online · sessão de cálculo)"]
  base-online --> arquivos-online["arquivos-online — central de arquivos"]
  base-online --> base-calculadora["base-calculadora (casco da calculadora · tabelas de índices)"]
  base-calculadora --> civeis["civeis — Cálculos cíveis"]
  base-calculadora --> base-prev["base-prev (cálculos previdenciários · playground)"]
  base-prev --> prev-rvt["prev-rvt — RVT (Tema 1.102/STF)"]
  base-prev --> prev-tc["prev-tc — TC / RMI (RGPS)"]
  base-prev --> prev-atrasados["prev-atrasados — Atrasados previdenciários"]
  base-prev --> prev-rpps["prev-rpps — RPPS (servidores da União)"]

Leia mais: Camadas Nuxt em detalhe

Packages — grafo de dependências ​

graph LR
  UT[utils]
  CM[comum]
  IND[indices]
  CJ[calculos-judiciais]
  CP[calculos-previdenciarios]
  RG[calculos-rgps]
  CR[calculos-rpps]
  PA[parsers]
  CSGS[cliente-sgs]
  CSIDRA[cliente-sidra]

  UT --> CM --> IND --> CJ --> CP
  UT --> PA --> CP
  UT --> CSGS & CSIDRA
  CP --> RG & CR
  RG -->|importação e peças de demonstrativos| CR

Leia mais: Pacotes em detalhe

Núcleo previdenciário e regimes ​

calculos-previdenciarios organiza conceitos compartilhados: segurado, períodos de contribuição, calendários de contagem, salários, requisitos, análise e coeficiente. RGPS e RPPS especializam essas bases em pacotes irmãos. O calendário e a forma de somar os totais continuam próprios de cada regime.

As aplicações consomem diretamente do núcleo apenas parâmetros e entidades de entrada (parametros/, salarios/, periodos-pcd/). Contagem, análise de requisitos e coeficiente são acionados pelo pacote do regime. Em base-prev, os componentes e composables específicos do RGPS ficam em rgps/ e são importados explicitamente por seus consumidores; não entram na superfície automática usada pelo RPPS.

Da conta ao demonstrativo ​

flowchart LR
  R[Resultado do motor] --> G[Geradores do domínio]
  G --> T[Tabelas, blocos, notas e marcas]
  T --> V[Tradução para a tela]
  T --> M[Montagem do documento]
  M --> P[Renderização PDF]

Os motores previdenciários produzem valores e fatos de domínio. Os geradores dos demonstrativos transformam esses resultados em tabelas e blocos. Uma marca registra, por exemplo, que o período não conta, o salário foi descartado ou o valor é um total. A tela e o PDF escolhem como apresentar essa marca.

calculos-judiciais fornece as estruturas compartilhadas e os geradores de liquidação. calculos-rgps fornece os de tempo RGPS, RMI e atrasados. calculos-rpps fornece os de tempo RPPS. O contrato do documento e seu renderizador ficam em demonstrativo-pdf. As colunas leem a linha tipada, evitando repetir o cálculo no componente.

Uma mudança de cor ou largura pertence à apresentação. Uma mudança de valor, conteúdo ou condição de destaque começa no resultado ou no gerador responsável. A conferência de paridade deve comparar as saídas a partir das mesmas entradas e tabelas de índices.

Princípios ​

  • Packages sem compilação: exportam os arquivos TypeScript pelos subpaths declarados em exports; os pacotes de domínio não têm barrel raiz. Nenhum step de build separado.
  • Português brasileiro no domínio: todos os identificadores, nomes de função e comentários de negócio são em PT-BR.
  • Web Workers para cálculos pesados: a UI delega via criarWorkerScope (@fc/utils) para manter a interface responsiva durante a apuração.
  • Catálogo de dependências centralizado: versões gerenciadas em pnpm-workspace.yaml com catálogos nomeados.