Files
system-docs/glosario_she_enterprise_v3.md
ARCHITECT 9f3a4214d3 Sync from R2 skynet v8: manuales, operación, glosario v3
Añadido:
- MANUAL_USUARIO_ARCHITECT.md
- MANUAL_USUARIO_CORP.md
- MANUAL_USUARIO_DECK.md
- MANUAL_USUARIO_HST.md
- 07_OPERACION/ (monitoring, runbooks, incident_response)
- glosario_she_enterprise_v3.md

Eliminado:
- glosario_she_enterprise_v2.md (reemplazado por v3)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-01 10:53:57 +00:00

23 KiB
Raw Blame History

Glosario Consolidado — Sistema SHE Enterprise v5.1

Versión: 3.0 Fecha: Diciembre 2025 Fuentes: Documentación técnica SHE, Sistema de Registro Inmutable v1.2, Análisis de Paradigmas, CAPTAIN CLAUDE Coordinator Actualización: Incorporación de orquestación multi-agente y paradigma TZZR


1. ARQUITECTURA CENTRAL

1.1 Sistema Principal

Término Definición
SHE Semantic Hashtag Engine. Motor narrativo-relacional que gestiona el flujo de estados y transiciones entre entidades. Es la caja fuerte de custodia (Milestones + Bloques).
HST Hash Semantic Tagging. Sistema de etiquetado semántico mediante etiquetas de 3 caracteres que proporciona clasificación visual e inmutable.
TZZR Technical Zero-Trust Zoned Repository. Sistema centralizado de gobernanza, Gitea, PostgreSQL e Infisical en servidor 69.62.126.110.

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. Determinista.
Secretaría Clara Margaret Punto de entrada inmutable. Todo dato ingresa exactamente como llegó. Registro permanente sin modificación.
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. WORM.
Gestoría Grace Grace Capa cognitiva con 18 módulos de IA para transformación de datos. Intercambiable, agnóstica.
Orquestador CAPTAIN CLAUDE CAPTAIN CLAUDE Sistema multi-agente LLM que coordina flujos complejos. Supervisor central de TZZR.

2. LA TRÍADA DE PLANOS

Plano Tabla Principal Naturaleza Descripción
Cannon Ítems Definición perfecta Especificaciones, planos, recetas. No consume energía. Inmutable por definición.
Burocrático Milestones Estado legal/contable Documentos, contratos, estados en vigor. Consume energía jurídica. Estados definidos.
Físico Bloques Evidencia material Fotos, registros, pruebas físicas. Consume energía real. Fotografía energética.

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.

2.1 Paradigma Temporal (T0 Framework)

T-N ────→ T-1 ────→ T0 ────→ T+1 ────→ T+N
 │         │        │        │         │
Origen   Referencia Inicio   Cierre   Futuro/
Difuso   Previa     Real     Eviden-  Histórico
                             cia
Punto Significado Plano Asociado Características
TN Origen difuso Pre-Cannon Exploración, ideas no consolidadas
T1 Referencia previa Cannon Punto desde el cual planificar, especificación
T0 Inicio ejecución Milestone (draft) Arranque formal, recursos comprometidos
T+1 Hito burocrático Milestone (active/completed) Registro formal de cierre operativo
T+N Resultado consolidado Bloque Materialización real en el mundo

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. Ciclo de vida desde draft a archived.
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 (Máquina de Estados)

Estado Descripción Transiciones
draft Borrador inicial → active, cancelled
active En ejecución → on_hold, completed, cancelled
on_hold Pausado → active, cancelled
completed Finalizado → archived
cancelled Cancelado (terminal) (ninguna)
archived Archivado (terminal) (ninguna)

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. Hash verificable.
tipo_accion Clasificación del bloque: punto, secuencia, esfuerzo_maximo.
evidencia_url URL obligatoria de la evidencia física (foto, archivo, registro). Almacenada en R2 o Arweave.
evidencia_hash SHA-256 del archivo de evidencia para verificación de integridad. Inmutable.

Tipos de Acción en Bloques

Tipo Descripción Energía Frecuencia
Generadora Crea nuevo valor (diseño, producción) Alta Inicio de ciclo
Preservadora Mantiene estado (almacenamiento, backup) Media Continua
Transformadora Modifica existente (ensamblaje, edición) Alta Iterativa
Verificadora Confirma calidad (inspección, testing) Baja Hitos

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. Inmutable una vez definida.
tipo Clasificación: producto, servicio, proceso, componente, protocolo.
specs_estandar JSONB con especificaciones técnicas estructuradas. Schema validado.
version_canon Versión de especificación. Incrementa solo con cambios significativos.

4. ENTIDADES AUXILIARES

