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

glosario_she_enterprise_v2.md

@@ -0,0 +1,400 @@
+# Glosario Consolidado — Sistema SHE Enterprise v5.0
+
+**Versión:** 1.0  
+**Fecha:** Diciembre 2025  
+**Fuentes:** Documentación técnica SHE, Sistema de Registro Inmutable v1.2, Análisis de Paradigmas
+
+---
+
+## 1. ARQUITECTURA CENTRAL
+
+### 1.1 Sistema Principal
+
+| Término | Definición |
+|---------|------------|
+| **SHE** | **S**emantic **H**ashtag **E**ngine. Motor narrativo-relacional que gestiona el flujo de estados y transiciones entre entidades. Es la caja fuerte de custodia (Milestones + Bloques). |
+| **HST** | **H**ash **S**emantic **T**agging. Sistema de etiquetado semántico mediante etiquetas de 3 caracteres que proporciona clasificación visual e inmutable. |
+
+### 1.2 Componentes del Sistema de Registro Inmutable
+
+| Término | Versión Personal | Versión Corporativa | Definición |
+|---------|------------------|---------------------|------------|
+| **Producción** | Alfred | Jared | Almacena árboles de procesos y flujos predefinidos. Implementado con Windmill/n8n. |
+| **Secretaría** | Clara | Margaret | Punto de entrada inmutable. Todo dato ingresa exactamente como llegó. Registro permanente. |
+| **Administración** | Mason | Mason | Tabla de trabajo temporal para enriquecer y consolidar información antes de registro definitivo. |
+| **Libros contables** | Feldman | Feldman | Registro final definitivo e inmutable. Contiene cola de validación + registro final. |
+| **Gestoría** | Grace | Grace | Capa cognitiva con 18 módulos de IA para transformación de datos. Intercambiable. |
+
+---
+
+## 2. LA TRÍADA DE PLANOS
+
+| Plano | Tabla Principal | Naturaleza | Descripción |
+|-------|-----------------|------------|-------------|
+| **Cannon** | Ítems | Definición perfecta | Especificaciones, planos, recetas. No consume energía. |
+| **Burocrático** | Milestones | Estado legal/contable | Documentos, contratos, estados en vigor. Consume energía jurídica. |
+| **Físico** | Bloques | Evidencia material | Fotos, registros, pruebas físicas. Consume energía real. |
+
+> **Regla de Oro**: Una burocracia sin evidencia física es ficción. Un ítem sin milestone es solo una idea. Un bloque sin contexto es ruido.
+
+---
+
+## 3. ENTIDADES PRINCIPALES
+
+### 3.1 Milestones (Plano Burocrático)
+
+| Término | Definición |
+|---------|------------|
+| **Milestone** | Registro en el plano burocrático que representa estados legales, contables o hitos documentales. |
+| **tipo_item** | Clasificación del milestone: `documento`, `estado`, `hito`, `evento`, `version`. |
+| **roothash** | Cadena de IDs ancestrales que permite reconstruir la jerarquía completa. Formato: `/id_raiz/id_padre/.../id_actual` |
+
+#### Estados de Milestone
+
+| Estado | Descripción |
+|--------|-------------|
+| `draft` | Borrador inicial |
+| `active` | En ejecución |
+| `on_hold` | Pausado |
+| `completed` | Finalizado |
+| `cancelled` | Cancelado (terminal) |
+| `archived` | Archivado (terminal) |
+
+### 3.2 Bloques (Plano Físico)
+
+| Término | Definición |
+|---------|------------|
+| **Bloque** | Unidad de evidencia física vinculada a un Milestone. Fotografía energética del intervalo T0 → T+1. |
+| **tipo_accion** | Clasificación del bloque: `punto`, `secuencia`, `esfuerzo_maximo`. |
+| **evidencia_url** | URL obligatoria de la evidencia física (foto, archivo, registro). |
+| **evidencia_hash** | SHA-256 del archivo de evidencia para verificación de integridad. |
+
+#### Tipos de Acción en Bloques
+
+| Tipo | Descripción | Energía |
+|------|-------------|---------|
+| **Generadora** | Crea nuevo valor (diseño, producción) | Alta |
+| **Preservadora** | Mantiene estado (almacenamiento, backup) | Media |
+| **Transformadora** | Modifica existente (ensamblaje, edición) | Alta |
+| **Verificadora** | Confirma calidad (inspección, testing) | Baja |
+
+### 3.3 Ítems (Plano Cannon)
+
+| Término | Definición |
+|---------|------------|
+| **Ítem** | Definición ideal de producto, proceso o servicio. Especificación perfecta que no consume energía. |
+| **tipo** | Clasificación: `producto`, `servicio`, `proceso`, `componente`, `protocolo`. |
+| **specs_estandar** | JSONB con especificaciones técnicas estructuradas. |
+
+---
+
+## 4. ENTIDADES AUXILIARES
+
+| Término | Definición |
+|---------|------------|
+| **Player** | Actor del sistema: `persona`, `empresa`, `departamento`, `sistema_ia`, `sensor_iot`. Entidad que puede actuar. |
+| **Bandera** | Marco jurídico/jurisdicción que gobierna operaciones. Define IVA, moneda, idioma, timezone. |
+| **Localización** | Ubicación física o lógica: `pais`, `region`, `ciudad`, `direccion`, `edificio`, `planta`, `sala`, `almacen`, `virtual`. |
+
+---
+
+## 5. SISTEMA HST — ETIQUETADO SEMÁNTICO
+
+### 5.1 Conceptos Clave
+
+| Término | Definición |
+|---------|------------|
+| **H_maestro** | SHA-256 de la imagen primigenia. 64 caracteres hexadecimales. Clave primaria inmutable. |
+| **Imagen primigenia** | Conjunto mínimo de atributos que definen inequívocamente una entidad. Inmutable. |
+| **ref** | Etiqueta semántica de 3 caracteres que clasifica registros (ej: `inv`, `pjt`, `ord`). |
+| **Skin** | Capa de presentación que modifica visualización sin alterar datos subyacentes. |
+| **hash_visible** | H_left(30) + estilo(4) + H_right(30). Identifica skin específico. |
+
+### 5.2 Grupos de Etiquetas
+
+| Grupo | Propiedad | Memorizable | Descripción |
+|-------|-----------|-------------|-------------|
+| **hst** | Sistema | ✅ Sí | Vocabulario semántico universal, inmutable |
+| **spe** | Sistema | ❌ No | Especificaciones técnicas |
+| **hsu** | Usuario | ✅ Sí | Etiquetas personales del usuario |
+| **msu** | Usuario | ❌ No | Metodologías personales |
+
+### 5.3 Catálogo de Etiquetas (ref)
+
+| ref | Nombre | Grupo | Descripción |
+|-----|--------|-------|-------------|
+| **inc** | Incidencia | Origen | Punto de entrada inicial |
+| **pjt** | Proyecto | Origen | Contenedor principal de trabajo |
+| **prp** | Propuesta | Origen | Oferta comercial |
+| **ord** | Pedido | Transacción | Orden de compra/venta |
+| **inv** | Factura recibida | Transacción | Documento fiscal de proveedor |
+| **siv** | Factura emitida | Transacción | Documento fiscal propio |
+| **pay** | Pago | Transacción | Transacción monetaria |
+| **exl** | Gasto | Transacción | Salida de dinero |
+| **whs** | Almacén | Logístico | Ubicación de stock |
+| **inn** | Entrada | Logístico | Recepción de material |
+| **out** | Salida | Logístico | Expedición de material |
+| **pct** | Producción | Productivo | Proceso productivo |
+| **sod** | Albarán | Logístico | Documento de entrega |
+| **doc** | Documento | Documental | Archivo genérico |
+| **ctr** | Contrato | Documental | Acuerdo legal |
+| **lic** | Licencia | Documental | Permiso/autorización |
+
+---
+
+## 6. ORQUESTACIÓN Y FLUJOS
+
+### 6.1 Alfred (Producción)
+
+| Término | Definición |
+|---------|------------|
+| **Alfred** | Orquestador determinista (n8n/Windmill). NO es IA. Ejecuta Métodos de forma determinista. |
+| **Jared** | Versión corporativa de Alfred para gestionar múltiples usuarios. |
+
+### 6.2 Métodos
+
+| Término | Definición |
+|---------|------------|
+| **Método** | Receta JSON pública que define procedimiento operativo. Secuencia de pasos atómicos. |
+| **h_metodo** | SHA-256 del JSON del Método. Identificador único e inmutable. |
+| **step_id** | Identificador del paso dentro del Método. |
+
+### 6.3 Tipos de Paso en Métodos
+
+| Tipo | Descripción | Ejemplo |
+|------|-------------|---------|
+| **module** | Invoca módulo Grace | `grace.parser` |
+| **action** | Operación CRUD | `create_relation` |
+| **condition** | Bifurcación lógica | `if amount > 1000` |
+| **wait** | Espera evento externo | `approval_received` |
+| **notify** | Envía notificación | `email`, `webhook` |
+
+---
+
+## 7. GRACE (GESTORÍA) — MÓDULOS IA
+
+### 7.1 Conceptos
+
+| Término | Definición |
+|---------|------------|
+| **Grace (gestoría)** | Capa cognitiva. Colección de 18 microservicios de IA especializados. Transforma datos, no decide flujos. |
+| **Contrato Común v1.2** | Interfaz universal para comunicación entre módulos Grace. Define estructura de Request/Response. |
+
+### 7.2 Catálogo de Módulos (18)
+
+| # | Módulo | Función |
+|---|--------|---------|
+| 1 | **PARSER** | Extracción de datos de documentos |
+| 2 | **CLASSIFIER** | Categorización, asigna etiquetas ref |
+| 3 | **VALIDATOR** | Verificación de datos contra reglas |
+| 4 | **SUGGESTER** | Recomendaciones rankeadas |
+| 5 | **NARRATOR** | Generación de texto natural |
+| 6 | **AUDITOR** | Detección de anomalías |
+| 7 | **MATCHER** | Conciliación de conjuntos |
+| 8 | **SUMMARIZER** | Resumen de documentos |
+| 9 | **TRANSLATOR** | Traducción de texto |
+| 10 | **EXTRACTOR** | OCR avanzado |
+| 11 | **PREDICTOR** | Pronóstico de series temporales |
+| 12 | **CLUSTERER** | Agrupación de datos |
+| 13 | **LINKER** | Detección de relaciones |
+| 14 | **SCORER** | Puntuación según criterios |
+| 15 | **ROUTER** | Enrutamiento de mensajes |
+| 16 | **RESPONDER** | Respuesta automática |
+| 17 | **MONITOR** | Vigilancia de métricas |
+| 18 | **LEARNER** | Mejora continua de modelos |
+
+---
+
+## 8. FLUJOS OPERATIVOS
+
+### 8.1 Flujos del Sistema de Registro Inmutable
+
+| Flujo | Condición | Ruta |
+|-------|-----------|------|
+| **Estándar** | Entrada manual, requiere enriquecimiento | Clara → Mason → Feldman |
+| **Producción** | Proceso predefinido completo | Alfred → Clara → Feldman |
+| **Incidencia** | Improvisación durante flujo | Clara → Mason → Feldman |
+
+### 8.2 Flujos HST Estándar
+
+| Flujo | Secuencia | Descripción |
+|-------|-----------|-------------|
+| **Compra completa** | `inc → pjt → prp → ord → exl → sod → inv → pay` | Ciclo completo de compra |
+| **Compra directa** | `inc → exl → sod → inv` | Gastos menores sin proyecto |
+| **Producción** | `inc → whs → inn → pct → out` | Transformación interna |
+
+---
+
+## 9. PARADIGMA TEMPORAL
+
+### 9.1 Línea Temporal
+
+```
+T-N ────→ T-1 ────→ T0 ────→ T+1 ────→ T+N
+ │         │        │        │         │
+Origen   Pre-      Inicio   Cierre   Futuro/
+Difuso   consoli-  Real     Eviden-  Histórico
+         dación            cia
+```
+
+| Punto | Significado | Características |
+|-------|-------------|-----------------|
+| **T−N** | Origen difuso | Exploración, ideas no consolidadas |
+| **T−1** | Referencia previa | Punto desde el cual planificar |
+| **T0** | Inicio ejecución | Arranque formal, recursos comprometidos |
+| **T+1** | Hito burocrático | Registro formal de cierre operativo |
+| **T+N** | Resultado consolidado | Materialización real en el mundo |
+
+### 9.2 Naturaleza Temporal de Entidades
+
+| Entidad | Intervalo | Naturaleza |
+|---------|-----------|------------|
+| **Ítem** | T-N → T-1 → T0 | Definición ideal, proceso, producto conceptual |
+| **Milestone** | T0 → T+1 | Estado contable/legal en vigor |
+| **Bloque** | T+1 | Evidencia física de la ejecución |
+
+---
+
+## 10. SEGURIDAD Y TRAZABILIDAD
+
+### 10.1 Sistemas de Protección
+
+| Término | Definición |
+|---------|------------|
+| **SENTINEL** | Sistema dual de auditoría y protección (LIGHT + DEEP). Nivel perimetral + interno. |
+| **NOTARIO** | Sistema de sellado blockchain con Merkle Tree para inmutabilidad temporal. |
+| **Key Vault** | Gestor centralizado de secretos y claves de cifrado. |
+
+### 10.2 Cifrado
+
+| Término | Definición |
+|---------|------------|
+| **DEK** | Data Encryption Key. Llave efímera que cifra datos directamente. |
+| **KEK** | Key Encryption Key. Llave maestra que cifra otras llaves. |
+| **PII** | Personally Identifiable Information. Datos personales que requieren cifrado estricto. |
+
+### 10.3 Perfiles de Cifrado
+
+| Perfil | Uso | Rotación |
+|--------|-----|----------|
+| **ALTO** | Datos sensibles (PII, financieros) | 30 días |
+| **MEDIO** | Datos operativos | 90 días |
+| **BAJO** | Datos públicos | N/A |
+| **TRANSIT** | Datos en tránsito (TLS 1.3) | Por sesión |
+
+---
+
+## 11. ALMACENAMIENTO
+
+### 11.1 Modelo de Temperaturas
+
+| Temperatura | Ubicación | Latencia | Uso |
+|-------------|-----------|----------|-----|
+| **Hot** | Local + Redis | <100ms | Trabajo activo |
+| **Warm** | Storj DCS | <5s | Histórico < 1 año |
+| **Cold** | Arweave | <60s | Archivo permanente, inmutable |
+
+### 11.2 Términos de Almacenamiento
+
+| Término | Definición |
+|---------|------------|
+| **Storj DCS** | Almacenamiento distribuido con erasure coding 80/29. Cifrado client-side. |
+| **Arweave** | Blockchain de almacenamiento permanente. Pago único, inmutable. |
+| **WORM** | Write Once Read Many. Política de almacenamiento inmutable. |
+
+---
+
+## 12. PARADIGMAS DE PROPIEDAD
+
+| Paradigma | Propietario | Alcance | Mutabilidad | Prefijo |
+|-----------|-------------|---------|-------------|---------|
+| **Sistema** | Plataforma SHE | Universal | Ninguna | `sys_` |
+| **Organización** | Empresa | Multi-usuario interno | Controlada | `org_` |
+| **Usuario** | Individual | Personal | Total | `usr_` |
+
+---
+
+## 13. LOGGING Y AUDITORÍA
+
+| Término | Definición |
+|---------|------------|
+| **trace_id** | UUID v4 que identifica una ejecución completa de Método. |
+| **idempotency_key** | Clave SHA-256 para detección de duplicados en 24h. |
+| **audit_status** | Estado de auditoría: `PENDING`, `PASS`, `WARN`, `FAIL`. |
+
+---
+
+## 14. MÓDULOS COMPLEMENTARIOS
+
+| Módulo | Función |
+|--------|---------|
+| **Vision Builder** | Herramienta de diseño visual de vida. Conecta objetivos con acciones. |
+| **Cloudville** | Simulador de estructuras organizativas con agentes IA. |
+| **Sistema de Voz** | Flujo autoalojado: VAD (Silero) → STT (Whisper) → NLU (LLM) → TTS (Coqui). |
+| **Bloques de Información** | Sistema de 6 elementos para trabajo con IAs: Contexto, Instrucción, Ejemplo, Restricción, Datos, Formato. |
+
+---
+
+## 15. PRINCIPIOS FUNDACIONALES
+
+| Principio | Descripción |
+|-----------|-------------|
+| **Paradigma de Resultados** | El sistema registra resultados, no incidencias ni justificaciones. |
+| **Ocultación Legítima** | Si hay resultado válido, las incidencias del proceso no se documentan. |
+| **Acuerdo Bilateral** | Empresa ofrece herramientas; trabajador ofrece resultados evidenciados. |
+| **Trazabilidad como Movilidad** | La trazabilidad es portfolio verificable, no arma de control. |
+| **Flujo Energético** | Ante duda, analizar dónde se consume la energía clarifica la clasificación. |
+| **Tres Planos de Verdad** | Cannon, burocrático y físico deben estar interconectados. |
+| **Project Cannon** | Los tres documentos inseparables: Listado de Costes (qué), Árbol de Procesos (cómo), Gantt (cuándo). |
+
+---
+
+## 16. REGLAS DE VALIDACIÓN (Resumen)
+
+### Reglas SHE (Estructurales)
+
+| Código | Regla |
+|--------|-------|
+| SHE-E1 | Padre único (0..1 en propia tabla) |
+| SHE-E2 | Cruce único (0..1 con tabla opuesta) |
+| SHE-E3 | Anti-loop interno |
+| SHE-E4 | Anti-loop cruzado |
+| SHE-E5 | Proyecto único obligatorio |
+
+### Reglas HST
+
+| Código | Regla |
+|--------|-------|
+| HST-1 | Hash maestro inmutable |
+| HST-2 | Imagen primigenia inmutable |
+| HST-3 | Skins no alteran concepto |
+| HST-4 | Jerarquía coherente |
+
+---
+
+## 17. PROJECT CANNON
+
+Los tres documentos fundamentales e inseparables para gestionar cualquier producción o proyecto.
+
+| Documento | Pregunta | Contenido |
+|-----------|----------|-----------|
+| **Listado de Costes** | ¿Qué? | Materiales + Procesos (BOM expandido) |
+| **Árbol de Procesos** | ¿Cómo? | Secuencia y dependencias |
+| **Gráfica de Gantt** | ¿Cuándo? | Distribución temporal |
+
+---
+
+## 18. NOMENCLATURA OBSOLETA (Pendiente de revisión)
+
+Términos heredados que deben sustituirse en la documentación.
+
+| Término Obsoleto | Sustituto | Origen | Notas |
+|------------------|-----------|--------|-------|
+| SFE (System Flow Engine) | *Eliminado* | Concepto obsoleto | Ya sustituido por SHE donde aplicaba |
+| Pipeline | *Eliminar* | Jerga n8n | Concepto innecesario |
+| Santísima Trinidad Documental | **Project Cannon** | PARTE_I | Ya renombrado |
+| Ideal (plano) | **Cannon** | Tríada de Planos | Ya renombrado |
+
+---
+
+*— Fin del Glosario —*