From 93d8a3b5c903e529cc9519397c85ea1603a92981 Mon Sep 17 00:00:00 2001 From: tzzrgit Date: Mon, 22 Dec 2025 09:42:16 +0100 Subject: [PATCH] Update README with system documentation --- README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 56 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ff93b8f..971062e 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,57 @@ -# sentinel +# SENTINEL -Auditoria del sistema - Sistema TZZR \ No newline at end of file +**Auditoría del sistema - Sistema TZZR** + +## Rol + +Observador paralelo que audita todos los componentes del sistema. + +## Posición + +``` +┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ +│ CLARA │ │MARGARET │ │ALFRED/ │ │ MASON │ │ FELDMAN │ +│ │ │ │ │JARED │ │ │ │ │ +└────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ + │ │ │ │ │ + └─────────────┴─────────────┴─────────────┴─────────────┘ + │ + ▼ + ┌──────────────────────────────┐ + │ SENTINEL │ + └──────────────────────────────┘ +``` + +**SENTINEL no está en el flujo lineal. Observa TODO en paralelo.** + +## Tipos de Auditoría + +| Tipo | Cuándo | Coste | +|------|--------|-------| +| **Superficial** | Siempre | Bajo | +| **Profunda** | Errores | Alto | +| **Profunda** | Muestreo X% | Alto | + +## Por qué Muestreo + +Auditar todo en profundidad haría el sistema muy pesado. El muestreo: +- Mantiene rendimiento +- Detecta problemas sistémicos +- Mide calidad de procesos + +## Alertas + +| Nivel | Acción | +|-------|--------| +| info | Log | +| warning | Log + notificación | +| error | Log + notificación urgente | +| critical | Log + notificación + pausa | + +## Arquitectura + +Ver documentación completa en [contratos-comunes/architecture](https://git.tzzr.me/tzzr/contratos-comunes/src/branch/main/architecture/05-sentinel.md) + +--- + +*Componente del sistema TZZR*