diff --git a/00_VISION/README.md b/00_VISION/README.md new file mode 100644 index 0000000..1330c22 --- /dev/null +++ b/00_VISION/README.md @@ -0,0 +1,29 @@ +# 00 - Visión + +> Principios fundamentales, paradigmas y terminología del sistema TZZR + +## Contenido + +| Documento | Descripción | +|-----------|-------------| +| [filosofia.md](filosofia.md) | Paradigmas del sistema, acuerdo bilateral usuario-sistema, principios de diseño | +| [glosario.md](glosario.md) | Términos técnicos, entidades del sistema, prefijos de hash | + +## Principios Clave + +1. **Soberanía de datos**: El usuario es dueño absoluto de su información +2. **Inmutabilidad**: Los registros históricos no se modifican +3. **Trazabilidad**: Cada cambio tiene origen y destino rastreable +4. **Interoperabilidad**: Los sistemas personal y empresarial se comunican + +## Entidades Principales + +- **HST**: Hash Semantic Tagging - Sistema de etiquetado semántico +- **ITM**: Items - Elementos del plano ideal +- **PLY**: Players - Identidades +- **LOC**: Locations - Ubicaciones +- **FLG**: Flags - Marcos jurídicos + +--- + +[← Volver al índice](../README.md) diff --git a/01_ARQUITECTURA/README.md b/01_ARQUITECTURA/README.md new file mode 100644 index 0000000..21ab40b --- /dev/null +++ b/01_ARQUITECTURA/README.md @@ -0,0 +1,61 @@ +# 01 - Arquitectura + +> Visión general del sistema, entidades y aplicaciones + +## Contenido Principal + +| Documento | Descripción | +|-----------|-------------| +| [overview.md](overview.md) | Diagrama general y componentes principales del sistema | +| [almacenamiento.md](almacenamiento.md) | Cloudflare R2, buckets, protocolo `locker://` | + +## Entidades + +Define las estructuras fundamentales del sistema. + +| Entidad | Archivo | Descripción | +|---------|---------|-------------| +| DECK | [deck.md](entidades/deck.md) | Servidor personal - instancia individual del usuario | +| CORP | [corp.md](entidades/corp.md) | Servidor empresarial - instancia organizacional | +| HST | [hst.md](entidades/hst.md) | Hash Semantic Tagging - sistema de categorización | +| ITM | [itm.md](entidades/itm.md) | Items - elementos del plano ideal T0 | +| PLY | [ply.md](entidades/ply.md) | Players - identidades y roles | +| LOC | [loc.md](entidades/loc.md) | Locations - ubicaciones físicas y virtuales | +| FLG | [flg.md](entidades/flg.md) | Flags - marcos jurídicos y regulatorios | + +## Aplicaciones + +Interfaces de usuario para interactuar con el sistema. + +| App | Archivo | Descripción | +|-----|---------|-------------| +| Packet | [packet.md](aplicaciones/packet.md) | App móvil para captura multimedia y entrada rápida | +| Vision Builder | [vision-builder.md](aplicaciones/vision-builder.md) | Herramienta para Visiones → Milestones → Acciones | +| Mind-Link | [mind-link.md](aplicaciones/mind-link.md) | Interfaz unificada de acceso al sistema | + +## Diagrama de Alto Nivel + +``` +┌─────────────────────────────────────────────────────────────┐ +│ APLICACIONES │ +│ ┌─────────┐ ┌───────────────┐ ┌─────────────┐ │ +│ │ Packet │ │ Vision Builder │ │ Mind-Link │ │ +│ └────┬────┘ └───────┬───────┘ └──────┬──────┘ │ +│ └─────────────────┼───────────────────┘ │ +│ ▼ │ +│ ┌──────────────────────────────────────────────────────┐ │ +│ │ DECK / CORP │ │ +│ │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │ │ +│ │ │ HST │ │ ITM │ │ PLY │ │ LOC │ │ FLG │ │ ... │ │ │ +│ │ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ │ │ +│ └──────────────────────────────────────────────────────┘ │ +│ ▼ │ +│ ┌──────────────────────────────────────────────────────┐ │ +│ │ ALMACENAMIENTO R2 │ │ +│ └──────────────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────────┘ +``` + +--- + +[← Volver al índice](../README.md) diff --git a/02_COMPONENTES/README.md b/02_COMPONENTES/README.md new file mode 100644 index 0000000..adc2fbe --- /dev/null +++ b/02_COMPONENTES/README.md @@ -0,0 +1,58 @@ +# 02 - Componentes + +> Servicios y agentes del sistema TZZR + +## Estructura + +Los componentes se dividen en dos categorías: + +- **Internos**: Servicios core que operan dentro del sistema +- **Servicios Externos**: Integraciones y servicios que operan fuera del núcleo + +## Componentes Internos + +Servicios fundamentales que gestionan el flujo de datos. + +| Componente | Archivo | Agente | Rol | +|------------|---------|--------|-----| +| Context System | [context-system.md](internos/context-system.md) | - | Log inmutable, gestor de contexto, dataset, grafo | +| Secretaría | [secretaria.md](internos/secretaria.md) | Clara / Margaret | Gestión de comunicaciones y agenda | +| Administración | [administracion.md](internos/administracion.md) | Mason | Edición temporal de registros | +| Contable | [contable.md](internos/contable.md) | Feldman | Consolidación financiera, inmutabilidad | +| Producción | [produccion.md](internos/produccion.md) | Alfred / Jared | Ejecución de tareas y workflows | +| Auditoría | [auditoria.md](internos/auditoria.md) | Sentinel | Verificación LIGHT y DEEP | +| Utilidades | [utilidades.md](internos/utilidades.md) | - | Funciones auxiliares del sistema | + +### Agentes por Contexto + +| Contexto | Secretaría | Producción | +|----------|------------|------------| +| Personal | Clara | Alfred | +| Corporativo | Margaret | Jared | + +## Servicios Externos + +Servicios que extienden las capacidades del sistema. + +| Servicio | Archivo | Descripción | +|----------|---------|-------------| +| Asistente | [asistente.md](servicios%20externos/asistente.md) | Penny - interfaz de voz conversacional | +| Gestoría | [gestoria.md](servicios%20externos/gestoria.md) | Gestión administrativa y fiscal externa | +| Gen. Iterativa | [generacion-iterativa.md](servicios%20externos/generacion-iterativa.md) | The Factory - generación de contenido | +| Orchestrator | [orchestratorv6.md](servicios%20externos/orchestratorv6.md) | Orquestación multi-agente LLM | +| Circle | [circle.md](servicios%20externos/circle.md) | Consejo de perspectivas múltiples | +| Cloudville | [cloudville.md](servicios%20externos/cloudville.md) | Laboratorio experimental | + +## Flujo de Datos + +``` +Usuario → [Secretaría] → [Context System] → [Producción] + ↓ + [Contable] + ↓ + [Auditoría] +``` + +--- + +[← Volver al índice](../README.md) diff --git a/03_MODELO_DATOS/README.md b/03_MODELO_DATOS/README.md new file mode 100644 index 0000000..aff5be2 --- /dev/null +++ b/03_MODELO_DATOS/README.md @@ -0,0 +1,56 @@ +# 03 - Modelo de Datos + +> Estructuras de datos, schemas SQL y flujos de información + +## Documentación Conceptual + +| Documento | Descripción | +|-----------|-------------| +| [entidades.md](entidades.md) | Definición de HST, ITM, PLY, LOC, FLG | +| [planos.md](planos.md) | T0 (ideal), MST (milestones), BCK (bloques) | +| [hashes.md](hashes.md) | h_maestro, h_entrada, h_instancia, h_bloque | +| [flujos.md](flujos.md) | Flujos estándar, producción e incidencia | +| [contenedor-schema.md](contenedor-schema.md) | Schema del contenedor principal | +| [context-tables.md](context-tables.md) | Tablas del sistema de contexto | + +## Schemas SQL + +Definiciones de base de datos en PostgreSQL. + +| Schema | Archivo | Propósito | +|--------|---------|-----------| +| Types | [00_types.sql](schemas/00_types.sql) | Tipos ENUM y estructuras base | +| HST Tags | [01_hst_tags.sql](schemas/01_hst_tags.sql) | Sistema de etiquetado semántico | +| Task Manager | [02_task_manager.sql](schemas/02_task_manager.sql) | Gestión de tareas y workflows | +| Work Log | [03_work_log.sql](schemas/03_work_log.sql) | Registro inmutable de trabajo | +| AI Context | [04_ai_context.sql](schemas/04_ai_context.sql) | Contexto para modelos de IA | +| AI Requests | [05_ai_requests.sql](schemas/05_ai_requests.sql) | Solicitudes y respuestas de IA | +| Clara | [06_clara.sql](schemas/06_clara.sql) | Schema del agente Clara | +| Feldman | [07_feldman.sql](schemas/07_feldman.sql) | Schema del agente Feldman | +| Alfred | [08_alfred.sql](schemas/08_alfred.sql) | Schema del agente Alfred | + +Ver [schemas/README.md](schemas/README.md) para detalles de implementación. + +## Jerarquía de Hashes + +``` +h_maestro (identidad única del elemento) + │ + ├── h_entrada (cada modificación) + │ │ + │ └── h_instancia (versión específica) + │ + └── h_bloque (consolidación periódica) +``` + +## Planos Temporales + +| Plano | Código | Descripción | +|-------|--------|-------------| +| Ideal | T0 | Estado objetivo, visión final | +| Milestone | MST | Puntos de control intermedios | +| Bloque | BCK | Consolidaciones inmutables | + +--- + +[← Volver al índice](../README.md) diff --git a/04_INFRAESTRUCTURA/README.md b/04_INFRAESTRUCTURA/README.md new file mode 100644 index 0000000..ed07591 --- /dev/null +++ b/04_INFRAESTRUCTURA/README.md @@ -0,0 +1,59 @@ +# 04 - Infraestructura + +> Servidores, despliegue, backup y recuperación + +## Contenido + +| Documento | Descripción | +|-----------|-------------| +| [architect.md](architect.md) | Servidor central - Gitea, PostgreSQL, Infisical | +| [despliegue.md](despliegue.md) | Guías docker-compose, fases, checklists | +| [backup-recovery.md](backup-recovery.md) | Estrategia DR, scripts de backup | +| [status.md](status.md) | Estado actual de servicios | + +## Servidores + +| Nombre | IP | SSH | Rol | +|--------|----|----|-----| +| **Architect** | 69.62.126.110 | - | Central (Gitea, PostgreSQL, coordinación) | +| **Deck** | 72.62.1.113 | `root@72.62.1.113` | Servidor personal | +| **Corp** | 92.112.181.188 | `root@92.112.181.188` | Servidor empresarial | +| **HST** | 72.62.2.84 | `root@72.62.2.84` | Hash Semantic Tagging | + +## Servicios por Servidor + +### Architect (Central) +- Gitea (gestión de código) +- PostgreSQL (base de datos) +- Infisical (gestión de secretos) +- Coordinación de agentes + +### Deck / Corp +- Agentes locales (Clara/Margaret, Alfred/Jared) +- Base de datos local +- Sincronización con central + +## Almacenamiento R2 + +**Endpoint**: `https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com` + +| Bucket | Uso | +|--------|-----| +| `documentos adjuntos/` | Documentos compartidos | +| `system/` | Configs y backups internos | +| `gpu-services/` | GRACE/PENNY/FACTORY | +| `backups/` | Backups Gitea y sistema | +| `auditorias/` | Logs de auditoría | + +## Stack Tecnológico + +- **Contenedores**: Docker + docker-compose +- **Base de datos**: PostgreSQL 16 +- **Código**: Gitea +- **Secretos**: Infisical +- **Storage**: Cloudflare R2 +- **GPU**: RunPod (para servicios IA) + +--- + +[← Volver al índice](../README.md) diff --git a/05_INTEGRACIONES/README.md b/05_INTEGRACIONES/README.md new file mode 100644 index 0000000..e349709 --- /dev/null +++ b/05_INTEGRACIONES/README.md @@ -0,0 +1,68 @@ +# 05 - Integraciones + +> APIs, protocolos de comunicación y servicios GPU + +## Contenido + +| Documento | Descripción | +|-----------|-------------| +| [factory-protocol.md](factory-protocol.md) | Protocolo de comunicación con The Factory | +| [hst-api.md](hst-api.md) | API REST de Hash Semantic Tagging | +| [gpu-services.md](gpu-services.md) | Servicios en RunPod: Grace, Penny, Factory | +| [notario.md](notario.md) | Servicio de notarización y certificación | + +## APIs Principales + +### HST API +Gestión de tags semánticos y categorización. + +``` +GET /api/v1/tags +POST /api/v1/tags +GET /api/v1/tags/{hash} +PUT /api/v1/tags/{hash} +``` + +### Factory Protocol +Comunicación con servicios de generación. + +``` +POST /factory/generate +GET /factory/status/{job_id} +POST /factory/iterate +``` + +## Servicios GPU (RunPod) + +| Servicio | Función | Modelo Base | +|----------|---------|-------------| +| **Grace** | 18 módulos de IA especializados | Varios | +| **Penny** | Asistente de voz conversacional | Whisper + TTS | +| **Factory** | Generación iterativa de contenido | Diversos | + +## Protocolos de Comunicación + +### S-Contract v2.1 +Protocolo estándar de comunicación entre componentes: + +```json +{ + "version": "2.1", + "source": "component_id", + "target": "component_id", + "action": "action_type", + "payload": {}, + "timestamp": "ISO8601", + "signature": "hash" +} +``` + +## Autenticación + +- **Interna**: Tokens JWT firmados por Architect +- **Externa**: API Keys gestionadas en Infisical +- **GPU**: Tokens específicos de RunPod + +--- + +[← Volver al índice](../README.md) diff --git a/06_SEGURIDAD/README.md b/06_SEGURIDAD/README.md new file mode 100644 index 0000000..306f1db --- /dev/null +++ b/06_SEGURIDAD/README.md @@ -0,0 +1,67 @@ +# 06 - Seguridad + +> Cifrado, gestión de secretos, modelo de amenazas y respuesta a incidentes + +## Contenido + +| Documento | Descripción | +|-----------|-------------| +| [inmutabilidad.md](inmutabilidad.md) | Principios de inmutabilidad, cadena de hashes | +| [secretos.md](secretos.md) | Gestión con Infisical, categorías de credenciales | +| [cifrado.md](cifrado.md) | Envelope encryption, KEK, algoritmos | +| [rotacion.md](rotacion.md) | Políticas de rotación de claves | +| [modelo-amenazas.md](modelo-amenazas.md) | Análisis de riesgos y mitigaciones | +| [respuesta-incidentes.md](respuesta-incidentes.md) | Procedimientos ante incidentes | + +## Principios de Seguridad + +1. **Inmutabilidad**: Los registros consolidados no se modifican +2. **Cifrado en reposo**: Datos sensibles cifrados con AES-256-GCM +3. **Cifrado en tránsito**: TLS 1.3 para todas las comunicaciones +4. **Mínimo privilegio**: Acceso solo a lo necesario +5. **Trazabilidad**: Toda acción queda registrada + +## Arquitectura de Cifrado + +``` +┌─────────────────────────────────────────┐ +│ Master Key (HSM) │ +└─────────────────┬───────────────────────┘ + │ + ┌─────────▼─────────┐ + │ KEK (Key Enc.) │ + └─────────┬─────────┘ + │ + ┌─────────────┼─────────────┐ + ▼ ▼ ▼ +┌───────┐ ┌───────┐ ┌───────┐ +│ DEK 1 │ │ DEK 2 │ │ DEK N │ +└───────┘ └───────┘ └───────┘ + │ │ │ + ▼ ▼ ▼ + Data Data Data +``` + +## Gestión de Secretos + +**Herramienta**: Infisical + +| Categoría | Ejemplos | Rotación | +|-----------|----------|----------| +| API Keys | OpenAI, Anthropic, RunPod | 90 días | +| DB Credentials | PostgreSQL users | 30 días | +| Storage | R2 access keys | 180 días | +| SSH Keys | Acceso a servidores | 365 días | + +## Modelo de Amenazas + +| Amenaza | Probabilidad | Impacto | Mitigación | +|---------|--------------|---------|------------| +| Acceso no autorizado | Media | Alto | MFA, logs, alertas | +| Pérdida de datos | Baja | Crítico | Backups 3-2-1 | +| Compromiso de keys | Baja | Alto | Rotación, Infisical | +| Denegación de servicio | Media | Medio | Rate limiting, CDN | + +--- + +[← Volver al índice](../README.md) diff --git a/99_ANEXOS/README.md b/99_ANEXOS/README.md new file mode 100644 index 0000000..fe83a06 --- /dev/null +++ b/99_ANEXOS/README.md @@ -0,0 +1,50 @@ +# 99 - Anexos + +> Inventarios, changelog y elementos pendientes + +## Contenido + +| Documento | Descripción | +|-----------|-------------| +| [inventario-repos.md](inventario-repos.md) | Lista completa de repositorios en Gitea | +| [inventario-credenciales.md](inventario-credenciales.md) | Credenciales organizadas por categoría | +| [pendientes.md](pendientes.md) | Elementos y decisiones por definir | +| [changelog.md](changelog.md) | Historial de cambios del sistema | + +## Repositorios Principales + +| Repositorio | Descripción | +|-------------|-------------| +| `tzzr/system-docs` | Esta documentación | +| `tzzr/orchestrator` | Orquestador multi-agente | +| `tzzr/sentinel` | Sistema de auditoría | +| `tzzr/feldman` | Consolidación contable | +| `tzzr/packet` | App móvil | + +## Categorías de Credenciales + +- **APIs IA**: OpenAI, Anthropic, RunPod +- **Bases de datos**: PostgreSQL, Redis +- **Storage**: Cloudflare R2 +- **Servicios**: Gitea, Infisical +- **SSH**: Acceso a servidores + +## Convenciones + +### Versionado de Documentación +- **Mayor**: Cambios arquitecturales significativos +- **Menor**: Nuevos componentes o secciones +- **Parche**: Correcciones y actualizaciones menores + +### Formato de Changelog +```markdown +## [X.Y.Z] - YYYY-MM-DD +### Added +### Changed +### Fixed +### Removed +``` + +--- + +[← Volver al índice](../README.md) diff --git a/README.md b/README.md new file mode 100644 index 0000000..a67c34b --- /dev/null +++ b/README.md @@ -0,0 +1,194 @@ +# 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*