docs(v5): Complete system documentation

Comprehensive documentation for TZZR system v5 including: - 00_VISION: Glossary and foundational philosophy - 01_ARQUITECTURA: System overview and server specs - 02_MODELO_DATOS: Entity definitions and data planes (T0, MST, BCK) - 03_COMPONENTES: Agent docs (CLARA, MARGARET, FELDMAN, GRACE) - 04_SEGURIDAD: Threat model and secrets management - 05_OPERACIONES: Infrastructure and backup/recovery - 06_INTEGRACIONES: GPU services (RunPod status: blocked) - 99_ANEXOS: Repository inventory (24 repos) Key findings documented: - CRITICAL: UFW inactive on CORP/HST - CRITICAL: PostgreSQL 5432 exposed - CRITICAL: .env files with 644 permissions - RunPod workers not starting (code ready in R2) - Infisical designated as single source of secrets (D-001) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-24 17:58:03 +00:00
parent a92d41c846
commit 6d15abcb1a
16 changed files with 4164 additions and 2 deletions
--- a/00_VISION/filosofia.md
+++ b/00_VISION/filosofia.md
@@ -0,0 +1,105 @@
+# Filosofía del Sistema TZZR
+
+**Versión:** 5.0
+**Fecha:** 2024-12-24
+
+---
+
+## 10 Principios Fundacionales
+
+### 1. Constructores, no gestores
+
+Las instancias Claude son **constructores de arquitecturas**, no gestores permanentes.
+
+- Cada instancia diseña y construye la arquitectura de un servidor
+- Cuando la arquitectura esté madura, el servidor será **clonable e independiente**
+- Funcionará sin necesidad de su instancia Claude
+- Solo los servidores del propietario original mantienen conexión con Claude
+
+### 2. Descentralización operativa
+
+```
+Architect App (centralizado)  →  Diseña moldes
+                                      ↓
+                    Instancias reales (descentralizadas)
+                                      ↓
+                    Cada una con su CORP, su DECK, sus agentes
+```
+
+### 3. Referencias ligeras mediante hashes
+
+```
+DEFINICIÓN ORIGINAL  →  SHA-256  →  HASH UNÍVOCO (64 chars)
+```
+
+El hash es una referencia ligera que arrastra toda la información del original sin duplicarla.
+
+### 4. Separación de planos
+
+| Plano | Nombre | Función |
+|-------|--------|---------|
+| **T-N → T0** | ITM (Ítems) | Lo ideal, la partitura |
+| **Burocrático** | MST (Milestones) | Documentos, hitos, estados |
+| **Físico** | BCK (Bloques) | Acciones, evidencias, trabajo real |
+
+### 5. Período flotante antes de inmutabilidad
+
+Los datos pasan por un período flotante que permite mejora antes del sellado definitivo.
+
+```
+Dato nuevo → Período flotante (24h) → Verificación SENTINEL → Sellado FELDMAN → Inmutable
+```
+
+### 6. Renombrabilidad de agentes
+
+Los componentes marcados como renombrables pueden personalizarse:
+
+```
+CLARA → "Lucía"
+ALFRED → "Pepe"
+PENNY → "Asistente"
+```
+
+Esto permite que cada usuario sienta el sistema como propio.
+
+### 7. GRACE nunca modifica
+
+GRACE extrae y comprende, pero **nunca modifica** el contenido original.
+
+> "Solo extrae y comprende, nunca modifica el contenido original."
+
+### 8. Auditoría dual: confía pero verifica
+
+SENTINEL opera en dos modos:
+
+| Modo | Frecuencia | Alcance | Tecnología |
+|------|------------|---------|------------|
+| **LIGHT** | Cada 5 min | Todos los registros | Reglas automáticas |
+| **DEEP** | Cada 1 hora | Muestreo | LLM análisis |
+
+### 9. Zero-retention en interfaces móviles
+
+PACKET no almacena datos localmente. Todo va directo al servidor.
+
+### 10. Curación humana en Vision Builder
+
+```
+VALORES → OBJETIVOS → IMÁGENES IA → CURACIÓN HUMANA → LO QUE SOBREVIVE DEFINE QUIÉN ERES
+```
+
+---
+
+## Modelo de Instancias
+
+**DECK** y **CORP** son plantillas. En producción habrá múltiples instancias:
+
+| Tipo | Ejemplos |
+|------|----------|
+| **DECK** | "Deck de Juan", "Deck de Victoria", "Deck de Pablo" |
+| **CORP** | "Lacitos de Colores SL", "TZR Tech", "Acme Corp" |
+
+Cada instancia:
+- Tiene su propio bucket de almacenamiento
+- Puede renombrar sus agentes
+- Opera de forma descentralizada
+- Se conecta a servicios compartidos (GRACE, THE FACTORY, CIRCLE)
--- a/00_VISION/glosario.md
+++ b/00_VISION/glosario.md
@@ -0,0 +1,129 @@
+# Glosario TZZR
+
+**Versión:** 5.0
+**Fecha:** 2024-12-24
+
+---
+
+## Entidades Base
+
+| Término | Hash | Descripción | Estado |
+|---------|------|-------------|--------|
+| **HST** | h_maestro | Hash Semantic Tagging - Etiquetas semánticas visuales | Implementado |
+| **ITM** | h_item | Ítems ideales - Definiciones del plano T0 | Planificado |
+| **PLY** | h_player | Players - Identidad de actores | Planificado |
+| **LOC** | h_loc | Locations - Ubicaciones geográficas | Planificado |
+| **FLG** | h_flag | Flags - Marcos jurídicos y banderas | Planificado |
+
+---
+
+## Planos de Datos
+
+| Plano | Tabla | Descripción |
+|-------|-------|-------------|
+| **T0** | items | Lo ideal, la partitura, estado futuro deseado |
+| **MST** | milestones | Plano burocrático - documentos, hitos, estados |
+| **BCK** | bloques | Plano físico - acciones, evidencias, trabajo real |
+
+---
+
+## Agentes
+
+### Ingesta
+| Agente | Servidor | Puerto | Descripción |
+|--------|----------|--------|-------------|
+| **CLARA** | DECK | 5051 | Recoge información personal, log inmutable |
+| **MARGARET** | CORP | 5051 | Recoge información corporativa, log inmutable |
+
+### Orquestación
+| Agente | Servidor | Puerto | Descripción |
+|--------|----------|--------|-------------|
+| **ALFRED** | DECK | 5052 | Flujos predefinidos personales |
+| **JARED** | CORP | 5052 | Flujos predefinidos corporativos (más potente) |
+
+### Procesamiento
+| Agente | Servidor | Puerto | Descripción |
+|--------|----------|--------|-------------|
+| **MASON** | CORP | 5053 | Enriquecimiento, ventana flotante 24h |
+| **FELDMAN** | CORP | 5054 | Consolidación final, blockchain, inmutable |
+| **SENTINEL** | - | - | Auditoría LIGHT (5min) + DEEP (1h) [planificado] |
+
+---
+
+## Servicios GPU (RunPod)
+
+| Servicio | Endpoint | Descripción | Estado |
+|----------|----------|-------------|--------|
+| **GRACE** | r00x4g3rrwkbyh | IA cognitiva, extracción (18 módulos) | Bloqueado |
+| **PENNY** | 0mxhaokgsmgee3 | Asistente personal, generación texto | Planificado |
+| **FACTORY** | ddnuk6y35zi56a | Generación iterativa | Planificado |
+
+---
+
+## Servidores
+
+| Servidor | IP | Rol |
+|----------|-----|-----|
+| **ARCHITECT** | 69.62.126.110 | Coordinador central, Gitea, PostgreSQL |
+| **DECK** | 72.62.1.113 | Servidor personal |
+| **CORP** | 92.112.181.188 | Servidor empresarial |
+| **HST** | 72.62.2.84 | API tags semánticos |
+| **LOCKER** | Cloudflare R2 | Almacenamiento (5 buckets) |
+
+---
+
+## Hashes y Identificadores
+
+| Prefijo | Tipo | Ejemplo | Descripción |
+|---------|------|---------|-------------|
+| **h_maestro** | SHA-256 | `a1b2c3...` | Hash de tag HST |
+| **h_instancia** | SHA-256 | `d4e5f6...` | Identidad servidor/contexto |
+| **h_entrada** | SHA-256 | `g7h8i9...` | Hash contenedor ingesta |
+| **h_bloque** | SHA-256 | `j0k1l2...` | Hash de bloque BCK |
+| **h_milestone** | SHA-256 | `m3n4o5...` | Hash de milestone MST |
+| **H_proyecto** | Prefijo | `H_tzzr_genesis` | Identificador proyecto legible |
+
+---
+
+## Interfaces
+
+| Interfaz | Tipo | Descripción |
+|----------|------|-------------|
+| **PACKET** | App móvil | Captura multimedia, zero-retention |
+| **Vision Builder** | Web | Diseño de vida mediante curación visual |
+| **Mind Link** | Web | Compartición de información |
+
+---
+
+## Protocolos
+
+| Protocolo | Versión | Descripción |
+|-----------|---------|-------------|
+| **S-CONTRACT** | v2.1 | Comunicación con IAs (context, deployment, envelope, payload) |
+| **locker://** | - | Referencias almacenamiento R2 |
+
+---
+
+## Grupos HST
+
+| Grupo | Cantidad | Descripción |
+|-------|----------|-------------|
+| **hst** | 639 | Tags del sistema base |
+| **spe** | 145 | Tags específicos |
+| **vsn** | 84 | Visiones |
+| **flg** | 65 | Banderas/países |
+| **vue** | 21 | Vistas |
+| **hsu** | - | Tags usuario (extensión) |
+
+---
+
+## Estados de Pipeline
+
+| Estado | Etapa | Descripción |
+|--------|-------|-------------|
+| **recibido** | CLARA/MARGARET | Contenedor ingresado, inmutable |
+| **en_edicion** | MASON | Usuario enriqueciendo datos |
+| **listo** | MASON | Listo para consolidar |
+| **pendiente** | FELDMAN | En cola de consolidación |
+| **consolidado** | FELDMAN | Registrado en milestone/bloque |
+| **sellado** | NOTARIO | Blockchain confirmado |