1# modules/matilda/ — Administración de servidores
2
3**Propósito.** Administrar servidores de forma declarativa: se describe
4el inventario deseado (hosts, contenedores Docker, vhosts de proxy
5inverso) y matilda renderiza la configuración y calcula el plan que
6reconcilia el estado actual con el deseado.
7
8## Crates
9
10| crate            | tipo | rol                                                          |
11| ---------------- | ---- | ------------------------------------------------------------ |
12| `matilda-core`   | lib  | Modelo: `Host`, `Container`, `VHost`, `Inventory`            |
13| `matilda-config` | lib  | Renderizado: `Container` → docker-compose / `docker run`; `VHost` → nginx |
14| `matilda-plan`   | lib  | Reconciliación: `plan(actual, deseado)` → lista ordenada de `Action`s |
15| `matilda-apply`  | lib  | Puente plan→ejecución: `Action`s → `ApplyStep`s (archivos + comandos) y script de shell |
16
17App: `apps/matilda` — demo CLI (`cargo run -p matilda`).
18
19## Flujo
20
21```text
22  Inventory (deseado) ──► matilda-config ──► docker-compose.yml + nginx
23        │
24        └──► matilda-plan ◄── Inventory (actual) ──► Plan { actions }
25```
26
27- **Declarativo**: el inventario describe *qué* debe existir; nadie
28  ejecuta nada en `core`/`config`/`plan` — son funciones puras.
29- **Plan ordenado**: crear contenedores antes que vhosts; eliminar
30  vhosts antes que sus contenedores. Determinista (inventario en
31  `BTreeMap`).
32
33## Dependencias
34
35- `config` y `plan` ← `matilda-core`. Todos `#![forbid(unsafe_code)]`.
36- Cero Docker, cero SSH, cero disco — sólo modelos y strings.
37
38## Crates de ejecución
39
40| crate            | tipo | rol                                                          |
41| ---------------- | ---- | ------------------------------------------------------------ |
42| `matilda-ghost`  | lib  | Ejecuta los `ApplyStep`s en la máquina destino (escribe archivos, corre comandos) + `dry_run`; reporta paso a paso |
43| `matilda-linker` | lib  | Aplica los pasos en un host **remoto** por SSH (`brahman-ssh-multiplex`); mismo `ApplyReport` |
44
45CLI: `apps/matilda` — `example` / `plan` / `script` / `apply`
46(local · `--dry-run` · `--host usuario@host` por SSH).
47
48## Estado
49
50`core` + `config` + `plan` + `apply` + `ghost` + `linker` implementados
51y verdes (~42 tests) + CLI. La cadena va de la declaración (inventario
52JSON) al plan, al script y a la aplicación —local, en seco o remota—.
53
54**Pendiente**: `matilda-discover` (leer el estado actual del servidor —
55`docker inspect`, sitios de nginx— para un diff real en vez de partir
56de un inventario vacío) y `matilda-app`, el frontend GPUI.