# EPICA: EPIC-MAI-002 - Proyectos y Estructura

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MAI-002 |
| **Nombre** | Proyectos y Estructura de Fraccionamientos |
| **Modulo** | proyectos-estructura |
| **Fase** | Fase 1 - Alcance Inicial |
| **Prioridad** | P0 (Critico) |
| **Estado** | Backlog |
| **Story Points** | 42 |
| **Sprint(s)** | Sprint 2-3 |

---

## Descripcion

Sistema de gestion de proyectos de construccion de vivienda con estructura jerarquica: Proyecto -> Fraccionamiento -> Seccion/Manzana -> Vivienda. Incluye catalogo de prototipos de vivienda, estados de avance por vivienda, y geolocalizacion para mapas.

**Extiende:** MGN-015 Projects (Core)

---

## Objetivo de Negocio

Proveer gestion de proyectos que:
- Organice fraccionamientos con estructura completa
- Rastree estado de cada vivienda individual
- Soporte diferentes prototipos de vivienda
- Visualice en mapa la distribucion del fraccionamiento
- Facilite reportes de avance por seccion/manzana

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-MAI002-001 | Como director, quiero crear proyectos de construccion | P0 | 3 | Backlog |
| US-MAI002-002 | Como director, quiero crear fraccionamientos dentro de proyectos | P0 | 5 | Backlog |
| US-MAI002-003 | Como residente, quiero crear secciones/manzanas dentro de fraccionamientos | P0 | 3 | Backlog |
| US-MAI002-004 | Como residente, quiero registrar viviendas individuales | P0 | 5 | Backlog |
| US-MAI002-005 | Como admin, quiero crear prototipos de vivienda (tipos) | P0 | 5 | Backlog |
| US-MAI002-006 | Como residente, quiero ver el estado de avance por vivienda | P0 | 5 | Backlog |
| US-MAI002-007 | Como director, quiero ver mapa del fraccionamiento con estados | P1 | 8 | Backlog |
| US-MAI002-008 | Como residente, quiero importar viviendas desde Excel | P1 | 5 | Backlog |
| US-MAI002-009 | Como director, quiero ver resumen de viviendas por estado | P1 | 3 | Backlog |

**Total Story Points:** 42 SP

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Jerarquia Proyecto -> Fraccionamiento -> Seccion -> Vivienda
- [ ] Catalogo de prototipos con especificaciones
- [ ] Estados de vivienda: Terreno, Cimentacion, Estructura, Acabados, Terminada, Entregada
- [ ] Asignacion de prototipo a vivienda
- [ ] Geolocalizacion por vivienda (lat/lng)
- [ ] Visualizacion en mapa interactivo

**No Funcionales:**
- [ ] Soporte 1000+ viviendas por fraccionamiento
- [ ] Mapa renderiza < 3s con 500 viviendas

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-MAI-001 Fundamentos | Backlog | Si |

**Esta epica bloquea:**
| Epica/Modulo | Razon |
|--------------|-------|
| EPIC-MAI-003 Presupuestos | Presupuesto por proyecto |
| EPIC-MAI-005 Control Obra | Avances por vivienda |
| EPIC-MAI-011 INFONAVIT | Registro de viviendas |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `project_management`
- [ ] Tablas: 6 (projects, developments, sections, housing_units, prototypes, prototype_specs)
- [ ] Extension: PostGIS para geolocalización

**Backend:**
- [ ] Modulo: `projects`
- [ ] Entities: 6
- [ ] Endpoints: 18+
- [ ] Tests: 25+

**Frontend:**
- [ ] Paginas: 6 (Projects, ProjectDetail, Development, Section, HousingUnits, Map)
- [ ] Componentes: 15+ (ProjectCard, DevelopmentTree, UnitStatus, MapView)
- [ ] Stores: 1 (projectsStore)

---

## Estados de Vivienda

| Estado | Codigo | Descripcion |
|--------|--------|-------------|
| Terreno | TER | Solo terreno preparado |
| Cimentacion | CIM | En proceso de cimentacion |
| Estructura | EST | En proceso estructural |
| Acabados | ACA | En acabados interiores/exteriores |
| Terminada | TRM | Construccion completa |
| Entregada | ENT | Entregada al comprador |

---

**Creada por:** Requirements-Analyst
**Fecha:** 2025-12-05
