O ValidaDocs é uma plataforma para processamento, validação e conciliação de documentos e planilhas em larga escala. O sistema oferece uma experiência ágil e intuitiva para a gestão e cruzamento de grandes volumes de dados.
- 🔄 Conciliação de Dados: Cruzamento de planilhas com documentos, garantindo operações seguras e consistentes (UPSERT/Delete) no banco de dados através de transações do Prisma.
- 📄 Processamento Inteligente de PDF: Módulo dedicado à leitura e extração automatizada de dados em arquivos PDF, sincronizando as informações diretamente com a interface do usuário em tempo real.
- ⚙️ Filas Assíncronas (BullMQ): Fila de processamento em background utilizando Redis para auto-save com debounce, processamento de documentos pesados e tarefas em lote, assegurando que a interface nunca fique bloqueada.
- 🎨 UI/UX Premium: Design imersivo usando o padrão "Mono Blue", componentes Glassmorphism (cartões translúcidos com blur), e feedback visual de estados (sucesso, erro, processando).
- 📂 Sistema de Histórico e Lotes: Controle de lotes e histórico de arquivos importados, com opções de exclusão em massa e pré-visualização de documentos diretamente no navegador via modais interativos.
- ☁️ Integração S3: Armazenamento resiliente e seguro de ativos documentais em nuvem.
| Categoria | Tecnologia |
|---|---|
| Framework | React Router v7 (Framework Mode) |
| Ambiente | Node.js / Runtime compatível |
| Linguagem | TypeScript |
| Banco de Dados | PostgreSQL (pg) via Prisma ORM |
| Background Jobs | BullMQ & Redis (ioredis) |
| Processamento | xlsx (Planilhas) / pdf-lib & pdf-parse (Documentos) |
| Ícones | Lucide React |
├── app/
│ ├── components/ # Componentes UI reutilizáveis e modais
│ ├── domain/ # Lógica de domínio, regras de negócio e extratores de PDF/Excel
│ ├── routes/ # Configuração de rotas de página (Loaders/Actions da API)
│ ├── services/ # Serviços de infraestrutura, banco de dados e mensageria
│ ├── styles/ # Folhas de estilo modularizadas (Vanilla CSS - Mono Blue)
│ ├── views/ # Componentes visuais principais (Conciliacao, ComprovantesFAT)
│ ├── root.tsx # Entrada principal da aplicação React Router v7
│ ├── routes.ts # Registro e mapeamento de rotas da aplicação
│ └── types.ts # Interfaces e definições de tipos TypeScript globais
├── prisma/ # Schema do banco de dados (PostgreSQL)
├── public/ # Ativos e imagens estáticas
└── Dockerfile # Configuração para deploy conteinerizado em produção
-
Instale as dependências
bun i
-
Configure o ambiente
cp .env.example .env
Preencha
SESSION_SECRETcom o resultado deopenssl rand -hex 32. -
Suba a infra local e o banco (Postgres, Redis e MinIO do
docker-compose.dev.yml, presos a127.0.0.1)bun run infra:up bun run db:push
-
Crie seu usuário admin (uma vez)
bun run create-admin -- seu.nome@empresa.com.br --password suasenha
-
Inicie o servidor de desenvolvimento
bun run dev
Para parar a infra:
bun run infra:down. -
Produção (Dokploy) O
docker-compose.ymlsobe app, banco, Redis e MinIO sem publicar portas: o proxy do Dokploy alcança a app pela porta interna.SESSION_SECRETprecisa estar no ambiente do Dokploy. Depois do primeiro deploy, crie os admins no terminal do container comnpm run create-admin -- email@empresa.com.br.