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"

(Los nombres de los paquetes cambian entre versiones de Tauri: si una compilación falla al buscar un archivo `.pc` que falta, consulta los
[requisitos actuales de Tauri para Linux](https://v2.tauri.app/start/prerequisites/)
para tu distribución.)

</details>

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

1. Instala las **Microsoft C++ Build Tools** (carga de trabajo "Desarrollo de escritorio con C++" en el Instalador de Visual Studio), necesarias tanto para el shell nativo de Tauri como para compilar el SQLite incluido.
2. Instala la cadena de herramientas de Rust **MSVC**: `rustup default stable-msvc`.
3. **WebView2**: ya está presente en Windows 11 y en la mayoría de instalaciones actualizadas de Windows 10; si no es así, la compilación de Tauri te pedirá que instales el runtime Evergreen.

</details>

---

## 2. Compilación

Desde la raíz del repositorio:```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

Una vez que hayas puesto en marcha tu propio servidor (§5) y tengas un dominio real apuntando a
él, configura esto y recompila: cada copia que distribuyas a partir de entonces mostrará
"Seal" como una opción real y seleccionable usando esa URL, sin tocar ningún
otro código. Déjalo sin configurar para compilaciones ordinarias/de desarrollo: no hay un servidor oficial
alojado por este repositorio, así que "Seal" permanece deshabilitado y la gente recurre a
un servidor personalizado o al local, en lugar de que la aplicación apunte silenciosamente a
un dominio de marcador de posición que en realidad no ejecuta nada.

---

## 3. Ejecutarlo en modo de desarrollo```sh
cd apps/desktop
npm install
npm run tauri dev

### Ejecutar dos instancias localmente (para probar realmente la mensajería)

Cada instancia necesita su propia identidad. Seal admite múltiples cuentas
de forma nativa (Configuración → Cuentas en este dispositivo), pero para dos *procesos
separados* en una misma máquina, `P2P_CHAT_PROFILE` es la vía más rápida:
crea automáticamente (la primera vez) o reanuda automáticamente (cada vez después) una cuenta
con ese nombre, de forma no interactiva, omitiendo por completo el selector de cuentas:```sh
# terminal 1
P2P_CHAT_PROFILE=alice npm run tauri dev

# terminal 2
P2P_CHAT_PROFILE=bob npm run tauri dev

Misma idea que arriba, pero inicia la aplicación compilada real (la salida de `build-mac-app.sh` / `build-mac-dmg.sh`, o una copia instalada en `/Applications`) dos veces con diferentes `P2P_CHAT_PROFILE`s en lugar de `npm run tauri dev`, más parecido a lo que ejecuta un usuario real. Muestra los PIDs y cómo detener ambos.

### Depuración

- **Registros de Rust**: establece `RUST_LOG` antes de iniciar, p. ej. `RUST_LOG=debug npm run tauri dev` (o `RUST_LOG=p2p_core=debug,net=debug` para acotarlo). Los campos registrados se limitan a metadatos (IDs de par/grupo/usuario, tipos de error); consulta [`docs/SECURITY.md`](https://github.com/emn4tor/seal/blob/HEAD/docs/SECURITY.md) para ver por qué es seguro dejarlo en modo verboso.
- **Frontend**: la ventana de desarrollo es un webview real; clic derecho → Inspeccionar elemento (o abrir las herramientas de desarrollo) funciona como en un navegador normal.
- **Crates del backend de forma aislada**: cada crate tiene su propio conjunto de pruebas que puedes ejecutar e iterar sin tocar la interfaz en absoluto; ver §4.
- **Un servidor de directorio independiente**, en lugar del integrado: ver §5.

---

## 4. Pruebas```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

Interactivo, solo Linux + systemd (consulta el encabezado del script para saber por qué). Pregunta sobre qué familia de distribución estás usando (Debian/Ubuntu, Fedora/RHEL/Rocky/Alma, Arch/Manjaro u openSUSE, pre-rellenada con una suposición de `/etc/os-release`, por lo que normalmente es una confirmación con una sola tecla) e instala los requisitos previos de compilación de esa distribución con una función dedicada por familia, ofrece instalar Rust mediante `rustup` si falta, compila el binario de lanzamiento, crea un usuario de sistema dedicado, genera un token de administrador, pregunta si quieres que configure un dominio con HTTPS automático mediante [Caddy](https://caddyserver.com) (instalando el propio Caddy, por distribución, recurriendo al binario estático oficial de Caddy si el paquete de una distribución no está disponible), o que simplemente enlace loopback/HTTP plano si prefieres ponerlo tú mismo al frente, luego escribe y habilita el servicio systemd. Es seguro volver a ejecutarlo.
Todo lo siguiente es lo que realmente hace, si prefieres hacerlo a mano
o entenderlo antes de ejecutarlo.

### macOS: un servidor de prueba LAN rápido```sh
./scripts/run-mac-test-server.sh

| Variable | Requerido | Significado |
|---|---|---|
| `DIRECTORY_DB_PATH` | no (por defecto `directory.sqlite3`, cwd) | Dónde reside el único archivo SQLite. El directorio padre debe existir. |
| `DIRECTORY_PUBLIC_ADDR` | no (por defecto `0.0.0.0:8080`) | La API de rendezvous con la que hablan las aplicaciones. Es seguro exponerla públicamente. |
| `DIRECTORY_ADMIN_ADDR` | no (por defecto `127.0.0.1:8090`) | El endpoint de purga. Mantenlo fuera de la internet pública; ver más abajo. |
| `DIRECTORY_ADMIN_TOKEN` | **sí** | Token Bearer para la API de administración. El proceso se niega a iniciar sin uno. Genéralo con `openssl rand -hex 32` o similar; no lo reutilices en ningún otro lugar. |

El proceso registra en los logs las direcciones a las que se vinculó al iniciar y advierte enérgicamente si `DIRECTORY_ADMIN_ADDR` no es loopback.

### Apuntar la aplicación al directorio

Tres maneras, en el orden en que normalmente acudirías a ellas:

1. **Pantalla de primer inicio**: elige "Custom server" e introduce la URL. Ver §3.
2. **Settings → Directory server**: cámbialo más tarde; surte efecto en el
   siguiente reinicio.
3. **`P2P_CHAT_DIRECTORY_URL`**, establecida antes de iniciar: omite la pregunta
   por completo y sobrescribe lo que se haya guardado, útil para ejecuciones de desarrollo o mediante scripts:   ```sh
   P2P_CHAT_DIRECTORY_URL=https://directory.example.com npm run tauri dev

Esto elimina el archivo SQLite y recrea un esquema vacío: no hay sentencias `DELETE`
ni estado parcial. Es seguro ejecutarlo sin avisar a nadie primero:
cada registro en él es una caché de datos que cada cliente ya tiene localmente
(su propio registro, presencia y cualquier lista de miembros de grupo de la que
formen parte), por lo que los clientes simplemente lo vuelven a poblar en cuestión de momentos tras su siguiente acción.
Deliberadamente no hay política de copia de seguridad para esta base de datos; consulta
[`docs/SECURITY.md`](https://github.com/emn4tor/seal/blob/HEAD/docs/SECURITY.md) para saber por qué mantener una socavaría
todo el propósito.

---

## 6. Uso de la aplicación

1. **Primer lanzamiento, primera pregunta**: qué servidor de directorio usar (§3).
   El valor predeterminado es el que esté integrado en la compilación que estés ejecutando (un servidor
   de pruebas local, a menos que quien lo haya compilado haya configurado uno oficial); elige
   "Servidor personalizado" para apuntar a uno que tú o alguien de confianza aloje.
2. **Elige un nombre para mostrar.** Esto genera un par de claves privadas en tu
   dispositivo (nada que recordar, y nada recuperable si se pierde: eso es
   deliberado) y te guía a través de una breve explicación dentro de la aplicación de cómo
   el cifrado realmente funciona. Puedes reproducirla cuando quieras desde Ajustes. Cada
   lanzamiento posterior te lleva directamente de vuelta sin aviso; esto solo ocurre una vez por
   cuenta. Añade más cuentas (identidades completamente separadas) desde Ajustes →
   Cuentas en este dispositivo, y cambia entre ellas sin reiniciar.
3. **Añade a alguien**: haz clic en **+** junto a "Mensajes directos" e introduce su
   ID (que se encuentra en *sus* Ajustes → Mi identidad). No hay un directorio para
   navegar por diseño; te conectas de la misma manera en que compartirías un número de teléfono.
4. **Envíales un mensaje**: elige su nombre de la lista y escribe. El primer
   mensaje a alguien establece una sesión cifrada automáticamente.
5. **Crea un grupo**: haz clic en **+** en la barra de iconos, ponle nombre y luego invita
   a personas por ID de la misma manera. Eliminar a alguien rota la clave del grupo para que
   no puedan leer nada enviado después.
6. **Bórralo todo**: Ajustes → Datos y privacidad. Esto es instantáneo,
   solo local e irreversible: destruye tus claves, contactos e
   historial en *este dispositivo* y no tiene ningún efecto en las personas con las que has hablado.