Update to Skynet v7 - Complete documentation restructure

- Nueva estructura de carpetas según Skynet v7 - Añadidos schemas SQL completos - Documentación de entidades, componentes e integraciones - Modelo de seguridad actualizado - Infraestructura y operaciones reorganizadas
2025-12-29 18:23:41 +00:00
parent ac481fe266
commit 6ea70bd34f
76 changed files with 13029 additions and 4340 deletions
--- a/00_VISION/filosofia.md
+++ b/00_VISION/filosofia.md
@@ -1,118 +1,185 @@
-# Filosofía del Sistema TZZR
+# Filosofía Fundacional

-**Versión:** 5.0
-**Fecha:** 2024-12-24
+**Versión:** 1.0  
+**Estado:** Definición

 ---

-## 10 Principios Fundacionales
-
-### 1. Constructores, no gestores
-
-ARCHITECT (con Claude) es un **constructor de arquitecturas**, no un gestor permanente.
-
- ARCHITECT diseña y construye la arquitectura de cada servidor
- Cuando la arquitectura esté madura, el servidor será **clonable e independiente**
- DECK y CORP funcionan sin conexión a ARCHITECT ni a Claude
- Son sistemas diseñados para **usar** servicios de IA (APIs externas, RunPod), no para contenerla
-
-### 2. Descentralización operativa
+## 1. Principio Fundamental

 ```
-Architect App (centralizado)  →  Diseña moldes
-                                      ↓
-                    Instancias reales (descentralizadas)
-                                      ↓
-                    Cada una con su CORP, su DECK, sus agentes
+┌─────────────────────────────────────────────────────────────────┐
+│                                                                 │
+│   "La realidad es un flujo energético continuo.                │
+│    Las categorías son modelos mentales útiles,                 │
+│    no verdades absolutas.                                       │
+│    Ante la duda, analizar el flujo de energía                  │
+│    clarifica la situación."                                     │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
 ```

-### 3. Referencias ligeras mediante hashes
+Este principio guía todas las decisiones arquitectónicas del sistema. Cuando existe ambigüedad sobre cómo clasificar algo, la pregunta correcta es: **¿dónde se consume la energía?**
+
+---
+
+## 2. Paradigma de Resultados

 ```
-DEFINICIÓN ORIGINAL  →  SHA-256  →  HASH UNÍVOCO (64 chars)
+┌─────────────────────────────────────────────────────────────────┐
+│                                                                 │
+│   "El sistema no registra incidencias. Registra resultados."   │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
 ```

-El hash es una referencia ligera que arrastra toda la información del original sin duplicarla.
+| Paradigma Burocrático | Paradigma de Resultados |
+|----------------------|------------------------|
+| ¿Por qué no cumpliste? | ¿Cumpliste? |
+| Documenta la desviación | Documenta el resultado |
+| Justifica el proceso | Evidencia el producto |
+| El error es información | El error es ruido |

-### 4. Separación de planos
+### Implicación Técnica

-| 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 |
+Cuando un Bloque de trabajo se completa, el sistema registra:
+- Qué se hizo
+- Evidencia de que se hizo
+- Quién lo hizo
+- Cuándo quedó completo

-### 5. Período flotante antes de inmutabilidad
+El sistema **NO registra**:
+- Cuánto tardó internamente
+- Qué interrupciones hubo
+- Por qué se desvió del proceso ideal
+- Cuántos intentos fueron necesarios

-Los datos pasan por un período flotante que permite mejora antes del sellado definitivo.
+---
+
+## 3. Paradigma Temporal
+
+### Línea Temporal Fundamental

 ```
-Dato nuevo → Período flotante (24h) → Verificación SENTINEL → Sellado FELDMAN → Inmutable
+T-N ────→ T-1 ────→ T0 ────→ T+1 ────→ T+N
+ │         │        │        │         │
+Origen   Pre-      Inicio   Cierre   Futuro/
+Difuso   consoli-  Real     Eviden-  Histórico
+         dación            cia
 ```

-### 6. Renombrabilidad de agentes
+### Definición de Puntos Temporales

