inmobiliaria-analytics/docs/99-analisis/ANALISIS-REESTRUCTURACION-2026-01-04.md

---
id: "ANALISIS-REESTRUCTURACION"
title: "Analisis de Reestructuracion de Documentacion"
type: "Analysis Document"
status: "Active"
project: "inmobiliaria-analytics"
reference: "gamilit"
created_date: "2026-01-04"
updated_date: "2026-01-04"
---

# Analisis de Reestructuracion de Documentacion

## Resumen Ejecutivo

Este documento analiza la estructura actual de documentacion del proyecto inmobiliaria-analytics y propone una reestructuracion basada en los estandares del proyecto gamilit (NEXUS v3.4 + SIMCO).

---

## 1. PROBLEMAS IDENTIFICADOS

### 1.1 Conflictos de Numeracion de EPICs

**Estado Actual:**
```
IDs utilizados: IA-001, IA-004, IA-005, IA-006, IA-007, IA-008
IDs faltantes:  IA-002, IA-003
```

**Problema:** Hay saltos en la numeracion (IA-002 y IA-003 no existen), violando la secuencia continua que se espera en un sistema de documentacion estructurado.

**Impacto:** Confusion sobre si existen modulos no documentados o si se eliminaron.

### 1.2 Nomenclatura de IDs Inconsistente

**Gamilit usa:**
- `EAI-NNN` = Epic Alcance Inicial
- `EXT-NNN` = Extension
- `EMR-NNN` = Migracion

**Inmobiliaria usa:**
- `IA-NNN` = Generico (sin indicar fase)

**Problema:** No es posible distinguir a que fase pertenece un EPIC solo por su ID.

### 1.3 Prefijos de User Stories No Estandarizados

**Gamilit usa:**
```
US-[CODIGO_EPIC]-NNN-slug.md
Ejemplo: US-FUND-001-autenticacion-basica-jwt.md
```

**Inmobiliaria usa:**
```
IA-007: US-SCR-NNN (SCR = Scraper)
IA-008: US-ML-NNN  (ML = Machine Learning)
```

**Problema:** Los prefijos no siguen el patron `US-[EPIC]-NNN` y usan mnemonicos arbitrarios.

### 1.4 Estructura de Carpetas Incompleta

**Carpetas vacias sin proposito claro:**
```
/03-requerimientos/        (vacio - deberia eliminarse)
/05-user-stories/          (vacio - deberia eliminarse)
/06-test-plans/            (vacio - deberia eliminarse)
/07-devops/                (vacio - deberia eliminarse)
/01-analisis-referencias/  (vacio - deberia eliminarse)
```

**Carpetas faltantes en EPICs (segun gamilit):**
```
/IA-007-webscraper/tareas/         (falta)
/IA-008-ml-analytics/tareas/       (falta)
```

### 1.5 Modulos vs EPICs Mezclados

**Problema:** En `/02-definicion-modulos/` hay definiciones de alto nivel que deberian ser EPICs completas en `/01-fase-alcance-inicial/`.

**Estado actual:**
- IA-004-TENANTS (solo definicion, no tiene EPIC estructurada)
- IA-005-PAYMENTS (solo definicion, no tiene EPIC estructurada)
- IA-006-PORTALS (solo definicion, no tiene EPIC estructurada)

---

## 2. PROPUESTA DE NUEVA ESTRUCTURA DE IDs

### 2.1 Convencion de Nomenclatura Propuesta

**Formato de EPICs:**
```
IAI-NNN = Inmobiliaria Analytics - Alcance Inicial
IAE-NNN = Inmobiliaria Analytics - Extension
IAM-NNN = Inmobiliaria Analytics - Migracion
```

### 2.2 Nueva Numeracion de EPICs

