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

# =============================================================================
# ENVIRONMENT-INVENTORY.yml - BETTING-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: "Betting Analytics"
  alias: "betting"
  nivel: "NIVEL_2A"
  tipo: "standalone"
  estado: "reservado"
  descripcion: "Plataforma de analitica de apuestas deportivas"

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

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

  package_managers:
    npm:
      version: "10.x"
      requerido: true
    pip:
      version: "23.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: "betting-frontend"
    framework: "React"
    version: "18.x"
    puerto: 3090
    ubicacion: "apps/frontend/"
    url_local: "http://localhost:3090"
    estado: "reservado"

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

  ml_service:
    nombre: "betting-ml"
    framework: "FastAPI"
    puerto: 3092
    ubicacion: "apps/ml-service/"
    url_local: "http://localhost:3092"
    estado: "reservado"

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

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

    ambientes:
      development:
        nombre: "betting_development"
        usuario: "betting_dev"
        password_ref: "DB_PASSWORD en .env"

      test:
        nombre: "betting_test"
        usuario: "betting_dev"
        password_ref: "DB_PASSWORD en .env"

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

    conexion_ejemplo: "postgresql://betting_dev:{password}@localhost:5438/betting_development"
    estado: "reservado - BD no creada aun"

  redis:
    host: "localhost"
    puerto: 6385
    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: "3091"

    - nombre: "DATABASE_URL"
      descripcion: "Connection string de PostgreSQL"
      requerido: true
      ejemplo: "postgresql://betting_dev:password@localhost:5438/betting_development"

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

    - 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: 3090-3092
  - PostgreSQL: puerto 5438
  - Redis: puerto 6385
  - BD: betting_development / betting_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
# =============================================================================