Pular para o conteúdo

Stack Tecnológica

Cada dependência do Juca está aqui por um motivo. Esta página lista a stack completa com versões, finalidades e status atual — incluindo quais pacotes são transitórios (serão removidos quando a migração para o Valter for concluída).

BibliotecaVersãoFinalidadeStatus
Next.js^16.1.6App Router, Server Components, Server ActionsAtivo
React19.2.3Framework de UI (recursos concorrentes, hook use())Ativo
React DOM19.2.3Renderizador do ReactAtivo
TypeScript^5Tipagem em toda a stackAtivo
Tailwind CSS^4.1.18Framework utilitário CSS-first (v4)Ativo
@tailwindcss/postcss^4.1.18Integração PostCSS para o TailwindAtivo

Esses SDKs alimentam o pipeline local de multi-LLM. São transitórios — o processamento de LLM está migrando para a API Valter.

BibliotecaVersãoFinalidadeStatus
@anthropic-ai/sdk^0.71.2Claude (Sonnet 4, Opus 4, Haiku 3.5) — gerador e revisorTransitório
openai^6.16.0OpenAI (GPT-5.x, o3) + DeepSeek (SDK compartilhado)Transitório
@google/generative-ai^0.24.1Gemini (2.5 Flash/Pro)Transitório
groq-sdk^0.37.0Groq (Qwen 3 32B, Llama 3.3 70B) — critics para inferência rápidaTransitório
BibliotecaVersãoFinalidadeStatus
better-sqlite3^12.6.2Persistência de sessões e blocks (modo WAL, chaves estrangeiras)Ativo — migrará para Postgres na v0.6+
sqlite-vec^0.1.7-alpha.2Extensão de busca vetorial para SQLiteTransitório
neo4j-driver^6.0.1Grafo de Conhecimento via adapter pattern (JSON ou Neo4j)Transitório — KG migrando para o Valter
BibliotecaVersãoFinalidadeStatus
next-auth^5.0.0-beta.30NextAuth v5 — Google OAuth + magic links via Resend, sessões JWTAtivo
BibliotecaVersãoFinalidadeStatus
lucide-react^0.563.0Biblioteca de íconesAtivo
swr^2.3.8Busca de dados (uso mínimo — apenas useHealthCheck)Em revisão
BibliotecaVersãoFinalidadeStatus
jspdf^4.2.0Geração de PDF a partir de sessões de briefingAtivo
pdf-parse^2.4.5Leitura de PDFs enviados para análiseTransitório
uuid^13.0.0Geração de IDs (uso mínimo — apenas health checks)Em revisão
yauzl^3.2.0Extração de ZIP (apenas scripts de ingestão)Transitório
BibliotecaVersãoFinalidadeStatus
@opentelemetry/api^1.9.0API de rastreamento distribuídoAtivo (opt-in)
@opentelemetry/sdk-node^0.211.0SDK OTel para Node.jsAtivo (opt-in)
@opentelemetry/exporter-trace-otlp-http^0.211.0Exportador OTLP HTTPAtivo (opt-in)
BibliotecaVersãoFinalidade
vitest^4.0.18Testes unitários e de integração
@vitest/coverage-v8^4.0.18Relatórios de cobertura V8
@playwright/test^1.58.0Testes E2E (apenas Chromium)
@testing-library/react^16.3.2Utilitários para teste de componentes
@testing-library/jest-dom^6.9.1Matchers de asserção para o DOM
@testing-library/user-event^14.6.1Simulação de interações do usuário
jsdom^28.0.0Ambiente de browser para o Vitest
eslint^9Linting com as regras do Next.js
@next/bundle-analyzer^16.1.4Análise do tamanho do bundle
dotenv^17.2.3Carregamento de variáveis de ambiente
FerramentaFinalidade
TurbopackServidor de desenvolvimento (via Next.js 16)
Docker (multi-stage)Builds de produção com saída standalone
GitHub ActionsPipeline de CI (lint + build + testes unitários)
RailwayHospedagem em produção (auto-deploy a partir de main)
Git LFSArmazenamento de arquivos grandes para arquivos de dados
Git hooks customizados (.githooks/)Lint no pre-commit, testes no pre-push

Após a limpeza estrutural (2026-02-28), a árvore de dependências está limpa:

  • 4 dependências fantasma removidas: zustand, @tanstack/react-virtual, next-pwa, resend
  • 2 dependências em revisão: uuid e swr (uso mínimo, candidatas à remoção)
  • Todas as dependências restantes são ativamente importadas e usadas no código de produção
  • Zero segredos hardcoded — todas as chaves de API e URLs via variáveis de ambiente