erp-construccion/docs/08-epicas/EPIC-MAI-002-proyectos.md

122 lines
4.0 KiB
Markdown

# 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