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
This commit is contained in:
ARCHITECT
203
02_COMPONENTES/servicios externos/gestoria.md
Normal file
203
02_COMPONENTES/servicios externos/gestoria.md
Normal file
@@ -0,0 +1,203 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user