# ═══════════════════════════════════════════════════════════════════════════════
# BACKEND_INVENTORY.yml - Trading Platform
# ═══════════════════════════════════════════════════════════════════════════════

version: "1.0.0"
fecha_actualizacion: "2026-01-24"
proyecto: "trading-platform"

# ═══════════════════════════════════════════════════════════════════════════════
# RESUMEN
# ═══════════════════════════════════════════════════════════════════════════════

resumen:
  total_modulos: 11
  total_controllers: 22
  total_services: 32
  total_endpoints: 50
  ubicacion: "apps/backend/src/"
  framework: "Express.js 5.0.1"
  lenguaje: "TypeScript 5.3.3"

# ═══════════════════════════════════════════════════════════════════════════════
# MODULOS
# ═══════════════════════════════════════════════════════════════════════════════

modulos:

  auth:
    descripcion: "Autenticacion OAuth, Email, SMS, 2FA"
    controllers: 5
    services: 5
    routes: 1
    dtos: 6
    servicios_detalle:
      - token.service.ts
      - email.service.ts
      - oauth.service.ts
      - phone.service.ts
      - twofa.service.ts

  users:
    descripcion: "Gestion de perfiles de usuario"
    controllers: 0
    services: 1
    routes: 1

  trading:
    descripcion: "Orders, trades, signals, bots"
    controllers: 0
    services: 8
    routes: 1
    servicios_detalle:
      - signal.service.ts
      - order.service.ts
      - trade.service.ts
      - bot.service.ts
      - watchlist.service.ts
      - position.service.ts
      - backtest.service.ts
      - market-data.service.ts

  education:
    descripcion: "Cursos, quizzes, gamificacion"
    controllers: 3
    services: 4
    routes: 1
    servicios_detalle:
      - course.service.ts
      - enrollment.service.ts
      - gamification.service.ts
      - quiz.service.ts

  investment:
    descripcion: "Productos, cuentas, portafolio"
    controllers: 0
    services: 3
    routes: 1
    servicios_detalle:
      - account.service.ts
      - product.service.ts
      - transaction.service.ts

  payments:
    descripcion: "Stripe, wallets, subscriptions"
    controllers: 0
    services: 3
    routes: 1
    servicios_detalle:
      - stripe.service.ts
      - wallet.service.ts
      - subscription.service.ts

  ml:
    descripcion: "Predicciones, modelos, backtesting"
    controllers: 0
    services: 6
    routes: 1
    servicios_detalle:
      - prediction.service.ts
      - model.service.ts
      - backtest.service.ts
      - feature.service.ts
      - risk.service.ts
      - ensemble.service.ts

  admin:
    descripcion: "Stats, modelos ML, agentes"
    controllers: 0
    services: 1
    routes: 1

  llm:
    descripcion: "LLM agent, estrategias"
    controllers: 0
    services: 1
    routes: 1

  agents:
    descripcion: "Trading agents orquestacion"
    controllers: 0
    services: 1
    routes: 1

  portfolio:
    descripcion: "Portfolio management"
    controllers: 0
    services: 1
    routes: 1

# ═══════════════════════════════════════════════════════════════════════════════
# RUTAS API
# ═══════════════════════════════════════════════════════════════════════════════

rutas_api:
  base: "/api/v1"
  endpoints:
    - path: "/auth"
      descripcion: "OAuth, Email, SMS, 2FA"
    - path: "/users"
      descripcion: "Perfil, settings"
    - path: "/trading"
      descripcion: "Orders, trades, signals, bots"
    - path: "/education"
      descripcion: "Cursos, quizzes, gamification"
    - path: "/investment"
      descripcion: "Productos, cuentas, transacciones"
    - path: "/payments"
      descripcion: "Stripe, wallets, subscriptions"
    - path: "/admin"
      descripcion: "Stats, ML models, agents"
    - path: "/ml"
      descripcion: "Predicciones, modelos"
    - path: "/llm"
      descripcion: "Estrategias LLM"
    - path: "/portfolio"
      descripcion: "Portafolio"
    - path: "/agents"
      descripcion: "Trading agents"

  health:
    - path: "/health"
      descripcion: "Quick check"
    - path: "/health/full"
      descripcion: "Sistema completo"
    - path: "/health/services"
      descripcion: "Health por servicio"

# ═══════════════════════════════════════════════════════════════════════════════
# INFRAESTRUCTURA
# ═══════════════════════════════════════════════════════════════════════════════

infraestructura:
  middleware:
    - auth.middleware.ts
    - error-handler.ts
    - not-found.ts
    - rate-limiter.ts

  websocket:
    - websocket.server.ts
    - trading-stream.service.ts

  config:
    - swagger.config.ts
    - index.ts

# ═══════════════════════════════════════════════════════════════════════════════
# INTEGRACIONES
# ═══════════════════════════════════════════════════════════════════════════════

integraciones:
  base_datos:
    - PostgreSQL
    - Redis
  pagos:
    - Stripe
  oauth:
    - Google
    - Facebook
    - GitHub
    - Apple
  comunicacion:
    - Twilio
    - Nodemailer
  llm:
    - OpenAI
    - Anthropic
  trading:
    - Binance
    - MetaTrader