# Trazabilidad del Proyecto
# clinica-veterinaria
# Creado: 2026-01-16

version: "1.0.0"
proyecto: "clinica-veterinaria"
fecha_creacion: "2026-01-16"

# ============================================================================
# TRAZABILIDAD MODULO <-> OBJETOS
# ============================================================================
trazabilidad_modulos:
  VET-001:
    nombre: "Mascotas y Propietarios"
    documentacion:
      especificacion: "docs/01-epicas/VET-001-mascotas-propietarios.md"
      definicion_modulo: "docs/02-definicion-modulos/modulo-mascotas.md"

    objetos_bd:
      tablas:
        - "veterinaria.especies"
        - "veterinaria.razas"
        - "veterinaria.propietarios"
        - "veterinaria.mascotas"
      schemas: ["veterinaria"]
      enums: ["sexo_animal"]

    objetos_backend:
      entities: [] # Pendiente implementacion
      services: [] # Pendiente implementacion
      controllers: [] # Pendiente implementacion

    objetos_frontend:
      componentes: [] # Pendiente implementacion
      stores: []
      hooks: []

  VET-002:
    nombre: "Vacunacion"
    documentacion:
      especificacion: "docs/01-epicas/VET-002-vacunacion.md"
      definicion_modulo: "docs/02-definicion-modulos/modulo-vacunacion.md"

    objetos_bd:
      tablas:
        - "veterinaria.vacunas"
        - "veterinaria.cartilla_vacunacion"
      schemas: ["veterinaria"]

    objetos_backend:
      entities: []
      services: []
      controllers: []

  VET-003:
    nombre: "Desparasitaciones"
    documentacion:
      especificacion: "docs/01-epicas/VET-003-desparasitaciones.md"

    objetos_bd:
      tablas:
        - "veterinaria.desparasitaciones"
      schemas: ["veterinaria"]

    objetos_backend:
      entities: []
      services: []

  VET-004:
    nombre: "Hospitalizacion"
    documentacion:
      especificacion: "docs/01-epicas/VET-004-hospitalizacion.md"

    objetos_bd:
      tablas:
        - "veterinaria.hospitalizacion"
        - "veterinaria.hospitalizacion_monitoreo"
      schemas: ["veterinaria"]
      enums: ["estado_hospitalizacion"]

    objetos_backend:
      entities: []
      services: []

  VET-005:
    nombre: "Estetica"
    documentacion:
      especificacion: "docs/01-epicas/VET-005-estetica.md"

    objetos_bd:
      tablas:
        - "veterinaria.estetica"
      schemas: ["veterinaria"]

    objetos_backend:
      entities: []
      services: []

  VET-006:
    nombre: "Farmacia"
    documentacion:
      especificacion: "docs/01-epicas/VET-006-farmacia.md"

    objetos_bd:
      tablas:
        - "veterinaria.medicamentos"
        - "veterinaria.medicamentos_lotes"
        - "veterinaria.dispensaciones"
        - "veterinaria.movimientos_farmacia"
        - "veterinaria.bitacora_controlados"
      schemas: ["veterinaria"]
      enums:
        - "categoria_medicamento"
        - "tipo_movimiento_farmacia"
        - "fraccion_controlada"
      funciones:
        - "get_lotes_proximos_caducar"
        - "get_medicamentos_stock_bajo"
        - "seleccionar_lote_fefo"
      triggers:
        - "trg_actualizar_stock"
        - "trg_registrar_dispensacion"

    objetos_backend:
      entities: []
      services: []

# ============================================================================
# MATRIZ DE COBERTURA
# ============================================================================
cobertura:
  total_modulos: 6
  con_documentacion: 6
  con_ddl: 6
  con_backend: 0
  con_frontend: 0
  con_tests: 0
  con_trazabilidad_completa: 0

  detalle:
    VET-001:
      documentacion: true
      ddl: true
      backend: false
      frontend: false
      tests: false

    VET-002:
      documentacion: true
      ddl: true
      backend: false
      frontend: false
      tests: false

    VET-003:
      documentacion: true
      ddl: true
      backend: false
      frontend: false
      tests: false

    VET-004:
      documentacion: true
      ddl: true
      backend: false
      frontend: false
      tests: false

    VET-005:
      documentacion: true
      ddl: true
      backend: false
      frontend: false
      tests: false

    VET-006:
      documentacion: true
      ddl: true
      backend: false
      frontend: false
      tests: false

# ============================================================================
# REFERENCIAS CRUZADAS
# ============================================================================
referencias_cruzadas:
  por_tabla:
    mascotas:
      modulo: "VET-001"
      documentos:
        - "docs/01-epicas/VET-001-mascotas-propietarios.md"
        - "docs/02-definicion-modulos/modulo-mascotas.md"
        - "docs/_definitions/DATABASE-SCHEMA.md"
      dependientes:
        - "cartilla_vacunacion"
        - "desparasitaciones"
        - "hospitalizacion"
        - "estetica"
        - "dispensaciones"

    hospitalizacion:
      modulo: "VET-004"
      documentos:
        - "docs/01-epicas/VET-004-hospitalizacion.md"
        - "docs/_definitions/DATABASE-SCHEMA.md"
      dependientes:
        - "hospitalizacion_monitoreo"

    medicamentos:
      modulo: "VET-006"
      documentos:
        - "docs/01-epicas/VET-006-farmacia.md"
        - "docs/_definitions/DATABASE-SCHEMA.md"
      dependientes:
        - "medicamentos_lotes"
        - "dispensaciones"
        - "movimientos_farmacia"
        - "bitacora_controlados"

# ============================================================================
# IMPACTO DE CAMBIOS
# ============================================================================
impacto:
  mascotas:
    tipo: "tabla"
    impacta:
      tablas:
        - "cartilla_vacunacion"
        - "desparasitaciones"
        - "hospitalizacion"
        - "estetica"
        - "dispensaciones"
      entities: [] # Pendiente
      services: [] # Pendiente
      modulos:
        - "VET-002"
        - "VET-003"
        - "VET-004"
        - "VET-005"
        - "VET-006"

  medicamentos:
    tipo: "tabla"
    impacta:
      tablas:
        - "medicamentos_lotes"
        - "dispensaciones"
        - "movimientos_farmacia"
        - "bitacora_controlados"
      entities: []
      services: []
      modulos:
        - "VET-006"

# ============================================================================
# HISTORIAL DE CAMBIOS
# ============================================================================
historial:
  - fecha: "2026-01-04"
    tipo: "creacion"
    descripcion: "DDL inicial schema veterinaria"
    autor: "Sprint 7"
    modulos: ["VET-001", "VET-002", "VET-003", "VET-004", "VET-005"]

  - fecha: "2026-01-07"
    tipo: "agregado"
    descripcion: "DDL modulo farmacia (VET-006)"
    autor: "Sprint 9"
    modulos: ["VET-006"]

  - fecha: "2026-01-16"
    tipo: "documentacion"
    descripcion: "Creacion estructura _definitions/ y _quick/"
    autor: "Migracion documentacion"
    modulos: ["VET-001", "VET-002", "VET-003", "VET-004", "VET-005", "VET-006"]

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