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

2025-12-24 17:28:34 +00:00
parent a92d41c846
commit 1b392803fd
81 changed files with 24560 additions and 0 deletions
--- a/v4-archive/system/01-filosofia.md
+++ b/v4-archive/system/01-filosofia.md
@@ -0,0 +1,112 @@
+# Filosofía del Sistema
+
+## Visión
+
+TZZR es un sistema de construcción de arquitecturas personales y empresariales mediante instancias Claude.
+
+```
+Claude Instances → Construyen → Servidores Clonables → Funcionan Independientes
+```
+
+## Principios Fundamentales
+
+### 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 mantendrán 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 por FELDMAN.
+
+```
+Dato nuevo → Período flotante → Verificación SENTINEL → Sellado FELDMAN → Inmutable
+```
+
+### 6. Renombrabilidad de agentes
+
+Los componentes marcados como "Renombrable: Sí" 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 |
+|------|------------|---------|
+| **LIGHT** | Cada 5 min | Todos los registros |
+| **DEEP** | Cada 1 hora | Muestreo con LLM |
+
+### 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...)
+
+---
+
+*Actualizado: 2025-12-21*
--- a/v4-archive/system/02-componentes.md
+++ b/v4-archive/system/02-componentes.md
@@ -0,0 +1,178 @@
+# Componentes del Sistema
+
+## Catálogo Completo
+
+| Componente | Rol | Renombrable |
+|------------|-----|-------------|
+| **BASES** | HST, ITM, PLY, LOC, FLG — lo que existe antes de todo | No |
+| **DECK** | Servidor personal | No |
+| **LOCKER** | Almacenamiento físico (actual: R2, futuro: descentralizado) | No |
+| **CORP** | Cada empresa: libros, entidades, secretos | Sí |
+| **GRACE** | Extracción + comprensión (IA), nunca modifica | Sí |
+| **MASON** | Trabaja los datos, busca que todo encaje | Sí |
+| **CLARA** | Recoge información + log IAs (personal) | Sí |
+| **MARGARET** | Recoge información + log IAs (CORP) | Sí |
+| **PENNY** | Asistente personal, recados | Sí |
+| **ALFRED** | Flujos de trabajo (personal) | Sí |
+| **JARED** | Flujos de trabajo (CORP) | Sí |
+| **FELDMAN** | Cuida los libros, valida con blockchain | Sí |
+| **SENTINEL** | Auditoría interna (LIGHT + DEEP) | Sí |
+| **Tesorero** | Cuentas bancarias (futuro) | Sí |
+| **THE FACTORY** | IA generativa iterativa | No |
+| **CIRCLE** | Consejo de perspectivas | No |
+| **Cloudville** | Laboratorio de zumbados | No |
+| **PACKET** | Interfaz móvil | No |
+| **Architect App** | Sistema centralizado, crea instancias originales | No |
+| **Vision Builder** | Interfaz diseño de vida | No |
+| **Mind Flow** | Interfaz de flujos | No |
+| **Mind Link** | Interfaz de compartición | No |
+| **Mind Map** | Interfaz de estructuras | No |
+
+---
+
+## DECK — Servidor Personal
+
+### Arquitectura
+
+| Componente | Función |
+|------------|---------|
+| **MST (Milestones)** | Plano burocrático — documentos, hitos, estados |
+| **BCK (Bloques)** | Plano físico — acciones, evidencias, trabajo real |
+| **PostgreSQL** | Base de datos relacional |
+| **Directus** | Gestión de vistas ligeras |
+| **HST interno** | Etiquetas propias + proyectos |
+
+### Servicios Integrados
+
+| Servicio | Función |
+|---------|---------|
+| Correo | Mail-in-a-Box |
+| Gestor contraseñas | Credenciales personales |
+| Acortador URLs | Shlink |
+
+### Agentes Internos
+
+| Agente | Función |
+|--------|---------|
+| **CLARA** | Recoge información, log de IAs |
+| **MASON** | Vistas flotantes para completar datos |
+| **FELDMAN** | Registros inmutables |
+| **ALFRED** | Flujos de trabajo |
+| **SENTINEL** | Auditoría interna |
+
+---
+
+## CORP — Servidor Corporativo
+
+### Diferencias con DECK
+
+| Aspecto | DECK | CORP |
+|---------|------|------|
+| Orientación | Personal | Empresa |
+| Flujos | ALFRED | JARED (más potente) |
+| Recogida info | CLARA | MARGARET (más potente) |
+| CRM/ERP | No | Odoo |
+
+### Agentes Internos
+
+| Agente | Función |
+|--------|---------|
+| **MARGARET** | Recoge información (versión corporativa) |
+| **MASON** | Vistas flotantes |
+| **FELDMAN** | Registros inmutables |
+| **JARED** | Flujos de trabajo (versión corporativa) |
+| **SENTINEL** | Auditoría interna |
+
+---
+
+## Agentes del Sistema
+
+### CLARA / MARGARET
+
+Recoge información y mantiene log de interacciones con IAs.
+
+| Variante | Contexto | Potencia |
+|----------|----------|----------|
+| **CLARA** | DECK | Estándar |
+| **MARGARET** | CORP | Mayor |
+
+### MASON
+
+Trabaja los datos, genera vistas flotantes para que el usuario complete información.
+
+### ALFRED / JARED
+
+Almacén de flujos de trabajo.
+
+| Variante | Contexto | Potencia |
+|----------|----------|----------|
+| **ALFRED** | DECK | Estándar |
+| **JARED** | CORP | Mayor |
+
+### FELDMAN
+
+Cuida los libros, valida con blockchain. Convierte registros en inmutables tras período flotante.
+
+### PENNY
+
+Asistente personal para recados y gestión del día a día. Servicio compartido.
+
+### SENTINEL
+
+Auditoría interna dual.
+
+| Modo | Frecuencia | Alcance | Tecnología |
+|------|------------|---------|------------|
+| **LIGHT** | Cada 5 min | Todos | Reglas automáticas |
+| **DEEP** | Cada 1 hora | Muestreo | LLM análisis |
+
+**Categorías**: Integridad (I-*), Cumplimiento (C-*), Performance (P-*), Seguridad (S-*)
+
+### GRACE
+
+Extracción + comprensión mediante IA. **Nunca modifica**.
+
+Ubicación: RunPod GPU (servicio compartido).
+
+---
+
+## Servicios Compartidos
+
+### THE FACTORY
+
+Taller de IA generativa iterativa.
+
+```
+Usuario define objetivo → Genera versión → Feedback → Nueva iteración → Repetir
+```
+
+### CIRCLE
+
+Consejo de perspectivas para madurar decisiones.
+
+```
+Usuario plantea cuestión → N agentes con roles → Cada uno responde → Usuario recibe contraste
+```
+
+Roles ejemplo: El prudente, El arriesgado, El escéptico, El pragmático, El abogado del diablo
+
+### Cloudville
+
+Laboratorio de zumbados. Espacio experimental con reglas mínimas.
+
+---
+
+## Interfaces
+
+| Interfaz | Tipo | Función |
+|----------|------|---------|
+| **PACKET** | App móvil | Captura → CLARA/MARGARET (zero-retention) |
+| **Architect App** | Sistema central | Crea instancias originales |
+| **Vision Builder** | Diseño de vida | Objetivos mediante curación visual |
+| **Mind Flow** | Flujos | Trabaja flujos → ALFRED/JARED |
+| **Mind Link** | Compartición | Acceso a info para otros |
+| **Mind Map** | Estructuras | Crear estructuras de datos visuales |
+
+---
+
+*Actualizado: 2025-12-21*
--- a/v4-archive/system/03-datos.md
+++ b/v4-archive/system/03-datos.md
@@ -0,0 +1,70 @@
+# Estructuras de Datos
+
+## BASES — Entidades Fundamentales
+
+Lo que existe antes de todo. Sistema de referencias unívocas mediante hashes.
+
+```
+DEFINICIÓN ORIGINAL → SHA-256 → HASH UNÍVOCO (64 chars)
+```
+
+### Entidades
+
+| Base | Hash | Función | Estado |
+|------|------|---------|--------|
+| **HST** | H_maestro | Etiquetas semánticas visuales | ✅ Implementado |
+| **ITM** | H_item | Definiciones ideales | Futuro |
+| **PLY** | H_player | Identidad de actores | Futuro |
+| **LOC** | H_loc | Ubicaciones | Futuro |
+| **FLG** | H_flag | Marcos jurídicos | Futuro |
+
+### HST — Hash Semantic Tagging
+
+| Grupo | Cantidad |
+|-------|----------|
+| `hst` | ~658 |
+| `spe` | ~145 |
+| `flg` | ~65 |
+| `vsn` | ~84 |
+| `vue` | ~21 |
+
+**Tablas**: `hst_tags`, `hst_trees`, `hst_relations`, `hst_skins`
+
+---
+
+## Planos de Datos
+
+| Plano | Nombre | Función |
+|-------|--------|---------|
+| T-N → T0 | ITM | Lo ideal, la partitura |
+| Burocrático | MST | Documentos, hitos, estados |
+| Físico | BCK | Acciones, evidencias |
+
+---
+
+## PostgreSQL — Contexto Claude
+
+Ver `admin/data-structures` para schema completo.
+
+| Tabla | Función |
+|-------|---------|
+| `instancias` | Identidad Claude |
+| `memoria` | Memoria largo plazo |
+| `conocimiento` | RAG compartido |
+| `conversaciones` | Sesiones |
+| `mensajes_v2` | Mensajes |
+
+---
+
+## Almacenamiento R2
+
+| Bucket | Uso |
+|--------|-----|
+| architect | Backups |
+| hst | Imágenes |
+| deck | Personal |
+| corp | Empresarial |
+
+---
+
+*Actualizado: 2025-12-21*
--- a/v4-archive/system/04-servicios.md
+++ b/v4-archive/system/04-servicios.md
@@ -0,0 +1,46 @@
+# Servicios TZZR
+
+## Infraestructura
+
+| Servidor | IP | Rol |
+|----------|-----|-----|
+| ARCHITECT | 69.62.126.110 | Coordinador, Gitea, PostgreSQL |
+| DECK | 72.62.1.113 | CLARA, ALFRED, Nextcloud, Mailcow |
+| CORP | 92.112.181.188 | MARGARET, FELDMAN, MASON, JARED |
+| HST | 72.62.2.84 | Directus, API tags |
+
+## Servicios por Servidor
+
+### ARCHITECT (69.62.126.110)
+- Gitea: 3000
+- PostgreSQL: 5432
+
+### DECK (72.62.1.113)
+- CLARA: 5051 (context service)
+- ALFRED: 5052 (task orchestrator)
+- Nextcloud: 8080
+- Mailcow: 25, 443, 993, 995
+
+### CORP (92.112.181.188)
+- MARGARET: 5051 (log entrada)
+- JARED: 5052 (processor)
+- MASON: 5053 (builder)
+- FELDMAN: 5054 (contable v3.0)
+- Directus: 8055
+- Vaultwarden: 8081
+- Shlink: 8082
+
+### HST (72.62.2.84)
+- Directus: 8055 (hst_images DB)
+- Filebrowser: 8081
+- nginx: 80/443
+
+## GPU Services (RunPod)
+
+| Servicio | Endpoint | Workers | GPU |
+|----------|----------|---------|-----|
+| GRACE | r00x4g3rrwkbyh | 2 | L4 |
+| PENNY | 0mxhaokgsmgee3 | 2 | L4 |
+| FACTORY | ddnuk6y35zi56a | 1 | L4 |
+
+Código en: `s3://architect/gpu-services/`
--- a/v4-archive/system/05-credenciales.md
+++ b/v4-archive/system/05-credenciales.md
@@ -0,0 +1,133 @@
+# Estructura de Credenciales
+
+## Gestores de Secretos
+
+| Nivel | Herramienta | Uso |
+|-------|-------------|-----|
+| Personal/Equipo | Proton Pass | Contraseñas externas |
+| Self-hosted | HashiCorp Vault | Contraseñas autoalojadas |
+| Aplicaciones | Infisical | Secretos internos |
+
+## Infisical (key.tzzr.me)
+
+Gestión centralizada de secretos para aplicaciones.
+
+### Proyectos
+
+| Proyecto | Contenido |
+|----------|-----------|
+| anthropic | API keys Claude |
+| r2 | Credenciales Cloudflare R2 |
+| windmill | Tokens Windmill |
+| postgres | Conexiones BD |
+
+### Acceso
+
+```
+URL: https://key.tzzr.me (o http://69.62.126.110:8082)
+```
+
+---
+
+## Credenciales por Servidor
+
+### ARCHITECT (69.62.126.110)
+
+| Servicio | Credenciales |
+|----------|--------------|
+| PostgreSQL | User: nocodb / Pass: nocodb_secure_2024 / DB: nocodb |
+| **Directus** | admin@tzzr.me / directus_admin_2024 |
+| Gitea | token en Infisical |
+| Windmill | token en Infisical |
+| API Anthropic | /opt/tzzr/claude-code/api_key |
+
+### DECK (72.62.1.113)
+
+| Servicio | Ubicación |
+|----------|-----------|
+| SSH | root / [Proton Pass] |
+| Mail-in-a-Box | admin panel |
+
+### HST (72.62.2.84)
+
+| Servicio | Ubicación |
+|----------|-----------|
+| SSH | root / [Proton Pass] |
+| API | internal |
+
+### CORP (92.112.181.188)
+
+| Servicio | Ubicación |
+|----------|-----------|
+| SSH | root / [Proton Pass] |
+
+---
+
+## Directus (ARCHITECT)
+
+```
+URL: http://69.62.126.110:8055
+Email: admin@tzzr.me
+Password: directus_admin_2024
+DB: PostgreSQL (nocodb)
+```
+
+### Tablas disponibles
+
+| Tabla | Uso |
+|-------|-----|
+| instancias | Configuración de instancias Claude |
+| conversaciones | Chats activos |
+| mensajes_v2 | Mensajes de conversaciones |
+| memoria | Memoria persistente |
+| conocimiento | Base de conocimiento |
+| contexto_ambiental | Contexto del sistema |
+
+---
+
+## Cloudflare R2
+
+```
+Account ID: 7dedae6030f5554d99d37e98a5232996
+Endpoint: https://<account_id>.r2.cloudflarestorage.com
+Credenciales: Infisical project "r2"
+```
+
+## RunPod
+
+```
+API Key: Infisical project "runpod"
+```
+
+## Anthropic
+
+```
+API Key: Infisical project "anthropic"
+Archivo local: /opt/tzzr/claude-code/api_key
+```
+
+---
+
+## Instancias Claude
+
+Cada instancia tiene su configuración en PostgreSQL tabla `instancias`:
+
+| Campo | Contenido |
+|-------|-----------|
+| system_prompt | Incluye credenciales SSH del servidor que construye |
+| permisos | JSON con capacidades |
+| modelo | sonnet/opus/haiku |
+
+---
+
+## Política de Rotación
+
+| Tipo | Frecuencia |
+|------|------------|
+| SSH passwords | Manual, bajo demanda |
+| API tokens | 90 días |
+| JWT sessions | 24 horas |
+
+---
+
+*Actualizado: 2025-12-22*
--- a/v4-archive/system/06-flujos.md
+++ b/v4-archive/system/06-flujos.md
@@ -0,0 +1,82 @@
+# Flujos de Trabajo
+
+## Reglas de Ejecución por Instancia
+
+### Principio Fundamental
+
+**Cada instancia Claude solo ejecuta comandos directamente en su propio servidor.**
+
+| Instancia | Servidor | IP | Puede ejecutar en |
+|-----------|----------|-----|-------------------|
+| architect | ARCHITECT | 69.62.126.110 | Solo ARCHITECT |
+| hst | HST | 72.62.2.84 | Solo HST |
+| deck | DECK | 72.62.1.113 | Solo DECK |
+| corp | CORP | 92.112.181.188 | Solo CORP |
+| runpod | RunPod | Variable | Solo sus pods |
+| locker | ARCHITECT | 69.62.126.110 | Solo su contexto |
+
+### Delegación de Tareas
+
+Cuando una instancia necesita que se ejecute algo en otro servidor:
+
+1. **NO ejecutar directamente** via SSH al otro servidor
+2. **Enviar mensaje** a la instancia correspondiente via PostgreSQL
+3. **Documentar** la tarea solicitada
+4. **Esperar** confirmación de la otra instancia
+
+### Ejemplo de Delegación
+
+```sql
+-- architect necesita que deck ejecute algo
+INSERT INTO mensajes_v2 (conversacion_id, role, contenido)
+SELECT id, 'user', 'Ejecuta X en tu servidor'
+FROM conversaciones
+WHERE instancia_id = 'deck' AND activa = true;
+```
+
+### Excepciones
+
+- **Consultas de solo lectura**: Se permiten consultas SSH para verificar estado
+- **Emergencias**: En caso de caída de una instancia, otra puede intervenir temporalmente
+
+---
+
+## Comunicación Entre Instancias
+
+### Canal Principal: PostgreSQL
+
+Tabla `mensajes_v2` con estructura de chat por conversación.
+
+```
+conversaciones (instancia_id) --> mensajes_v2 (conversacion_id)
+```
+
+### Flujo de Mensaje
+
+1. Instancia origen inserta mensaje con role='user'
+2. Windmill detecta mensaje pendiente
+3. Windmill invoca Claude de la instancia destino
+4. Respuesta se guarda con role='assistant'
+
+---
+
+## Windmill
+
+### Triggers
+
+| Trigger | Frecuencia | Función |
+|---------|------------|---------|
+| Mensaje nuevo | 30s | Procesar mensajes pendientes |
+| Retry queue | 5m | Reintentar envíos fallidos |
+| Heartbeat | 1h | Verificar estado de instancias |
+
+### Endpoint
+
+```
+URL: https://flows.tzzr.me
+Workspace: admins
+```
+
+---
+
+*Actualizado: 2025-12-21*
--- a/v4-archive/system/README.md
+++ b/v4-archive/system/README.md
@@ -0,0 +1,37 @@
+# Sistema TZZR
+
+Documentación central del sistema TZZR - Arquitectura de construcción con Claude.
+
+## Índice
+
+| Documento | Contenido |
+|-----------|-----------|
+| [01-filosofia.md](01-filosofia.md) | Visión, principios, modelo de construcción |
+| [02-componentes.md](02-componentes.md) | Catálogo de componentes del sistema |
+| [03-datos.md](03-datos.md) | Estructuras de datos y schemas |
+| [04-servicios.md](04-servicios.md) | Herramientas, servicios e infraestructura |
+| [05-credenciales.md](05-credenciales.md) | Estructura de secretos y accesos |
+
+## Concepto
+
+```
+TZZR = Sistema de construcción de arquitecturas personales/empresariales
+
+Claude Instances → Construyen → Servidores Clonables → Funcionan Independientes
+```
+
+## Repos Relacionados
+
+| Repo | Función |
+|------|---------|
+| tzzr/architect | Coordinación del equipo Claude |
+| tzzr/deck | Servidor personal (clonable) |
+| tzzr/corp | Servidor empresarial (clonable) |
+| tzzr/hst | Tags semánticos maestros |
+| tzzr/locker | Sistema de almacenamiento R2 |
+| admin/architect-app | Código de la API Flask |
+| admin/data-structures | Schema PostgreSQL detallado |
+
+---
+
+*Actualizado: 2025-12-23*