| ID Actual | ID Propuesto | Nombre | Fase |
|-----------|--------------|--------|------|
| IA-001 | IAI-001 | Fundamentos | Alcance Inicial |
| *(nuevo)* | IAI-002 | Propiedades (CRUD base) | Alcance Inicial |
| *(nuevo)* | IAI-003 | Usuarios y Perfiles | Alcance Inicial |
| IA-004 | IAI-004 | Multi-Tenancy | Alcance Inicial |
| IA-005 | IAI-005 | Pagos (Stripe) | Alcance Inicial |
| IA-006 | IAI-006 | Portales | Alcance Inicial |
| IA-007 | IAI-007 | Web Scraping y ETL | Alcance Inicial |
| IA-008 | IAI-008 | ML Analytics | Alcance Inicial |

### 2.3 Nueva Nomenclatura de User Stories

**Formato propuesto:**
```
US-[MODULO]-NNN-slug.md
```

**Mapeo de modulos:**
| EPIC | Codigo Modulo | Ejemplo |
|------|---------------|---------|
| IAI-001 | FUND | US-FUND-001-autenticacion.md |
| IAI-002 | PROP | US-PROP-001-crud-propiedades.md |
| IAI-003 | USER | US-USER-001-perfiles.md |
| IAI-004 | TENT | US-TENT-001-tenant-onboarding.md |
| IAI-005 | PAY | US-PAY-001-integracion-stripe.md |
| IAI-006 | PORT | US-PORT-001-portal-publico.md |
| IAI-007 | SCR | US-SCR-001-scraping-inmuebles24.md |
| IAI-008 | ML | US-ML-001-valuacion-avm.md |

**Nota:** Los prefijos actuales US-SCR-* y US-ML-* YA siguen esta convencion correctamente.

### 2.4 Nueva Nomenclatura de Requerimientos

**Formato propuesto:**
```
RF-[MODULO]-NNN-descripcion.md
```

**Mapeo actual a nuevo:**
| ID Actual | ID Propuesto |
|-----------|--------------|
| RF-IA-007-001 | RF-SCR-001 |
| RF-IA-007-002 | RF-SCR-002 |
| RF-IA-008-001 | RF-ML-001 |

### 2.5 Nueva Nomenclatura de Especificaciones

**Formato propuesto:**
```
ET-[MODULO]-NNN-descripcion.md
```

**Mapeo actual a nuevo:**
| ID Actual | ID Propuesto |
|-----------|--------------|
| ET-IA-007-scraper | ET-SCR-001-scraper.md |
| ET-IA-007-etl | ET-SCR-002-etl.md |
| ET-IA-007-proxies | ET-SCR-003-proxies.md |
| ET-IA-008-avm | ET-ML-001-avm.md |
| ET-IA-008-opportunities | ET-ML-002-opportunities.md |

---

## 3. PROPUESTA DE ESTRUCTURA DE CARPETAS

### 3.1 Estructura Raiz Propuesta

```
docs/
├── 00-vision-general/               # [MANTENER]
│   ├── _MAP.md
│   ├── VISION-PRODUCTO.md
│   ├── ARQUITECTURA-GENERAL.md
│   ├── STACK-TECNOLOGICO.md
│   └── GLOSARIO.md                  # [AGREGAR]
│
├── 01-fase-alcance-inicial/         # [REESTRUCTURAR]
│   ├── _MAP.md
│   ├── IAI-001-fundamentos/
│   ├── IAI-002-propiedades/         # [AGREGAR]
│   ├── IAI-003-usuarios/            # [AGREGAR]
│   ├── IAI-004-tenants/             # [AGREGAR desde 02-definicion]
│   ├── IAI-005-pagos/               # [AGREGAR desde 02-definicion]
│   ├── IAI-006-portales/            # [AGREGAR desde 02-definicion]
│   ├── IAI-007-webscraper/          # [RENOMBRAR desde IA-007]
│   └── IAI-008-ml-analytics/        # [RENOMBRAR desde IA-008]
│
├── 02-fase-robustecimiento/         # [AGREGAR - futuro]
│   └── _MAP.md
│
├── 03-fase-extensiones/             # [AGREGAR - futuro]
│   └── _MAP.md
│
├── 04-fase-backlog/                 # [MANTENER]
│   ├── _MAP.md
│   ├── DEFINITION-OF-READY.md
│   └── DEFINITION-OF-DONE.md
│
├── 90-transversal/                  # [EXPANDIR]
│   ├── _MAP.md
│   ├── api/
│   ├── arquitectura/
│   ├── inventarios/
│   └── roadmap/
│
├── 95-guias-desarrollo/             # [EXPANDIR]
│   ├── _MAP.md
│   ├── backend/
│   ├── frontend/
│   └── testing/
│
├── 96-quick-reference/              # [MANTENER]
│   └── _MAP.md
│
├── 97-adr/                          # [MANTENER]
│   ├── _MAP.md
│   ├── README.md
│   └── ADR-NNN-*.md
│
├── 99-analisis/                     # [MANTENER]
│   └── *.md
│
├── _MAP.md                          # [MANTENER]
└── README.md                        # [MANTENER]
```

