Forge ERP Delivery

Sistema de gestão de pedidos e produtos com tema industrial dark

v1.0.0React 19tRPC 11MySQLPronto para Produção

Um sistema completo de PDV (Ponto de Venda) com análise avançada, sincronização com Google Sheets e monitoramento de concorrentes. Desenvolvido com tema Forge Dark industrial, tipografia Barlow Condensed e acento brasa #ff6b2b.

Testes Vitest

Páginas Principais

Tabelas de Banco

100%

Funcionalidades

Funcionalidades Principais

PDV Fullscreen

Interface otimizada para vendas rápidas

Grid de produtos com categorias coloridas
Busca em tempo real
Checkout panel com total gigante
Múltiplos canais (balcão, iFood, WhatsApp)

Gestão de Pedidos

Fluxo completo com múltiplos status

Filtros de status com contadores
Fluxo inline de avanço/cancelamento
Refresh automático a cada 30s
Histórico completo de pedidos

CRUD de Produtos

Gerenciar cardápio com análise de margem

Criar, ler, atualizar, deletar
Cálculo de margem em tempo real
Cores dinâmicas (verde/amarelo/vermelho)
Barra de progresso de estoque

Dashboards (4 Abas)

Análise avançada com gráficos

Vendas — Faturamento e ticket médio
Estoque — Níveis e rotatividade
Financeiro — Receita e lucro
Executivo — KPIs e tendências

Análise de Concorrência

Benchmarking com scatter plot

Scatter plot taxa × tempo
Coluna "sua vantagem" automática
Comparação visual de preços
Tendência de preços (6 meses)

Google Sheets Sync

Sincronização bidirecional automática

Exportação em tempo real
Pedidos, Produtos e KPIs
Sincronização manual e automática
Abas estruturadas na planilha

Stack Tecnológico

React 19

Framework moderno com hooks e suspense

Tailwind CSS 4

Tema Forge Dark customizado com 6 camadas

Recharts

Gráficos interativos e responsivos

Vite

Build tool rápido e otimizado

Arquitetura do Sistema

Frontend (React)

• 5 páginas principais
• Componentes reutilizáveis
• Tema Forge Dark
• Animações fluidas
• Responsivo

Backend (tRPC)

• 11 procedures tRPC
• Type-safe end-to-end
• Validação com Zod
• Autenticação OAuth
• Integração Google Sheets

Database (MySQL)

• 7 tabelas normalizadas
• Índices otimizados
• Migrações automáticas
• Relacionamentos
• Auditoria

Fluxo de Dados

Usuário interage com UI (React)

Clica em botões, preenche formulários

Chamada tRPC para Backend

Type-safe, com validação Zod

Procedure tRPC executa lógica

Validação, autenticação, processamento

Query/Mutation no Banco de Dados

Drizzle ORM com tipos TypeScript

Resposta retorna ao Frontend

Atualiza UI, mostra feedback ao usuário

Sincronização com Google Sheets (opcional)

Exporta dados para análise externa

Testes e Qualidade

Cobertura de Testes

Procedures ForgeDB12/12

Testes de Pedidos7/7

Google Sheets Sync8/8

Integração11/11

Auth Logout1/1

Métricas de Qualidade

Testes Passando39/39 ✓

TypeScript Errors0

Build Errors0

LSP Issues0

DependênciasOK

Como Começar

Desenvolvimento Local

# Clonar repositório

git clone <seu-repositorio>

# Instalar dependências

pnpm install

# Iniciar servidor

pnpm dev

# Executar testes

pnpm test

Deploy em Produção

Configurar variáveis

DATABASE_URL, OAuth, Google Sheets

Executar testes

Validar que tudo está funcionando

Criar checkpoint

Salvar versão no Management UI

Publicar

Clique em "Publish" no painel

Documentação

README.md

Visão geral do projeto

Informações gerais, features, stack tecnológico e instruções de instalação rápida.

GUIA_USO.md

Manual completo do usuário

Guia passo a passo com screenshots, dicas, atalhos de teclado e FAQ.

DEPLOYMENT.md

Deploy em produção

Instruções detalhadas para deploy, configuração de secrets e troubleshooting.

Desenvolvido com ❤️ usando Forge Dark Theme