inmobiliaria-analytics/docs/01-fase-alcance-inicial/IAI-008-ml-analytics/historias-usuario/US-ML-008.md

id	title	type	epic	status	story_points	priority	project	created_date	updated_date
US-ML-008	Mapa de zonas emergentes	User Story	IAI-008	Draft	8	Media	inmobiliaria-analytics	2026-01-04	2026-01-04

US-ML-008: Mapa de zonas emergentes

---

User Story

Como inversor inmobiliario Quiero visualizar zonas con potencial de apreciacion en un mapa interactivo Para identificar donde invertir antes de que suban los precios

---

Descripcion

Implementar mapa interactivo que muestre zonas clasificadas por potencial de apreciacion, con colores indicando oportunidad (verde=alta, amarillo=media, rojo=baja), incluyendo metricas clave y tendencias historicas por zona.

---

Criterios de Aceptacion

• Mapa interactivo con polygonos de zonas
• Color-coding por potencial de apreciacion
• Click en zona muestra metricas detalladas
• Filtros por tipo de propiedad y rango de precio
• Historico de 12 meses en graficas
• Carga rapida (< 2 segundos)

---

Mockup del Mapa

+----------------------------------------------------------+
|  MAPA DE OPORTUNIDADES DE INVERSION                       |
+----------------------------------------------------------+
|  Filtros: [Casas ▼] [< $5M ▼] [Ultimos 12 meses ▼]       |
+----------------------------------------------------------+
|                                                           |
|     ┌─────────────────────────────────────────────┐      |
|     │                 ZAPOPAN                      │      |
|     │    ┌────────┐                               │      |
|     │    │ Country│ ▓▓▓                           │      |
|     │    │  Club  │                               │      |
|     │    └────────┘     ┌──────────┐              │      |
|     │                   │Providencia│ ███         │      |
|     │    ┌──────┐       │  (+18%)   │             │      |
|     │    │Chapal│       └──────────┘              │      |
|     │    │ita   │ ▓▓▓                             │      |
|     │    └──────┘                                 │      |
|     │                        GUADALAJARA          │      |
|     │         ┌─────────┐                         │      |
|     │         │Lafayette│ ███                     │      |
|     │         │ (+22%)  │                         │      |
|     │         └─────────┘    ┌────────┐           │      |
|     │                        │Americana│ ▓▓▓      │      |
|     │                        │ (+15%)  │          │      |
|     │                        └────────┘           │      |
|     │                                             │      |
|     │   ███ Alta (>15%)  ▓▓▓ Media (8-15%)       │      |
|     │   ░░░ Baja (<8%)   ─── Sin datos           │      |
|     └─────────────────────────────────────────────┘      |
|                                                           |
+----------------------------------------------------------+

---

Panel de Detalle de Zona

+------------------------------------------+
|  LAFAYETTE - Zapopan                     |
+------------------------------------------+
|                                          |
|  Score de Inversion: 87/100       ████   |
|  Riesgo: Bajo                            |
|                                          |
|  METRICAS                                |
|  ┌─────────────────────────────────────┐ |
|  │ Apreciacion 12m     │  +22.3%       │ |
|  │ Precio promedio/m2  │  $35,400      │ |
|  │ vs. promedio ciudad │  +18%         │ |
|  │ Tendencia           │  Acelerando   │ |
|  │ Inventario activo   │  45 props     │ |
|  │ Dias en mercado     │  38 dias      │ |
|  └─────────────────────────────────────┘ |
|                                          |
|  TENDENCIA DE PRECIOS                    |
|     $40K │        ╭──────                |
|     $35K │    ╭───╯                      |
|     $30K │╭───╯                          |
|     $25K │                               |
|          └────────────────────           |
|           E F M A M J J A S O N D        |
|                                          |
|  DRIVERS DE CRECIMIENTO                  |
|  - Nuevo desarrollo comercial            |
|  - Derrame de zona Andares               |
|  - Alta demanda, bajo inventario         |
|                                          |
|  PROPIEDADES EN ZONA                     |
|  [Ver 45 propiedades activas]            |
|                                          |
+------------------------------------------+

---

Tareas Tecnicas

#	Tarea	Estimacion
1	Obtener/crear GeoJSON de colonias	4h
2	Implementar mapa con Mapbox/Leaflet	6h
3	Calcular scores por zona (backend)	4h
4	Panel de detalle interactivo	4h
5	Graficas de tendencia por zona	4h
6	Filtros y busqueda	3h
7	Optimizacion de carga	2h
8	Tests	2h

Total estimado: 29h (~3.5 dias)

---

Datos por Zona

zone_data:
  lafayette:
    polygon: "geojson..."
    municipality: "Zapopan"

    metrics:
      appreciation_12m: 22.3
      avg_price_m2: 35400
      vs_city_avg: 1.18
      trend: "accelerating"
      inventory: 45
      avg_dom: 38

    investment_score: 87
    risk_level: "low"

    drivers:
      - "Nuevo desarrollo comercial cercano"
      - "Derrame de zona Andares"
      - "Alta demanda vs inventario bajo"

    forecast:
      next_12m: 15.5  # % estimado
      confidence: 0.78

---

API Endpoints

endpoints:
  GET /api/zones/emerging:
    description: "Lista de zonas emergentes"
    response:
      - zone_id
      - name
      - polygon_geojson
      - score
      - appreciation_12m
      - color_code

  GET /api/zones/{zone_id}/details:
    description: "Detalle de una zona"
    response:
      - full_metrics
      - price_history_monthly
      - drivers
      - forecast
      - sample_properties

  GET /api/zones/heatmap:
    description: "Datos para heatmap de precios"
    response:
      - grid_cells_with_values

---

Definition of Done

• Mapa renderiza correctamente
• Polygonos de zonas cargados
• Colores reflejan scoring correcto
• Panel de detalle funcional
• Performance < 2s carga inicial
• Mobile responsive

---

Asignado a: - Sprint: -