# TZZR System Documentation

> Documentación técnica del sistema TZZR - Sistema de organización personal y empresarial basado en Hash Semantic Tagging (HST)

---

## Navegación Rápida

| Sección | Descripción |
|---------|-------------|
| [00 - Visión](#00_vision) | Filosofía, principios y glosario |
| [01 - Arquitectura](#01_arquitectura) | Overview, entidades y aplicaciones |
| [02 - Componentes](#02_componentes) | Servicios internos y externos |
| [03 - Modelo de Datos](#03_modelo_datos) | Schemas, flujos y estructuras |
| [04 - Infraestructura](#04_infraestructura) | Servidores, despliegue y backups |
| [05 - Integraciones](#05_integraciones) | APIs, protocolos y GPU services |
| [06 - Seguridad](#06_seguridad) | Cifrado, secretos y modelo de amenazas |
| [99 - Anexos](#99_anexos) | Inventarios, changelog y pendientes |

---

## 00_VISION

Principios fundamentales y terminología del sistema.

| Documento | Descripción |
|-----------|-------------|
| [filosofia.md](00_VISION/filosofia.md) | Paradigmas, acuerdo bilateral usuario-sistema |
| [glosario.md](00_VISION/glosario.md) | Términos, entidades y prefijos de hash |

---

## 01_ARQUITECTURA

Visión general del sistema, entidades y aplicaciones.

| Documento | Descripción |
|-----------|-------------|
| [overview.md](01_ARQUITECTURA/overview.md) | Diagrama general y componentes principales |
| [almacenamiento.md](01_ARQUITECTURA/almacenamiento.md) | R2, buckets, protocolo `locker://` |

### Entidades

| Entidad | Archivo | Descripción |
|---------|---------|-------------|
| DECK | [deck.md](01_ARQUITECTURA/entidades/deck.md) | Servidor personal del usuario |
| CORP | [corp.md](01_ARQUITECTURA/entidades/corp.md) | Servidor empresarial |
| HST | [hst.md](01_ARQUITECTURA/entidades/hst.md) | Hash Semantic Tagging |
| ITM | [itm.md](01_ARQUITECTURA/entidades/itm.md) | Items (plano ideal T0) |
| PLY | [ply.md](01_ARQUITECTURA/entidades/ply.md) | Players (identidad) |
| LOC | [loc.md](01_ARQUITECTURA/entidades/loc.md) | Locations (ubicaciones) |
| FLG | [flg.md](01_ARQUITECTURA/entidades/flg.md) | Flags (marcos jurídicos) |

### Aplicaciones

| App | Archivo | Descripción |
|-----|---------|-------------|
| Packet | [packet.md](01_ARQUITECTURA/aplicaciones/packet.md) | App móvil de captura multimedia |
| Vision Builder | [vision-builder.md](01_ARQUITECTURA/aplicaciones/vision-builder.md) | Visiones → Milestones → Acciones |
| Mind-Link | [mind-link.md](01_ARQUITECTURA/aplicaciones/mind-link.md) | Interfaz unificada de acceso |

---

## 02_COMPONENTES

Servicios y agentes del sistema organizados por tipo.

### Componentes Internos

| Componente | Archivo | Descripción |
|------------|---------|-------------|
| Context System | [context-system.md](02_COMPONENTES/internos/context-system.md) | Log inmutable, gestor, dataset, grafo |
| Secretaría | [secretaria.md](02_COMPONENTES/internos/secretaria.md) | Clara (personal), Margaret (corporativo) |
| Administración | [administracion.md](02_COMPONENTES/internos/administracion.md) | Mason (edición temporal) |
| Contable | [contable.md](02_COMPONENTES/internos/contable.md) | Feldman (consolidación, inmutabilidad) |
| Producción | [produccion.md](02_COMPONENTES/internos/produccion.md) | Alfred (personal), Jared (corporativo) |
| Auditoría | [auditoria.md](02_COMPONENTES/internos/auditoria.md) | Sentinel (LIGHT/DEEP) |
| Utilidades | [utilidades.md](02_COMPONENTES/internos/utilidades.md) | Funciones auxiliares |

### Servicios Externos

| Servicio | Archivo | Descripción |
|----------|---------|-------------|
| Asistente | [asistente.md](02_COMPONENTES/servicios%20externos/asistente.md) | Penny (voz conversacional) |
| Gestoría | [gestoria.md](02_COMPONENTES/servicios%20externos/gestoria.md) | Gestión administrativa externa |
| Gen. Iterativa | [generacion-iterativa.md](02_COMPONENTES/servicios%20externos/generacion-iterativa.md) | The Factory |
| Orchestrator | [orchestratorv6.md](02_COMPONENTES/servicios%20externos/orchestratorv6.md) | Orquestación multi-agente LLM |
| Circle | [circle.md](02_COMPONENTES/servicios%20externos/circle.md) | Consejo de perspectivas |
| Cloudville | [cloudville.md](02_COMPONENTES/servicios%20externos/cloudville.md) | Laboratorio experimental |

---

## 03_MODELO_DATOS

Estructuras de datos, schemas SQL y flujos de información.

| Documento | Descripción |
|-----------|-------------|
| [entidades.md](03_MODELO_DATOS/entidades.md) | HST, ITM, PLY, LOC, FLG |
| [planos.md](03_MODELO_DATOS/planos.md) | T0 (ideal), MST (milestones), BCK (bloques) |
| [hashes.md](03_MODELO_DATOS/hashes.md) | h_maestro, h_entrada, h_instancia, h_bloque |
| [flujos.md](03_MODELO_DATOS/flujos.md) | Estándar, producción, incidencia |
| [contenedor-schema.md](03_MODELO_DATOS/contenedor-schema.md) | Schema del contenedor principal |
| [context-tables.md](03_MODELO_DATOS/context-tables.md) | Tablas del sistema de contexto |

### Schemas SQL

| Schema | Archivo | Descripción |
|--------|---------|-------------|
| Types | [00_types.sql](03_MODELO_DATOS/schemas/00_types.sql) | Tipos y enums |
| HST Tags | [01_hst_tags.sql](03_MODELO_DATOS/schemas/01_hst_tags.sql) | Sistema de etiquetado semántico |
| Task Manager | [02_task_manager.sql](03_MODELO_DATOS/schemas/02_task_manager.sql) | Gestión de tareas |
| Work Log | [03_work_log.sql](03_MODELO_DATOS/schemas/03_work_log.sql) | Registro de trabajo |
| AI Context | [04_ai_context.sql](03_MODELO_DATOS/schemas/04_ai_context.sql) | Contexto para IA |
| AI Requests | [05_ai_requests.sql](03_MODELO_DATOS/schemas/05_ai_requests.sql) | Solicitudes a IA |
| Clara | [06_clara.sql](03_MODELO_DATOS/schemas/06_clara.sql) | Schema de Clara |
| Feldman | [07_feldman.sql](03_MODELO_DATOS/schemas/07_feldman.sql) | Schema de Feldman |
| Alfred | [08_alfred.sql](03_MODELO_DATOS/schemas/08_alfred.sql) | Schema de Alfred |

---

## 04_INFRAESTRUCTURA

Configuración de servidores, despliegue y recuperación.

| Documento | Descripción |
|-----------|-------------|
| [architect.md](04_INFRAESTRUCTURA/architect.md) | Servidor central (Gitea, PostgreSQL, Infisical) |
| [despliegue.md](04_INFRAESTRUCTURA/despliegue.md) | docker-compose, fases, checklists |
| [backup-recovery.md](04_INFRAESTRUCTURA/backup-recovery.md) | Estrategia DR, scripts de backup |
| [status.md](04_INFRAESTRUCTURA/status.md) | Estado actual de servicios |

---

## 05_INTEGRACIONES

APIs, protocolos de comunicación y servicios GPU.

| Documento | Descripción |
|-----------|-------------|
| [factory-protocol.md](05_INTEGRACIONES/factory-protocol.md) | Protocolo de The Factory |
| [hst-api.md](05_INTEGRACIONES/hst-api.md) | API de tags semánticos |
| [gpu-services.md](05_INTEGRACIONES/gpu-services.md) | RunPod: Grace, Penny, Factory |
| [notario.md](05_INTEGRACIONES/notario.md) | Servicio de notarización |

---

## 06_SEGURIDAD

Cifrado, gestión de secretos y modelo de amenazas.

| Documento | Descripción |
|-----------|-------------|
| [inmutabilidad.md](06_SEGURIDAD/inmutabilidad.md) | Principios, cadena de hashes |
| [secretos.md](06_SEGURIDAD/secretos.md) | Infisical, gestión de credenciales |
| [cifrado.md](06_SEGURIDAD/cifrado.md) | Envelope encryption, KEK |
| [rotacion.md](06_SEGURIDAD/rotacion.md) | Rotación de claves |
| [modelo-amenazas.md](06_SEGURIDAD/modelo-amenazas.md) | Riesgos y mitigaciones |
| [respuesta-incidentes.md](06_SEGURIDAD/respuesta-incidentes.md) | Procedimientos de respuesta |

---

## 99_ANEXOS

Inventarios, changelog y elementos pendientes.

| Documento | Descripción |
|-----------|-------------|
| [inventario-repos.md](99_ANEXOS/inventario-repos.md) | Lista de repositorios |
| [inventario-credenciales.md](99_ANEXOS/inventario-credenciales.md) | Credenciales por categoría |
| [pendientes.md](99_ANEXOS/pendientes.md) | Elementos por definir |
| [changelog.md](99_ANEXOS/changelog.md) | Historial de cambios |

---

## Recursos Adicionales

- [Estructura del Esquema](estructura%20skynet.md) - Árbol de directorios
- [Glosario SHE Enterprise](glosario_she_enterprise_v2.md) - Términos extendidos

---

## Servidores del Sistema

| Servidor | IP | Rol |
|----------|----|----|
| Architect | 69.62.126.110 | Central (Gitea, PostgreSQL) |
| Deck | 72.62.1.113 | Servidor personal |
| Corp | 92.112.181.188 | Servidor empresarial |
| HST | 72.62.2.84 | Hash Semantic Tagging |

---

*Última actualización: 2025-12-29*