# Navegacion Rapida de Base de Datos
# clinica-veterinaria
# Creado: 2026-01-16

version: "1.0.0"
proyecto: "clinica-veterinaria"

# ============================================================================
# SCHEMAS
# ============================================================================
schemas:
  veterinaria:
    descripcion: "Schema principal con tablas veterinarias"
    tablas_count: 15
    tablas_principales:
      - especies
      - razas
      - vacunas
      - propietarios
      - mascotas
      - cartilla_vacunacion
      - desparasitaciones
      - hospitalizacion
      - hospitalizacion_monitoreo
      - estetica
      - medicamentos
      - medicamentos_lotes
      - dispensaciones
      - movimientos_farmacia
      - bitacora_controlados

  heredados:
    auth:
      origen: "erp-core"
      descripcion: "Autenticacion y sesiones"
    tenants:
      origen: "erp-core"
      descripcion: "Multi-tenancy"
    clinica:
      origen: "erp-clinicas"
      descripcion: "Doctors, appointments, consultations"
      nota: "consultations extendida con mascota_id"

# ============================================================================
# TABLAS PRINCIPALES (Top 10)
# ============================================================================
tablas_principales:
  - nombre: "mascotas"
    schema: "veterinaria"
    descripcion: "Pacientes (mascotas) de la clinica"
    entity: "Mascota.entity.ts (planificado)"
    relaciones: ["propietarios", "especies", "razas", "cartilla_vacunacion", "hospitalizacion"]
    rls: true

  - nombre: "propietarios"
    schema: "veterinaria"
    descripcion: "Duenos de mascotas"
    entity: "Propietario.entity.ts (planificado)"
    relaciones: ["mascotas"]
    rls: true

  - nombre: "cartilla_vacunacion"
    schema: "veterinaria"
    descripcion: "Historial de vacunas por mascota"
    entity: "CartillaVacunacion.entity.ts (planificado)"
    relaciones: ["mascotas", "vacunas"]
    rls: true

  - nombre: "hospitalizacion"
    schema: "veterinaria"
    descripcion: "Registro de internamientos"
    entity: "Hospitalizacion.entity.ts (planificado)"
    relaciones: ["mascotas", "hospitalizacion_monitoreo"]
    rls: true

  - nombre: "medicamentos"
    schema: "veterinaria"
    descripcion: "Catalogo de medicamentos veterinarios"
    entity: "Medicamento.entity.ts (planificado)"
    relaciones: ["medicamentos_lotes", "dispensaciones"]
    rls: true

  - nombre: "dispensaciones"
    schema: "veterinaria"
    descripcion: "Despacho de medicamentos"
    entity: "Dispensacion.entity.ts (planificado)"
    relaciones: ["medicamentos", "medicamentos_lotes", "mascotas"]
    rls: true

# ============================================================================
# ENUMS
# ============================================================================
enums:
  - nombre: "sexo_animal"
    valores: ["macho", "hembra", "desconocido"]
    usado_en: ["mascotas"]

  - nombre: "estado_hospitalizacion"
    valores: ["ingresado", "en_tratamiento", "estable", "critico", "alta", "fallecido"]
    usado_en: ["hospitalizacion"]

  - nombre: "categoria_medicamento"
    valores: ["antibiotico", "antiparasitario", "analgesico", "antiinflamatorio", "vacuna", "vitamina", "dermatologico", "oftalmico", "cardiaco", "digestivo", "otro"]
    usado_en: ["medicamentos"]

  - nombre: "tipo_movimiento_farmacia"
    valores: ["entrada", "salida", "ajuste_positivo", "ajuste_negativo", "devolucion", "merma"]
    usado_en: ["movimientos_farmacia", "bitacora_controlados"]

  - nombre: "fraccion_controlada"
    valores: ["no_controlado", "fraccion_i", "fraccion_ii", "fraccion_iii", "fraccion_iv"]
    usado_en: ["medicamentos"]

# ============================================================================
# BUSQUEDA RAPIDA
# ============================================================================
busqueda:
  por_modulo:
    VET-001: ["especies", "razas", "propietarios", "mascotas"]
    VET-002: ["vacunas", "cartilla_vacunacion"]
    VET-003: ["desparasitaciones"]
    VET-004: ["hospitalizacion", "hospitalizacion_monitoreo"]
    VET-005: ["estetica"]
    VET-006: ["medicamentos", "medicamentos_lotes", "dispensaciones", "movimientos_farmacia", "bitacora_controlados"]

  por_tipo:
    catalogo:
      - especies
      - razas
      - vacunas
      - medicamentos
    transaccional:
      - cartilla_vacunacion
      - desparasitaciones
      - hospitalizacion
      - hospitalizacion_monitoreo
      - estetica
      - dispensaciones
      - movimientos_farmacia
    auditoria:
      - bitacora_controlados

# ============================================================================
# ARCHIVOS DDL
# ============================================================================
ddl:
  ubicacion: "database/schemas/"
  archivos:
    - archivo: "01-veterinaria-schema-ddl.sql"
      descripcion: "Schema principal veterinaria"
      fecha: "2026-01-04"

    - archivo: "02-veterinaria-farmacia-ddl.sql"
      descripcion: "Modulo farmacia"
      fecha: "2026-01-07"

  seeds:
    ubicacion: "database/seeds/"
    archivos:
      - archivo: "fase8/01-veterinaria-catalogos.sql"
        descripcion: "Seeds de catalogos (especies, razas, vacunas)"

# ============================================================================
# REFERENCIAS
# ============================================================================
referencias:
  schema_completo: "@PROJ_DEF_DB"
  entities: "@PROJ_DEF_ENTITIES"
  inventario: "orchestration/inventarios/DATABASE_INVENTORY.yml"