rckrdmrd/inmobiliaria-analytics
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
inmobiliaria-analytics/docs/99-analisis/ANALISIS-REESTRUCTURACION-2026-01-04.md
rckrdmrd f570727617 feat: Documentation and orchestration updates 
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 05:35:40 -06:00

12 KiB
Raw Permalink Blame History

id title type status project reference created_date updated_date
ANALISIS-REESTRUCTURACION Analisis de Reestructuracion de Documentacion Analysis Document Active inmobiliaria-analytics gamilit 2026-01-04 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