tzzr/system-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Añadir estructura navegable con READMEs por sección

Browse Source 
- README.md principal con índice completo y tablas navegables
- README por cada sección (00-06 y 99_ANEXOS)
- Enlaces relativos para navegación interna
- Diagramas ASCII para arquitectura y flujos
- Tablas de referencia rápida

Basado en estructura skynet v7

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
ARCHITECT
2025-12-29 19:08:07 +00:00
parent 6ea70bd34f
commit 3006ff9a76
9 changed files with 642 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
00_VISION/README.md Normal file
View File

@@ -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)

61
01_ARQUITECTURA/README.md Normal file
View File

@@ -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)

58
02_COMPONENTES/README.md Normal file
View File

@@ -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)

56
03_MODELO_DATOS/README.md Normal file
View File

@@ -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)

59
04_INFRAESTRUCTURA/README.md Normal file
View File

@@ -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)

68
05_INTEGRACIONES/README.md Normal file
View File

@@ -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)

67
06_SEGURIDAD/README.md Normal file
View File

@@ -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)

50
99_ANEXOS/README.md Normal file
View File

@@ -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)

194
README.md Normal file
View File

@@ -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*