Fedora:```sh
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \
  libappindicator-gtk3-devel librsvg2-devel pkgconf-pkg-config
sudo dnf group install "C Development Tools and Libraries"

(Os nomes dos pacotes mudam entre versões do Tauri: se uma compilação falhar procurando por um arquivo `.pc` ausente, consulte os
[pré-requisitos atuais do Tauri para Linux](https://v2.tauri.app/start/prerequisites/)
para a sua distribuição.)

</details>

<details>
<summary><strong>Windows</strong></summary>

1. Instale as **Ferramentas de Build do Microsoft C++** (Visual Studio Installer →
   carga de trabalho "Desenvolvimento para desktop com C++"), necessárias tanto para o shell nativo do Tauri
   quanto para compilar o SQLite embutido.
2. Instale a toolchain Rust **MSVC**: `rustup default stable-msvc`.
3. **WebView2**: já está presente no Windows 11 e na maioria das instalações atualizadas do Windows
   10; se não estiver, o build do Tauri solicitará que você instale o
   runtime Evergreen.

</details>

---

## 2. Compilação

Na raiz do repositório:```sh
# Rust workspace (backend crates + the directory server)
cargo build --workspace --release

# Frontend + the actual desktop app bundle (installer/.app/.exe)
cd apps/desktop
npm install
npm run tauri build

Depois de subir seu próprio servidor (§5) e apontar um domínio real para
ele, configure isso e recompile: toda cópia que você distribuir a partir de então mostra
"Seal" como uma opção real e selecionável usando essa URL, sem tocar em nenhum
outro código. Deixe sem configurar para builds comuns/de desenvolvimento: não há um servidor
oficial hospedado por este repositório, então "Seal" permanece desabilitado e as pessoas recorrem a
um servidor personalizado ou ao local, em vez de o aplicativo apontar silenciosamente para
um domínio placeholder que não está realmente executando nada.

---

## 3. Executando em modo de desenvolvimento```sh
cd apps/desktop
npm install
npm run tauri dev

### Executando duas instâncias localmente (para realmente testar mensagens)

Cada instância precisa de sua própria identidade. O Seal suporta múltiplas contas
nativamente (Configurações → Contas neste dispositivo), mas para dois *processos
separados* na mesma máquina, `P2P_CHAT_PROFILE` é o caminho mais rápido: ele
cria automaticamente (primeira vez) ou retoma automaticamente (todas as vezes depois) uma conta
com esse nome, de forma não interativa, pulando completamente o seletor de contas:```sh
# terminal 1
P2P_CHAT_PROFILE=alice npm run tauri dev

# terminal 2
P2P_CHAT_PROFILE=bob npm run tauri dev

Mesma ideia de acima, mas inicia o aplicativo realmente compilado (saída de `build-mac-app.sh` /
`build-mac-dmg.sh`, ou uma cópia instalada em `/Applications`) duas vezes
com diferentes `P2P_CHAT_PROFILE`s em vez de `npm run tauri dev`, mais próximo
do que um usuário real executa. Mostra os PIDs e como interromper ambos.

### Depuração

- **Logs Rust**: defina `RUST_LOG` antes de iniciar, ex.:
  `RUST_LOG=debug npm run tauri dev` (ou `RUST_LOG=p2p_core=debug,net=debug`
  para restringir). Os campos registrados são limitados a metadados (IDs de
  peer/grupo/usuário, tipos de erro); veja [`docs/SECURITY.md`](https://github.com/emn4tor/seal/blob/HEAD/docs/SECURITY.md) para saber por que
  é seguro deixá-los detalhados.
- **Frontend**: a janela de desenvolvimento é um webview real; clique com o botão direito → Inspecionar
  Elemento (ou abra as ferramentas de desenvolvedor) funciona como um navegador normal.
- **Crates de backend isoladamente**: cada crate tem sua própria suíte de testes que você pode
  executar e iterar sem tocar na interface; veja §4.
- **Um servidor de diretório autônomo**, em vez do embutido: veja §5.

---

## 4. Testes```sh
# everything
cargo test --workspace

# one crate, e.g. the full backend-to-backend flow a Tauri command would trigger
cargo test -p p2p-core --test app_service

# lint + format check (what CI runs)
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings

# dependency vulnerability scan
cargo install cargo-audit --locked   # once
cargo audit

# frontend type-check + build
cd apps/desktop && npm run build

