# CATALOGO-MODULOS.yml
# Registro maestro de modulos genericos del Knowledge-Base
# Sistema: NEXUS v3.4 + SIMCO

version: "1.0.0"
fecha_actualizacion: "2026-01-04"
mantenedor: "Architecture-Analyst"
total_modulos: 37

categorias:
  # ============================================
  # AUTHENTICATION - Autenticacion y Autorizacion
  # ============================================
  authentication:
    nombre: "Autenticacion"
    descripcion: "Modulos para manejo de autenticacion y autorizacion"
    ruta_base: "modules/authentication/"
    modulos:
      - id: "auth-jwt-nestjs"
        nombre: "JWT Authentication (NestJS)"
        version: "2.1.0"
        estado: "production"
        proyectos_usando:
          - gamilit
          - erp-core
          - trading-platform
        caracteristicas:
          - JWT con refresh tokens
          - Guards y decoradores NestJS
          - Multi-tenant support
          - Rate limiting integrado
        ruta: "modules/authentication/jwt-nestjs/"

      - id: "auth-jwt-express"
        nombre: "JWT Authentication (Express)"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - pos-micro
        caracteristicas:
          - JWT basico
          - Middleware Express
          - Sesiones opcionales
        ruta: "modules/authentication/jwt-express/"

      - id: "auth-oauth2-google"
        nombre: "OAuth2 Google"
        version: "1.0.0"
        estado: "beta"
        proyectos_usando: []
        caracteristicas:
          - Google Sign-In
          - Passport.js integration
          - Token refresh
        ruta: "modules/authentication/oauth2-google/"

      - id: "auth-session-based"
        nombre: "Session Authentication"
        version: "1.0.0"
        estado: "production"
        proyectos_usando:
          - erp-suite
        caracteristicas:
          - Sesiones en Redis
          - CSRF protection
          - Remember me
        ruta: "modules/authentication/session-based/"

      - id: "auth-multi-tenant"
        nombre: "Multi-tenant Auth"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - Tenant isolation
          - Subdomain routing
          - RLS integration
        ruta: "modules/authentication/multi-tenant-auth/"

  # ============================================
  # PAYMENTS - Pasarelas de Pago
  # ============================================
  payments:
    nombre: "Pagos"
    descripcion: "Integracion con pasarelas de pago"
    ruta_base: "modules/payments/"
    modulos:
      - id: "payments-stripe-checkout"
        nombre: "Stripe Checkout"
        version: "3.0.0"
        estado: "production"
        proyectos_usando:
          - trading-platform
          - gamilit
        caracteristicas:
          - Checkout sessions
          - Webhooks handler
          - Multiple currencies
          - Test mode support
        ruta: "modules/payments/stripe-checkout/"

      - id: "payments-stripe-subscriptions"
        nombre: "Stripe Subscriptions"
        version: "2.5.0"
        estado: "production"
        proyectos_usando:
          - trading-platform
        caracteristicas:
          - Billing portal
          - Proration handling
          - Usage-based billing
          - Subscription lifecycle
        ruta: "modules/payments/stripe-subscriptions/"

      - id: "payments-paypal-standard"
        nombre: "PayPal Standard"
        version: "1.2.0"
        estado: "production"
        proyectos_usando: []
        caracteristicas:
          - PayPal buttons
          - IPN handler
          - Refunds support
        ruta: "modules/payments/paypal-standard/"

      - id: "payments-conekta-mexico"
        nombre: "Conekta (Mexico)"
        version: "1.0.0"
        estado: "beta"
        proyectos_usando: []
        caracteristicas:
          - OXXO payments
          - SPEI transfers
          - Card payments
        ruta: "modules/payments/conekta-mexico/"

  # ============================================
  # NOTIFICATIONS - Sistema de Notificaciones
  # ============================================
  notifications:
    nombre: "Notificaciones"
    descripcion: "Sistema de notificaciones multi-canal"
    ruta_base: "modules/notifications/"
    modulos:
      - id: "notifications-email-sendgrid"
        nombre: "Email (SendGrid)"
        version: "1.2.0"
        estado: "production"
        proyectos_usando:
          - gamilit
        caracteristicas:
          - Templates dinamicos
          - Tracking open/click
          - Batch sending
        ruta: "modules/notifications/email-sendgrid/"

      - id: "notifications-email-ses"
        nombre: "Email (AWS SES)"
        version: "1.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - High volume
          - Cost effective
          - Bounce handling
        ruta: "modules/notifications/email-ses/"

      - id: "notifications-push-firebase"
        nombre: "Push (Firebase)"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - gamilit
        caracteristicas:
          - FCM integration
          - Topic messaging
          - Data messages
        ruta: "modules/notifications/push-firebase/"

      - id: "notifications-sms-twilio"
        nombre: "SMS (Twilio)"
        version: "1.0.0"
        estado: "beta"
        proyectos_usando: []
        caracteristicas:
          - SMS sending
          - 2FA support
          - Delivery status
        ruta: "modules/notifications/sms-twilio/"

      - id: "notifications-in-app-websocket"
        nombre: "In-App (WebSocket)"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - trading-platform
        caracteristicas:
          - Real-time updates
          - Socket.io integration
          - Room-based messaging
        ruta: "modules/notifications/in-app-websocket/"

  # ============================================
  # USER-MANAGEMENT - Gestion de Usuarios
  # ============================================
  user-management:
    nombre: "Gestion de Usuarios"
    descripcion: "Modulos para gestion de usuarios y permisos"
    ruta_base: "modules/user-management/"
    modulos:
      - id: "users-roles-permissions"
        nombre: "Roles y Permisos (RBAC)"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
          - gamilit
        caracteristicas:
          - Role-based access
          - Permission guards
          - Hierarchy support
        ruta: "modules/user-management/roles-permissions/"

      - id: "users-profiles"
        nombre: "Perfiles de Usuario"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - gamilit
          - trading-platform
        caracteristicas:
          - Extended profiles
          - Avatar handling
          - Profile validation
        ruta: "modules/user-management/user-profiles/"

      - id: "users-multi-tenant"
        nombre: "Usuarios Multi-tenant"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - Tenant isolation
          - Cross-tenant admins
          - Tenant switching
        ruta: "modules/user-management/multi-tenant-users/"

      - id: "users-preferences"
        nombre: "Preferencias de Usuario"
        version: "1.0.0"
        estado: "production"
        proyectos_usando:
          - trading-platform
        caracteristicas:
          - User settings
          - Theme preferences
          - Notification prefs
        ruta: "modules/user-management/user-preferences/"

  # ============================================
  # UI-COMPONENTS - Componentes UI
  # ============================================
  ui-components:
    nombre: "Componentes UI"
    descripcion: "Componentes UI reutilizables React"
    ruta_base: "modules/ui-components/"
    modulos:
      - id: "ui-admin-dashboard"
        nombre: "Admin Dashboard"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
          - gamilit
        caracteristicas:
          - Layout responsive
          - Sidebar navigation
          - Widget system
        ruta: "modules/ui-components/admin-dashboard/"

      - id: "ui-login-forms"
        nombre: "Login/Register Forms"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - all
        caracteristicas:
          - Login/Register/Reset
          - Form validation
          - Social login buttons
        ruta: "modules/ui-components/login-forms/"

      - id: "ui-data-tables"
        nombre: "Data Tables"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - Sorting/Filtering
          - Pagination
          - Export to CSV/Excel
        ruta: "modules/ui-components/data-tables/"

      - id: "ui-file-upload"
        nombre: "File Upload"
        version: "1.2.0"
        estado: "production"
        proyectos_usando:
          - gamilit
        caracteristicas:
          - Drag and drop
          - Progress tracking
          - Multiple files
        ruta: "modules/ui-components/file-upload/"

      - id: "ui-rich-text-editor"
        nombre: "Rich Text Editor"
        version: "1.0.0"
        estado: "beta"
        proyectos_usando: []
        caracteristicas:
          - WYSIWYG editor
          - Image embedding
          - Markdown support
        ruta: "modules/ui-components/rich-text-editor/"

  # ============================================
  # API-PATTERNS - Patrones de API
  # ============================================
  api-patterns:
    nombre: "Patrones de API"
    descripcion: "Patrones y utilidades para APIs"
    ruta_base: "modules/api-patterns/"
    modulos:
      - id: "api-rest-crud"
        nombre: "REST CRUD Base"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - all
        caracteristicas:
          - CRUD endpoints
          - Response formatting
          - Error handling
        ruta: "modules/api-patterns/rest-crud/"

      - id: "api-graphql-base"
        nombre: "GraphQL Base Setup"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - gamilit
        caracteristicas:
          - Schema definition
          - Resolvers pattern
          - DataLoader integration
        ruta: "modules/api-patterns/graphql-base/"

      - id: "api-pagination"
        nombre: "Paginacion Estandar"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - all
        caracteristicas:
          - Offset pagination
          - Cursor pagination
          - Meta response
        ruta: "modules/api-patterns/pagination/"

      - id: "api-filtering-sorting"
        nombre: "Filtrado y Ordenamiento"
        version: "1.2.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - Dynamic filters
          - Multi-column sort
          - Query builder
        ruta: "modules/api-patterns/filtering-sorting/"

      - id: "api-rate-limiting"
        nombre: "Rate Limiting"
        version: "1.0.0"
        estado: "production"
        proyectos_usando:
          - trading-platform
        caracteristicas:
          - Redis-based
          - Per-user limits
          - Sliding window
        ruta: "modules/api-patterns/rate-limiting/"

  # ============================================
  # DATABASE-PATTERNS - Patrones de BD
  # ============================================
  database-patterns:
    nombre: "Patrones de Base de Datos"
    descripcion: "Patrones PostgreSQL reutilizables"
    ruta_base: "modules/database-patterns/"
    modulos:
      - id: "db-audit-trail"
        nombre: "Audit Trail"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - Trigger-based
          - Who/When tracking
          - JSON diff storage
        ruta: "modules/database-patterns/audit-trail/"

      - id: "db-soft-delete"
        nombre: "Soft Delete Pattern"
        version: "1.2.0"
        estado: "production"
        proyectos_usando:
          - all
        caracteristicas:
          - deleted_at column
          - Automatic filtering
          - Restore capability
        ruta: "modules/database-patterns/soft-delete/"

      - id: "db-multi-tenant-schema"
        nombre: "Multi-tenant Schema"
        version: "2.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - Schema per tenant
          - RLS policies
          - Connection pooling
        ruta: "modules/database-patterns/multi-tenant-schema/"

      - id: "db-versioning"
        nombre: "Row Versioning"
        version: "1.0.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - Version column
          - Optimistic locking
          - History table
        ruta: "modules/database-patterns/versioning/"

      - id: "db-full-text-search"
        nombre: "Full Text Search"
        version: "1.0.0"
        estado: "beta"
        proyectos_usando:
          - gamilit
        caracteristicas:
          - pg_trgm extension
          - tsvector indexes
          - Ranked results
        ruta: "modules/database-patterns/full-text-search/"

  # ============================================
  # INTEGRATIONS - Integraciones Externas
  # ============================================
  integrations:
    nombre: "Integraciones"
    descripcion: "Conectores con sistemas externos"
    ruta_base: "modules/integrations/"
    modulos:
      - id: "integration-odoo-connector"
        nombre: "Odoo ERP Connector"
        version: "1.5.0"
        estado: "production"
        proyectos_usando:
          - erp-core
        caracteristicas:
          - XML-RPC client
          - Bidirectional sync
          - Model mapping
        ruta: "modules/integrations/odoo-connector/"

      - id: "integration-quickbooks-sync"
        nombre: "QuickBooks Sync"
        version: "1.0.0"
        estado: "beta"
        proyectos_usando:
          - erp-construccion
        caracteristicas:
          - OAuth2 auth
          - Invoice sync
          - Customer sync
        ruta: "modules/integrations/quickbooks-sync/"

      - id: "integration-google-workspace"
        nombre: "Google Workspace"
        version: "1.2.0"
        estado: "production"
        proyectos_usando:
          - gamilit
        caracteristicas:
          - Calendar API
          - Drive API
          - Gmail API
        ruta: "modules/integrations/google-workspace/"

      - id: "integration-microsoft-365"
        nombre: "Microsoft 365"
        version: "1.0.0"
        estado: "beta"
        proyectos_usando: []
        caracteristicas:
          - Outlook API
          - OneDrive API
          - Teams webhooks
        ruta: "modules/integrations/microsoft-365/"

# ============================================
# ESTADISTICAS
# ============================================
estadisticas:
  por_categoria:
    authentication: 5
    payments: 4
    notifications: 5
    user-management: 4
    ui-components: 5
    api-patterns: 5
    database-patterns: 5
    integrations: 4
  por_estado:
    production: 30
    beta: 7
    deprecated: 0