Motor v1.2 • Agnóstico de Norma por Princípio (ADR-006)

A inteligência e automação para projetos elétricos prediais.

O Enki transforma plantas, tabelas e normas em modelos verificáveis e executáveis. Cálculos elétricos determinísticos de rede com OpenDSS, conformidade normativa plugável e geração automatizada de unifilares e quadros de cargas — sem amarras a CAD proprietário.

0,00%
Divergência nos testes canônicos vs OpenDSS
Agnóstico
Regras de normas técnicas totalmente plugáveis
Headless
CLI de 8 comandos e API FastAPI sem CAD
Auditável
Proveniência estrita: cada valor tem origem formal
enki-ide — Edifício Orion • Projeto Elétrico R1
OpenDSS: Conectado NBR 5410:2004
Explorador Semântico v1.1
  • Entrada da Concessionária (13.8kV)
  • QGBT-01 (Quadro Geral Baixa Tensão)
  • QDF-Pavimento 01
  • ↳ Circ. 01 (Iluminação LED) 10A • 1.5mm²
  • ↳ Circ. 02 (Tomadas TUG 127V) 20A • 2.5mm²
  • ↳ Circ. 03 (Ar Cond. TUE 220V) 25A • 4.0mm²
  • QDF-Pavimento 02..12
Demanda Total
142.8 kVA
FP: 0.94 • 380/220V
Queda de Tensão Máx
1.82 %
Limite normativo: 4.0%
Status de Conformidade
100% OK
0 erros • 2 avisos
Console Determinístico Enki Execution Time: 18ms

[INFO] Modelo Físico: 12 pavimentos e 148 ambientes reconstruídos a partir do DXF/IFC.

[CALC] OpenDSS Engine: Fluxo de potência convergido com 3 iterações.

[VALIDATION] Regra NBR-5410-6.2.6 (Critério Térmico): OK para todos os 48 circuitos.

[ROUTING] Roteador físico 2D (NetworkX): 1.420m de eletrodutos mapeados com desvio de pilares.

[READY] Unifilar vetorial SVG e Lista de Materiais (BOM) gerados com sucesso.

Fundamentos Arquiteturais

Os 4 Pilares da Engenharia Enki

Princípios rígidos definidos em Architecture Decision Records (ADRs) para garantir escalabilidade, portabilidade e veracidade técnica.

1. Agnóstico de Norma por Princípio

Nenhum cálculo, identificador, bitola default ou fator de agrupamento é embutido no código central (ADR-006). Normas técnicas (NBR 5410, NEC, IEC ou cadernos de encargos corporativos) são conjuntos de regras plugáveis e versionáveis, permitindo adaptação a qualquer país ou concessionária sem alterar o núcleo de cálculo.

ADR-006 • Regras Plugáveis e Auditoria

2. Motor de Rede Desacoplado (OpenDSS)

Cálculo elétrico real de engenharia através do OpenDssEngine (ADR-015): fluxo de carga trifásico, curto-circuito, cálculo exato de impedâncias, queda de tensão e balanceamento de demanda. Garantia de 0,00% de divergência contra o caminho analítico canônico com performance de milissegundos.

ADR-015/017-021 • Cálculo Determinístico

3. Modelo Físico & Reconciliação Espacial

O Enki modela a infraestrutura real: edificação, pavimentos, compartimentos e paredes com rastreabilidade e nível de confiança por entidade. Importa plantas DXF e IFC, reconcilia dados físicos com tabelas de cargas e realiza roteamento 2D de condutos contornando obstáculos arquitetônicos via NetworkX.

Trilha B (B1-B10) • Geometria & BIM/CAD

4. IDE Determinística com IA Explicável

A IA interpreta intenção em linguagem natural e documentos técnicos; o núcleo de engenharia calcula, valida e executa (ADR-012). Cada valor no painel de propriedades tem sua proveniência explícita: informado pelo engenheiro, calculado por fórmula, derivado de regra normativa ou sugerido por catálogo.

ADR-012 • Rastreabilidade & Human-in-the-loop

Pipeline de Engenharia

Do Desenho Bruto ao Memorial Auditável

Fluxo unificado: Entrada → Conhecimento → Engenharia → Interação.

01

Entrada Não Estruturada

Plantas arquitetônicas DXF/DWG, arquivos IFC de modelos BIM, planilhas CSV/XLSX de cargas ou especificações textuais.

02

Grafo & Modelo Físico

Construção automática da topologia: equipamento → circuito → quadro. Modelagem dos pavimentos, paredes e rotas de infraestrutura.

03

Cálculo & Normas

Resolução de fluxo de carga e curto-circuito pelo OpenDSS. Dimensionamento de condutores e disjuntores por critérios térmicos e de tensão.

04

Entrega & Artefatos

Geração de diagramas unifilares vetoriais SVG, listas de materiais consolidadas, quadros de cargas e memoriais de cálculo completos.

Modularidade Radical

Nenhuma dependência externa governa o núcleo.

No Enki Engine, AutoCAD, Revit, motores de cálculo específicos ou LLMs são tratados como plugins substituíveis atrás de interfaces estritas. O núcleo opera puramente com geometria, grafos elétricos e regras normativas desacopladas.

Interface FonteFisica

Permite acoplar AutoCAD, BricsCAD, FreeCAD ou arquivos puros sem reescrever o domínio elétrico.

Interface ElectricalEngine

OpenDSS é o motor padrão de rede, mas a interface suporta motores de alta tensão ou simuladores alternativos.

Contratos Imutáveis e Versionados (Schema 1.1)

Persistência segura em JSON Schema com concorrência otimista (expected_revision) e histórico transacional.

src/enki/domain/ Clean Architecture Layers
├── calculation/       # Modelo Elétrico de Cálculo (Queda, Demanda, Bitola)
│   ├── opendss_engine.py
│   └── criteria.py
├── electrical/        # Grafo Elétrico (Topologia Quadro/Circuito/Carga)
│   ├── network_graph.py
│   └── schema.json
├── infrastructure/    # Modelo Físico (Edificação, Pavimentos, Paredes)
│   ├── geometry.py
│   └── routing_2d.py
├── bridge/            # Reconciliação Física ↔ Elétrica
│   └── provenance.py
└── normative/         # Compilador Normativo Plugável (NBR 5410, IEC)
    ├── rule_engine.py
    └── standards/

Headless & CI/CD

Construído para Engenheiros e Desenvolvedores

Roda limpo em qualquer Linux, Docker ou pipeline de automação sem interface gráfica.

$ enki --help
Enki CLI v1.2
Usage: enki [OPTIONS] COMMAND [ARGS]...

  Motor de automação e validação para projetos elétricos prediais.

Commands:
  import-dxf   Importa e vetoriza geometria física de paredes e ambientes a partir do DXF
  organize     Organiza e agrupa equipamentos em circuitos e quadros de distribuição
  calculate    Executa fluxo de potência e dimensionamento térmico e de tensão via OpenDSS
  validate     Avalia conformidade estrita contra regras da norma plugada (NBR 5410, NEC)
  render       Exporta diagrama unifilar vetorial em SVG e relatórios memoriais em Markdown
  serve        Inicia o servidor de API FastAPI e WebSockets para o Workspace Web