miinventario-v2/orchestration/TRACEABILITY.yml

# Trazabilidad - MiInventario
# Version: 1.0.0
# Fecha: 2026-01-16

version: "1.0.0"
proyecto: "miinventario"
fecha_creacion: "2026-01-16"

# ============================================================================
# TRAZABILIDAD EPICA -> MODULO -> OBJETOS
# ============================================================================
trazabilidad_epicas:
  MII-001:
    nombre: "Infraestructura Base"
    fase: 1
    modulos: [health]
    objetos_bd: []
    entregables:
      - docker-compose
      - PostgreSQL 15
      - Redis
      - MinIO

  MII-002:
    nombre: "Autenticacion"
    fase: 1
    modulos: [auth, users]
    objetos_bd:
      tablas: [users, otps, refresh_tokens]
      enums: [users_role_enum, otps_purpose_enum]
    objetos_backend:
      entities: [User, Otp, RefreshToken]
      services: [AuthService, UsersService]
      controllers: [AuthController, UsersController]
      guards: [JwtAuthGuard]
      strategies: [JwtStrategy]

  MII-003:
    nombre: "Gestion de Tiendas"
    fase: 1
    modulos: [stores]
    objetos_bd:
      tablas: [stores, store_users]
      enums: [store_users_role_enum]
    objetos_backend:
      entities: [Store, StoreUser]
      services: [StoresService]
      controllers: [StoresController]

  MII-004:
    nombre: "Captura de Video"
    fase: 1
    modulos: [videos]
    objetos_bd:
      tablas: [videos]
      enums: [videos_status_enum]
    objetos_backend:
      entities: [Video]
      services: [VideosService]
    integraciones: [S3/MinIO]

  MII-005:
    nombre: "Procesamiento IA"
    fase: 1
    modulos: [ia-provider, videos]
    objetos_bd:
      tablas: [ia_providers]
    objetos_backend:
      entities: [IaProvider]
      services: [IaProviderService]
    integraciones: [OpenAI, Anthropic]

  MII-006:
    nombre: "Reportes de Inventario"
    fase: 1
    modulos: [inventory]
    objetos_bd:
      tablas: [inventory_items]
    objetos_backend:
      entities: [InventoryItem]
      services: [InventoryService]
      controllers: [InventoryController]

  MII-007:
    nombre: "Retroalimentacion"
    fase: 2
    modulos: [feedback]
    objetos_bd:
      tablas: [corrections, ground_truth, product_submissions]
      enums: [corrections_type_enum, ground_truth_status_enum, product_submissions_status_enum]
    objetos_backend:
      entities: [Correction, GroundTruth, ProductSubmission]
      services: [FeedbackService]
      controllers: [FeedbackController]

  MII-008:
    nombre: "Validacion Aleatoria"
    fase: 2
    modulos: [validations]
    objetos_bd:
      tablas: [validation_requests, validation_responses]
    objetos_backend:
      entities: [ValidationRequest, ValidationResponse]
      services: [ValidationsService, ValidationEngineService]
      controllers: [ValidationsController]

  MII-009:
    nombre: "Wallet y Creditos"
    fase: 3
    modulos: [credits]
    objetos_bd:
      tablas: [credit_balances, credit_transactions]
      enums: [credit_transactions_type_enum]
    objetos_backend:
      entities: [CreditBalance, CreditTransaction]
      services: [CreditsService]
      controllers: [CreditsController]

  MII-010:
    nombre: "Paquetes de Recarga"
    fase: 3
    modulos: [credits]
    objetos_bd:
      tablas: [credit_packages]
    objetos_backend:
      entities: [CreditPackage]

  MII-011:
    nombre: "Pagos con Tarjeta"
    fase: 3
    modulos: [payments]
    objetos_bd:
      tablas: [payments]
      enums: [payments_method_enum, payments_status_enum]
    objetos_backend:
      entities: [Payment]
      services: [PaymentsService]
      controllers: [PaymentsController]
    integraciones: [Stripe]

  MII-012:
    nombre: "Pagos OXXO"
    fase: 3
    modulos: [payments]
    integraciones: [Stripe (OXXO)]

  MII-013:
    nombre: "Pagos 7-Eleven"
    fase: 3
    modulos: [payments]
    estado: "planificado"

  MII-014:
    nombre: "Sistema de Referidos"
    fase: 4
    modulos: [referrals]
    objetos_bd:
      tablas: [referrals]
      enums: [referrals_status_enum]
    objetos_backend:
      entities: [Referral]
      services: [ReferralsService]
      controllers: [ReferralsController]

  MII-015:
    nombre: "Administracion SaaS"
    fase: 4
    modulos: [admin]
    objetos_bd:
      tablas: [audit_logs, promotions]
      enums: [promotions_type_enum]
    objetos_backend:
      entities: [AuditLog, Promotion]
      services:
        - DashboardService
        - ModerationService
        - PackagesService
        - PromotionsService
        - ProvidersService
        - AuditLogService
      controllers: [AdminController]

