system-plan/ARCHITECTURE.md

TZZR - Estado Real del Ecosistema

Fecha de auditoría: 2025-12-24 Auditor: Orchestrator (Architect Agent)

---

1. INVENTARIO DE REPOS (23 repos)

Estado por Categoría

Estado	Cantidad	Repos
IMPLEMENTADO	5	clara, hst, packet, orchestrator, context
PARCIAL	4	grace, penny, the-factory, deck
SOLO DOCS	14	alfred, architect, contratos-comunes, corp, credentials, feldman, jared, locker, margaret, mason, mind-link, sentinel, system, vision-builder

---

2. ESTADO DETALLADO POR REPO

IMPLEMENTADOS (código funcional)

Repo	Lenguaje	Descripción Real	Desplegado
clara	Python/Flask	API de ingesta para DECK. Recibe contenedores de PACKET, sube a R2, registra en PostgreSQL	NO
hst	Python/Flask	Image server para tags semánticos. Sirve imágenes por subdominios .tzrtech.org	SÍ (72.62.2.84)
packet	Flutter/Dart	App móvil completa. Captura multimedia, etiqueta con HST, envía a backends	NO (código listo)
orchestrator	Python	Framework multi-agente LLM. Soporta Claude, GPT-4, Gemini	Local only
context	SQL/Docs	Sistema de bloques de contexto para agentes. 35 bloques en PostgreSQL	SÍ (architect DB)

PARCIALMENTE IMPLEMENTADOS

Repo	Contenido Real	Falta
grace	Handler RunPod con 6 módulos (ASR, OCR, TTS, Face, Embeddings, Avatar)	Desplegar en RunPod
penny	Estructura RunPod para generación de texto (config, engine, server)	Completar engine, desplegar
the-factory	Handler RunPod para generación iterativa	Implementar Director/Evaluator
deck	Configuración de servidor (docker, scripts, nginx)	Integrar clara, alfred

SOLO DOCUMENTACIÓN (conceptuales)

Repo	Propósito Documentado	Estado Real
alfred	Flujos predefinidos DECK	Solo README con diagrama
jared	Flujos predefinidos CORP	Solo README con diagrama
margaret	Log de entrada CORP	Solo README (clon de clara)
mason	Espacio de enriquecimiento	Solo README
feldman	Consolidación en bloques	Solo README
sentinel	Auditoría del sistema	Solo README
vision-builder	Diseño de visiones	Solo README
locker	Gateway almacenamiento	Solo README + credenciales R2
mind-link	Interfaz de conexión	Carpeta src/ vacía
corp	Servidor empresarial	Solo STATUS.md
architect	Coordinación	Docs + carpetas de setup obsoletas
contratos-comunes	Especificaciones	Docs extensivos, sin código
credentials	Gestión de credenciales	Docs + inventarios
system	Documentación central	Solo markdown

---

3. MAPA DE DEPENDENCIAS

Flujo de Datos Principal

                          ┌─────────────────┐
                          │     PACKET      │
                          │  (App móvil)    │
                          └────────┬────────┘
                                   │
              ┌────────────────────┼────────────────────┐
              ▼                    ▼                    ▼
     ┌─────────────┐      ┌─────────────┐      ┌─────────────┐
     │    CLARA    │      │  MARGARET   │      │ALFRED/JARED │
     │  (DECK log) │      │ (CORP log)  │      │  (flujos)   │
     │ IMPLEMENTADO│      │   SOLO DOC  │      │  SOLO DOC   │
     └──────┬──────┘      └──────┬──────┘      └──────┬──────┘
            │                    │                    │
            └────────────────────┼────────────────────┘
                                 ▼
                        ┌─────────────┐
                        │    MASON    │
                        │   SOLO DOC  │
                        └──────┬──────┘
                               ▼
                        ┌─────────────┐
                        │   FELDMAN   │
                        │   SOLO DOC  │
                        └─────────────┘

Servicios GPU

         ┌─────────────┐
         │    GRACE    │
         │  6 módulos  │  ←── RunPod template listo
         │   PARCIAL   │
         └──────┬──────┘
                │
    ┌───────────┼───────────┐
    ▼           ▼           ▼
┌────────┐ ┌────────┐ ┌──────────┐
│ PENNY  │ │FACTORY │ │  (otros) │
│PARCIAL │ │PARCIAL │ │          │
└────────┘ └────────┘ └──────────┘

Matriz de Dependencias

Componente	Depende de	Es dependido por
PACKET	HST (tags), CLARA/MARGARET (backend)	Ninguno
CLARA	PostgreSQL, R2, HST (tags)	MASON, FELDMAN
MARGARET	PostgreSQL, R2, HST (tags)	MASON, FELDMAN
MASON	CLARA/MARGARET	FELDMAN
FELDMAN	MASON	SENTINEL
HST	PostgreSQL	PACKET, CLARA, MARGARET
GRACE	RunPod GPU	PENNY, FACTORY, cualquier servicio
LOCKER	Cloudflare R2	CLARA, MARGARET, FACTORY

