system-docs/README.md

# TZZR System Documentation v5

**Versión:** 5.0
**Fecha:** 2024-12-24
**Estado:** Consolidación completa

---

## Qué es TZZR

TZZR es un sistema de construcción de arquitecturas personales y empresariales mediante instancias Claude. Los agentes IA actúan como constructores que diseñan y edifican servidores clonables e independientes.

---

## Arquitectura General

```
┌─────────────────────────────────────────────────────────────┐
│                      ARCHITECT (69.62.126.110)              │
│  PostgreSQL central │ Gitea │ Orchestrator │ Infisical     │
└─────────────────────────────────────────────────────────────┘
          │                    │                    │
          ▼                    ▼                    ▼
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│ DECK            │  │ CORP            │  │ HST             │
│ 72.62.1.113     │  │ 92.112.181.188  │  │ 72.62.2.84      │
│                 │  │                 │  │                 │
│ CLARA, ALFRED   │  │ MARGARET, JARED │  │ 973 tags        │
│ Servidor        │  │ MASON, FELDMAN  │  │ API pública     │
│ Personal        │  │ Empresarial     │  │                 │
└─────────────────┘  └─────────────────┘  └─────────────────┘
          │                    │
          └────────┬───────────┘
                   ▼
┌─────────────────────────────────────────────────────────────┐
│              Cloudflare R2 (5 buckets)                     │
│  architect │ deck │ corp │ hst │ locker                    │
└─────────────────────────────────────────────────────────────┘
```

---

## Flujo de Datos Principal

```
PACKET (móvil)
    ↓
CLARA (DECK) / MARGARET (CORP)  ← Ingesta inmutable
    ↓
ALFRED / JARED                   ← Flujos predefinidos
    ↓
MASON                            ← Enriquecimiento (24h)
    ↓
FELDMAN                          ← Consolidación blockchain
    ↓
SENTINEL                         ← Auditoría (planificado)
```

---

## Índice de Documentación

### 00_VISION
- [Filosofía](00_VISION/filosofia.md) - 10 principios fundacionales
- [Glosario](00_VISION/glosario.md) - Términos técnicos A-Z

### 01_ARQUITECTURA
- [Overview](01_ARQUITECTURA/overview.md) - Vista general consolidada
- [Servidores](01_ARQUITECTURA/servidores.md) - ARCHITECT, DECK, CORP, HST

### 02_MODELO_DATOS
- [Entidades](02_MODELO_DATOS/entidades.md) - HST, ITM, PLY, LOC, FLG
- [Planos](02_MODELO_DATOS/planos.md) - T0 (ITM), MST, BCK

### 03_COMPONENTES
- [CLARA/MARGARET](03_COMPONENTES/agentes/clara-margaret.md) - Ingesta
- [FELDMAN](03_COMPONENTES/agentes/feldman.md) - Consolidación
- [GRACE](03_COMPONENTES/servicios/grace.md) - IA cognitiva

### 04_SEGURIDAD
- [Modelo de Amenazas](04_SEGURIDAD/modelo-amenazas.md) - Riesgos
- [Secretos](04_SEGURIDAD/secretos.md) - Gestión credenciales

### 05_OPERACIONES
- [Infraestructura](05_OPERACIONES/infraestructura.md) - Servidores
- [Backup/Recovery](05_OPERACIONES/backup-recovery.md) - DR plan

### 06_INTEGRACIONES
- [GPU Services](06_INTEGRACIONES/gpu-services.md) - RunPod

### 99_ANEXOS
- [Inventario Repos](99_ANEXOS/inventario-repos.md) - 24 repos

---

## Estado Actual

| Componente | Estado | Notas |
|------------|--------|-------|
| CLARA | Operativo | DECK:5051 |
| MARGARET | Operativo | CORP:5051 |
| ALFRED | Operativo | DECK:5052 |
| JARED | Operativo | CORP:5052 |
| MASON | Operativo | CORP:5053 |
| FELDMAN | Operativo | CORP:5054 |
| HST | Operativo | 973 tags |
| SENTINEL | Planificado | Sin implementar |
| GRACE | Bloqueado | RunPod no inicia |
| NOTARIO | Planificado | Sin implementar |

---

## Generación

Documentación generada mediante proceso de auditoría colaborativa:
- 3 auditores especializados (Arquitectura, Datos, Seguridad)
- Cross-review y resolución de conflictos
- Síntesis consolidada

**Fecha generación:** 2024-12-24