docs: Añadir estructura navegable con READMEs por sección
- 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:
29
00_VISION/README.md
Normal file
29
00_VISION/README.md
Normal 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
61
01_ARQUITECTURA/README.md
Normal 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
58
02_COMPONENTES/README.md
Normal 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
56
03_MODELO_DATOS/README.md
Normal 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
59
04_INFRAESTRUCTURA/README.md
Normal 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
68
05_INTEGRACIONES/README.md
Normal 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
67
06_SEGURIDAD/README.md
Normal 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
50
99_ANEXOS/README.md
Normal 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
194
README.md
Normal 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*
|
||||
Reference in New Issue
Block a user