workspace/projects/erp-suite/apps/verticales/construccion/docs/08-epicas/EPIC-MAI-002-proyectos.md
rckrdmrd ea1879f4ad feat: Initial workspace structure with multi-level Git configuration
- Configure workspace Git repository with comprehensive .gitignore
- Add Odoo as submodule for ERP reference code
- Include documentation: SETUP.md, GIT-STRUCTURE.md
- Add gitignore templates for projects (backend, frontend, database)
- Structure supports independent repos per project/subproject level

Workspace includes:
- core/ - Reusable patterns, modules, orchestration system
- projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.)
- knowledge-base/ - Reference code and patterns (includes Odoo submodule)
- devtools/ - Development tools and templates
- customers/ - Client implementations template

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-08 10:44:23 -06:00

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