Término Definición
Player Actor del sistema: persona, empresa, departamento, sistema_ia, sensor_iot. Entidad que puede actuar e iniciar flujos.
Bandera Marco jurídico/jurisdicción que gobierna operaciones. Define IVA, moneda, idioma, timezone, leyes aplicables.
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. Definitoria.
Imagen primigenia Conjunto mínimo de atributos que definen inequívocamente una entidad. Inmutable. Alma de la identidad.
ref Etiqueta semántica de 3 caracteres que clasifica registros (ej: inv, pjt, ord). Memorizable.
Skin Capa de presentación que modifica visualización sin alterar datos subyacentes. Intercambiable.
hash_visible H_left(30) + estilo(4) + H_right(30). Identifica skin específico. Cosmético pero determinista.

5.2 Grupos de Etiquetas

Grupo Propiedad Memorizable Descripción
hst Sistema Vocabulario semántico universal, inmutable, oficial
spe Sistema No Especificaciones técnicas, JSONB
hsu Usuario Etiquetas personales del usuario, custom refs
msu Usuario No Metodologías personales, flujos privados

5.3 Catálogo de Etiquetas (ref) - v3.1

ref Nombre Grupo Descripción
inc Incidencia Origen Punto de entrada inicial, disparador de flujo
pjt Proyecto Origen Contenedor principal de trabajo, epicentro
prp Propuesta Origen Oferta comercial, valuación preliminar
ord Pedido Transacción Orden de compra/venta, compromiso
inv Factura recibida Transacción Documento fiscal de proveedor, pasivo
siv Factura emitida Transacción Documento fiscal propio, activo
pay Pago Transacción Transacción monetaria, liquidación
exl Gasto Transacción Salida de dinero, erogación
whs Almacén Logístico Ubicación de stock, depósito
inn Entrada Logístico Recepción de material, ingreso
out Salida Logístico Expedición de material, egreso
pct Producción Productivo Proceso productivo, transformación
sod Albarán Logístico Documento de entrega, remisión
doc Documento Documental Archivo genérico, no clasificado
ctr Contrato Documental Acuerdo legal, vinculante
lic Licencia Documental Permiso/autorización, regulatorio
aud Auditoría Compliance Registro de inspección, verificación
ntf Notificación Sistema Alerta/evento, comunicación

6. ORQUESTACIÓN Y FLUJOS

6.1 Alfred y Jared (Producción Determinista)

Término Definición
Alfred Orquestador determinista personal (n8n/Windmill). NO es IA. Ejecuta Métodos de forma determinista.
Jared Versión corporativa de Alfred para gestionar múltiples usuarios simultáneamente. Escalado.

6.2 CAPTAIN CLAUDE (Orquestación Multi-Agente)

Término Definición
CAPTAIN CLAUDE Sistema multi-agente LLM que coordina flujos complejos, decisiones ramificadas y gestión de excepciones. Supervisor central de TZZR. Interpreta intención, no solo ejecuta.
Agente Especializado LLM con rol definido (vendedor, ingeniero, analista, etc.). Opera dentro de boundaries TZZR.
Contexto Compartido Estado distribuido que permite que agentes se comuniquen sin acoplamiento. Via Redis + Context Manager.

6.3 Métodos

Término Definición
Método Receta JSON pública que define procedimiento operativo. Secuencia de pasos atómicos. Schema validado.
h_metodo SHA-256 del JSON del Método. Identificador único e inmutable. Auditable.
step_id Identificador del paso dentro del Método. Numerado secuencialmente o por UUID.

6.4 Tipos de Paso en Métodos

Tipo Descripción Ejemplo Agente
module Invoca módulo Grace grace.parser Grace
action Operación CRUD create_relation Feldman/Mason
condition Bifurcación lógica if amount > 1000 CAPTAIN CLAUDE
wait Espera evento externo approval_received Sistema
notify Envía notificación email, webhook Penny (voz)
agent Delega a LLM especializado agente_vendedor.analiza_oferta LLM custom

6.5 Flujos HST Estándar

Flujo Secuencia Descripción
Compra completa inc → pjt → prp → ord → exl → sod → inv → pay Ciclo completo de compra con auditoría
Compra directa inc → exl → sod → inv Gastos menores sin proyecto
Producción inc → whs → inn → pct → out Transformación interna de materia
Resolución de incidencia inc → pjt → [Grace análisis] → sod → ctr Incidencia → Proyecto → Solución → Documentación

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. Agnóstica de proveedor.
Contrato Común v2.1 Interfaz universal para comunicación entre módulos Grace. Define estructura de Request/Response. JSON schema.
Módulo Grace Microservicio IA que implementa Contrato Común. Input → Procesa → Output. Documentado.

7.2 Catálogo de Módulos Grace (18)

