ProtoVolt

Simulador de Circuitos Eletricos Profissional

Projetos eletricos profissionais em minutos. Feito no Brasil, para eletricistas brasileiros.

Demo | Documentacao | Contato

---

Sobre

ProtoVolt e um simulador de circuitos eletricos desenvolvido para profissionais brasileiros. Com simulacao em tempo real usando Modified Nodal Analysis (MNA), validacao automatica NBR 5410, e geracao de orcamentos com precos atualizados do mercado brasileiro.

Dois Estilos Visuais

• Esquematico - Simbolos tecnicos NBR 5410 para documentacao profissional
• Pictorico - Renderizacao realista estilo Victron para apresentacoes e clientes

Funcionalidades

Simulacao em Tempo Real

• Motor MNA (Modified Nodal Analysis) - Analise de circuitos AC/DC precisa
• Visualizacao de corrente - Veja a energia fluindo pelos condutores
• Deteccao de falhas - Identifica curtos, sobrecargas e circuitos abertos

100+ Componentes Eletricos

Categoria	Qtd	Exemplos
Fontes	2	AC, DC
Protecao	12	Disjuntores 1P/2P/3P, DR, IDR, DPS, Fusiveis, Seccionadora
Interruptores	13	Simples, Duplo, Triplo, Touch, Smart, Dimmer, 3-way, 4-way
Iluminacao	12	Lampadas, Spots, Arandelas, Plafons, LED, Emergencia
Tomadas	9	2P, 3P, Industrial, USB, Smart, Piso, Veicular
HVAC	8	Ar Split, Exaustor, Ventilador, Climatizador
Aquecimento	5	Chuveiro, Torneira, Boiler, Pressurizador
Seguranca	10	Sensores, Cameras IP, Alarmes, Fechaduras Biometricas
Automacao	12	Porteiro, Interfone, Motor Cortina/Persiana, Hub Smart
Industrial	14	Motores, Contatores, VFD, Soft Starter, SSR, Timer

50+ Templates Profissionais

• 20 Residenciais - Quarto, cozinha, banheiro, QDC, three-way
• 15 Industriais - DOL, estrela-triangulo, soft starter, VFD, CCM
• 15 Automacao - Portoes, alarmes, CFTV, smart home

Conformidade NBR 5410

• Validacao automatica de circuitos
• Verificacao de dimensionamento de condutores
• Alertas de sobrecarga e subdimensionamento
• Referencias diretas a secoes da norma

Orcamento Automatico

• Precos atualizados do mercado brasileiro
• 3 faixas: Economica, Media, Premium
• Lista de materiais (BOM) exportavel
• Links diretos para Mercado Livre e Amazon

Exportacao Profissional

• PDF - Memorial descritivo completo
• DXF - Compativel com AutoCAD
• Compartilhamento - Link direto ou WhatsApp

Tecnologias

Categoria	Tecnologia
Frontend	React 18.3, TypeScript 5.6, Tailwind CSS
Build	Vite 6.0
Simulacao	MNA Engine (custom), Complex Linear Algebra
Renderizacao	SVG + Canvas 2D (particulas de alta performance)
Backend	Firebase (Auth, Firestore, Hosting)
AI	Azure OpenAI GPT-4 (opcional)
Testes	Vitest, React Testing Library
Colaboracao	Yjs + PartyKit (real-time sync)

Instalacao

Pre-requisitos

• Node.js 18+
• npm ou yarn

Setup

# Clone o repositorio
git clone https://github.com/JuanCS-Dev/protovolt.git
cd protovolt

# Instale dependencias
npm install

# Configure variaveis de ambiente (opcional)
cp .env.example .env.local

# Execute em desenvolvimento
npm run dev

Variaveis de Ambiente (Opcionais)

# Firebase (para persistencia)
VITE_FIREBASE_API_KEY=
VITE_FIREBASE_AUTH_DOMAIN=
VITE_FIREBASE_PROJECT_ID=

# Azure OpenAI (para geracao AI)
VITE_AZURE_OPENAI_ENDPOINT=
VITE_AZURE_OPENAI_KEY=
VITE_AZURE_OPENAI_DEPLOYMENT=
VITE_AZURE_OPENAI_API_VERSION=

# Kiwify (para pagamentos)
VITE_KIWIFY_CHECKOUT_URL=

Scripts

npm run dev       # Servidor de desenvolvimento
npm run build     # Build de producao
npm run preview   # Preview do build
npm run test      # Executar testes
npm run lint      # Verificar codigo

Estrutura do Projeto

protovolt/
├── components/
│   ├── symbols/
│   │   ├── schematic/      # Simbolos NBR 5410
│   │   ├── pictorial/      # Simbolos realistas (100+ componentes)
│   │   │   ├── PictorialFactory.tsx   # Factory pattern
│   │   │   ├── AllPictorialComponents.tsx
│   │   │   └── ...
│   │   └── shared/         # Tipos e utilitarios compartilhados
│   ├── canvas/             # Canvas e controles
│   └── ...
├── engine/                 # Motor de simulacao MNA
│   ├── ac/                 # Solver AC
│   ├── behaviors/          # Comportamentos de componentes
│   ├── models/             # Modelos eletricos
│   └── transient/          # Analise transitoria
├── services/
│   ├── templateGenerator/  # Gerador de templates
│   ├── electricalEngineer.ts
│   └── pdfGenerator.ts
├── hooks/                  # React hooks customizados
├── constants/              # Definicoes de componentes
├── data/                   # Dados de precos BR
├── types/                  # Tipos TypeScript centralizados
└── tests/                  # Testes automatizados

Atalhos de Teclado

Atalho	Acao
Del / Backspace	Deletar componente selecionado
Ctrl+Z	Desfazer
Ctrl+Shift+Z	Refazer
Ctrl+S	Salvar projeto
Espaco	Toggle simulacao
Esc	Cancelar selecao
Duplo-clique	Toggle estado (interruptores)

Controles do Canvas

Botao	Funcao
+ / -	Zoom in/out
Maximizar	Reset da visualizacao
Chip/Cubo	Alternar estilo (Esquematico/Pictorico)
Regua	Toggle regua de medicao

Documentacao

• Constituicao do Codigo - Padroes de desenvolvimento
• Referencia NBR 5410 - Tabelas e formulas
• Plano de Modularizacao - Arquitetura de simbolos

Contribuicao

Este e um projeto proprietario. Contribuicoes nao sao aceitas no momento.

Licenca

Copyright 2025. Todos os direitos reservados. Veja LICENSE para detalhes.

Contato

• Email: juan@vertice-maximus.com
• Issues: GitHub Issues

---

Feito com energia no Brasil