Black Box
Tecnologia

TypeScript-first.
Projetado para durar.

A filosofia tecnológica da Black Box é construída em torno de uma restrição: tudo que construímos precisa ser mantível, escalável e correto num horizonte de 10 anos. Nossas escolhas de stack refletem essa disciplina.

Arquitetura do Sistema
01

Apresentação

Next.js App Router com React Server Components para performance otimizada. TailwindCSS para design consistente e responsivo em todos os produtos. TypeScript em toda a árvore de componentes.

02

Camada de API

tRPC para procedimentos type-safe de ponta a ponta. Validação de entrada com Zod. Arquitetura de roteadores modulares que mapeia limpo para os domínios de cada produto.

03

Lógica de Negócio

Camada de serviços orientada a domínio escrita em TypeScript. Serviços sem estado que se compõem em fluxos de trabalho. Padrões orientados a eventos para coordenação complexa entre módulos.

04

Dados

PostgreSQL como armazenamento principal. Prisma ORM para acesso type-safe ao banco. Redis para cache, filas e gerenciamento de sessão. Isolamento por schema por produto.

05

Infraestrutura

Conteinerizado via Docker para ambientes consistentes. GitHub Actions para CI/CD. Servidores de aplicação sem estado atrás de balanceadores Nginx. Cloud-agnostic por design.


Detalhes da Stack

Frontend

Next.js

App Router, SSR, RSC

TypeScript

Tipagem de ponta a ponta

TailwindCSS

Estilização utility-first

Framer Motion

Animações para produção

Backend

Node.js

Runtime TypeScript

tRPC

APIs type-safe de ponta a ponta

Zod

Validação de schemas

Prisma

ORM type-safe

Banco de Dados & Storage

PostgreSQL

Banco relacional primário

Redis

Cache e filas

S3-compatible

Armazenamento de arquivos e documentos

Infraestrutura

Docker

Deploys conteinerizados

GitHub Actions

Pipelines de CI/CD

Nginx

Proxy reverso e balanceamento de carga


Modelo de Plataforma

Uma plataforma. Produtos infinitos.

A plataforma Black Box é uma arquitetura SaaS multi-produto. Todos os produtos compartilham uma camada comum de autenticação, gestão de usuários e infraestrutura de cobrança — enquanto cada produto mantém isolamento estrito de dados.

Isso significa que empresas usando múltiplos produtos Black Box têm login unificado, configurações organizacionais compartilhadas e relatórios entre produtos — sem que os dados de um produto vazem para outro.

Camada de Plataforma

AuthUsuáriosOrganizaçõesCobrançaNotificações

Camada de Produto

LexProColodetti ExpressCCI ImplantaçãoAcadapes

Camada de Módulos

ProcessosFretesImplantaçõesDocumentosRelatórios