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

id	title	type	epic	project	created_date	updated_date
MAP-IAI-008	Mapa de EPIC IAI-008 ML Analytics	Navigation Map	IAI-008	inmobiliaria-analytics	2026-01-04	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	AVM - Valuacion automatica	Alta	Draft
RF-ML-002	Prediccion tiempo de venta	Alta	Draft
RF-ML-003	Deteccion oportunidades	Alta	Draft
RF-ML-004	Zonas emergentes	Media	Draft

---

Especificaciones Tecnicas

ID	Titulo	Estado	Contenido Principal
ET-ML-001	Modelo AVM	Creado	XGBoost/LightGBM ensemble, SHAP, features
ET-ML-002	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	Valuacion automatica de propiedad	13	Alta	MVP
US-ML-002	Explicabilidad SHAP de valuacion	5	Media	MVP
US-ML-003	Prediccion de dias en mercado	8	Alta	F2
US-ML-004	Dashboard de tendencias por zona	8	Alta	MVP
US-ML-005	Alertas de oportunidades	5	Alta	F2
US-ML-006	Generacion reporte CMA	8	Alta	F2
US-ML-007	Calculadora ROI para inversores	5	Media	F3
US-ML-008	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/
• Anterior: IAI-007-webscraper/
• Siguiente: -

---

Ultima actualizacion: 2026-01-04