system-docs/v4-archive/margaret

MARGARET

Log de entrada CORP - Sistema TZZR

Rol

Secretaria de entrada para CORP (servidor empresarial). Variante de CLARA con funcionalidades adicionales.

Posicion en el Flujo

PACKET (App) --> MARGARET --> MASON --> FELDMAN
                    |
                    └--> R2 (archivos)

Endpoints

Metodo	Ruta	Descripcion
GET	/health	Estado del servicio
POST	/ingest	Recibir contenedor
GET	/query/<h_entrada>	Consultar por hash
GET	/list	Listar entradas

Autenticacion

Todas las rutas (excepto /health) requieren:

X-Auth-Key: {h_instancia}

Despliegue

# En CORP
cd /opt/margaret
cp .env.example .env
# Editar .env con credenciales
docker compose up -d

Configuracion

Ver .env.example para variables requeridas:

• H_INSTANCIA: Hash unico de CORP
• DB_*: Credenciales PostgreSQL
• R2_*: Credenciales Cloudflare R2

Base de Datos

Ejecutar init.sql en PostgreSQL:

sudo -u postgres psql -d corp -f init.sql

Comparacion

Aspecto	CLARA (DECK)	MARGARET (CORP)
Servidor	Personal	Empresarial
Log	Inmutable	Inmutable
Puerto	5051	5051
Bucket R2	deck	corp

Funcion

1. Recibe contenedor de PACKET
2. Envia archivos a R2
3. Registra metadata + ubicacion R2
4. NO agrega informacion
5. NO procesa
6. NO modifica

---

Componente del sistema TZZR - Implementado 2025-12-24