inmobiliaria-analytics/docs/01-fase-alcance-inicial/IAI-007-webscraper/historias-usuario/US-SCR-005.md
rckrdmrd f570727617 feat: Documentation and orchestration updates
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 05:35:40 -06:00

2.2 KiB

id title type epic status story_points priority project created_date updated_date
US-SCR-005 Dashboard de monitoreo de scraping User Story IAI-007 Draft 5 Media inmobiliaria-analytics 2026-01-04 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

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: -