# Módulo Función Entrada Salida
1 PARSER Extracción de datos de documentos Documento (PDF/IMG) Entidades JSON
2 CLASSIFIER Categorización, asigna etiquetas ref Texto/Documento ref (hst/msu) + score
3 VALIDATOR Verificación de datos contra reglas Datos + Esquema PASS/FAIL + detalles
4 SUGGESTER Recomendaciones rankeadas Contexto + Historial Lista rankeada de sugerencias
5 NARRATOR Generación de texto natural Datos + Template Narrativa en lenguaje natural
6 AUDITOR Detección de anomalías Serie de datos Alertas + anomalías
7 MATCHER Conciliación de conjuntos 2+ conjuntos de datos Pares coincidentes + score
8 SUMMARIZER Resumen de documentos Documento largo Resumen conciso
9 TRANSLATOR Traducción de texto Texto + idioma_origen + idioma_destino Texto traducido
10 EXTRACTOR OCR avanzado + estructura Imagen/PDF Texto estructurado
11 PREDICTOR Pronóstico de series temporales Series históricas + período Pronóstico con intervalo
12 CLUSTERER Agrupación de datos Dataset + k Clusters con centroides
13 LINKER Detección de relaciones 2+ entidades Relaciones + tipo + peso
14 SCORER Puntuación según criterios Entidad + criterios Score numérico + componentes
15 ROUTER Enrutamiento de mensajes Mensaje + destinos Entrega a destino óptimo
16 RESPONDER Respuesta automática Pregunta/Solicitud Respuesta contextualizada
17 MONITOR Vigilancia de métricas Métricas en tiempo real Alertas + dashboards
18 LEARNER Mejora continua de modelos Dataset + retroalimentación Modelo mejorado

8. SEGURIDAD Y TRAZABILIDAD

8.1 Sistemas de Protección

Término Definición
SENTINEL Sistema dual de auditoría y protección (LIGHT + DEEP). Nivel perimetral + interno. Validación continua.
SENTINEL LIGHT Perimetral: autenticación, autorización, acceso. Defensa en bordes.
SENTINEL DEEP Interno: auditoría de datos, detección de anomalías, verificación de integridad. Observabilidad completa.
NOTARIO Sistema de sellado blockchain con Merkle Tree para inmutabilidad temporal. Proof of existence.
Key Vault Gestor centralizado de secretos y claves de cifrado. Infisical en TZZR.

8.2 Cifrado

Término Definición
DEK Data Encryption Key. Llave efímera que cifra datos directamente. Generada por sesión.
KEK Key Encryption Key. Llave maestra que cifra otras llaves. Almacenada en Key Vault.
Envelope Encryption Patrón: datos cifrados con DEK, DEK cifrada con KEK. Separación de responsabilidad.
PII Personally Identifiable Information. Datos personales que requieren cifrado estricto. GDPR.

8.3 Perfiles de Cifrado

Perfil Uso Rotación Nivel
ALTO Datos sensibles (PII, financieros) 30 días AES-256 + HMAC
MEDIO Datos operativos 90 días AES-192
BAJO Datos públicos N/A Opcional
TRANSIT Datos en tránsito (TLS 1.3) Por sesión TLS 1.3 + ECDHE

9. ALMACENAMIENTO

9.1 Modelo de Temperaturas

Temperatura Ubicación Latencia Uso Retención
Hot Local + Redis <100ms Trabajo activo 7 días
Warm R2 (Cloudflare) <5s Histórico < 1 año 1 año
Cold Arweave <60s Archivo permanente, inmutable Permanente

9.2 Términos de Almacenamiento

Término Definición
R2 Almacenamiento S3-compatible de Cloudflare. Endpoint: https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
Arweave Blockchain de almacenamiento permanente. Pago único, inmutable. Auditoría final.
WORM Write Once Read Many. Política de almacenamiento inmutable. Feldman usa WORM.
Bucket architect Bucket principal en R2 con carpetas: system/, documentos adjuntos/, auditorias/, backups/

10. 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_

11. LOGGING Y AUDITORÍA

Término Definición
trace_id UUID v4 que identifica una ejecución completa de Método. Permite rastrear flujo entero.
idempotency_key Clave SHA-256 para detección de duplicados en 24h. Previene re-ejecución.
audit_status Estado de auditoría: PENDING, PASS, WARN, FAIL. Resultado de validación SENTINEL.
audit_log Registro inmutable de toda transacción. Almacenado en Feldman + Clara con hash verificable.

12. REGLAS DE VALIDACIÓN (Resumen)

Reglas SHE (Estructurales)

