Update to Skynet v7 - Complete documentation restructure

- Nueva estructura de carpetas según Skynet v7 - Añadidos schemas SQL completos - Documentación de entidades, componentes e integraciones - Modelo de seguridad actualizado - Infraestructura y operaciones reorganizadas
2025-12-29 18:23:41 +00:00
parent ac481fe266
commit 6ea70bd34f
76 changed files with 13029 additions and 4340 deletions
--- a/99_ANEXOS/changelog.md
+++ b/99_ANEXOS/changelog.md
@@ -0,0 +1,184 @@
+# Changelog
+
+---
+
+## 2024-12-28 (v2)
+
+### FASE 1 - Contenido Técnico Puro
+
+- Añadidos 6 schemas SQL reales a `03_MODELO_DATOS/schemas/`
+- Añadidos 3 M-CONTRACTs JSON a `05_INTEGRACIONES/m-contracts/`
+- Creado `04_INFRAESTRUCTURA/status.md` con IPs, puertos, h_instancia
+- Creado `03_MODELO_DATOS/contenedor-schema.md` con estructura JSON
+- Expandido `01_ARQUITECTURA/aplicaciones/mind-link.md` con spec UI v11
+
+### FASE 2 - Flujos y Protocolos (auditado)
+
+- Corregido `03_MODELO_DATOS/flujos.md`:
+  - Producción OK salta Mason
+  - Feldman = Cola + Bloques (dos tablas)
+  - Ventanas 24h configurables
+- Expandido `05_INTEGRACIONES/s-contract.md`:
+  - Perfiles FULL/LITE
+  - Modos despliegue (EXTERNAL, SELF_HOSTED, SEMI)
+  - Request/Response completos
+  - Jerarquía S/M-CONTRACT
+- Expandido `02_COMPONENTES/auditoria.md`:
+  - Arquitectura SENTINEL-LIGHT/DEEP
+  - Reglas de integridad (I-*)
+  - Reglas de conformidad (C-*)
+  - Reglas de rendimiento (P-*)
+  - Schema SQL
+
+### FASE 3 - Protocolos Adicionales
+
+- Creado `05_INTEGRACIONES/factory-protocol.md`:
+  - Ciclo Director → Executor → Evaluator → Auditor
+  - Convergencia y configuración
+- Creado `05_INTEGRACIONES/notario.md`:
+  - Sellado blockchain con Merkle trees
+  - Schema SQL notario_batches
+  - Verificación de integridad
+- Expandido `02_COMPONENTES/cognitiva.md`:
+  - Catálogo completo de 18 módulos Grace
+  - 5 familias: Visión, Voz, Identidad, Semántica, Utilidades
+  - Cadenas de fallback
+
+### FASE 4 - Contenido v4 (credenciales y políticas)
+
+- Expandido `99_ANEXOS/inventario-credenciales.md`:
+  - 10 categorías: APIs IA, BD, almacenamiento, infra, blockchain, comunicaciones, DNS, GPU, servidores, cifrado
+  - Modelos Anthropic y configuración instancias
+  - Tablas PostgreSQL principales
+  - IPs y dominios de todos los servidores
+- Creado `06_SEGURIDAD/rotacion.md`:
+  - Matriz por tipo de credencial
+  - Procedimiento de rotación
+  - Alertas y calendario
+- Creado `06_SEGURIDAD/respuesta-incidentes.md`:
+  - Tiempos de respuesta por severidad
+  - Acciones por tipo de incidente
+  - Checklist post-incidente
+- Expandido `06_SEGURIDAD/cifrado.md`:
+  - Envelope encryption completo
+  - Jerarquía MK → KEK → DEK
+  - Algoritmos y rotación
+- Expandido `01_ARQUITECTURA/entidades/deck.md`:
+  - Arquitectura deployment router
+  - Modos EXTERNAL, SELF_HOSTED, SEMI
+  - Conectores GRACE, PENNY, FACTORY
+  - Servicios Docker y credenciales
+
+### FASE 5 - Contenido v3 (contexto y voz)
+
+- Creado `03_MODELO_DATOS/context-tables.md`:
+  - Tablas instancias, memoria, conocimiento, conversaciones, mensajes_v2
+  - Tabla contexto_ambiental
+  - Flujo de contexto para Claude
+  - Diagrama de relaciones
+- Expandido `02_COMPONENTES/asistente.md` (PENNY):
+  - Arquitectura completa VAD → ASR → Core → TTS
+  - Planos de información (0-5)
+  - Flujo voz-a-voz con latencias
+  - Configuración YAML
+  - Modelos autoalojados
+
+### Corrección - Schemas faltantes de v5
+
+- Añadido `06_clara.sql`: Log inmutable de secretaría
+- Añadido `07_feldman.sql`: Libros contables (milestones, bloques, cola, validaciones)
+- Añadido `08_alfred.sql`: Flujos de producción
+
+### Estadísticas Finales
+
+| Métrica | v1 | v2 |
+|---------|----|----|
+| Documentos .md | 45 | 53 |
+| Archivos SQL | 0 | 9 |
+| Archivos JSON | 0 | 3 |
+| Total | 45 | 65 |
+
+---
+
+## 2024-12-28 (v1)
+
+### Documentación
+
+- Creación de estructura documental completa
+- 40+ documentos organizados en 7 secciones
+- Esquema basado en análisis de backups v3, v4, v5
+
+### Estructura
+
+```
+00_VISION (2 docs)
+01_ARQUITECTURA (9 docs)
+02_COMPONENTES (12 docs)
+03_MODELO_DATOS (5 docs)
+04_INFRAESTRUCTURA (3 docs)
+05_INTEGRACIONES (3 docs)
+06_SEGURIDAD (4 docs)
+99_ANEXOS (4 docs)
+```
+
+---
+
+## 2024-12-24
+
+### Sistema
+
+- Migración NocoDB → Directus en todos los servidores
+- Nuevos dominios: tzzrarchitect.me, tzzrdeck.me, tzzrcorp.me
+
+### Descubrimientos
+
+- RunPod: pods corriendo 24/7 innecesariamente ($75 gasto)
+- Pods detenidos: grace, penny, factory
+- Serverless endpoints ya existían
+
+---
+
+## 2024-12-22/23
+
+### Sesión Multi-instancia
+
+- ARCHITECT como hub central
+- Coordinación con DECK, CORP, HST, LOCKER
+- Documentación DNS en zone files
+- Actualización de repositorios Gitea
+
+### Servicios Documentados
+
+- CORP: 11 servicios
+- DECK: 9 servicios
+- HST: API v3.2
+
+---
+
+## Versiones de Documentos
+
+| Documento | Versión | Fecha |
+|-----------|---------|-------|
+| Sistema Registro Inmutable | 1.2 | 2024-12-27 |
+| Context System | 0.1 | 2024-12-27 |
+| S-CONTRACT | 2.1 | 2024-12-24 |
+| Manual Arquitectura SHE | 5.0 | 2024-12-22 |
+
+---
+
+## Convenciones
+
+### Versionado
+
+- **Major (X.0)**: Cambios incompatibles
+- **Minor (X.Y)**: Nueva funcionalidad compatible
+- **Patch (X.Y.Z)**: Correcciones
+
+### Estados
+
+| Estado | Significado |
+|--------|-------------|
+| Planificado | Definido pero no iniciado |
+| En desarrollo | Trabajo en curso |
+| Implementado | Funcional en producción |
+| Obsoleto | Reemplazado o descontinuado |
--- a/99_ANEXOS/inventario-credenciales.md
+++ b/99_ANEXOS/inventario-credenciales.md
@@ -0,0 +1,240 @@
+# Inventario de Credenciales
+
+**Actualizado:** 2024-12-22
+
+---
+
+## 1. APIs de Inteligencia Artificial
+
+| Servicio | Variable | Tipo | Rotación | Proyecto Infisical |
+|----------|----------|------|----------|-------------------|
+| OpenRouter | `OPENROUTER_API_KEY` | API_KEY | 90 días | anthropic |
+| Groq | `GROQ_API_KEY` | API_KEY | 90 días | anthropic |
+| OpenAI | `OPENAI_API_KEY` | API_KEY | 90 días | anthropic |
+| Anthropic | `ANTHROPIC_API_KEY` | API_KEY | 90 días | anthropic |
+
+### Uso por Servicio
+
+| Servicio | Función |
+|----------|---------|
+| OpenRouter | LLM Principal |
+| Groq | Backup LLM |
+| OpenAI | Embeddings |
+| Anthropic | Agentes Claude |
+
+### Modelos Anthropic
+
+| Modelo | ID | Uso |
+|--------|-----|-----|
+| Opus 4.5 | claude-opus-4-5-20251101 | Tareas complejas |
+| Sonnet 4.5 | claude-sonnet-4-5-20251101 | Balance calidad/coste |
+| Haiku 3.5 | claude-3-5-haiku-20241022 | Tareas rápidas |
+
+### Configuración Instancias Claude
+
+| Instancia | Modelo |
+|-----------|--------|
+| architect | sonnet |
+| hst | sonnet |
+| deck | sonnet |
+| corp | sonnet |
+| runpod | sonnet |
+| locker | haiku |
+
+---
+
+## 2. Bases de Datos
+
+| Servicio | Variable | Tipo | Rotación | Servidor |
+|----------|----------|------|----------|----------|
+| PostgreSQL | `POSTGRES_PASS` | DB_CREDENTIAL | 30 días | ARCHITECT |
+| Directus | `DIRECTUS_ADMIN_PASS` | SERVICE_TOKEN | 30 días | ARCHITECT |
+| Redis | `REDIS_PASSWORD` | DB_CREDENTIAL | 30 días | ARCHITECT |
+| Gitea | `GITEA_DB_PASSWD` | DB_CREDENTIAL | 30 días | ARCHITECT |
+
+### PostgreSQL (ARCHITECT)
+
+```
+Host: localhost / 172.17.0.1 (Docker)
+Port: 5432
+User: architect
+Database: architect
+```
+
+### Tablas Principales
+
+| Tabla | Uso |
+|-------|-----|
+| instancias | Configuración instancias Claude |
+| conversaciones | Chats activos |
+| mensajes_v2 | Mensajes de conversaciones |
+| memoria | Memoria persistente |
+| conocimiento | Base de conocimiento |
+| contexto_ambiental | Contexto del sistema |
+
+### Directus (ARCHITECT)
+
+```
+URL: http://69.62.126.110:8055
+Email: admin@tzzr.me
+```
+
+### Redis (ARCHITECT)
+
+```
+Host: localhost
+Port: 6379
+```
+
+---
+
+## 3. Almacenamiento
+
+| Servicio | Variable | Tipo | Rotación |
+|----------|----------|------|----------|
+| Cloudflare R2 | `R2_ACCESS_KEY_ID` | API_KEY | 90 días |
+| Cloudflare R2 | `R2_SECRET_ACCESS_KEY` | API_KEY | 90 días |
+| Hostinger S3 | `HOSTINGER_ACCESS_KEY` | API_KEY | 90 días |
+
+### Buckets R2
+
+| Bucket | Uso |
+|--------|-----|
+| tzzr-backups | Backups automáticos |
+| tzzr-assets | Assets estáticos |
+| tzzr-uploads | Uploads usuarios |
+
+---
+
+## 4. Infraestructura
+
+| Servicio | Variable | Tipo | Rotación |
+|----------|----------|------|----------|
+| Hostinger | `HOSTINGER_API_TOKEN` | API_KEY | 90 días |
+| Cloudflare | `CF_API_TOKEN` | API_KEY | 90 días |
+| Traefik | `TRAEFIK_DASHBOARD_PASS` | SERVICE_TOKEN | 30 días |
+
+---
+
+## 5. Blockchain
+
+| Servicio | Variable | Tipo | Rotación |
+|----------|----------|------|----------|
+| Ethereum | `ETH_PRIVATE_KEY` | SIGNING_KEY | 180 días |
+| Infura | `INFURA_API_KEY` | API_KEY | 90 días |
+
+---
+
+## 6. Comunicaciones
+
+| Servicio | Variable | Tipo | Rotación |
+|----------|----------|------|----------|
+| Slack | `SLACK_WEBHOOK_URL` | SERVICE_TOKEN | 7 días |
+| ntfy | `NTFY_TOKEN` | SERVICE_TOKEN | 7 días |
+| Email SMTP | `SMTP_PASSWORD` | SERVICE_TOKEN | 30 días |
+
+---
+
+## 7. DNS y CDN
+
+| Servicio | Variable | Tipo | Rotación |
+|----------|----------|------|----------|
+| Cloudflare DNS | `CF_DNS_TOKEN` | API_KEY | 90 días |
+| Let's Encrypt | `LETSENCRYPT_EMAIL` | CERTIFICATE | 90 días |
+
+---
+
+## 8. GPU / RunPod
+
+| Servicio | Variable | Tipo | Rotación |
+|----------|----------|------|----------|
+| RunPod | `RUNPOD_API_KEY` | API_KEY | 90 días |
+| RunPod Endpoint | `RUNPOD_ENDPOINT_ID` | CONFIG | N/A |
+
+### Endpoints Activos
+
+| Módulo | Endpoint |
+|--------|----------|
+| ASR_ENGINE | https://api.runpod.ai/v2/{asr_id} |
+| OCR_CORE | https://api.runpod.ai/v2/{ocr_id} |
+| EMBEDDINGS | https://api.runpod.ai/v2/{emb_id} |
+
+---
+
+## 9. Acceso a Servidores
+
+| Servidor | IP | Dominio | Tipo | Función |
+|----------|-----|---------|------|---------|
+| ARCHITECT | 69.62.126.110 | tzzr.me | SSH_CREDENTIAL | Central |
+| HST | 72.62.2.84 | tzrtech.org | SSH_CREDENTIAL | Tags HST |
+| DECK | 72.62.1.113 | tzzrdeck.me | SSH_CREDENTIAL | Personal |
+| CORP | 92.112.181.188 | tzzrcorp.me | SSH_CREDENTIAL | Empresas |
+
+### ARCHITECT (69.62.126.110)
+
+```
+Dominio: tzzr.me
+Proveedor: Hostinger KVM2
+SSH Port: 22
+User: root
+```
+
+#### Servicios Docker
+
+| Servicio | Puerto |
+|----------|--------|
+| Directus | 8055 |
+| Gitea | 3000 |
+| Windmill | 8100 |
+| Infisical | 8082 |
+
+### HST (72.62.2.84)
+
+```
+Dominio: tzrtech.org
+Función: Tags HST
+```
+
+### DECK (72.62.1.113)
+
+```
+Dominio: tzzrdeck.me
+Función: Personal
+```
+
+### CORP (92.112.181.188)
+
+```
+Dominio: tzzrcorp.me
+Función: Empresas
+```
+
+---
+
+## 10. Cifrado
+
+| Tipo | Variable | Rotación |
+|------|----------|----------|
+| Master Key | `MASTER_KEY` | 365 días |
+| KEK-DATA | `KEK_DATA` | 365 días |
+| KEK-SECRETS | `KEK_SECRETS` | 365 días |
+| KEK-SIGNING | `KEK_SIGNING` | 180 días |
+| JWT Secret | `JWT_SECRET` | 180 días |
+
+---
+
+## Regla de Ejecución
+
+> Cada instancia Claude solo ejecuta en su propio servidor.
+> Para otros servidores, delega vía PostgreSQL.
+
+---
+
+## Ubicación de Credenciales
+
+| Tipo | Ubicación |
+|------|-----------|
+| API Keys | Infisical |
+| Contraseñas | Proton Pass |
+| SSH Keys | /root/.ssh/ |
+| Certificados | Traefik (auto-renovación) |
--- a/99_ANEXOS/inventario-repos.md
+++ b/99_ANEXOS/inventario-repos.md
@@ -1,387 +1,83 @@
-# Inventario de Repositorios TZZR
+# Inventario de Repositorios

