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.yamlcom catálogos nomeados.