Código Regla Explicación
SHE-E1 Padre único (0..1 en propia tabla) Una entidad no puede tener múltiples padres en la misma tabla
SHE-E2 Cruce único (0..1 con tabla opuesta) Máximo 1 vínculo entre dos entidades opuestas
SHE-E3 Anti-loop interno Una entidad no puede ser ancestro de sí misma en su tabla
SHE-E4 Anti-loop cruzado Ciclos prohibidos entre tablas relacionadas
SHE-E5 Proyecto único obligatorio Toda entidad operativa debe vincularse a un proyecto

Reglas HST

Código Regla Aplicación
HST-1 Hash maestro inmutable H_maestro nunca cambia, define identidad
HST-2 Imagen primigenia inmutable Atributos primarios son constantes
HST-3 Skins no alteran concepto Visualización cosmética, no modifica datos
HST-4 Jerarquía coherente Refs deben formar árbol válido sin ciclos

13. PROJECT CANNON

Los tres documentos fundamentales e inseparables para gestionar cualquier producción o proyecto.

Documento Pregunta Contenido Propiedad
Listado de Costes ¿Qué? Materiales + Procesos (BOM expandido) Plano Cannon
Árbol de Procesos ¿Cómo? Secuencia y dependencias Plano Cannon
Gráfica de Gantt ¿Cuándo? Distribución temporal Milestones

Regla: No se aprueba proyecto sin los 3 documentos completos y consistentes.


14. PRINCIPIOS FUNDACIONALES v8

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, Árbol, Gantt.

15. MODELOS COMPLEMENTARIOS

Modelo Función Propósito
Vision Builder Herramienta de diseño visual de vida Conecta objetivos con acciones
Cloudville Simulador de estructuras organizativas con agentes IA Experimentación de configuraciones
Sistema de Voz (Penny) Flujo autoalojado: VAD → STT → NLU → TTS Interfaz conversacional
Bloques de Información Sistema de 6 elementos para trabajo con IAs Contexto, Instrucción, Ejemplo, Restricción, Datos, Formato
The Factory Generación iterativa de contenido Desarrollo incremental

16. 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, usar Método
Santísima Trinidad Documental Project Cannon PARTE_I Ya renombrado
Ideal (plano) Cannon Tríada de Planos Ya renombrado
Orquestador genérico CAPTAIN CLAUDE v8 Especificacion concreta
Agentes TZZR Servicios TZZR v8 Clara, Alfred, etc. son SERVICIOS, no agentes IA

16.1 NOMENCLATURA OBLIGATORIA

IMPORTANTE: Los siguientes componentes son SERVICIOS (microservicios Python), NO son agentes de IA:

Servicio Funcion Servidor
Clara Secretaria (ingesta inmutable) DECK
Alfred Produccion (flujos) DECK
Mason Administracion (enriquecimiento) DECK/CORP
Feldman Contable (registro final) DECK/CORP
Margaret Secretaria corporativa CORP
Jared Produccion corporativa CORP

Terminologia correcta:

  • "Servicio Clara" o "Clara service"
  • "Microservicio Feldman"
  • "Servicios TZZR"

Terminologia INCORRECTA (no usar):

  • "Agente Clara"
  • "Agentes TZZR"
  • "Agentes IA" (excepto para Grace/CAPTAIN CLAUDE)

Sistemas con IA:

  • Grace: Capa cognitiva con modulos de IA
  • CAPTAIN CLAUDE: Sistema de coordinacion con LLM

17. ÍNDICE ALFABÉTICO RÁPIDO

[A] Acción | Agente | Almacén | Auditoría [B] Bloque | Bloques de información | Bucket [C] Cannon | CAPTAIN CLAUDE | Clasificación | Contrato Común | Contexto [D] DEK | Documento | Dashboard [E] Entidad | Enumeración | Especificación | Esquema [F] Feldman | Flagshot | Flujo | Frase [G] Glosario | Grace | Grafo [H] Hash | HST | h_maestro | h_metodo [I] Ítem | Imagen primigenia | Immutable Log [J] Jared | Jurisdicción [K] KEK | Key Vault [L] Localización | Listado | Licencia | Log [M] Maestro | Margaret | Mason | Método | Milestone | Módulo [N] Narración | Notario [O] Operativo | Orquestador [P] Parser | Payment | Player | Plano | Producción | Propuesta | Proyecto [Q] Query | Ruta [R] Receta | Ref | Relación | Resultado | R2 | Roothash [S] Secretaría | Sentimiento | Sentinel | Skin | SQL | Storage [T] Tabla | Tag | Temporal | Transacción | TZZR [U] Usuario | Utilidad [V] Validación | Versión | Vinculación [W] WORM [X] (no aplica) [Y] (no aplica) [Z] (no aplica)


— Fin del Glosario v3 —

Última actualización: 2025-12-30 Versión: 3.0 - Sistema SHE Enterprise v5.1 Próxima revisión: 2026-06-30