inmobiliaria-analytics/orchestration/environment/ENVIRONMENT-INVENTORY.yml

# =============================================================================
# ENVIRONMENT-INVENTORY.yml - INMOBILIARIA-ANALYTICS
# =============================================================================
# Inventario de Entorno de Desarrollo
# Generado por: @PERFIL_DEVENV
# Estado: RESERVADO (pendiente de implementacion)
# =============================================================================

version: "1.0.0"
fecha_creacion: "2026-01-04"
fecha_actualizacion: "2026-01-04"
responsable: "@PERFIL_DEVENV"
estado: "RESERVADO"

# -----------------------------------------------------------------------------
# IDENTIFICACION DEL PROYECTO
# -----------------------------------------------------------------------------

proyecto:
  nombre: "Inmobiliaria Analytics"
  alias: "inmobiliaria"
  nivel: "NIVEL_2A"
  tipo: "standalone"
  estado: "reservado"
  descripcion: "Plataforma de analitica inmobiliaria"

# -----------------------------------------------------------------------------
# HERRAMIENTAS Y RUNTIME (PLANIFICADO)
# -----------------------------------------------------------------------------

herramientas:
  runtime:
    node:
      version: "20.x"
      requerido: true
      notas: "Para backend NestJS y frontend React"
    python:
      version: "3.11"
      requerido: false
      notas: "Opcional para ML"

  package_managers:
    npm:
      version: "10.x"
      requerido: true

  build_tools:
    - nombre: "Vite"
      version: "5.x"
      uso: "Frontend build"
    - nombre: "TypeScript"
      version: "5.x"
      uso: "Compilacion"
    - nombre: "NestJS CLI"
      version: "10.x"
      uso: "Backend build"

# -----------------------------------------------------------------------------
# SERVICIOS Y PUERTOS (RESERVADOS)
# -----------------------------------------------------------------------------

servicios:
  frontend:
    nombre: "inmobiliaria-frontend"
    framework: "React"
    version: "18.x"
    puerto: 3100
    ubicacion: "apps/frontend/"
    url_local: "http://localhost:3100"
    estado: "reservado"

  backend:
    nombre: "inmobiliaria-backend"
    framework: "NestJS"
    version: "10.x"
    puerto: 3101
    ubicacion: "apps/backend/"
    url_local: "http://localhost:3101"
    api_prefix: "/api/v1"
    estado: "reservado"

# -----------------------------------------------------------------------------
# BASE DE DATOS (RESERVADO)
# -----------------------------------------------------------------------------

base_de_datos:
  principal:
    engine: "PostgreSQL"
    version: "15"
    host: "localhost"
    puerto: 5439

    ambientes:
      development:
        nombre: "inmobiliaria_development"
        usuario: "inmobiliaria_dev"
        password_ref: "DB_PASSWORD en .env"

      test:
        nombre: "inmobiliaria_test"
        usuario: "inmobiliaria_dev"
        password_ref: "DB_PASSWORD en .env"

    schemas:
      - nombre: "public"
        descripcion: "Schema principal"

    conexion_ejemplo: "postgresql://inmobiliaria_dev:{password}@localhost:5439/inmobiliaria_development"
    estado: "reservado - BD no creada aun"

  redis:
    host: "localhost"
    puerto: 6386
    uso: "cache, sessions"
    estado: "reservado"

# -----------------------------------------------------------------------------
# VARIABLES DE ENTORNO (TEMPLATE)
# -----------------------------------------------------------------------------

variables_entorno:
  archivo_ejemplo: ".env.example"
  estado: "pendiente de crear"

  variables:
    - nombre: "NODE_ENV"
      descripcion: "Ambiente de ejecucion"
      requerido: true
      ejemplo: "development"

    - nombre: "PORT"
      descripcion: "Puerto del servidor backend"
      requerido: true
      ejemplo: "3101"

    - nombre: "DATABASE_URL"
      descripcion: "Connection string de PostgreSQL"
      requerido: true
      ejemplo: "postgresql://inmobiliaria_dev:password@localhost:5439/inmobiliaria_development"

    - nombre: "REDIS_URL"
      descripcion: "Connection string de Redis"
      requerido: true
      ejemplo: "redis://localhost:6386"

    - nombre: "JWT_SECRET"
      descripcion: "Secreto para JWT"
      requerido: true
      sensible: true

# -----------------------------------------------------------------------------
# NOTAS DE IMPLEMENTACION
# -----------------------------------------------------------------------------

notas_implementacion: |
  ## Estado: RESERVADO

  Este proyecto tiene puertos y recursos reservados pero aun no esta implementado.

  ### Recursos Reservados:
  - Puertos: 3100-3101
  - PostgreSQL: puerto 5439
  - Redis: puerto 6386
  - BD: inmobiliaria_development / inmobiliaria_dev

  ### Pasos para Activar:
  1. Crear estructura de proyecto
  2. Crear BD y usuario
  3. Configurar .env.example
  4. Actualizar estado a "desarrollo"  

# -----------------------------------------------------------------------------
# REFERENCIAS
# -----------------------------------------------------------------------------

referencias:
  perfil_devenv: "orchestration/agents/perfiles/PERFIL-DEVENV.md"
  inventario_master: "orchestration/inventarios/DEVENV-MASTER-INVENTORY.yml"
  inventario_puertos: "orchestration/inventarios/DEVENV-PORTS-INVENTORY.yml"

# =============================================================================
# FIN DE INVENTARIO
# =============================================================================