From 9be13e3f71c40accd87282b3a429ac3399b5eca3 Mon Sep 17 00:00:00 2001
From: tzzrgit <git@tzr.systems>
Date: Mon, 22 Dec 2025 09:42:13 +0100
Subject: [PATCH] Update README with system documentation

---
 README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 50 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 55f70a7..cc5bc15 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,51 @@
-# margaret
+# MARGARET
 
-Log de entrada CORP - Sistema TZZR
\ No newline at end of file
+**Log de entrada CORP - Sistema TZZR**
+
+## Rol
+
+Secretaria de entrada para CORP (servidor empresarial). Variante de CLARA con funcionalidades adicionales.
+
+## Posición en el Flujo
+
+```
+PACKET (App) ──► MARGARET ──► MASON ──► FELDMAN
+                    │
+                    └──► R2 (archivos)
+```
+
+## Comparación
+
+| Aspecto | CLARA (DECK) | MARGARET (CORP) |
+|---------|--------------|-----------------|
+| Servidor | Personal | Empresarial |
+| Log | Inmutable | Inmutable |
+| Extras | - | + NOTARIO (certificación) |
+
+## Función
+
+1. Recibe contenedor de PACKET
+2. Envía archivos a R2
+3. Registra metadata + ubicación R2
+4. **NO añade información**
+5. **NO procesa**
+6. **NO modifica**
+
+## Identificador
+
+```
+h_instancia = SHA-256(seed único de CORP)
+```
+
+Mismo hash para:
+- Autenticación (`X-Auth-Key`)
+- Biblioteca privada
+- Prefijo R2
+
+## Arquitectura
+
+Ver documentación completa en [contratos-comunes/architecture](https://git.tzzr.me/tzzr/contratos-comunes/src/branch/main/architecture/01-clara-margaret.md)
+
+---
+
+*Componente del sistema TZZR*