-Los componentes marcados como renombrables pueden personalizarse:
+| Punto | Significado | Características |
+|-------|-------------|-----------------|
+| **T−N** | Origen difuso | Exploración, ideas no consolidadas |
+| **T−1** | Referencia previa | Punto desde el cual planificar hacia T0 |
+| **T0** | Inicio ejecución | Arranque formal, recursos comprometidos |
+| **T+1** | Hito burocrático | Registro formal de cierre operativo |
+| **T+N** | Resultado consolidado | Materialización real en el mundo |
+
+### Naturaleza Temporal de Entidades
+
+| Entidad | Intervalo | Naturaleza |
+|---------|-----------|------------|
+| **Ítem** | T-N → T-1 → T0 | Definición ideal, proceso, producto conceptual |
+| **Milestone** | T0 → T+1 | Estado contable/legal en vigor |
+| **Bloque** | T+1 | Evidencia física de la ejecución |
+
+> **"Un Bloque es la fotografía energética del intervalo T0 → T+1"**
+
+---
+
+## 4. El Acuerdo Bilateral
+
+El sistema implementa un **pacto implícito de descargo de responsabilidad**:
+
+### La Empresa Ofrece
+
+- Herramientas para que el trabajador demuestre su buen trabajo
+- Ausencia de vigilancia de proceso
+- Contexto automático (arrastre de datos conocidos)
+- Granularidad que permite progreso incluso en días difíciles
+
+### El Trabajador Ofrece
+
+- Resultados evidenciados
+- Bloques completados
+- Narrativa verificable de su aportación
+
+### El Límite del Acuerdo
+
+> **Si los resultados no llegan, la trazabilidad revela el problema.**
+
+Pero lo revela de forma **constructiva**, no punitiva.
+
+---
+
+## 5. Trazabilidad como Movilidad
+
+La trazabilidad tradicional es un arma de control. En este sistema, es una **herramienta de movilidad**:
+
+### Para el Trabajador
+
+- Portfolio verificable de resultados
+- Evidencia objetiva de capacidades
+- Independencia de la opinión subjetiva del supervisor
+- Portabilidad entre puestos y empresas
+
+### Para la Empresa
+
+- Visibilidad real de dónde se genera valor
+- Identificación de cuellos de botella sin buscar culpables
+- Datos para optimizar asignación de recursos
+- Base objetiva para decisiones de personal
+
+### Mecánica Técnica
+
+Cada Bloque completado es un registro inmutable que demuestra:

 ```
-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
+[Trabajador X] completó [Tarea Y] con [Evidencia Z] en [Contexto W]
 ```

 ---

-## Modelo de Instancias
+## 6. Implicaciones para el Diseño

-**DECK** y **CORP** son plantillas. En producción habrá múltiples instancias:
+### Granularidad de Bloques

-| Tipo | Ejemplos |
-|------|----------|
-| **DECK** | "Deck de Juan", "Deck de Victoria", "Deck de Pablo" |
-| **CORP** | "Lacitos de Colores SL", "TZR Tech", "Acme Corp" |
+Los Bloques deben ser suficientemente pequeños para que:
+- Un día malo no impida completar ninguno
+- El progreso sea visible incluso con interrupciones
+- La evidencia sea simple (una foto, un tap, una confirmación)

-Cada instancia:
- Tiene su propio bucket de almacenamiento
- Puede renombrar sus agentes
- **Opera de forma autónoma** (no depende de ARCHITECT en runtime)
- Tiene su propio gestor de secretos (Vaultwarden)
- Hace sus propios backups a R2
+### Arrastre de Contexto

-### Servicios Compartidos (Opcionales)
+Cada nuevo Bloque debe heredar automáticamente:
+- Identidad del trabajador (sesión)
+- Datos del Milestone padre
+- Información ya capturada en pasos anteriores
+- Reglas aplicables (Bandera)

-Las instancias **pueden** conectarse a servicios GPU compartidos:
+El trabajador **solo aporta lo nuevo**. Nunca re-introduce datos existentes.

-| Servicio | Función | Requerido |
-|----------|---------|-----------|
-| GRACE | Extracción IA | Opcional |
-| THE FACTORY | Generación | Opcional |
-| CIRCLE | Colaboración | Opcional |
+### Evidencia Mínima Viable

-> **Nota:** Si los servicios compartidos no están disponibles, la instancia sigue operando. Solo las funciones de IA estarán limitadas.
+La evidencia requerida debe ser:
+- La mínima necesaria para demostrar el resultado
+- Capturable en segundos
+- No interpretable (foto > descripción textual)
+- Protección para el trabajador, no vigilancia
+
+---
+
+## Resumen
+
+| Principio | Implementación |
+|-----------|----------------|
+| Resultados sobre justificaciones | Solo se registran Bloques completados |
+| Ocultación legítima | Las incidencias se absorben si hay resultado |
+| Acuerdo bilateral | Herramientas a cambio de resultados |
+| Trazabilidad como movilidad | Portfolio verificable para ambas partes |
+| Eliminación del burócrata | Arrastre automático, sin transcripción |
+| Granularidad liberadora | Bloques pequeños = progreso posible |
+| Evidencia mínima | Demostrar resultado, no documentar proceso |
--- a/00_VISION/glosario.md
+++ b/00_VISION/glosario.md
@@ -1,7 +1,7 @@
-# Glosario TZZR
+# Glosario

-**Versión:** 5.0
-**Fecha:** 2024-12-24
+**Versión:** 1.0  
+**Estado:** Definición

 ---

@@ -10,7 +10,7 @@
 | 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 |
