# 09 — Dashboards por perfil *(Entregable I)*

> Criterio de diseño: un dashboard no es una vitrina de cifras. Es la respuesta a **"¿qué necesito saber y hacer
> ahora?"** para ese rol, en ese momento del año. Toda cifra que no lleve a una acción se elimina.

---

## Dashboard del Superadmin *(§38)*

**Pregunta que responde:** ¿el colegio está operando correctamente y qué requiere mi intervención?

```
┌─────────────────────────────────────────────────────────────────────────────┐
│  Año 2026 · Periodo 2 (abierto, cierra en 12 días)          ● Todo en orden │
├─────────────────────────────────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │   847    │  │    42    │  │    24    │  │   831    │  │    16    │      │
│  │Estudiantes│ │ Docentes │  │  Cursos  │  │Matrículas│  │ Retiros  │      │
│  │  ▲ 12    │  │          │  │          │  │  activas │  │  año     │      │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘  └──────────┘      │
├─────────────────────────────────────────────────────────────────────────────┤
│  ⚠ PENDIENTES ADMINISTRATIVOS                                               │
│   • 36 notas sin registrar en 2 cursos          → Ver detalle               │
│   • El Periodo 2 cierra en 12 días              → Panel de cierre           │
│   • 3 estudiantes sin acudiente asociado        → Resolver                  │
│   • El año 2027 aún no ha sido creado           → Crear año                 │
├───────────────────────────────────────┬─────────────────────────────────────┤
│  DISTRIBUCIÓN POR NIVEL               │  ACTIVIDAD RECIENTE                 │
│  Preescolar   ████ 68                 │  10:42 M. GONZÁLEZ registró 32      │
│  Primaria     ███████████ 312         │        notas · Matemáticas 6°A      │
│  Secundaria   ██████████████ 389      │  10:31 C. PÉREZ modificó la nota    │
│  Media        ███ 78                  │        de J. GÓMEZ (3.5 → 4.2)      │
│                                       │  09:58 Coordinación matriculó a     │
│  RENDIMIENTO INSTITUCIONAL P2         │        L. DÍAZ en 6°B               │
│  Superior ██ 12%   Alto ████████ 41%  │  09:15 A. RUIZ publicó un comunicado│
│  Básico ███████ 35%  Bajo ████ 12%    │                     → Ver auditoría │
├───────────────────────────────────────┴─────────────────────────────────────┤
│  ACCESOS RÁPIDOS                                                            │
│  [Matricular] [Cerrar periodo] [Generar boletines] [Crear año] [Reportes]   │
└─────────────────────────────────────────────────────────────────────────────┘
```