### 3.2 Estructura de Cada EPIC

```
IAI-NNN-nombre/
├── README.md                    # Vision del EPIC
├── _MAP.md                      # Indice de navegacion
│
├── requerimientos/              # Requerimientos Funcionales
│   ├── _MAP.md
│   └── RF-[MOD]-NNN-*.md
│
├── especificaciones/            # Especificaciones Tecnicas
│   ├── _MAP.md
│   └── ET-[MOD]-NNN-*.md
│
├── historias-usuario/           # User Stories
│   ├── _MAP.md
│   └── US-[MOD]-NNN-*.md
│
├── tareas/                      # Tareas Tecnicas [AGREGAR]
│   ├── _MAP.md
│   └── TASK-[AREA]-[MOD]-NNN-*.md
│
└── implementacion/              # Docs de implementacion
    ├── _MAP.md
    ├── CHANGELOG.md
    ├── TRACEABILITY.yml
    ├── BACKEND.yml
    ├── DATABASE.yml
    └── FRONTEND.yml
```

---

## 4. CARPETAS A ELIMINAR

Las siguientes carpetas vacias deben eliminarse:

```
/03-requerimientos/           # Vacia - requerimientos estan en EPICs
/05-user-stories/             # Vacia - US estan en EPICs
/06-test-plans/               # Vacia - mover a 90-transversal/testing/
/07-devops/                   # Vacia - mover a 90-transversal/devops/
/01-analisis-referencias/     # Vacia - mover contenido a 99-analisis/
/04-modelado/                 # Vacia - mover a 90-transversal/arquitectura/
/02-definicion-modulos/       # Contenido mover a EPICs respectivas
```

---

## 5. PLAN DE MIGRACION

### Fase 1: Preparacion (1h)
1. Crear backup de documentacion actual
2. Crear nuevas carpetas de estructura
3. Crear _MAP.md para carpetas nuevas

### Fase 2: Renombrado de EPICs (2h)
1. Renombrar IA-007 -> IAI-007
2. Renombrar IA-008 -> IAI-008
3. Actualizar todos los IDs en frontmatter
4. Actualizar referencias cruzadas

### Fase 3: Migracion de Modulos (2h)
1. Mover IA-004-TENANTS a IAI-004-tenants/
2. Mover IA-005-PAYMENTS a IAI-005-pagos/
3. Mover IA-006-PORTALS a IAI-006-portales/
4. Crear estructura EPIC completa para cada uno

### Fase 4: Limpieza (1h)
1. Eliminar carpetas vacias
2. Eliminar /02-definicion-modulos/ (ya migrado)
3. Actualizar _MAP.md raiz
4. Validar enlaces

### Fase 5: Documentacion Faltante (2h)
1. Crear IAI-002-propiedades/ (estructura basica)
2. Crear IAI-003-usuarios/ (estructura basica)
3. Agregar tareas/ a EPICs existentes
4. Agregar GLOSARIO.md

---

## 6. COMPARACION: ANTES vs DESPUES

