# Trazabilidad del Proyecto - MiChangarrito
# Proyecto: michangarrito
# Fecha: 2026-01-16

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

# ============================================================================
# TRAZABILIDAD MODULO <-> OBJETOS
# ============================================================================
trazabilidad_modulos:
  MCH-M01:
    nombre: "Authentication"
    epica: "MCH-002"
    documentacion:
      especificacion: "docs/01-epicas/MCH-002-autenticacion.md"
      requerimientos: ["RF-AUTH-001", "RF-AUTH-002"]

    objetos_bd:
      tablas: ["users", "sessions", "refresh_tokens"]
      schemas: ["public"]

    objetos_backend:
      entities: ["User", "Session", "RefreshToken"]
      services: ["AuthService", "JwtService", "SessionService"]
      controllers: ["AuthController"]
      guards: ["JwtAuthGuard", "RolesGuard"]

    objetos_frontend:
      componentes: ["LoginForm", "RegisterForm"]
      stores: ["authStore"]
      hooks: ["useAuth"]

  MCH-M03:
    nombre: "Stores"
    epica: "MCH-001"
    documentacion:
      especificacion: "docs/01-epicas/MCH-001-infraestructura-base.md"

    objetos_bd:
      tablas: ["stores", "store_settings", "store_hours"]
      schemas: ["stores"]

    objetos_backend:
      entities: ["Store", "StoreSettings", "StoreHours"]
      services: ["StoresService", "StoreSettingsService"]
      controllers: ["StoresController"]

    objetos_frontend:
      componentes: ["StoreSelector", "StoreForm", "StoreSettings"]
      stores: ["storeStore"]

  MCH-M05:
    nombre: "Sales (POS)"
    epica: "MCH-004"
    documentacion:
      especificacion: "docs/01-epicas/MCH-004-punto-venta.md"
      requerimientos: ["RF-POS-001", "RF-POS-002", "RF-POS-003"]

    objetos_bd:
      tablas: ["sales", "sale_items", "payments", "cash_registers"]
      schemas: ["sales"]

    objetos_backend:
      entities: ["Sale", "SaleItem", "Payment", "CashRegister"]
      services: ["SalesService", "PaymentsService", "CashRegisterService"]
      controllers: ["SalesController", "PaymentsController"]

    objetos_frontend:
      componentes: ["POSTerminal", "ProductGrid", "Cart", "PaymentModal"]
      stores: ["posStore"]
      hooks: ["usePOS", "useCart"]

  MCH-M09:
    nombre: "Fiados"
    epica: "MCH-008"
    documentacion:
      especificacion: "docs/01-epicas/MCH-008-sistema-fiados.md"

    objetos_bd:
      tablas: ["fiados", "fiado_payments", "credit_limits"]
      schemas: ["fiados"]

    objetos_backend:
      entities: ["Fiado", "FiadoPayment", "CreditLimit"]
      services: ["FiadosService", "CreditService"]
      controllers: ["FiadosController"]

    objetos_frontend:
      componentes: ["FiadosList", "FiadoDetail", "PaymentForm"]
      hooks: ["useFiados"]

  MCH-M15:
    nombre: "Orders"
    epica: "MCH-015"
    documentacion:
      especificacion: "docs/01-epicas/MCH-015-pedidos-whatsapp.md"

    objetos_bd:
      tablas: ["orders", "order_items", "deliveries"]
      schemas: ["orders"]

    objetos_backend:
      entities: ["Order", "OrderItem", "Delivery"]
      services: ["OrdersService", "DeliveriesService"]
      controllers: ["OrdersController"]

    objetos_frontend:
      componentes: ["OrdersList", "OrderDetail", "OrderStatus"]

# ============================================================================
# MATRIZ DE COBERTURA
# ============================================================================
cobertura:
  total_modulos: 18
  con_documentacion: 18
  con_tests: 0
  con_trazabilidad_completa: 5

  detalle:
    MCH-M01:
      documentacion: true
      especificacion: true
      requerimientos: true
      historias: false
      tests_unitarios: false
      tests_integracion: false

    MCH-M05:
      documentacion: true
      especificacion: true
      requerimientos: true
      historias: false
      tests_unitarios: false
      tests_integracion: false

    MCH-M09:
      documentacion: true
      especificacion: true
      requerimientos: false
      historias: false
      tests_unitarios: false
      tests_integracion: false

# ============================================================================
# REFERENCIAS CRUZADAS
# ============================================================================
referencias_cruzadas:
  por_documento:
    "MCH-002-autenticacion.md":
      modulos: ["MCH-M01"]
      tablas: ["users", "sessions", "refresh_tokens"]
      entities: ["User", "Session", "RefreshToken"]

    "MCH-004-punto-venta.md":
      modulos: ["MCH-M05"]
      tablas: ["sales", "sale_items", "payments"]
      entities: ["Sale", "SaleItem", "Payment"]

    "MCH-008-sistema-fiados.md":
      modulos: ["MCH-M09"]
      tablas: ["fiados", "fiado_payments"]
      entities: ["Fiado", "FiadoPayment"]

  por_modulo:
    MCH-M01:
      documentos:
        - "MCH-002-autenticacion.md"

    MCH-M05:
      documentos:
        - "MCH-004-punto-venta.md"

    MCH-M09:
      documentos:
        - "MCH-008-sistema-fiados.md"

# ============================================================================
# IMPACTO DE CAMBIOS
# ============================================================================
impacto:
  users:
    tipo: "tabla"
    impacta:
      entities: ["User"]
      services: ["AuthService", "UsersService"]
      controllers: ["AuthController", "UsersController"]
      documentos: ["MCH-002-autenticacion.md"]
      modulos: ["MCH-M01", "MCH-M02"]

  stores:
    tipo: "tabla"
    impacta:
      entities: ["Store"]
      services: ["StoresService", "ProductsService", "SalesService"]
      documentos: ["MCH-001-infraestructura-base.md"]
      modulos: ["MCH-M03", "MCH-M04", "MCH-M05"]

  sales:
    tipo: "tabla"
    impacta:
      entities: ["Sale"]
      services: ["SalesService", "FiadosService"]
      documentos: ["MCH-004-punto-venta.md", "MCH-008-sistema-fiados.md"]
      modulos: ["MCH-M05", "MCH-M09"]

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

# ============================================================================
# ESTADISTICAS
# ============================================================================
estadisticas:
  modulos_mapeados: 5
  tablas_mapeadas: 15
  entities_mapeadas: 15
  documentos_referenciados: 5
  ultima_actualizacion: "2026-01-16"