# ==============================================================================
# PORTS REGISTRY - Control Plane
# ==============================================================================
# Proposito: Registro centralizado de puertos para evitar conflictos
# Mantenido por: DevOps-Agent
# Actualizado: 2025-12-18
# ==============================================================================

version: "1.0.0"
updated: "2025-12-18"

# ------------------------------------------------------------------------------
# REGLAS GLOBALES
# ------------------------------------------------------------------------------
rules:
  public_ingress_only:
    description: "Solo el reverse proxy expone puertos al publico"
    enforcement: "required"
    allowed_public_ports:
      - 80   # HTTP
      - 443  # HTTPS

  internal_ranges:
    description: "Rangos reservados por tipo de servicio"
    backend_api: "3000-3099"
    frontend_web: "3100-3199"
    microservices: "3200-3299"
    databases: "5432-5499"
    cache: "6379-6399"
    monitoring: "9000-9099"
    ml_services: "8000-8099"

# ------------------------------------------------------------------------------
# ASIGNACIONES - INFRAESTRUCTURA
# ------------------------------------------------------------------------------
infrastructure:
  traefik:
    description: "Reverse proxy principal"
    public:
      - 80
      - 443
    internal:
      dashboard: 8080

  postgres:
    description: "Base de datos PostgreSQL compartida"
    internal: 5432

  redis:
    description: "Cache Redis"
    internal: 6379

  prometheus:
    description: "Metricas"
    internal: 9090

  grafana:
    description: "Dashboards de monitoreo"
    internal: 9091

  pgadmin:
    description: "Admin de PostgreSQL"
    internal: 5050

# ------------------------------------------------------------------------------
# ASIGNACIONES - PROYECTOS
# ------------------------------------------------------------------------------
projects:

  # ============================================================================
  # GAMILIT - Plataforma de gamificacion educativa
  # ============================================================================
  gamilit:
    description: "Plataforma de gamificacion educativa"
    status: "active"
    services:
      api:
        internal: 3000
        protocol: "http"
        healthcheck: "/health"
        description: "API principal NestJS"
      web:
        internal: 3001
        protocol: "http"
        description: "Frontend React"
      websocket:
        internal: 3002
        protocol: "ws"
        description: "WebSocket server para tiempo real"

  # ============================================================================
  # ERP SUITE - Suite ERP Multi-Vertical
  # ============================================================================
  erp_suite:
    description: "Suite ERP multi-vertical - Core"
    status: "active"
    services:
      api:
        internal: 3010
        protocol: "http"
        healthcheck: "/health"
        description: "API Core del ERP"
      web:
        internal: 3011
        protocol: "http"
        description: "Frontend Core del ERP"

  erp_construccion:
    description: "Vertical de construccion"
    status: "active"
    services:
      api:
        internal: 3012
        protocol: "http"
        healthcheck: "/health"
      web:
        internal: 3013
        protocol: "http"

  erp_mecanicas:
    description: "Vertical de mecanicas diesel"
    status: "active"
    services:
      api:
        internal: 3014
        protocol: "http"
        healthcheck: "/health"
      web:
        internal: 3015
        protocol: "http"

  erp_vidrio:
    description: "Vertical de vidrio templado"
    status: "planned"
    services:
      api:
        internal: 3016
        protocol: "http"
      web:
        internal: 3017
        protocol: "http"

  erp_retail:
    description: "Vertical de retail"
    status: "planned"
    services:
      api:
        internal: 3018
        protocol: "http"
      web:
        internal: 3019
        protocol: "http"

  # ============================================================================
  # TRADING PLATFORM - Plataforma de trading (3040-3049)
  # ============================================================================
  trading:
    description: "Plataforma de analisis y trading"
    status: "active"
    services:
      api:
        internal: 3081
        protocol: "http"
        healthcheck: "/health"
        description: "API principal Express"
      web:
        internal: 3080
        protocol: "http"
        description: "Frontend React"
      websocket:
        internal: 3082
        protocol: "ws"
        description: "WebSocket server"
      ml_engine:
        internal: 3083
        protocol: "http"
        healthcheck: "/health"
        description: "Motor ML FastAPI"
      data_service:
        internal: 3084
        protocol: "http"
        healthcheck: "/health"
        description: "Servicio de datos de mercado"
      llm_agent:
        internal: 3085
        protocol: "http"
        healthcheck: "/health"
        description: "Agente LLM FastAPI"
      trading_agents:
        internal: 3086
        protocol: "http"
        healthcheck: "/health"
        description: "Agentes de trading automatizado"

  # ============================================================================
  # BETTING ANALYTICS - Analytics de apuestas (3050-3059)
  # ============================================================================
  betting:
    description: "Plataforma de analytics de apuestas"
    status: "planned"
    services:
      api:
        internal: 3050
        protocol: "http"
        healthcheck: "/health"
        description: "API principal FastAPI"
      web:
        internal: 3051
        protocol: "http"
        description: "Frontend React"
      ml_engine:
        internal: 3053
        protocol: "http"
        healthcheck: "/health"
        description: "Motor ML para predicciones"

# ------------------------------------------------------------------------------
# VALIDACION
# ------------------------------------------------------------------------------
validation:
  script: "devtools/scripts/validation/validate-ports.sh"
  run_on:
    - "pre-commit"
    - "ci-pipeline"
  fail_on_conflict: true

  inmobiliaria:
    services:
      api:
        internal: 3100
        protocol: http
        description: "Inmobiliaria Analytics API"
      web:
        internal: 3101
        protocol: http
        description: "Inmobiliaria Analytics Frontend"
    status: planned

  platform_marketing:
    services:
      api:
        internal: 3110
        protocol: http
        description: "Platform Marketing API"
      web:
        internal: 3111
        protocol: http
        description: "Platform Marketing Frontend"
      comfyui:
        internal: 8188
        protocol: http
        description: "ComfyUI for content generation"
    status: active