sabia/docs/pt-BR/arquitetura.md

Arquitetura

English · Português

Dois crates e um app:

crates/sabia-core   toda a lógica (biblioteca)
crates/sabia-cli    binário `sabia` (CLI + servidor local da UI)
apps/gui            interface (ui/ = HTML/CSS/JS; src-tauri/ = app desktop)

A CLI e o app desktop são clientes finos: ambos chamam o Engine do núcleo. A UI do navegador (sabia ui) e a do Tauri carregam o mesmo apps/gui/ui/.

sabia-core

Módulo	Papel
engine.rs	Orquestra tudo e expõe a API que CLI e GUI consomem.
iface.rs, netlink.rs	Descobre interfaces e canais; liga/desliga modo monitor por netlink/iw.
radiotap.rs	Parsing do cabeçalho radiotap; banda e canal.
dot11.rs	Parsing de quadros 802.11 (gerenciamento: beacon, probe).
eapol.rs	Parsing do EAPOL e dos campos do 4-way handshake.
handshake.rs	Monta o handshake (ANonce, SNonce, MIC, PMKID) a partir dos quadros.
crack.rs	Deriva PMK (PBKDF2-HMAC-SHA1) e PTK, confere MIC e PMKID.
scan.rs	Percorre canais e agrega APs e clientes vistos.
capture.rs, inject.rs	Captura crua por AF_PACKET; injeção de quadros (deauth).
pcapreader.rs, pcapwriter.rs	Leitura e escrita de .pcap.
audit.rs	Trilha de auditoria local encadeada por hash.
doctor.rs	Diagnóstico de privilégios, ferramentas e interfaces.
update.rs	Auto-atualização por releases do Gitea (curl + SHA-256).
error.rs, testutil.rs	Tipo de erro compartilhado; ajudantes de teste.

Plataforma

Captura e modo monitor são Linux (AF_PACKET + netlink). Parsing (radiotap, dot11, eapol, handshake), quebra (crack) e .pcap são multiplataforma, por serem offline — por isso os testes rodam em Linux no CI.

Transporte da UI

sabia ui sobe um servidor em 127.0.0.1 protegido por um token gerado na hora; serve index.html/app.css/app.js/logo.png embutidos no binário e uma API JSON. O app Tauri usa os mesmos arquivos, chamando o Engine direto por comandos Tauri em vez de HTTP.