6ea70bd34f
- 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
204 lines
6.0 KiB
Markdown
204 lines
6.0 KiB
Markdown
# Gestoría
|
|
|
|
**Nombre:** Grace
|
|
**Versión:** 2.0
|
|
**Estado:** Enterprise Standard
|
|
|
|
---
|
|
|
|
## Descripción
|
|
|
|
GRACE no es un chatbot. Es un **conjunto de 18 microservicios cognitivos desacoplados**.
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ PRINCIPIO GRACE │
|
|
│ │
|
|
│ "GRACE transforma, Producción (Alfred/Jared) decide" │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Características
|
|
|
|
| Propiedad | Valor |
|
|
|-----------|-------|
|
|
| Stateless | No guarda estado |
|
|
| Determinista | Misma entrada → misma salida |
|
|
| Intercambiable | Modelos sustituibles |
|
|
| Trazable | Todo via trace_id |
|
|
|
|
**GRACE no:**
|
|
- Toma decisiones
|
|
- Altera estados
|
|
- Escribe en base de datos
|
|
|
|
---
|
|
|
|
## Infraestructura
|
|
|
|
| Aspecto | Valor |
|
|
|---------|-------|
|
|
| **Plataforma** | RunPod Serverless |
|
|
| **GPU** | NVIDIA L4 (24GB) |
|
|
| **Endpoint** | https://api.runpod.ai/v2/{id} |
|
|
| **Modos** | runsync, run, status |
|
|
|
|
---
|
|
|
|
## Catálogo de 18 Módulos
|
|
|
|
### FAMILIA A - VISIÓN (Procesado Documental)
|
|
|
|
| # | Módulo | Función |
|
|
|---|--------|---------|
|
|
| 1 | **IMG_PREPROCESS** | Normalización: crop, denoise, upscale, grayscale |
|
|
| 2 | **PDF_SCANNER** | Limpieza escaneados: deskew, binarización, bordes |
|
|
| 3 | **OCR_CORE** | Extracción texto: layout analysis, HOCR |
|
|
|
|
### FAMILIA B - VOZ (Reuniones)
|
|
|
|
| # | Módulo | Función |
|
|
|---|--------|---------|
|
|
| 4 | **ASR_ENGINE** | Reconocimiento habla: Whisper Large v3, diarización |
|
|
| 5 | **TTS_ENGINE** | Síntesis voz neutral para notificaciones |
|
|
|
|
### FAMILIA C - IDENTIDAD (Biometría)
|
|
|
|
| # | Módulo | Función |
|
|
|---|--------|---------|
|
|
| 6 | **FACE_VECTOR** | Vector biométrico facial (Float32 L2) |
|
|
| 7 | **ID_CONSOLIDATION** | Fusión identidades: mediana geométrica |
|
|
| 8 | **AVATAR_GEN** | Avatar neutral 512x512 desde vector |
|
|
|
|
### FAMILIA D - SEMÁNTICA (NLP)
|
|
|
|
| # | Módulo | Función |
|
|
|---|--------|---------|
|
|
| 9 | **EMBEDDINGS** | Vectorización semántica para búsquedas |
|
|
| 10 | **SUMMARIZER** | Resumen estructurado: objetivos, acuerdos, riesgos |
|
|
| 11 | **TASK_EXTRACTOR** | Minería de acciones, responsables, fechas |
|
|
| 12 | **CLASSIFIER** | Asigna tags HST basado en contenido |
|
|
| 13 | **SIMILARITY** | Comparador vectorial (Cosine Similarity) |
|
|
|
|
### FAMILIA E - UTILIDADES
|
|
|
|
| # | Módulo | Función |
|
|
|---|--------|---------|
|
|
| 14 | **FIELD_EXTRACTOR** | Lectura estructurada: CIF, fechas, importes |
|
|
| 15 | **HASHER** | Generador SHA256 y UUID v4 |
|
|
| 16 | **INPUT_NORMALIZER** | Traducción formatos y enumeraciones |
|
|
| 17 | **OUTPUT_ADAPTER** | Adaptación a formatos legacy |
|
|
| 18 | **LANG_DETECT** | Identificación idioma ISO 639-1 |
|
|
|
|
---
|
|
|
|
## Cadenas de Fallback
|
|
|
|
Cada módulo define degradación vía `fallback_chain` en S-CONTRACT:
|
|
|
|
### Ejemplo OCR
|
|
|
|
```json
|
|
"routing": {
|
|
"module": "OCR_CORE",
|
|
"fallback_chain": ["OCR_LOCAL", "OCR_GROQ", "OCR_OPENAI"]
|
|
}
|
|
```
|
|
|
|
### Ejemplo ASR
|
|
|
|
```json
|
|
"routing": {
|
|
"module": "ASR_ENGINE",
|
|
"fallback_chain": ["ASR_WHISPER_LOCAL", "ASR_FASTER_WHISPER", "ASR_GROQ"]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Integración con S-CONTRACT
|
|
|
|
Todos los módulos GRACE cumplen S-CONTRACT sin excepciones. No hay contratos específicos por módulo.
|
|
|
|
### Request (LITE)
|
|
|
|
```json
|
|
{
|
|
"contract_version": "2.1",
|
|
"profile": "LITE",
|
|
"envelope": {
|
|
"trace_id": "uuid-v4",
|
|
"idempotency_key": "sha256-input"
|
|
},
|
|
"routing": {
|
|
"module": "CLASSIFIER"
|
|
},
|
|
"context": {
|
|
"lang": "es",
|
|
"mode": "strict"
|
|
},
|
|
"payload": {
|
|
"type": "text",
|
|
"encoding": "utf-8",
|
|
"content": "Texto a procesar"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Response
|
|
|
|
```json
|
|
{
|
|
"contract_version": "2.1",
|
|
"profile": "LITE",
|
|
"status": {
|
|
"code": "SUCCESS",
|
|
"provider_used": "groq"
|
|
},
|
|
"result": {
|
|
"data": {
|
|
"category": "FINANZAS",
|
|
"confidence": 0.98
|
|
}
|
|
},
|
|
"quality": {
|
|
"confidence": 0.98,
|
|
"tokens_input": 150,
|
|
"tokens_output": 45
|
|
},
|
|
"metadata": {
|
|
"model_id": "llama-3.1-70b-versatile",
|
|
"processing_ms": 340
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Relación con Otros Componentes
|
|
|
|
GRACE es un servicio de transformación. Cuando termina de procesar, envía el resultado a Secretaría (Clara/Margaret) como cualquier otro origen:
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ PUNTO DE ENTRADA ÚNICO │
|
|
├─────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ GRACE ──────┐ │
|
|
│ Penny ──────┼──► Secretaría (Clara/Margaret) │
|
|
│ Packet ─────┤ │
|
|
│ Manual ─────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
GRACE no es un paso del flujo de datos. Es un servicio que cualquier componente puede invocar vía S-CONTRACT para obtener transformaciones cognitivas (OCR, transcripción, clasificación, etc.).
|
|
|
|
---
|
|
|
|
## Compatibilidad Universal
|
|
|
|
El sistema está diseñado para que cuando aparezcan módulos mejores, encajen sin trabajo añadido. S-CONTRACT es el marco de compatibilidad universal — cualquier módulo que lo cumpla es interoperable.
|