Archive: System v4 - Estado al 2024-12-24

v4-archive/margaret/README.md

@@ -0,0 +1,79 @@
+# MARGARET
+
+![Estado](https://img.shields.io/badge/Estado-IMPLEMENTADO-brightgreen)
+
+**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
+
+```bash
+# 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:
+```bash
+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*