[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure

- Move 2 non-standard folders to _archive/
- Create 3 missing obligatory files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-01-24 14:38:29 -06:00
parent b1ea3342a3
commit e12f73bdda
9 changed files with 607 additions and 47 deletions

1
backend Submodule

@ -0,0 +1 @@
Subproject commit 7fad97a72d5403dc7c79f9fcb78ba8f9a2f53db2

1
database Submodule

@ -0,0 +1 @@
Subproject commit c817594bb604e8e62fbd09bba7b9bb89e1dcc835

1
frontend Submodule

@ -0,0 +1 @@
Subproject commit 1cd8f932ceadba338c39061dcb0b26cb745c8aa0

View File

@ -0,0 +1,232 @@
# ===============================================================================
# MAPA DE DOCUMENTACION - INMOBILIARIA-ANALYTICS
# ===============================================================================
#
# Proposito: Centro de referencias a toda la documentacion del proyecto
# Alias: @INMO_MAPA_DOC
# Herencia: STANDALONE (hereda directivas de workspace-v2)
# Estado: IDEA (P4 - Backlog)
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-24"
updated: "2026-01-24"
proyecto: "inmobiliaria-analytics"
tipo: "STANDALONE"
hereda_de: "workspace-v2"
nivel: "CONSUMER (L2)"
estado: "IDEA"
prioridad: "P4"
# -------------------------------------------------------------------------------
# DOCUMENTACION DE USUARIO (docs/)
# -------------------------------------------------------------------------------
docs:
raiz:
README.md:
alias: "@INMO_README"
descripcion: "Punto de entrada del proyecto"
estado: "por crear"
vision:
ruta: "docs/00-vision-general/"
alias: "@INMO_VISION"
descripcion: "Vision, arquitectura, requerimientos"
estado: "por crear"
epicas:
ruta: "docs/01-epicas/"
alias: "@INMO_EPICAS"
descripcion: "Epicas del proyecto"
estado: "por crear"
# -------------------------------------------------------------------------------
# DOCUMENTACION OPERACIONAL (orchestration/)
# -------------------------------------------------------------------------------
orchestration:
raiz:
_MAP.md:
alias: "@INMO_ORCH_MAP"
descripcion: "Mapa de navegacion orchestration"
PROJECT-STATUS.md:
alias: "@INMO_STATUS"
descripcion: "Estado actual del proyecto"
PROXIMA-ACCION.md:
alias: "@INMO_NEXT"
descripcion: "Siguiente tarea a ejecutar"
BOOTLOADER.md:
alias: "@INMO_BOOT"
descripcion: "Protocolo de arranque NEXUS"
trazabilidad:
CONTEXT-MAP.yml:
alias: "@INMO_CONTEXT"
descripcion: "Mapeo de contexto NEXUS"
_inheritance.yml:
alias: "@INMO_INHERITANCE"
descripcion: "Herencia: STANDALONE desde workspace-v2"
DEPENDENCY-GRAPH.yml:
alias: "@INMO_DEPS"
descripcion: "Grafo de dependencias"
TRACEABILITY.yml:
alias: "@INMO_TRACE"
descripcion: "Trazabilidad del proyecto"
PROJECT-PROFILE.yml:
alias: "@INMO_PROFILE"
descripcion: "Perfil y metadata del proyecto"
guidelines:
ruta: "orchestration/00-guidelines/"
alias: "@INMO_GUIDELINES"
archivos:
CONTEXTO-PROYECTO.md:
alias: "@INMO_CONTEXTO"
descripcion: "Contexto y variables del proyecto"
HERENCIA-DIRECTIVAS.md:
alias: "@INMO_HERENCIA_DIR"
descripcion: "Herencia de directivas"
HERENCIA-SIMCO.md:
alias: "@INMO_HERENCIA_SIMCO"
descripcion: "Herencia del sistema SIMCO"
inventarios:
ruta: "orchestration/inventarios/"
alias: "@INMO_INV"
nota: "Inventarios vacios - proyecto en fase IDEA"
archivos:
MASTER_INVENTORY.yml:
alias: "@INMO_INV_MASTER"
estado: "vacio"
DATABASE_INVENTORY.yml:
alias: "@INMO_INV_DB"
estado: "vacio"
BACKEND_INVENTORY.yml:
alias: "@INMO_INV_BE"
estado: "vacio"
FRONTEND_INVENTORY.yml:
alias: "@INMO_INV_FE"
estado: "vacio"
trazas:
ruta: "orchestration/trazas/"
alias: "@INMO_TRAZAS"
archivos:
- TRAZA-TAREAS-BACKEND.md
- TRAZA-TAREAS-DATABASE.md
- TRAZA-TAREAS-FRONTEND.md
archivo:
ruta: "orchestration/_archive/"
descripcion: "Contenido archivado (no estandar)"
contenido:
- "environment/ - Configuracion de ambiente pre-estandarizacion"
- "estados/ - Estados de subagentes pre-estandarizacion"
# -------------------------------------------------------------------------------
# REFERENCIAS AL WORKSPACE
# -------------------------------------------------------------------------------
workspace_refs:
directivas:
alias: "@WS_DIRECTIVAS"
ruta: "workspace-v2/orchestration/directivas/"
descripcion: "Directivas SIMCO del workspace"
simco:
alias: "@WS_SIMCO"
ruta: "workspace-v2/orchestration/directivas/simco/"
descripcion: "Sistema SIMCO"
perfiles:
alias: "@WS_PERFILES"
ruta: "workspace-v2/orchestration/agents/perfiles/"
descripcion: "Perfiles de agentes"
templates:
alias: "@WS_TEMPLATES"
ruta: "workspace-v2/shared/templates/"
descripcion: "Templates compartidos"
# -------------------------------------------------------------------------------
# MODULOS PLANEADOS
# -------------------------------------------------------------------------------
modulos_planeados:
- id: "INMO-001"
nombre: "Analisis de Mercado"
descripcion: "Analisis de precios y tendencias"
estado: "idea"
- id: "INMO-002"
nombre: "Valuacion Automatizada"
descripcion: "Estimacion de valor de propiedades"
estado: "idea"
- id: "INMO-003"
nombre: "Comparativos"
descripcion: "Comparacion entre propiedades similares"
estado: "idea"
- id: "INMO-004"
nombre: "Reportes de Inversion"
descripcion: "ROI y analisis de rentabilidad"
estado: "idea"
# -------------------------------------------------------------------------------
# ESTADISTICAS
# -------------------------------------------------------------------------------
estadisticas:
docs:
total_archivos: 0
carpetas: 0
nota: "Proyecto en fase IDEA - sin documentacion de usuario"
orchestration:
total_archivos: 10
inventarios: 4
trazas: 3
total_aliases: 20
cobertura_documentacion: "0%"
ultima_auditoria: "2026-01-24"
# -------------------------------------------------------------------------------
# NAVEGACION RAPIDA POR ROL
# -------------------------------------------------------------------------------
por_rol:
orquestador:
inicio: "@INMO_STATUS"
siguiente: "@INMO_NEXT"
contexto: "@INMO_CONTEXT"
desarrollador:
nota: "Proyecto en fase IDEA - sin desarrollo activo"
permitido: "Solo documentacion y planeacion"
dba:
nota: "Proyecto en fase IDEA - sin base de datos"
# -------------------------------------------------------------------------------
# RESTRICCIONES P4
# -------------------------------------------------------------------------------
restricciones:
prioridad: "P4 (Backlog)"
permitido:
- "Documentacion de requerimientos"
- "Planeacion de arquitectura"
- "Definicion de epicas"
- "Investigacion de mercado"
bloqueado:
- "Desarrollo de codigo"
- "Implementacion de features"
- "Setup de infraestructura"
- "Testing"
razon: "Recursos limitados - priorizar proyectos P0-P3"
# ===============================================================================
# FIN DE MAPA DE DOCUMENTACION
# ===============================================================================

145
orchestration/_MAP.md Normal file
View File

@ -0,0 +1,145 @@
# MAPA DE ORQUESTACION: inmobiliaria-analytics
**Proyecto:** inmobiliaria-analytics
**Nivel:** CONSUMER (L2) - Estandar SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
**Sistema:** NEXUS v4.0 + SIMCO + SAAD
**Estado:** IDEA (P4 - Backlog)
**Ultima actualizacion:** 2026-01-24
---
## Estructura Estandarizada
```
orchestration/
├── _MAP.md # [OBLIGATORIO] Este archivo
├── _inheritance.yml # [OBLIGATORIO] Herencia (workspace-v2)
├── BOOTLOADER.md # [OBLIGATORIO] Protocolo de arranque
├── CONTEXT-MAP.yml # [OBLIGATORIO] Mapa de contexto NEXUS
├── PROJECT-PROFILE.yml # [OBLIGATORIO] Perfil del proyecto
├── PROJECT-STATUS.md # [OBLIGATORIO] Estado actual
├── PROXIMA-ACCION.md # [OBLIGATORIO] Checkpoint de sesion
├── DEPENDENCY-GRAPH.yml # [OBLIGATORIO] Dependencias
├── TRACEABILITY.yml # [OBLIGATORIO] Trazabilidad
├── MAPA-DOCUMENTACION.yml # [OBLIGATORIO] Mapa de docs
├── 00-guidelines/ # [OBLIGATORIO]
│ ├── CONTEXTO-PROYECTO.md # Descripcion del proyecto
│ ├── HERENCIA-DIRECTIVAS.md # Herencia de directivas
│ ├── HERENCIA-SIMCO.md # Herencia SIMCO
│ └── PROJECT-STATUS.md # Estado (duplicado)
├── inventarios/ # [OBLIGATORIO]
│ ├── MASTER_INVENTORY.yml # Inventario maestro
│ ├── DATABASE_INVENTORY.yml # Inventario BD
│ ├── BACKEND_INVENTORY.yml # Inventario Backend
│ └── FRONTEND_INVENTORY.yml # Inventario Frontend
├── trazas/ # [OBLIGATORIO]
│ ├── TRAZA-TAREAS-BACKEND.md
│ ├── TRAZA-TAREAS-DATABASE.md
│ └── TRAZA-TAREAS-FRONTEND.md
└── _archive/ # Carpetas archivadas (no estandar)
├── environment/ # Config de ambiente (archivado)
│ ├── ENVIRONMENT-INVENTORY.yml
│ └── PROJECT-ENV-CONFIG.yml
└── estados/ # Estados (archivado)
└── REGISTRO-SUBAGENTES.json
```
---
## Archivos Obligatorios (10/10)
| # | Archivo | Estado | Proposito |
|---|---------|--------|-----------|
| 1 | `_MAP.md` | OK | Mapa de navegacion |
| 2 | `_inheritance.yml` | OK | Herencia desde workspace-v2 |
| 3 | `BOOTLOADER.md` | OK | Protocolo de arranque NEXUS |
| 4 | `CONTEXT-MAP.yml` | OK | Mapa de contexto |
| 5 | `PROJECT-PROFILE.yml` | OK | Perfil y metadata |
| 6 | `PROJECT-STATUS.md` | OK | Estado actual |
| 7 | `PROXIMA-ACCION.md` | OK | Checkpoint de sesion |
| 8 | `DEPENDENCY-GRAPH.yml` | OK | Grafo de dependencias |
| 9 | `TRACEABILITY.yml` | OK | Trazabilidad |
| 10 | `MAPA-DOCUMENTACION.yml` | OK | Mapa de documentacion |
---
## Carpetas Obligatorias (3/3)
| # | Carpeta | Estado | Contenido |
|---|---------|--------|-----------|
| 1 | `00-guidelines/` | OK | Contexto y herencia del proyecto |
| 2 | `inventarios/` | OK | Inventarios por capa (vacios - proyecto IDEA) |
| 3 | `trazas/` | OK | Trazas de tareas por dominio |
---
## Carpetas Opcionales/Archivadas
| Carpeta | Estado | Nota |
|---------|--------|------|
| `_archive/` | OK | Contenido no estandar archivado |
| `_archive/environment/` | ARCHIVADO | Config de ambiente pre-estandarizacion |
| `_archive/estados/` | ARCHIVADO | Estados de subagentes pre-estandarizacion |
---
## Navegacion
| Destino | Enlace |
|---------|--------|
| Documentacion proyecto | [../docs/](../docs/) |
| Orchestration Workspace | [../../../orchestration/_MAP.md](../../../orchestration/_MAP.md) |
| Directivas SIMCO | [../../../orchestration/directivas/simco/](../../../orchestration/directivas/simco/) |
| Estandar Orchestration | [../../../orchestration/directivas/simco/SIMCO-ESTANDAR-ORCHESTRATION.md](../../../orchestration/directivas/simco/SIMCO-ESTANDAR-ORCHESTRATION.md) |
---
## Informacion del Proyecto
| Campo | Valor |
|-------|-------|
| **Nombre** | Inmobiliaria Analytics |
| **Alias** | INMO |
| **Tipo** | STANDALONE |
| **Estado** | IDEA |
| **Prioridad** | P4 (Backlog) |
| **Completitud** | 0% |
| **En Produccion** | No |
---
## Restricciones P4
**Permitido:**
- Documentacion de requerimientos
- Planeacion de arquitectura
- Definicion de epicas
- Investigacion de mercado
**Bloqueado:**
- Desarrollo de codigo
- Implementacion de features
- Setup de infraestructura
- Testing
---
## Validacion
**Nivel:** CONSUMER (L2)
**Requisitos:** 10 archivos root + 3 carpetas obligatorias
**Estado:** CUMPLE
```
Archivos root: 10/10
Carpetas: 3/3 (+1 archivo: _archive)
_inheritance.yml: tipo=STANDALONE, hereda_de=workspace-v2
```
---
**Reestructurado:** 2026-01-24 segun SIMCO-ESTANDAR-ORCHESTRATION v1.0.0

View File

@ -1,47 +1,47 @@
# =============================================================================
# PROJECT-ENV-CONFIG.yml
# Configuración de Ambiente específica del proyecto INMOBILIARIA-ANALYTICS
# =============================================================================
# Proyecto: INMOBILIARIA-ANALYTICS - Análisis del Mercado Inmobiliario
# Actualizado: 2025-12-05
# Referencia: ~/workspace/core/devtools/environment/DEV-ENVIRONMENT-REGISTRY.yml
# =============================================================================
project:
name: "INMOBILIARIA_ANALYTICS"
slug: "inmobiliaria-analytics"
description: "Plataforma de Análisis del Mercado Inmobiliario"
status: "development"
port_block: 3100
ports:
frontend: 3105
backend: 3106
ml_service: 8004
database:
host: "localhost"
port: 5432 # UNA sola instancia PostgreSQL
name: "inmobiliaria_analytics"
user: "inmobiliaria_user"
# password: Ver archivo .env local
urls:
frontend: "http://localhost:3105"
backend_api: "http://localhost:3106/api"
swagger: "http://localhost:3106/api/docs"
env_files:
backend: "apps/backend/.env"
frontend: "apps/frontend/.env"
stack:
backend: "NestJS + TypeScript"
frontend: "React + TypeScript + Vite"
database: "PostgreSQL 15"
ml_service: "FastAPI + Python"
notes: |
- Proyecto en desarrollo inicial
- Servicio ML para análisis predictivo del mercado
- Base de datos: inmobiliaria_analytics (en instancia PostgreSQL compartida)
# =============================================================================
# PROJECT-ENV-CONFIG.yml
# Configuración de Ambiente específica del proyecto INMOBILIARIA-ANALYTICS
# =============================================================================
# Proyecto: INMOBILIARIA-ANALYTICS - Análisis del Mercado Inmobiliario
# Actualizado: 2025-12-05
# Referencia: ~/workspace/core/devtools/environment/DEV-ENVIRONMENT-REGISTRY.yml
# =============================================================================
project:
name: "INMOBILIARIA_ANALYTICS"
slug: "inmobiliaria-analytics"
description: "Plataforma de Análisis del Mercado Inmobiliario"
status: "development"
port_block: 3100
ports:
frontend: 3105
backend: 3106
ml_service: 8004
database:
host: "localhost"
port: 5432 # UNA sola instancia PostgreSQL
name: "inmobiliaria_analytics"
user: "inmobiliaria_user"
# password: Ver archivo .env local
urls:
frontend: "http://localhost:3105"
backend_api: "http://localhost:3106/api"
swagger: "http://localhost:3106/api/docs"
env_files:
backend: "apps/backend/.env"
frontend: "apps/frontend/.env"
stack:
backend: "NestJS + TypeScript"
frontend: "React + TypeScript + Vite"
database: "PostgreSQL 15"
ml_service: "FastAPI + Python"
notes: |
- Proyecto en desarrollo inicial
- Servicio ML para análisis predictivo del mercado
- Base de datos: inmobiliaria_analytics (en instancia PostgreSQL compartida)

View File

@ -0,0 +1,180 @@
# ===============================================================================
# DECLARACION DE HERENCIA - INMOBILIARIA-ANALYTICS
# ===============================================================================
#
# Proyecto: inmobiliaria-analytics
# Descripcion: Plataforma de analitica del sector inmobiliario para analisis
# de mercado, valuacion de propiedades y tendencias.
# Nivel: CONSUMER (L2) - Proyecto STANDALONE
# Estado: IDEA (P4 - Backlog)
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-24"
updated: "2026-01-24"
proyecto: "inmobiliaria-analytics"
updated_by: "Claude Opus 4.5 - Reestructuracion SIMCO v1.0.0"
# -----------------------------------------------------------------------------
# RELACION DE HERENCIA
# -----------------------------------------------------------------------------
herencia:
parent: "workspace-v2"
parent_version: "2.5.0"
tipo: "STANDALONE"
cadena: "workspace-v2 -> inmobiliaria-analytics"
descripcion: "Proyecto independiente que hereda directivas del workspace"
# -----------------------------------------------------------------------------
# ESTADO DEL PROYECTO
# -----------------------------------------------------------------------------
estado:
general: "idea"
madurez: "conceptual"
completitud: "0%"
prioridad: "P4"
en_produccion: false
# -----------------------------------------------------------------------------
# STACK TECNOLOGICO (PLANIFICADO)
# -----------------------------------------------------------------------------
configuracion:
stack:
backend: "Por definir (posiblemente NestJS)"
frontend: "Por definir (posiblemente React)"
database: "Por definir (posiblemente PostgreSQL)"
analytics: "Por definir"
puertos:
backend: "Por reservar"
frontend: "Por reservar"
database: "5432 (instancia compartida)"
# -----------------------------------------------------------------------------
# MODULOS PLANIFICADOS
# -----------------------------------------------------------------------------
modulos:
# Modulos heredados del workspace (directivas y templates)
heredados:
- name: "directivas-simco"
version: "4.3.0"
status: "active"
descripcion: "Sistema SIMCO de orquestacion"
origen: "workspace-v2/orchestration/directivas/"
- name: "nexus"
version: "4.0"
status: "active"
descripcion: "Sistema de gestion de contexto"
origen: "workspace-v2/orchestration/directivas/simco/"
# Modulos propios del proyecto (en fase idea)
propios:
- name: "analisis-mercado"
id: "INMO-001"
estado: "idea"
descripcion: "Analisis de precios y tendencias del mercado"
- name: "valuacion-automatizada"
id: "INMO-002"
estado: "idea"
descripcion: "Estimacion automatica de valor de propiedades"
- name: "comparativos"
id: "INMO-003"
estado: "idea"
descripcion: "Comparacion entre propiedades similares"
- name: "reportes-inversion"
id: "INMO-004"
estado: "idea"
descripcion: "ROI y analisis de rentabilidad"
# -----------------------------------------------------------------------------
# CONSUMIDORES
# -----------------------------------------------------------------------------
consumidores:
# inmobiliaria-analytics es aplicacion final, no tiene consumidores
proyectos: []
# -----------------------------------------------------------------------------
# EXCLUSIONES
# -----------------------------------------------------------------------------
exclusiones:
modulos_excluidos:
- name: "erp-modules"
razon: "Proyecto standalone, no usa modulos ERP"
- name: "saas-modules"
razon: "No es proyecto SaaS multi-tenant"
# -----------------------------------------------------------------------------
# VALIDACION
# -----------------------------------------------------------------------------
validacion:
ultima_validacion: "2026-01-24"
estado_general: "IDEA"
completitud: "0%"
checklist:
- item: "Estructura orchestration estandarizada"
status: "passed"
- item: "Herencia declarada"
status: "passed"
- item: "Inventarios vacios (sin desarrollo)"
status: "passed"
- item: "Prioridad P4 confirmada"
status: "passed"
restricciones:
permitido:
- "Documentacion de requerimientos"
- "Planeacion de arquitectura"
- "Definicion de epicas"
- "Investigacion de mercado"
bloqueado:
- "Desarrollo de codigo"
- "Implementacion de features"
- "Setup de infraestructura"
- "Testing"
razon: "Recursos limitados - priorizar proyectos P0-P3"
# -----------------------------------------------------------------------------
# PROPAGACION
# -----------------------------------------------------------------------------
propagacion:
recibe_de:
- "workspace-v2/orchestration/directivas/"
propaga_a: []
config:
auto_doc: true
auto_def: true
auto_code: false
# -----------------------------------------------------------------------------
# METADATA
# -----------------------------------------------------------------------------
metadata:
created_by: "Claude Opus 4.5"
created_at: "2026-01-24"
updated_by: "Claude Opus 4.5 - Reestructuracion SIMCO"
updated_at: "2026-01-24"
task_id: "TASK-2026-01-24-ESTANDARIZACION"
related_documents:
- "orchestration/CONTEXT-MAP.yml"
- "orchestration/DEPENDENCY-GRAPH.yml"
- "orchestration/PROJECT-PROFILE.yml"
- "orchestration/BOOTLOADER.md"
# ===============================================================================
# FIN DE DECLARACION DE HERENCIA
# ===============================================================================