-**Versión:** 5.0
-**Fecha:** 2024-12-24
-**Fuente:** Gitea (http://localhost:3000/tzzr)
+**Actualizado:** 2024-12-28

 ---

-## Resumen
+## Repositorios tzzr/

-| Categoría | Cantidad |
-|-----------|----------|
-| Infraestructura | 6 |
-| Data Services | 6 |
-| Security/Ops | 6 |
-| Interfaces | 6 |
-| **Total** | **24** |
+| Repo | Descripción | Estado |
+|------|-------------|--------|
+| **system-docs** | Documentación central | Activo |
+| **architect** | Servidor coordinador | Activo |
+| **deck** | Servidor personal | Activo |
+| **corp** | Servidor empresarial | Activo |
+| **hst** | Tags semánticos | Activo |
+| **packet** | App móvil | En desarrollo |
+| **grace** | Capa cognitiva IA | Activo |
+| **penny** | Asistente de voz | Activo |
+| **the-factory** | Generación iterativa | Activo |
+| **orchestrator** | Multi-agente | Activo |
+| **clara** | Secretaría personal | Activo |
+| **margaret** | Secretaría corporativa | Activo |
+| **mason** | Administración | Activo |
+| **feldman** | Contable | Activo |
+| **alfred** | Producción personal | Activo |
+| **jared** | Producción corporativa | Planificado |
+| **sentinel** | Auditoría | Planificado |
+| **locker** | Almacenamiento R2 | Activo |
+| **vision-builder** | App de visiones | En desarrollo |
+| **mind-link** | Interfaz unificada | Planificado |
+| **contratos-comunes** | S-CONTRACT, schemas | Activo |

 ---

-## Infraestructura
+## Repositorios admin/

-### orchestrator
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/orchestrator |
-| Estado | Activo |
-| Descripción | Sistema de orquestación central |
-| Prioridad | Alta |
-
-**Archivos clave:**
- `main.py` - Entrada principal
- `.env` - Configuración
- `docker-compose.yml` - Despliegue
+| Repo | Descripción | Estado |
+|------|-------------|--------|
+| **architect-app** | Código API Flask | Activo |
+| **data-structures** | Schema PostgreSQL | Activo |
+| **credentials** | Estructura de secretos | Privado |

 ---

-### hst-api
+## Por Categoría

-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/hst-api |
-| Estado | Activo |
-| Descripción | API de tags HST (973 tags) |
-| Prioridad | Alta |
+### Core

-**Archivos clave:**
- `api/routes.py` - Endpoints
- `db/schema.sql` - Schema
+- system-docs
+- architect
+- contratos-comunes

---
+### Servidores

-### clara
+- deck
+- corp
+- hst

-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/clara |
-| Estado | Activo |
-| Descripción | Agente de ingesta personal |
-| Prioridad | Alta |
+### Componentes

-**Archivos clave:**
- `app.py` - API FastAPI
- `ingest.py` - Lógica de ingesta
- `Dockerfile` - Container
+- clara, margaret (secretaría)
+- mason (administración)
+- feldman (contable)
+- alfred, jared (producción)
+- sentinel (auditoría)

---
+### Servicios IA

-### margaret
+- grace
+- penny
+- the-factory
+- orchestrator

-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/margaret |
-| Estado | Activo |
-| Descripción | Agente de ingesta corporativo |
-| Prioridad | Alta |
+### Aplicaciones

-**Archivos clave:**
- `app.py` - API FastAPI
- `ingest.py` - Lógica de ingesta
- `Dockerfile` - Container
+- packet
+- vision-builder
+- mind-link

---
+### Infraestructura

-### alfred
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/alfred |
-| Estado | Activo |
-| Descripción | Flujos predefinidos DECK |
-| Prioridad | Media |
-
-**Archivos clave:**
- `flows/` - Definiciones de flujos
- `executor.py` - Motor de ejecución
-
---
-
-### jared
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/jared |
-| Estado | Activo |
-| Descripción | Flujos predefinidos CORP |
-| Prioridad | Media |
-
-**Archivos clave:**
- `flows/` - Definiciones de flujos
- `executor.py` - Motor de ejecución
-
---
-
-## Data Services
-
-### mason
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/mason |
-| Estado | Activo |
-| Descripción | Enriquecimiento de datos |
-| Prioridad | Alta |
-
-**Archivos clave:**
- `workspace.py` - Gestión workspace
- `enrichment.py` - Lógica de enriquecimiento
-
---
-
-### feldman
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/feldman |
-| Estado | Activo |
-| Descripción | Consolidación blockchain |
-| Prioridad | Alta |
-
-**Archivos clave:**
- `validator.py` - Reglas M-001, M-002, M-003
- `consolidator.py` - Creación de bloques
-
---
-
-### grace-handler
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/grace-handler |
-| Estado | Bloqueado (RunPod) |
-| Descripción | Handler GPU para GRACE |
-| Prioridad | Alta |
-
-**Archivos clave:**
- `handler.py` - RunPod handler
- `modules/` - 6 módulos IA
-
---
-
-### penny-handler
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/penny-handler |
-| Estado | Planificado |
-| Descripción | Handler GPU para PENNY |
-| Prioridad | Baja |
-
---
-
-### factory-handler
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/factory-handler |
-| Estado | Planificado |
-| Descripción | Handler GPU para FACTORY |
-| Prioridad | Baja |
-
---
-
-### s-contract
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/s-contract |
-| Estado | En desarrollo |
-| Descripción | Contextos y datasets IA |
-| Prioridad | Media |
-
---
-
-## Security/Ops
-
-### sentinel
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/sentinel |
-| Estado | Planificado |
-| Descripción | Auditoría del sistema |
-| Prioridad | Media |
-
-**Modos:**
- LIGHT: Cada 5 min, reglas automáticas
- DEEP: Cada 1 hora, muestreo con LLM
-
---
-
-### infisical-config
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/infisical-config |
-| Estado | Activo |
-| Descripción | Configuración Infisical |
-| Prioridad | Alta |
-
---
-
-### backup-scripts
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/backup-scripts |
-| Estado | En desarrollo |
-| Descripción | Scripts de backup R2 |
-| Prioridad | Alta |
-
---
-
-### deploy-configs
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/deploy-configs |
-| Estado | Activo |
-| Descripción | Configuraciones de despliegue |
-| Prioridad | Media |
-
---
-
-### monitoring
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/monitoring |
-| Estado | Planificado |
-| Descripción | Dashboards y alertas |
-| Prioridad | Media |
-
---
-
-### security-audit
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/security-audit |
-| Estado | En desarrollo |
-| Descripción | Scripts de auditoría |
-| Prioridad | Alta |
-
---
-
-## Interfaces
-
-### packet-app
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/packet-app |
-| Estado | En desarrollo |
-| Descripción | App móvil Flutter |
-| Prioridad | Alta |
-
-**Tecnología:** Flutter/Dart
-
---
-
-### vision-builder
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/vision-builder |
-| Estado | En desarrollo |
-| Descripción | Diseñador de visiones |
-| Prioridad | Media |
-
---
-
-### admin-dashboard
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/admin-dashboard |
-| Estado | Planificado |
-| Descripción | Dashboard administrativo |
-| Prioridad | Baja |
-
---
-
-### api-gateway
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/api-gateway |
-| Estado | Planificado |
-| Descripción | Gateway API unificado |
-| Prioridad | Media |
-
---
-
-### docs-site
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/docs-site |
-| Estado | En desarrollo |
-| Descripción | Sitio de documentación |
-| Prioridad | Media |
-
---
-
-### system-docs
-
-| Campo | Valor |
-|-------|-------|
-| URL | http://localhost:3000/tzzr/system-docs |
-| Estado | Activo (este repo) |
-| Descripción | Documentación System v5 |
-| Prioridad | Alta |
-
---
-
-## Estadísticas
-
-### Por Estado
-
-| Estado | Cantidad |
-|--------|----------|
-| Activo | 12 |
-| En desarrollo | 6 |
-| Planificado | 5 |
-| Bloqueado | 1 |
-
-### Por Prioridad
-
-| Prioridad | Cantidad |
-|-----------|----------|
-| Alta | 12 |
-| Media | 8 |
-| Baja | 4 |
-
---
-
-## Dependencias Entre Repos
-
-```
-packet-app
-    │
-    ▼
-clara / margaret
-    │
-    ▼
-alfred / jared
-    │
-    ▼
-mason ◄──── grace-handler (bloqueado)
-    │
-    ▼
-feldman
-    │
-    ▼
-sentinel (planificado)
-```
-
---
-
-## Notas
-
-1. **grace-handler**: Código listo en R2, RunPod no inicia workers
-2. **sentinel**: Solo documentación, sin implementación
-3. **system-docs**: Este repositorio, documentación v5
-4. **orchestrator**: Coordinador central en ARCHITECT
+- locker
+- credentials
--- a/99_ANEXOS/pendientes.md
+++ b/99_ANEXOS/pendientes.md
@@ -0,0 +1,68 @@
+# Elementos Pendientes
+
+**Actualizado:** 2024-12-28
+
+---
+
+## Por Definir
+
+| Elemento | Prioridad | Dependencias |
+|----------|-----------|--------------|
+| Estructura tabla ITM (Items) | Alta | - |
+| Estructura tabla PLY (Players) | Alta | - |
+| Estructura tabla LOC (Locations) | Media | - |
+| Estructura tabla FLG (Flags) | Media | HST |
+| Mecanismo "encaja/no encaja" | Alta | Producción |
+| Formato flujos en Producción | Alta | - |
+| Lista módulos Grace completa | Media | - |
+| Contratos E/S de Grace | Media | S-CONTRACT |
+| Scheduler período flotante Mason | Alta | - |
+| Merkle tree para verificación | Media | Feldman |
+| Smart contract blockchain | Baja | Merkle tree |
+
+---
+
+## Por Implementar
+
+| Componente | Estado | Bloqueador |
+|------------|--------|------------|
+| Sentinel LIGHT | Planificado | - |
+| Sentinel DEEP | Planificado | LIGHT |
+| ITM (plano ideal) | Schema definido | - |
+| PLY (identidad) | Schema definido | - |
+| LOC (ubicaciones) | Schema definido | - |
+| Mind Link | Planificado | API REST |
+| Packet offline | En desarrollo | - |
+
+---
+
+## Por Documentar
+
+| Documento | Ubicación | Estado |
+|-----------|-----------|--------|
+| API Feldman | 05_INTEGRACIONES | Pendiente |
+| API Mason | 05_INTEGRACIONES | Pendiente |
+| API Clara/Margaret | 05_INTEGRACIONES | Pendiente |
+| Guía despliegue DECK | 04_INFRAESTRUCTURA | Parcial |
+| Guía despliegue CORP | 04_INFRAESTRUCTURA | Parcial |
+
+---
+
+## Decisiones Pendientes
+
+| ID | Decisión | Opciones | Estado |
+|----|----------|----------|--------|
+| D-008 | Motor de búsqueda contexto | PostgreSQL FTS vs Elasticsearch | Abierta |
+| D-009 | Formato flujos Producción | JSON vs YAML vs DSL | Abierta |
+| D-010 | Grafo de contexto | Kuzu vs Neo4j embedded | Kuzu elegido |
+
+---
+
+## Deuda Técnica
+
+| Item | Impacto | Esfuerzo |
+|------|---------|----------|
+| Migrar NocoDB → Directus | Completado | - |
+| Unificar schemas entre servidores | Medio | Alto |
+| Tests automatizados | Alto | Alto |
+| CI/CD pipeline | Medio | Medio |