# Proyecto B — Skill Matrix Digital

## 1. Objetivo

Sustituir el Excel gigante de autoevaluación por una plataforma que:
1. Digitalice el **catálogo de competencias** del especialista energético por niveles.
2. Evalúe de forma **objetiva y encubierta** (el agente no sabe qué nivel se está midiendo).
3. **Infiera el nivel** de cada agente con evidencias: tests situacionales + telemetría del simulador.
4. Dé soporte a decisiones de **retribución por niveles** con datos auditables.

## 2. Niveles (según definición de la clienta)

| Nivel | Definición | Criterio orientativo |
|-------|-----------|----------------------|
| **Onboarding** | Acaba de terminar la formación inicial | 0–3 meses |
| **Junior** | Opera con supervisión, ~3 meses | Ejecuta procesos básicos con guía ocasional |
| **Core** | Gestiona cualquier cosa de forma **autónoma** | Sin supervisión, dentro de umbrales de tiempo/calidad |
| **Master** | Va más allá y tiene **más impacto** | Mentoriza, resuelve casos complejos, mejora procesos |
| **Pro** | Resuelve **cualquier problema** + impacto **en otros departamentos** | Visión global, transversalidad |

Cada nivel lleva asociada una banda retributiva (la gestiona RRHH; la plataforma solo aporta la clasificación y la evidencia).

## 3. Estructura del catálogo de competencias

Se importa desde el Excel existente (input imprescindible — ver doc 06):

```
Área (ej.: Atención al cliente, Altas, Facturación, Impagos...)
 └── Competencia (ej.: "Gestionar pago con tarjeta")
      └── Nivel requerido (junior/core/master/pro)
      └── Evidencias posibles:
           ├── Test situacional (pregunta/escenario)
           ├── Ejercicio en simulador (proceso vinculado)
           └── Validación de manager (solo para competencias no simulables)
```

## 4. Motor de evaluación (el corazón del proyecto)

### 4.1 Principio: evaluación encubierta
El agente **nunca se autoevalúa** y **no ve el mapeo pregunta→nivel**. Recibe "tests de conocimiento" y "ejercicios prácticos" periódicos; el sistema, por detrás, mapea cada ítem a competencias y niveles.

### 4.2 Tipos de ítem

1. **Test situacional**: escenario realista con opciones ("Un cliente quiere pagar con tarjeta pero el TPV da error X, ¿qué haces?"). Cada opción puntúa distinto y discrimina niveles (la respuesta del core ≠ la del pro).
2. **Ejercicio en simulador** (Proyecto A): tiempo + errores + resultado. Ejemplo: "¿Cómo harías un M1?" → examen cronometrado.
3. **Casos abiertos** (para master/pro): respuesta libre corregida con rúbrica; opcionalmente pre-corrección con IA y validación humana.
4. **Señales de manager**: para competencias de impacto transversal (pro) que no se pueden simular.

### 4.3 Clasificación de nivel

- Cada competencia se marca como **acreditada / no acreditada / pendiente de evidencia** según los ítems superados.
- El nivel global se calcula por reglas configurables, p. ej.: *Core = 100% de competencias junior acreditadas + ≥80% de competencias core, con tiempos dentro del percentil 60 del baseline*.
- **Nada de porcentajes mágicos opacos**: el desglose competencia a competencia queda auditable para RRHH y para el propio agente (transparencia del resultado, no del método).
- Alertas: agente que lleva ≥12 meses y no acredita nivel core → plan de mejora con re-examen en simulador.

### 4.4 Anti-gaming

- Banco de ítems amplio con rotación aleatoria y variantes de datos (el simulador genera clientes ficticios distintos cada vez).
- Ítems trampa de consistencia (misma competencia preguntada de formas distintas).
- Los tiempos del simulador son difíciles de falsear: o sabes hacer el M1 o no.

## 5. Vistas de la plataforma

| Vista | Para quién | Contenido |
|-------|-----------|-----------|
| **Mi progreso** | Agente | Competencias acreditadas, nivel actual, qué formación tiene pendiente (sin revelar la mecánica de puntuación) |
| **Matriz de equipo** | Manager | Heatmap agentes × competencias, niveles, alertas |
| **Campañas de evaluación** | Formadora | Crear/lanzar tandas de tests y exámenes, ver resultados |
| **Panel RRHH** | RRHH/Dirección | Distribución de niveles, evidencias por agente, export para decisiones retributivas |
| **Editor de catálogo** | Formadora/Admin | CRUD de áreas, competencias, ítems y reglas de nivel; importador del Excel |

## 6. Integración con el Proyecto A

- API interna: cada examen completado en el simulador emite un evento `exam.completed` con {agente, proceso, tiempo, errores, resultado} que la Skill Matrix consume para acreditar competencias.
- Base de datos compartida (ver `03_MODELO_DATOS.md`): usuarios, procesos y resultados viven en el mismo esquema.

## 7. Fuera de alcance (v1)

- Cálculo de nóminas o integración con software de RRHH (solo export).
- Evaluación 360º.
- Gamificación (badges, rankings públicos) — posible v2.