# ============================================================================
# MATRIZ DE COBERTURA
# ============================================================================
cobertura:
  total_epicas: 15
  epicas_completadas: 15
  total_modulos: 14
  modulos_implementados: 14
  total_tablas: 21
  tablas_implementadas: 21
  total_entities: 21
  entities_implementadas: 21

  porcentajes:
    epicas: 100
    modulos: 100
    tablas: 100
    entities: 100
    tests_backend: 90
    tests_mobile: 0

# ============================================================================
# REFERENCIAS CRUZADAS
# ============================================================================
referencias_cruzadas:
  por_tabla:
    users:
      epicas: [MII-002]
      modulos: [auth, users]
      entities: [User]
      services: [UsersService, AuthService]

    stores:
      epicas: [MII-003]
      modulos: [stores]
      entities: [Store]
      services: [StoresService]

    videos:
      epicas: [MII-004]
      modulos: [videos]
      entities: [Video]
      services: [VideosService]

    inventory_items:
      epicas: [MII-006]
      modulos: [inventory]
      entities: [InventoryItem]
      services: [InventoryService]

    credit_balances:
      epicas: [MII-009]
      modulos: [credits]
      entities: [CreditBalance]
      services: [CreditsService]

    payments:
      epicas: [MII-011, MII-012]
      modulos: [payments]
      entities: [Payment]
      services: [PaymentsService]

    referrals:
      epicas: [MII-014]
      modulos: [referrals]
      entities: [Referral]
      services: [ReferralsService]

# ============================================================================
# IMPACTO DE CAMBIOS
# ============================================================================
impacto:
  tablas_criticas:
    users:
      impacta:
        entities: [User]
        services: [UsersService, AuthService, CreditsService, PaymentsService, ReferralsService]
        modulos: [auth, users, credits, payments, referrals, notifications, admin, feedback]
      riesgo: "ALTO"

    videos:
      impacta:
        entities: [Video, InventoryItem]
        services: [VideosService, InventoryService]
        modulos: [videos, inventory]
      riesgo: "ALTO"

    credit_balances:
      impacta:
        entities: [CreditBalance]
        services: [CreditsService, PaymentsService, ReferralsService]
        modulos: [credits, payments, referrals, videos]
      riesgo: "ALTO"

# ============================================================================
# HISTORIAL DE CAMBIOS
# ============================================================================
historial:
  - fecha: "2026-01-16"
    tipo: "creacion"
    descripcion: "Trazabilidad inicial del proyecto"
    autor: "Claude"

# ============================================================================
# ESTADISTICAS
# ============================================================================
estadisticas:
  epicas_mapeadas: 15
  modulos_mapeados: 14
  tablas_mapeadas: 21
  entities_mapeadas: 21
  documentos_referenciados: 4
  ultima_actualizacion: "2026-01-16"