Setup e Requisitos
Requisitos
| Ferramenta | Versão mínima | Instalação |
|---|---|---|
| Node.js | >=24.22.2 | Via fnm (veja abaixo) |
| pnpm | 12.18.0 | corepack enable |
| git | qualquer versão recente | brew install git / distro |
| Docker | qualquer versão recente | Apenas para APIs com banco de dados |
A configuração de instalação fica em pnpm-workspace.yaml. Após trocar de versão, execute pnpm install na raiz: o Corepack seleciona o pnpm fixado no packageManager. Neste projeto, dependências recém-publicadas aguardam 24 horas para entrar na resolução; scripts de instalação de dependências precisam estar declarados em allowBuilds.
Gerência de versão Node.js com fnm
O projeto usa fnm para troca automática de versão ao entrar no diretório (.nvmrc presente). Um script de setup já cuida da instalação:
bash
# macOS / Linux
bash scripts/setup-fnm.sh
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File scripts\setup-fnm.ps1Após o script, feche e abra o terminal para recarregar o perfil do shell.
Para forçar a troca manual:
bash
fnm useInstalação
bash
# 1 — Clonar
git clone https://github.com/CECALC/fabrica-de-calculos.git
cd fabrica-de-calculos
# 2 — Ativar pnpm
corepack enable
# 3 — Instalar dependências
pnpm install
# 4 — Gerar tipos Nuxt (necessário antes do primeiro dev)
pnpm dev:prepareO GitHub é o hub de colaboração do código. Branches de trabalho nascem do develop local e a publicação passa por merge request no GitLab da Justiça Federal da 3ª Região, que dispara o CI/CD — veja o repositório e o ciclo de um trabalho.
Desenvolvimento
bash
# Todas as apps em paralelo (sem proxy; cada app na sua porta)
pnpm dev
# Ambiente integrado em Docker, com proxy Caddy reproduzindo o roteamento path-based de produção
pnpm dev:docker
# Apenas uma app
pnpm --filter @fc/prev-tc devAmbientes integrados
Use pnpm dev:docker para subir o conjunto integrado em contêineres ou pnpm dev:local para executar as aplicações Node/Nuxt diretamente no host. Os dois comandos oferecem um assistente interativo, imprimem os endereços disponíveis ao final e encerram os processos filhos ao receber Ctrl+C.
bash
pnpm dev:docker
pnpm dev:localO assistente permite escolher as aplicações, usar um provedor de identidade local e exercitar a exigência de chave de API. Credenciais de teste, topologia, perfis, portas e demais opções operacionais ficam na documentação interna do repositório.
Para o ambiente em contêineres, os comandos auxiliares consultam o estado, acompanham logs e encerram a execução preservando os volumes:
bash
pnpm dev:docker:ps
pnpm dev:docker:logs
pnpm dev:docker:downO ambiente completo exige memória suficiente para várias aplicações Nuxt simultâneas. Quando houver limitação de recursos, prefira pnpm dev:local selecionando apenas as aplicações necessárias pelo menu interativo.
Validação antes do MR
bash
pnpm dev:prepare # apenas se houve mudanças em apps Nuxt
CI=true pnpm lint # sempre
pnpm lint:styles # apenas se houve mudanças em .css/.scss
pnpm exec turbo run typecheck --concurrency=2 # sempre
pnpm exec turbo run test:run --concurrency=2 < /dev/null # código com testesOu o atalho completo:
bash
CI=true pnpm preparar-publicacao < /dev/null