diff --git a/backend b/backend new file mode 160000 index 0000000..7fad97a --- /dev/null +++ b/backend @@ -0,0 +1 @@ +Subproject commit 7fad97a72d5403dc7c79f9fcb78ba8f9a2f53db2 diff --git a/database b/database new file mode 160000 index 0000000..c817594 --- /dev/null +++ b/database @@ -0,0 +1 @@ +Subproject commit c817594bb604e8e62fbd09bba7b9bb89e1dcc835 diff --git a/frontend b/frontend new file mode 160000 index 0000000..1cd8f93 --- /dev/null +++ b/frontend @@ -0,0 +1 @@ +Subproject commit 1cd8f932ceadba338c39061dcb0b26cb745c8aa0 diff --git a/orchestration/MAPA-DOCUMENTACION.yml b/orchestration/MAPA-DOCUMENTACION.yml new file mode 100644 index 0000000..7d615d7 --- /dev/null +++ b/orchestration/MAPA-DOCUMENTACION.yml @@ -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 +# =============================================================================== diff --git a/orchestration/_MAP.md b/orchestration/_MAP.md new file mode 100644 index 0000000..78889fb --- /dev/null +++ b/orchestration/_MAP.md @@ -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 diff --git a/orchestration/environment/ENVIRONMENT-INVENTORY.yml b/orchestration/_archive/environment/ENVIRONMENT-INVENTORY.yml similarity index 100% rename from orchestration/environment/ENVIRONMENT-INVENTORY.yml rename to orchestration/_archive/environment/ENVIRONMENT-INVENTORY.yml diff --git a/orchestration/environment/PROJECT-ENV-CONFIG.yml b/orchestration/_archive/environment/PROJECT-ENV-CONFIG.yml similarity index 96% rename from orchestration/environment/PROJECT-ENV-CONFIG.yml rename to orchestration/_archive/environment/PROJECT-ENV-CONFIG.yml index 709f248..0251382 100644 --- a/orchestration/environment/PROJECT-ENV-CONFIG.yml +++ b/orchestration/_archive/environment/PROJECT-ENV-CONFIG.yml @@ -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) diff --git a/orchestration/estados/REGISTRO-SUBAGENTES.json b/orchestration/_archive/estados/REGISTRO-SUBAGENTES.json similarity index 100% rename from orchestration/estados/REGISTRO-SUBAGENTES.json rename to orchestration/_archive/estados/REGISTRO-SUBAGENTES.json diff --git a/orchestration/_inheritance.yml b/orchestration/_inheritance.yml new file mode 100644 index 0000000..fbb14ab --- /dev/null +++ b/orchestration/_inheritance.yml @@ -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 +# ===============================================================================