### IDs de EPICs

| Antes | Despues | Cambio |
|-------|---------|--------|
| IA-001 | IAI-001 | Prefijo |
| - | IAI-002 | Nuevo |
| - | IAI-003 | Nuevo |
| IA-004 | IAI-004 | Prefijo + Estructura |
| IA-005 | IAI-005 | Prefijo + Estructura |
| IA-006 | IAI-006 | Prefijo + Estructura |
| IA-007 | IAI-007 | Prefijo |
| IA-008 | IAI-008 | Prefijo |

### IDs de Requerimientos

| Antes | Despues |
|-------|---------|
| RF-IA-007-001 | RF-SCR-001 |
| RF-IA-007-002 | RF-SCR-002 |
| RF-IA-007-003 | RF-SCR-003 |
| RF-IA-007-004 | RF-SCR-004 |
| RF-IA-007-005 | RF-SCR-005 |
| RF-IA-008-001 | RF-ML-001 |
| RF-IA-008-002 | RF-ML-002 |
| RF-IA-008-003 | RF-ML-003 |
| RF-IA-008-004 | RF-ML-004 |

### IDs de User Stories

| Antes | Despues | Notas |
|-------|---------|-------|
| US-SCR-001 | US-SCR-001 | Sin cambio |
| US-SCR-002 | US-SCR-002 | Sin cambio |
| US-SCR-003 | US-SCR-003 | Sin cambio |
| US-SCR-004 | US-SCR-004 | Sin cambio |
| US-SCR-005 | US-SCR-005 | Sin cambio |
| US-ML-001 | US-ML-001 | Sin cambio |
| US-ML-002 | US-ML-002 | Sin cambio |
| US-ML-003 | US-ML-003 | Sin cambio |
| US-ML-004 | US-ML-004 | Sin cambio |
| US-ML-005 | US-ML-005 | Sin cambio |
| US-ML-006 | US-ML-006 | Sin cambio |
| US-ML-007 | US-ML-007 | Sin cambio |
| US-ML-008 | US-ML-008 | Sin cambio |

### IDs de Especificaciones

| Antes | Despues |
|-------|---------|
| ET-IA-007-scraper | ET-SCR-001-scraper |
| ET-IA-007-etl | ET-SCR-002-etl |
| ET-IA-007-proxies | ET-SCR-003-proxies |
| ET-IA-008-avm | ET-ML-001-avm |
| ET-IA-008-opportunities | ET-ML-002-opportunities |

---

## 7. CHECKLIST DE VALIDACION

### Post-Migracion

- [ ] Todos los EPICs tienen ID unico secuencial (IAI-001 a IAI-008)
- [ ] Todos los RF siguen formato RF-[MOD]-NNN
- [ ] Todos los US siguen formato US-[MOD]-NNN
- [ ] Todos los ET siguen formato ET-[MOD]-NNN
- [ ] Cada EPIC tiene: README, _MAP, requerimientos/, especificaciones/, historias-usuario/, tareas/, implementacion/
- [ ] No hay carpetas vacias sin proposito
- [ ] Todos los _MAP.md estan actualizados
- [ ] Referencias cruzadas funcionan

---

## 8. DECISION REQUERIDA

**Opcion A: Migracion Completa**
- Renombrar todos los IDs
- Reestructurar completamente
- ~8 horas de trabajo
- Consistencia total con gamilit

**Opcion B: Migracion Parcial**
- Mantener IDs actuales (IA-*)
- Solo agregar estructura faltante
- ~4 horas de trabajo
- Consistencia parcial

**Opcion C: Solo Documentar**
- No hacer cambios estructurales
- Documentar convenciones actuales
- ~1 hora de trabajo
- Sin migracion

**Recomendacion:** Opcion A para proyectos nuevos, Opcion B si ya hay codigo que referencia IDs actuales.

---

**Autor:** Sistema de Orquestacion
**Fecha:** 2026-01-04
**Version:** 1.0