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

4.0 KiB

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