---
id: "US-SCR-005"
title: "Dashboard de monitoreo de scraping"
type: "User Story"
epic: "IAI-007"
status: "Draft"
story_points: 5
priority: "Media"
project: "inmobiliaria-analytics"
created_date: "2026-01-04"
updated_date: "2026-01-04"
---

# US-SCR-005: Dashboard de monitoreo de scraping

---

## User Story

**Como** administrador del sistema
**Quiero** un dashboard para monitorear el estado del scraping
**Para** detectar problemas rapidamente y asegurar calidad de datos

---

## Descripcion

Implementar dashboard de monitoreo que muestre metricas en tiempo real, estado de jobs, salud del pool de proxies, y alertas activas.

---

## Criterios de Aceptacion

- [ ] Dashboard muestra propiedades scrapeadas hoy/semana
- [ ] Muestra success rate por fuente
- [ ] Muestra estado de jobs activos
- [ ] Muestra salud del pool de proxies
- [ ] Alertas visibles cuando hay problemas
- [ ] Graficas de tendencia temporal

---

## Widgets del Dashboard

```yaml
row_1:
  - tipo: stat_card
    titulo: "Propiedades Hoy"
    valor: count_today

  - tipo: stat_card
    titulo: "Success Rate"
    valor: success_rate_24h
    formato: percentage

  - tipo: stat_card
    titulo: "Jobs Activos"
    valor: active_jobs_count

  - tipo: stat_card
    titulo: "Proxies Activos"
    valor: active_proxies_count
    alerta: < 20

row_2:
  - tipo: line_chart
    titulo: "Propiedades por Hora"
    datos: properties_hourly_7d
    group_by: source

  - tipo: line_chart
    titulo: "Success Rate"
    datos: success_rate_hourly_7d

row_3:
  - tipo: table
    titulo: "Jobs Recientes"
    columnas: [id, source, status, progress, duration]

  - tipo: pie_chart
    titulo: "Errores por Tipo"
    datos: errors_by_type_24h
```

---

## Tareas Tecnicas

| # | Tarea | Estimacion |
|---|-------|------------|
| 1 | Definir metricas Prometheus | 3h |
| 2 | Crear dashboard Grafana | 4h |
| 3 | Configurar alertas | 2h |
| 4 | Integrar en admin panel | 3h |

**Total estimado:** 12h (~1.5 dias)

---

## Definition of Done

- [ ] Dashboard accesible desde admin panel
- [ ] Datos se actualizan en tiempo real
- [ ] Alertas configuradas y funcionando
- [ ] Documentacion de metricas

---

**Asignado a:** -
**Sprint:** -