inmobiliaria-analytics/docs/01-fase-alcance-inicial/IAI-008-ml-analytics/_MAP.md

---
id: "MAP-IAI-008"
title: "Mapa de EPIC IAI-008 ML Analytics"
type: "Navigation Map"
epic: "IAI-008"
project: "inmobiliaria-analytics"
created_date: "2026-01-04"
updated_date: "2026-01-04"
---

# _MAP: EPIC IAI-008 - Machine Learning y Analytics Avanzado

**EPIC:** IAI-008
**Nombre:** Sistema de ML y Analytics Avanzado
**Estado:** Draft
**Story Points:** 60 (estimado)

---

## Estructura del EPIC

```
IAI-008-ml-analytics/
├── _MAP.md                        # Este archivo
├── README.md                      # Vision general del EPIC
│
├── requerimientos/
│   ├── _MAP.md
│   ├── RF-ML-001.md              # AVM - Valuacion automatica
│   ├── RF-ML-002.md              # Prediccion tiempo de venta
│   ├── RF-ML-003.md              # Deteccion oportunidades
│   └── RF-ML-004.md              # Zonas emergentes
│
├── especificaciones/
│   ├── _MAP.md
│   ├── ET-ML-001-avm.md          # Modelo AVM (XGBoost ensemble)
│   └── ET-ML-002-opportunities.md # Deteccion de oportunidades
│
├── historias-usuario/
│   ├── _MAP.md
│   ├── US-ML-001.md              # Valuacion automatica basica
│   ├── US-ML-002.md              # Explicabilidad de valuacion
│   ├── US-ML-003.md              # Prediccion dias en mercado
│   ├── US-ML-004.md              # Dashboard tendencias
│   ├── US-ML-005.md              # Alertas oportunidades
│   ├── US-ML-006.md              # Reporte CMA
│   ├── US-ML-007.md              # Analisis ROI inversion
│   └── US-ML-008.md              # Zonas emergentes
│
├── tareas/
│   └── _MAP.md
│
└── implementacion/
    ├── _MAP.md
    ├── MODEL-CARDS/              # Documentacion de modelos
    └── CHANGELOG.md              # Historial de cambios
```

---

## Requerimientos Funcionales

| ID | Nombre | Prioridad | Estado |
|----|--------|-----------|--------|
| [RF-ML-001](./requerimientos/RF-ML-001.md) | AVM - Valuacion automatica | Alta | Draft |
| [RF-ML-002](./requerimientos/RF-ML-002.md) | Prediccion tiempo de venta | Alta | Draft |
| [RF-ML-003](./requerimientos/RF-ML-003.md) | Deteccion oportunidades | Alta | Draft |
| [RF-ML-004](./requerimientos/RF-ML-004.md) | Zonas emergentes | Media | Draft |

---

## Especificaciones Tecnicas

| ID | Titulo | Estado | Contenido Principal |
|----|--------|--------|---------------------|
| [ET-ML-001](./especificaciones/ET-ML-001-avm.md) | Modelo AVM | Creado | XGBoost/LightGBM ensemble, SHAP, features |
| [ET-ML-002](./especificaciones/ET-ML-002-opportunities.md) | Deteccion Oportunidades | Creado | Undervalued detector, emerging zones, alerts |

---

## Servicios ML

| ID | Servicio | Tipo | Algoritmo | Prioridad |
|----|----------|------|-----------|-----------|
| AVM-Core | PropertyPricePredictor | Regression | XGBoost ensemble | Alta |
| DOM-Predictor | TimeToSellPredictor | Survival | Cox PH / RSF | Alta |
| Demand-Forecaster | ZoneDemandPredictor | Time Series | Prophet | Media |
| Deal-Finder | UndervaluedDetector | Anomaly | AVM + z-score | Alta |
| Zone-Spotter | EmergingZoneIdentifier | Clustering | K-Means + trends | Media |
| Investment-Analyzer | ROIAnalyzer | Financial | Multi-model | Media |

---

## Historias de Usuario

| ID | Titulo | SP | Prioridad | Fase |
|----|--------|----|-----------|------|
| [US-ML-001](./historias-usuario/US-ML-001.md) | Valuacion automatica de propiedad | 13 | Alta | MVP |
| [US-ML-002](./historias-usuario/US-ML-002.md) | Explicabilidad SHAP de valuacion | 5 | Media | MVP |
| [US-ML-003](./historias-usuario/US-ML-003.md) | Prediccion de dias en mercado | 8 | Alta | F2 |
| [US-ML-004](./historias-usuario/US-ML-004.md) | Dashboard de tendencias por zona | 8 | Alta | MVP |
| [US-ML-005](./historias-usuario/US-ML-005.md) | Alertas de oportunidades | 5 | Alta | F2 |
| [US-ML-006](./historias-usuario/US-ML-006.md) | Generacion reporte CMA | 8 | Alta | F2 |
| [US-ML-007](./historias-usuario/US-ML-007.md) | Calculadora ROI para inversores | 5 | Media | F3 |
| [US-ML-008](./historias-usuario/US-ML-008.md) | Mapa de zonas emergentes | 8 | Media | F3 |

**Total Story Points:** 60

---

## Dependencias

### Depende de:
- IAI-007 (Webscraper): Datos de propiedades
- IAI-002 (Propiedades): Modelo normalizado
- IAI-001 (Auth): API authentication

### Bloquea a:
- Portal de Inversores (features avanzadas)
- Reportes white-label

---

## Metricas de Exito

| Modelo | Metrica | Objetivo |
|--------|---------|----------|
| AVM | MAPE | < 10% |
| AVM | R2 | >= 0.85 |
| Time-to-sell | MAPE | < 25% |
| Demand forecast | Dir. Accuracy | >= 70% |

---

## Riesgos

| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Datos insuficientes | Alta | Alto | Scraping agresivo inicial |
| Accuracy baja | Media | Alto | Feature engineering, mas datos |
| Latencia alta | Media | Medio | Caching, batch predictions |
| Drift de modelos | Alta | Medio | Monitoreo, re-entrenamiento |

---

## Navegacion

- **Arriba:** [01-fase-alcance-inicial/](../_MAP.md)
- **Anterior:** [IAI-007-webscraper/](../IAI-007-webscraper/_MAP.md)
- **Siguiente:** -

---

**Ultima actualizacion:** 2026-01-04