Interativo, apenas Linux + systemd (veja o cabeçalho do script para saber o porquê). Ele
pergunta em qual família de distro você está (Debian/Ubuntu, Fedora/RHEL/Rocky/Alma,
Arch/Manjaro ou openSUSE, pré-preenchida com uma suposição de `/etc/os-release`,
então normalmente é só uma tecla para confirmar) e instala os pré-requisitos
de compilação dessa distro com uma função dedicada por família, oferece instalar o Rust
via `rustup` se estiver faltando, compila o binário de release, cria um usuário
de sistema dedicado, gera um token de administrador, pergunta se você quer que ele
configure um domínio com HTTPS automático via [Caddy](https://caddyserver.com)
(instalando o próprio Caddy, por distro, recorrendo ao binário estático oficial
do Caddy se o pacote da distro não estiver disponível), ou apenas fazer bind
em loopback/HTTP simples se você preferir expô-lo você mesmo, depois grava e
ativa o serviço systemd. Seguro para reexecutar.
Tudo abaixo é o que ele realmente faz, se você preferir fazer manualmente
ou entender antes de executá-lo.

### macOS: um servidor de teste rápido na LAN```sh
./scripts/run-mac-test-server.sh

| Variável | Obrigatório | Significado |
|---|---|---|
| `DIRECTORY_DB_PATH` | não (padrão `directory.sqlite3`, diretório de trabalho atual) | Onde o arquivo SQLite único fica. O diretório pai deve existir. |
| `DIRECTORY_PUBLIC_ADDR` | não (padrão `0.0.0.0:8080`) | A API de rendezvous com a qual os apps falam. Pode ser exposta publicamente. |
| `DIRECTORY_ADMIN_ADDR` | não (padrão `127.0.0.1:8090`) | O endpoint de purga. Mantenha-o fora da internet pública; veja abaixo. |
| `DIRECTORY_ADMIN_TOKEN` | **sim** | Token Bearer para a API de administração. O processo se recusa a iniciar sem um. Gere com `openssl rand -hex 32` ou similar; não o reutilize em nenhum outro lugar. |

O processo registra em log quais endereços ele vinculou na inicialização e avisa alto se
`DIRECTORY_ADMIN_ADDR` não for loopback.

### Apontando o aplicativo para ele

Três maneiras, na ordem em que você normalmente as usaria:

1. **Tela da primeira execução**: escolha "Custom server" e digite a URL. Veja §3.
2. **Configurações → Directory server**: altere depois; tem efeito no próximo
   reinício.
3. **`P2P_CHAT_DIRECTORY_URL`**, definida antes de iniciar: pula a pergunta
   completamente e substitui o que foi salvo, útil para execuções de desenvolvimento/script:   ```sh
   P2P_CHAT_DIRECTORY_URL=https://directory.example.com npm run tauri dev

Isto elimina o ficheiro SQLite e recria um esquema vazio: não há instruções
`DELETE`, nem estado parcial. É seguro executar sem avisar ninguém primeiro:
cada registo nele é um cache de dados que cada cliente já possui localmente
(o seu próprio registo, presença e quaisquer listas de grupos de que seja
membro), pelo que os clientes apenas o voltam a preencher momentos após a
sua próxima ação. Não há deliberadamente nenhuma política de cópias de
segurança para esta base de dados; consulte
[`docs/SECURITY.md`](https://github.com/emn4tor/seal/blob/HEAD/docs/SECURITY.md) para saber por que razão manter uma
comprometeria todo o propósito.

---

## 6. Usar a aplicação

1. **Primeiro arranque, primeira pergunta**: qual servidor de diretório usar (§3).
   O padrão é o que estiver incorporado na compilação que você está a executar (um servidor
   de teste local, a menos que quem o compilou tenha configurado um oficial); escolha
   "Servidor personalizado" para apontar para um que você ou alguém em quem confie hospede.
2. **Escolha um nome de exibição.** Isto gera um par de chaves privadas no seu dispositivo
   (nada para lembrar e nada recuperável se perdido: isso é deliberado) e orienta-o através
   de uma breve explicação na aplicação sobre como a encriptação realmente funciona. Pode
   repeti-la em qualquer altura a partir das Definições. Cada arranque posterior volta a
   entrar diretamente, sem qualquer pedido; isto só acontece uma vez por conta. Adicione
   mais contas (identidades totalmente separadas) a partir de Definições → Contas neste
   dispositivo e alterne entre elas sem reiniciar.
3. **Adicionar alguém**: clique em **+** ao lado de "Mensagens diretas" e introduza o ID da pessoa
   (encontrado nas Definições → A Minha Identidade). Não há diretório para navegar, de propósito;
   a ligação é feita da mesma forma que se partilharia um número de telefone.
4. **Envie-lhes uma mensagem**: escolha o nome da pessoa na lista e escreva. A primeira
   mensagem para alguém estabelece automaticamente uma sessão encriptada.
5. **Iniciar um grupo**: clique em **+** na barra de ícones, dê-lhe um nome e convide pessoas
   pelo ID da mesma forma. Remover alguém roda a chave do grupo para que essa pessoa não
   consiga ler nada enviado posteriormente.
6. **Eliminar tudo**: Definições → Dados e Privacidade. Isto é instantâneo, apenas local e irreversível:
   destrói as suas chaves, contactos e historial *neste dispositivo* e não tem qualquer efeito nas pessoas
   com quem falou.