inmobiliaria-analytics/docs/01-fase-alcance-inicial/IAI-008-ml-analytics/historias-usuario/US-ML-004.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

113 lines
2.3 KiB
Markdown

---
id: "US-ML-004"
title: "Dashboard de tendencias de mercado"
type: "User Story"
epic: "IAI-008"
status: "Draft"
story_points: 8
priority: "Alta"
project: "inmobiliaria-analytics"
created_date: "2026-01-04"
updated_date: "2026-01-04"
---
# US-ML-004: Dashboard de tendencias de mercado
---
## User Story
**Como** usuario de la plataforma
**Quiero** ver tendencias de precios y mercado por zona
**Para** entender la dinamica del mercado inmobiliario
---
## Descripcion
Implementar dashboard interactivo que muestre tendencias de precios, inventario, absorcion y otros indicadores clave por zona geografica, con visualizaciones de series temporales y mapas de calor.
---
## Criterios de Aceptacion
- [ ] Dashboard muestra precio promedio por zona
- [ ] Grafica de tendencia temporal (12 meses)
- [ ] Mapa de calor de precios por m2
- [ ] Indicadores de mercado (inventario, absorcion)
- [ ] Filtros por zona, tipo, rango de precio
- [ ] Datos actualizados diariamente
---
## Widgets del Dashboard
```yaml
widgets:
header:
- stat: "Precio Promedio/m2"
valor: "$28,500"
cambio: "+3.2%"
- stat: "Inventario Activo"
valor: "1,234"
cambio: "-5%"
- stat: "Dias Promedio"
valor: "62"
cambio: "-8%"
- stat: "Indice de Mercado"
valor: "72/100"
cambio: "+2"
row_1:
- tipo: line_chart
titulo: "Evolucion de Precios"
datos: precio_m2_mensual
period: 12_meses
- tipo: heatmap_geo
titulo: "Precio por m2 por Zona"
datos: precio_m2_por_zona
row_2:
- tipo: bar_chart
titulo: "Top 10 Colonias por Precio"
datos: top_colonias
- tipo: line_chart
titulo: "Inventario vs Absorcion"
datos: [inventario, ventas]
```
---
## Tareas Tecnicas
| # | Tarea | Estimacion |
|---|-------|------------|
| 1 | Agregaciones de datos por zona | 6h |
| 2 | API de tendencias | 4h |
| 3 | Componente de graficas (Recharts) | 8h |
| 4 | Mapa de calor (Mapbox/Leaflet) | 8h |
| 5 | Filtros interactivos | 4h |
| 6 | Caching de agregaciones | 3h |
**Total estimado:** 33h (~4 dias)
---
## Definition of Done
- [ ] Dashboard renderiza correctamente
- [ ] Datos actualizados diariamente
- [ ] Performance aceptable (< 2s carga)
- [ ] Filtros funcionan correctamente
- [ ] Mobile responsive
---
**Asignado a:** -
**Sprint:** -