+| **ITM** | h_item | Items - Definiciones del plano ideal (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 |
@@ -27,84 +27,70 @@

 ---

-## Componentes (Microservicios)
+## Componentes del Sistema

-> **Nota:** Los componentes tienen nombres de persona pero son **microservicios backend**, no IA.
-> Están diseñados para consumir servicios de IA externos (APIs, RunPod), no para contenerla.
+### Registro Inmutable

-### secretaria (ingesta)
-| Componente | Servidor | Puerto | Descripción |
-|------------|----------|--------|-------------|
-| **secretaria (CLARA)** | DECK | 5051 | Recoge información personal, log inmutable |
-| **secretaria (MARGARET)** | CORP | 5051 | Recoge información corporativa, log inmutable |
+| Componente | Nombre Personal | Nombre Corporativo | Descripción |
+|------------|-----------------|-------------------|-------------|
+| Secretaría | Clara | Margaret | Ingesta, log inmutable |
+| Administración | Mason | Mason | Enriquecimiento, ventana flotante 24h |
+| Contable | Feldman | Feldman | Consolidación final, inmutable |
+| Producción | Alfred | Jared | Flujos predefinidos, orquestación |
+| Auditoría | Sentinel | Sentinel | LIGHT (5min) + DEEP (1h) |

-### administrativo (enriquecimiento)
-| Componente | Servidor | Puerto | Descripción |
-|------------|----------|--------|-------------|
-| **administrativo (MASON)** | DECK | 5053 | Enriquecimiento, ventana flotante 24h |
-| **administrativo (MASON)** | CORP | 5053 | Enriquecimiento, ventana flotante 24h |
+### Servicios IA

-### contable (consolidación)
-| Componente | Servidor | Puerto | Descripción |
-|------------|----------|--------|-------------|
-| **contable (FELDMAN)** | DECK | 5054 | Consolidación final, blockchain, inmutable |
-| **contable (FELDMAN)** | CORP | 5054 | Consolidación final, blockchain, inmutable |
+| Componente | Descripción |
+|------------|-------------|
+| Grace | Capa cognitiva, 18 módulos IA |
+| Penny | Asistente de voz conversacional |
+| The Factory | Generación iterativa |

-### producción (orquestación)
-| Componente | Servidor | Puerto | Descripción |
-|------------|----------|--------|-------------|
-| **producción (ALFRED)** | DECK | 5052 | Flujos predefinidos, orden de ejecución |
-| **producción (JARED)** | CORP | 5052 | Flujos predefinidos, orden de ejecución |
+### Orquestación

-### auditoría (planificado)
-| Componente | Servidor | Puerto | Descripción |
-|------------|----------|--------|-------------|
-| **SENTINEL** | - | - | Auditoría LIGHT (5min) + DEEP (1h) |
-
---
-
-## 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 |
+| Componente | Descripción |
+|------------|-------------|
+| Orchestrator | Orquestación multi-agente LLM |
+| Circle | Consejo de perspectivas |
+| Cloudville | Laboratorio de zumbados |

 ---

 ## 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) |
+| Servidor | Descripción |
+|----------|-------------|
+| **ARCHITECT** | Coordinador central, Gitea, PostgreSQL |
+| **DECK** | Servidor personal |
+| **CORP** | Servidor empresarial |
+| **HST** | API tags semánticos |

 ---

-## Hashes y Identificadores
+## Hashes e 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 |
+| Prefijo | Tipo | Descripción |
+|---------|------|-------------|
+| **h_maestro** | SHA-256 | Hash de tag HST |
+| **h_instancia** | SHA-256 | Identidad servidor/contexto |
+| **h_entrada** | SHA-256 | Hash contenedor ingesta |
+| **h_bloque** | SHA-256 | Hash de bloque BCK |
+| **h_milestone** | SHA-256 | Hash de milestone MST |
+| **h_item** | SHA-256 | Hash de ítem T0 |
+| **h_player** | SHA-256 | Hash de identidad PLY |
+| **h_loc** | SHA-256 | Hash de ubicación LOC |
+| **h_flag** | SHA-256 | Hash de bandera FLG |

 ---

-## Interfaces
+## Aplicaciones

-| Interfaz | Tipo | Descripción |
-|----------|------|-------------|
-| **PACKET** | App móvil | Captura multimedia, zero-retention |
+| Aplicación | 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 |
+| **Mind Link** | Web | Interfaz unificada de acceso |

 ---

@@ -112,7 +98,7 @@

 | Protocolo | Versión | Descripción |
 |-----------|---------|-------------|
-| **S-CONTRACT** | v2.1 | Comunicación con IAs (context, deployment, envelope, payload) |
+| **S-CONTRACT** | v2.1 | Comunicación con servicios IA |
 | **locker://** | - | Referencias almacenamiento R2 |

 ---
@@ -134,9 +120,9 @@

 | 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 |
+| **recibido** | Secretaría | Contenedor ingresado, inmutable |
+| **en_edicion** | Administración | Usuario enriqueciendo datos |
+| **listo** | Administración | Listo para consolidar |
+| **pendiente** | Contable | En cola de consolidación |
+| **consolidado** | Contable | Registrado en milestone/bloque |
+| **sellado** | Notario | Blockchain confirmado |