| Bloque | Contenido | Comportamiento |
|---|---|---|
| **Cabecera de contexto** | Año, periodo, estado y días restantes | Cambia a ámbar si el periodo cierra en menos de 7 días |
| **Indicadores** | Estudiantes, docentes, cursos, matrículas activas, retiros | Cada tarjeta enlaza a su listado ya filtrado |
| **Pendientes** | Lista priorizada de lo que requiere acción | **Es el bloque más importante.** Cada línea es accionable |
| **Distribución** | Estudiantes por nivel educativo | Solo posible gracias a la entidad Grado ([DP-09](00-hallazgos-y-decisiones.md#dp-09--el-modelo-confunde-grado-con-curso--y-eso-rompe-la-promoción)) |
| **Rendimiento** | Distribución por nivel de desempeño del periodo | Enlaza al reporte de bajo rendimiento |
| **Actividad reciente** | Últimas 10 operaciones auditadas | Ventana a la auditoría completa |
| **Accesos rápidos** | Las 5 acciones más frecuentes | Cambian según el momento del año |

**Detalle [RT] — accesos rápidos contextuales.** El sistema conoce el momento del calendario escolar y adapta los
atajos: en enero destaca *Matricular* y *Asignar docentes*; en junio, *Cerrar periodo* y *Generar boletines*; en
noviembre, *Promoción* y *Crear año*. Es un detalle pequeño que ahorra navegación durante todo el año.

---

## Dashboard del Coordinador *(§39)*

**Pregunta que responde:** ¿va bien la operación académica y quién está atrasado?

```
┌─────────────────────────────────────────────────────────────────────────────┐
│  Año 2026 · Periodo 2 · cierra el 15/06                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│  AVANCE DE DIGITACIÓN DE NOTAS · PERIODO 2                                  │
│  ████████████████████████████░░░░░  612 / 648  (94%)                        │
│                                                                             │
│  Docentes con notas pendientes:                                             │
│  ┌───────────────────┬──────────────────┬───────────┬────────────────────┐ │
│  │ CARLOS PÉREZ      │ Sociales · 7°B   │  0 / 21   │ [Recordar]         │ │
│  │ ANA RUIZ          │ Inglés · 9°A     │ 13 / 28   │ [Recordar]         │ │
│  └───────────────────┴──────────────────┴───────────┴────────────────────┘ │
├──────────────────────────────────┬──────────────────────────────────────────┤
│  ALERTAS ACADÉMICAS              │  RENDIMIENTO POR CURSO (P2)              │
│  ⚠ 47 estudiantes con 3+         │  11°A ████████████ 4.12                  │
│    asignaturas en Bajo           │  10°A ███████████ 4.05                   │
│  ⚠ 6°B: promedio 3.12, el más    │   9°A ██████████ 3.88                    │
│    bajo del colegio              │   ...                                    │
│  ⚠ 8 estudiantes sin ninguna     │   6°B ███████ 3.12  ⚠                    │
│    nota registrada               │                    → Ver reporte completo│
├──────────────────────────────────┴──────────────────────────────────────────┤
│  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐                │
│  │  24 cursos │ │ 42 docentes│ │ 128 tareas │ │ 6 comunic. │                │
│  │            │ │            │ │  activas   │ │  vigentes  │                │
│  └────────────┘ └────────────┘ └────────────┘ └────────────┘                │
├─────────────────────────────────────────────────────────────────────────────┤
│  [Matricular] [Panel de cierre] [Boletines] [Promoción] [Bajo rendimiento]  │
└─────────────────────────────────────────────────────────────────────────────┘
```

**El bloque de avance de digitación es el corazón de este dashboard.** Responde a la pregunta que un coordinador
hace todos los días de la última semana de periodo: *¿quién me falta?* Sin él, esa información se obtiene llamando
por teléfono a los docentes.

El botón **[Recordar]** genera un comunicado dirigido a ese docente con el detalle de lo pendiente. Un clic en
lugar de una llamada. **[RT]** — no está en la especificación, pero es coherente con el módulo de comunicados
existente y con el objetivo de §62.

**No incluye:** configuración institucional ni administración de años (§7).

---

## Dashboard del Docente *(§40)*

**Pregunta que responde:** ¿qué tengo pendiente hoy?

```
┌─────────────────────────────────────────────────────────────────────────────┐
│  Hola, MARÍA GONZÁLEZ            2026 · Periodo 2 · abierto hasta el 15/06  │
├─────────────────────────────────────────────────────────────────────────────┤
│  ⚠ TIENES PENDIENTES                                                        │
│   • 32 notas por registrar en Matemáticas · 7°A      → [Digitar notas]      │
│   • Sin desempeños en Matemáticas · 6°B · P2         → [Crear desempeños]   │
│   • 5 observaciones de boletín pendientes (6°A)      → [Escribir]           │
├─────────────────────────────────────────────────────────────────────────────┤
│  MIS ASIGNACIONES                                          Periodo 2        │
│  ┌────────────────────────────────────────────────────────────────────────┐ │
│  │ 📐 MATEMÁTICAS · 6°A   👥 32   Notas 32/32 ✓   Desempeños 4 ✓          │ │
│  │                                                    [Notas] [Desempeños] │ │
│  ├────────────────────────────────────────────────────────────────────────┤ │
│  │ 📐 MATEMÁTICAS · 6°B   👥 30   Notas 30/30 ✓   Desempeños 0 ⚠          │ │
│  │                                                    [Notas] [Desempeños] │ │
│  ├────────────────────────────────────────────────────────────────────────┤ │
│  │ 📐 MATEMÁTICAS · 7°A   👥 32   Notas  0/32 ⚠   Desempeños 3 ✓          │ │
│  │                                                    [Notas] [Desempeños] │ │
│  ├────────────────────────────────────────────────────────────────────────┤ │
│  │ ⭐ DIRECCIÓN DE CURSO · 6°A   👥 32                                     │ │
│  │                        [Observaciones] [Comunicado] [Ver estudiantes]   │ │
│  └────────────────────────────────────────────────────────────────────────┘ │
├───────────────────────────────────┬─────────────────────────────────────────┤
│  MIS TAREAS ACTIVAS               │  RENDIMIENTO DE MIS GRUPOS (P2)         │
│  📋 Taller de fracciones · 6°A    │  6°A  ███████████ 4.05                  │
│      Vence en 2 días  ⚠           │  6°B  █████████ 3.72                    │
│  📋 Evaluación · 6°B              │  7°A  — sin calificar                   │
│      Vence en 5 días              │                                         │
│                    [Nueva tarea]  │  Estudiantes en nivel Bajo: 7           │
└───────────────────────────────────┴─────────────────────────────────────────┘
```

| Decisión de diseño | Motivo |
|---|---|
| **Los pendientes van primero** | Es lo único que el docente necesita ver al entrar |
| **Cada asignación es una tarjeta con su estado** | Se ve de un vistazo qué falta, sin entrar a cada curso |
| **Botones directos a la acción** | Del dashboard a la digitación de notas en **un clic** (§62) |
| **La dirección de curso es una tarjeta aparte** | Refleja que es un rol distinto de la titularidad (§8) |
| **Rendimiento solo de sus grupos** | Nunca ve datos de asignaturas ajenas (§8, §40) |

**El docente nunca ve:** cursos donde no tiene asignación · notas de otras asignaturas · información
administrativa · datos sensibles de estudiantes.

---

## Dashboard del Acudiente *(§41)*

**Pregunta que responde:** ¿cómo va mi hijo y qué tiene pendiente?

**Diseñado primero para celular** — es donde el 90 % de los acudientes lo abrirá.

```
┌───────────────────────────────┐
│ ☰  SIGA                  🔔 2 │
├───────────────────────────────┤
│  [ JUAN ACOSTA ▼ ]            │  ← selector si tiene varios hijos
│                               │
│  ┌─────────────────────────┐  │
│  │      JUAN CARLOS        │  │
│  │      ACOSTA RIVERA      │  │
│  │   6°A · 2026 · Periodo 2│  │
│  └─────────────────────────┘  │
│                               │
│  ┌─────────────────────────┐  │
│  │  DESEMPEÑO DEL PERIODO  │  │
│  │                         │  │
│  │        ALTO             │  │
│  │      ●●●●○              │  │
│  │                         │  │
│  │   ▲ Mejoró respecto     │  │
│  │     al periodo anterior │  │
│  └─────────────────────────┘  │
│                               │
│  EVOLUCIÓN                    │
│  ┌─────────────────────────┐  │
│  │Superior ·············   │  │
│  │Alto     ·······●───●·   │  │
│  │Básico   ·●───●·······   │  │
│  │Bajo     ·············   │  │
│  │          P1  P2  P3  P4 │  │
│  └─────────────────────────┘  │
│                               │
│  📋 PRÓXIMAS TAREAS       (3) │
│  ┌─────────────────────────┐  │
│  │ Taller de fracciones    │  │
│  │ Matemáticas · en 2 días⚠│  │
│  ├─────────────────────────┤  │
│  │ Ensayo                  │  │
│  │ Español · en 5 días     │  │
│  └─────────────────────────┘  │
│              [Ver todas]      │
│                               │
│  📢 COMUNICADOS           (2) │
│  ┌─────────────────────────┐  │
│  │ Reunión de padres       │  │
│  │ Coordinación · hace 2 d │  │
│  └─────────────────────────┘  │
│              [Ver todos]      │
├───────────────────────────────┤
│  ⌂     📋     📢     👤       │
└───────────────────────────────┘
```

### El indicador de desempeño — el punto delicado

Es donde se materializa [DP-01](00-hallazgos-y-decisiones.md#dp-01--el-padre-y-el-estudiante-no-ven-notas-pero-sí-ven-promedio-general-y-puesto).
Lo que se muestra arriba es la **opción recomendada por el equipo**: nivel cualitativo, sin número.

| Configuración | Qué ve el acudiente |
|---|---|
| **Recomendada (por defecto)** | "ALTO", 4 de 5 puntos, tendencia. **Sin número.** Eje Y de la gráfica etiquetado por nivel |
| Si el colegio activa `mostrar_promedio_numerico_a_familias` | Se añade "4.05" bajo el nivel, y el eje Y pasa a numérico |
| Si el colegio activa `mostrar_puesto_a_familias` | Se añade "Puesto 7 de 32" |

Los tres interruptores viven en Configuración académica y **no requieren desarrollo adicional** para activarse.

### Lo que el acudiente NUNCA ve (§9)

- ❌ Notas individuales por asignatura
- ❌ Boletines académicos
- ❌ Información de estudiantes que no son sus hijos
- ❌ Datos de otros acudientes

### Mensajes de acompañamiento [RT]

Junto al indicador, el sistema muestra un mensaje derivado del nivel y la tendencia (§41):

| Nivel + tendencia | Mensaje |
|---|---|
| Superior o Alto, estable o al alza | *Rendimiento favorable. Continúa así.* |
| Básico, al alza | *Evolución positiva. Vas por buen camino.* |
| Básico, estable o a la baja | *Se recomienda fortalecer el desempeño.* |
| Bajo, cualquier tendencia | *Requiere acompañamiento. Te sugerimos contactar al director de curso.* |

El tono es de acompañamiento, no de juicio, y **nunca menciona cifras**.

---

## Dashboard del Estudiante *(§10, §41)*

Estructura idéntica a la del acudiente, con tres diferencias:

1. **Sin selector de estudiante** — solo se ve a sí mismo.
2. **Tono en primera persona** — "Tu desempeño", "Tus tareas".
3. **Las tareas son el elemento dominante**, porque es lo que un estudiante realmente viene a consultar. Se
   ordenan por urgencia y llevan un contador de días.

```
┌───────────────────────────────┐
│  Hola, JUAN                   │
│  6°A · Periodo 2              │
│                               │
│  ⚠ 1 tarea vence en 2 días    │
│                               │
│  ┌─────────────────────────┐  │
│  │  TU DESEMPEÑO           │  │
│  │        ALTO   ●●●●○     │  │
│  │  ▲ Mejoraste este       │  │
│  │    periodo              │  │
│  └─────────────────────────┘  │
│                               │
│  MIS TAREAS                   │
│  🔴 Taller de fracciones      │
│     Matemáticas · en 2 días   │
│  🟡 Ensayo                    │
│     Español · en 5 días       │
│  ⚪ Mapa conceptual           │
│     Sociales · en 9 días      │
└───────────────────────────────┘
```

**Restricciones idénticas (§10):** sin notas individuales, sin boletines.

---

## Resumen comparativo

| Bloque | Superadmin | Coordinador | Docente | Acudiente | Estudiante |
|---|:---:|:---:|:---:|:---:|:---:|
| Contexto (año / periodo) | ✓ | ✓ | ✓ | ✓ | ✓ |
| Indicadores institucionales | ✓ | ✓ | — | — | — |
| Pendientes administrativos | ✓ | ✓ | — | — | — |
| Avance de digitación de notas | ✓ | ✓ | Propio | — | — |
| Alertas académicas | ✓ | ✓ | Propias | — | — |
| Rendimiento por curso | ✓ | ✓ | Propios | — | — |
| Actividad reciente / auditoría | ✓ | Parcial | — | — | — |
| Mis asignaciones | — | — | ✓ | — | — |
| Indicador de desempeño personal | — | — | — | ✓ | ✓ |
| Gráfica de evolución | — | — | — | ✓ | ✓ |
| Tareas | ✓ | ✓ | Propias | Del hijo | Propias |
| Comunicados | ✓ | ✓ | ✓ | ✓ | ✓ |
| Accesos rápidos | ✓ | ✓ | ✓ | — | — |

---

## Notas técnicas

| Aspecto | Decisión |
|---|---|
| **Origen de los datos** | Los indicadores académicos leen del **consolidado** materializado, no recalculan ([RG-04](00-hallazgos-y-decisiones.md#rg-04--cálculo-de-puestos-y-promedios-en-cada-carga-de-pantalla)) |
| **Carga** | El armazón carga primero; los bloques pesados se piden después, de forma asíncrona, con esqueleto de carga |
| **Caché** | Los indicadores institucionales se guardan en caché unos minutos. Un dashboard no necesita precisión al segundo |
| **Gráficas** | Biblioteca ligera de gráficos, cargada solo en las pantallas que la usan |
| **Sin datos** | Cada bloque tiene su estado vacío con explicación y acción, nunca una gráfica en blanco |
| **Actualización** | Manual mediante botón de refresco. Sin recarga automática que interrumpa al usuario |
