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

152 lines
4.1 KiB
Markdown

---
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:** -