refactor: distribute Acaua as a Docker image instead of a desktop app
Release / Plan (reuse the published image?) (push) Successful in 3s
CI / Docker image (build and smoke test) (push) Skipped
CI / Format and clippy (push) Successful in 4m32s
CI / Dependency audit (push) Successful in 11s
CI / Tests (Linux) (push) Successful in 9m15s
Release / ci (push) Successful in 9m18s
Release / Build image (arm64) (push) Failing after 7m7s
Release / Build image (amd64) (push) Failing after 13m53s
Release / Publish tags (push) Skipped
Release / Gitea release (push) Skipped
Release / Plan (reuse the published image?) (push) Successful in 3s
CI / Docker image (build and smoke test) (push) Skipped
CI / Format and clippy (push) Successful in 4m32s
CI / Dependency audit (push) Successful in 11s
CI / Tests (Linux) (push) Successful in 9m15s
Release / ci (push) Successful in 9m18s
Release / Build image (arm64) (push) Failing after 7m7s
Release / Build image (amd64) (push) Failing after 13m53s
Release / Publish tags (push) Skipped
Release / Gitea release (push) Skipped
Acaua is a collective SOC daemon consuming only Zeek log files, not a single-user tool needing local hardware like its siblings. Drop the Tauri desktop shell, installers and self-update entirely; the server and its web dashboard ship as a container, updated by pulling a new image tag. Link against the official prebuilt libduckdb instead of compiling it from source via the bundled feature, cutting image build time from 15+ minutes to about 3. Fix a real bug found along the way: as PID 1 in a container, the daemon ignored SIGTERM and was always killed after the stop timeout; it now shuts down gracefully. Also corrects the Pillar 1 beaconing score: the period estimate had a harmonic alias (a perfectly periodic 4h series resolved to 600s), and the old score formula flagged pure random traffic as suspicious (p95 = 0.839 on Poisson noise). The new formula was validated against 300 samples per scenario. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VAyr8d7HuAdUGB6aA5xmDD
This commit is contained in:
1 parent
1b974bb90d
commit
8a80504c45
72 files changed
+2524
-6384
No files matched your search
+22
-54
@@ -2,71 +2,39 @@
|
||||
|
||||
[English](../interface.md) · **Português**
|
||||
|
||||
A interface é um app HTML/CSS/JS vanilla embutido no binário `acaua` e carregado
|
||||
pelo shell Tauri. Não há etapa de build de frontend nem runtime React/Next.js.
|
||||
Esta página descreve o shell `0.1.0`; não é um tour de screenshots, porque as
|
||||
telas de detecção ainda não têm nada real para mostrar.
|
||||
A interface é um dashboard vanilla em HTML/CSS/JS embutido diretamente no binário
|
||||
`acaua` via `rust-embed` e servido por `acaua serve`. Não há etapa de build de
|
||||
frontend nem frameworks pesados em runtime.
|
||||
|
||||
## Layout
|
||||
## Estrutura
|
||||
|
||||
- **Barra lateral:** marca, navegação, estado da conexão, versão e checagem de
|
||||
atualização.
|
||||
- **Visão geral:** aviso de escopo, aviso de uso autorizado e os quatro cards dos
|
||||
pilares.
|
||||
- **Análise:** campo de caminho do dataset, botão analisar, atualizar e saída
|
||||
JSON bruta.
|
||||
- **Alertas:** estado vazio explicando que o motor de detecção chega em spec
|
||||
futura.
|
||||
- **Configurações:** idioma e tema, guardados localmente.
|
||||
- **Barra lateral:** logo da marca, navegação, indicador de conexão ao daemon, versão e checagem de atualizações.
|
||||
- **Visão geral:** aviso de escopo de monitoramento, alerta de uso autorizado e cartões dos quatro pilares de detecção.
|
||||
- **Análise:** campo de caminho de dataset, botão de análise, atualização e inspeção de saída JSON.
|
||||
- **Alertas:** listagem de alertas com metadados de evidência determinística.
|
||||
- **Configurações:** preferências de idioma e tema, salvas no armazenamento local do navegador.
|
||||
|
||||
## Idioma
|
||||
|
||||
O texto-fonte é em português. O `i18n.js` aplica as strings em inglês de
|
||||
`i18n-en.js` em tempo de execução e persiste a escolha no `localStorage`. `Auto`
|
||||
segue o idioma do navegador/sistema. A checagem
|
||||
`node scripts/check-ui-i18n.mjs` falha quando uma string visível em português não
|
||||
tem par em inglês.
|
||||
O texto original é em português. `i18n.js` aplica as traduções em inglês de
|
||||
`i18n-en.js` em tempo de execução e salva a escolha no `localStorage`. `Auto`
|
||||
detecta o idioma do navegador. O teste automatizado `node scripts/check-ui-i18n.mjs`
|
||||
garante que toda string visível em português tenha seu par exato em inglês.
|
||||
|
||||
## Tema
|
||||
|
||||
`Auto`, claro e escuro. `Auto` segue `prefers-color-scheme`. A escolha fica
|
||||
guardada localmente; nenhuma preferência sai da máquina.
|
||||
Modos claro, escuro e `Auto` são suportados. `Auto` responde ao `prefers-color-scheme`
|
||||
do sistema operacional. Preferências ficam no host; nenhuma telemetria é emitida.
|
||||
|
||||
## Estado da conexão
|
||||
## Estado de conexão
|
||||
|
||||
O rodapé consulta `/api/health` e mostra um de:
|
||||
A interface comunica-se com `/api/health` e exibe:
|
||||
|
||||
- **Conectando…:** a primeira requisição ainda não terminou.
|
||||
- **Serviço local ativo:** `/api/health` respondeu.
|
||||
- **Serviço indisponível:** a requisição falhou; o shell continua utilizável para
|
||||
configurações.
|
||||
|
||||
O shell Tauri poderá apontar para um daemon local ou um `serve` remoto em versão
|
||||
futura. Em `0.1.0` ele usa a API local.
|
||||
- **Conectando:** conexão inicial em andamento.
|
||||
- **Serviço local ativo:** o daemon está respondendo.
|
||||
- **Serviço indisponível:** falha na conexão com o daemon; a interface continua acessível para ajustes locais.
|
||||
|
||||
## Tela de análise
|
||||
|
||||
`Analisar` envia o caminho para `/api/analyze` e imprime a resposta JSON. O
|
||||
esqueleto valida o caminho e devolve um relatório stub. Ele não lê registros Zeek
|
||||
e não renderiza pontuações. Falhas aparecem como texto, nunca como estado vazio
|
||||
silencioso.
|
||||
|
||||
## Tela de alertas
|
||||
|
||||
A lista está vazia de propósito. Uma linha futura de alerta vai mostrar pilar,
|
||||
pontuação, timestamp e link para o registro de evidência. A evidência precisa
|
||||
incluir entradas, valores intermediários, sentinelas, pesos e versão do código;
|
||||
pontuação sozinha não basta.
|
||||
|
||||
## Acessibilidade
|
||||
|
||||
- A navegação usa botões reais e `aria-label`.
|
||||
- O diálogo de configurações usa `<dialog>` com título rotulado.
|
||||
- Mudanças de estado usam texto, não só cor.
|
||||
|
||||
## Limitações
|
||||
|
||||
- Sem screenshots reais: as telas são shells.
|
||||
- Sem detalhe de alerta, gráficos ou navegador de dataset ainda.
|
||||
- Sem autenticação: a UI assume daemon em loopback.
|
||||
- O app desktop não se auto-atualiza; ele só informa a versão disponível.
|
||||
Enviar um caminho de diretório para `/api/analyze` dispara a ingestão do Zeek e o
|
||||
pipeline analítico de detecção.
|
||||
Reference in new issue
Block a user