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

111 lines
2.2 KiB
Markdown

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