---
id: "US-ML-006"
title: "Reporte CMA automatizado"
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-006: Reporte CMA automatizado

---

## User Story

**Como** agente inmobiliario
**Quiero** generar reportes CMA (Comparative Market Analysis) automaticamente
**Para** presentar valuaciones profesionales a mis clientes sin trabajo manual

---

## Descripcion

Implementar sistema de generacion automatica de reportes CMA profesionales que incluyan comparables, analisis de mercado, valuacion AVM y recomendaciones, exportables a PDF con branding personalizable.

---

## Criterios de Aceptacion

- [ ] Sistema genera CMA completo en < 30 segundos
- [ ] Incluye minimo 5 comparables relevantes
- [ ] Muestra graficas de tendencias de mercado
- [ ] Incluye valuacion AVM con explicacion
- [ ] PDF profesional con branding del agente
- [ ] Exportable en multiples formatos (PDF, DOCX)

---

## Estructura del Reporte

```yaml
cma_sections:
  portada:
    - logo_agencia
    - titulo: "Analisis Comparativo de Mercado"
    - direccion_propiedad
    - fecha_reporte
    - datos_agente

  resumen_ejecutivo:
    - valor_estimado: "$4,850,000"
    - rango_sugerido: "$4,600,000 - $5,100,000"
    - precio_recomendado: "$4,750,000"
    - confianza: "85%"
    - dias_estimados_mercado: "45-60"

  propiedad_sujeto:
    - fotos_principales
    - caracteristicas_clave
    - ubicacion_mapa
    - descripcion

  comparables:
    - lista_5_propiedades
    - tabla_comparativa
    - ajustes_aplicados
    - mapa_ubicaciones

  analisis_mercado:
    - tendencias_precios_zona
    - inventario_absorcion
    - dias_promedio_mercado
    - predicciones

  valuacion:
    - metodologia
    - factores_principales_shap
    - conclusion
    - disclaimer

  anexos:
    - detalle_comparables
    - fuentes_datos
```

---

## Mockup de Portada

```
+--------------------------------------------------+
|                                                   |
|              [LOGO AGENCIA]                       |
|                                                   |
|  ═══════════════════════════════════════════════  |
|                                                   |
|      ANALISIS COMPARATIVO DE MERCADO             |
|              (CMA Report)                         |
|                                                   |
|  ───────────────────────────────────────────────  |
|                                                   |
|  Propiedad:                                       |
|  Av. Providencia 1234, Col. Providencia           |
|  Guadalajara, Jalisco                             |
|                                                   |
|  ───────────────────────────────────────────────  |
|                                                   |
|  Preparado por:                                   |
|  Juan Perez | RE/MAX Premium                      |
|  Tel: 33 1234 5678                                |
|  Email: juan@remax.mx                             |
|                                                   |
|  Fecha: 4 de Enero, 2026                          |
|                                                   |
+--------------------------------------------------+
```

---

## Tareas Tecnicas

| # | Tarea | Estimacion |
|---|-------|------------|
| 1 | Definir esquema JSON del CMA | 2h |
| 2 | Selector de comparables automatico | 6h |
| 3 | Generador de graficas (Recharts/D3) | 6h |
| 4 | Template PDF con react-pdf | 8h |
| 5 | API de generacion | 4h |
| 6 | Sistema de branding personalizable | 4h |
| 7 | Tests | 3h |

**Total estimado:** 33h (~4 dias)

---

## Definition of Done

- [ ] CMA se genera en < 30 segundos
- [ ] PDF renderiza correctamente
- [ ] Comparables son relevantes (similarity > 0.7)
- [ ] Branding es configurable
- [ ] Tests de generacion pasan

---

**Asignado a:** -
**Sprint:** -