---

4. INFRAESTRUCTURA ACTUAL

Servidores

Servidor	IP	Servicios Activos	Servicios Documentados pero NO activos
ARCHITECT	69.62.126.110	Gitea, Directus, PostgreSQL, Infisical	Windmill (puerto 8100)
DECK	72.62.1.113	Directus, PostgreSQL, Mailcow, FileBrowser	CLARA, ALFRED, Vision Builder
CORP	92.112.181.188	Directus, Nextcloud, Odoo, Vaultwarden	MARGARET, JARED
HST	72.62.2.84	Nginx (imágenes), Directus, PostgreSQL	-

Bases de Datos

Servidor	DB	Tablas Principales
ARCHITECT	architect	context_blocks, agent_context_index, creds_, s_contract_
ARCHITECT	gitea	(gitea interno)
ARCHITECT	infisical	(infisical interno)
DECK	tzzr	(sin tablas de flujo reales)
HST	hst_images	5 tablas de tags (973 registros)

Cloudflare R2

Bucket	Estado	Contenido
architect	Vacío	-
deck	1 objeto	test.txt (5 bytes)
corp	Vacío	-
hst	Vacío	-
locker	Vacío	-

---

5. INCONSISTENCIAS DETECTADAS

Críticas

ID	Descripción	Impacto
I01	CLARA documentada pero no desplegada en DECK	Flujo de ingesta no funciona
I02	MARGARET/JARED/MASON/FELDMAN solo documentados	Pipeline completo no existe
I03	PostgreSQL sin tablas de flujo	clara_log, feldman_bloques no existen
I04	GRACE no desplegado en RunPod	Procesamiento IA no disponible
I05	R2 buckets vacíos	Almacenamiento configurado pero no usado

Moderadas

ID	Descripción	Impacto
I06	Windmill documentado pero no activo	Alternativa a n8n no disponible
I07	HSU API en CORP documentada pero no verificada	Biblioteca de usuario sin confirmar
I08	orchestrator solo funciona localmente	No hay orquestación remota
I09	PACKET código completo pero no compilado/publicado	App móvil no disponible para usuarios
I10	architect repo tiene carpetas obsoletas	app-v2, orchestrator-v3 confusos

Menores

ID	Descripción	Impacto
I11	mind-link tiene src/ vacío	Repo inútil actualmente
I12	NocoDB referenciado pero migrado a Directus	Documentación desactualizada
I13	contratos-comunes muy extenso sin tests	Especificaciones sin validación
I14	Credenciales dispersas entre repos	Difícil gestión centralizada

---

6. SERVICIOS REALES vs DOCUMENTADOS

DECK (72.62.1.113)

Servicio	Documentado	Real
PostgreSQL	SÍ	SÍ
Directus	SÍ	SÍ
Mailcow	SÍ	SÍ
FileBrowser	SÍ	SÍ
CLARA	SÍ	NO
ALFRED	SÍ	NO
Vision Builder	SÍ	NO
Windmill	SÍ	NO

CORP (92.112.181.188)

Servicio	Documentado	Real
Directus	SÍ	SÍ
Nextcloud	SÍ	SÍ
Odoo	SÍ	SÍ
MARGARET	SÍ	NO
JARED	SÍ	NO
HSU API	SÍ	? (no verificado)

HST (72.62.2.84)

Servicio	Documentado	Real
Nginx (imágenes)	SÍ	SÍ
Directus	SÍ	SÍ
PostgreSQL	SÍ	SÍ
API /biblioteca	SÍ	SÍ

---

7. RESUMEN EJECUTIVO

Lo que FUNCIONA

1. HST - Sistema de tags semánticos operativo
2. Gitea - Control de versiones funcional
3. Directus - CMS en todos los servidores
4. PostgreSQL - Bases de datos operativas
5. R2 - Buckets configurados (vacíos)
6. context - Sistema de contexto para agentes

Lo que está LISTO pero NO DESPLEGADO

1. CLARA - Código Python completo
2. PACKET - App Flutter completa
3. GRACE - Handler RunPod con 6 módulos

Lo que es SOLO DOCUMENTACIÓN

1. Todo el pipeline de flujo (ALFRED → MASON → FELDMAN)
2. MARGARET (versión CORP de CLARA)
3. JARED (versión CORP de ALFRED)
4. SENTINEL (auditoría)
5. VISION BUILDER (diseño de visiones)
6. MIND LINK (conexión de ideas)

Porcentaje de Implementación Real

• Infraestructura base: 80% (servidores, DBs, R2)
• Servicios de soporte: 60% (Directus, Gitea, etc.)
• Pipeline de datos: 10% (solo HST funciona end-to-end)
• Procesamiento IA: 0% (GRACE no desplegado)
• Apps de usuario: 0% (PACKET no publicada)

---

Documento generado automáticamente por auditoría del ecosistema TZZR