# Entities Catalog - clinica-veterinaria

**Alias:** @PROJ_DEF_ENTITIES
**Version:** 1.0.0
**Ultima actualizacion:** 2026-01-16

---

## 1. RESUMEN

| Metrica | Valor |
|---------|-------|
| **Total Entities** | 0 (Pendiente implementacion) |
| **Por Modulo** | Ver seccion 2 |
| **Estado** | Planificado |

> **Nota:** Este proyecto actualmente tiene solo DDL de base de datos.
> Las entities de NestJS se implementaran en fases posteriores.

---

## 2. ENTITIES POR MODULO (Planificadas)

### 2.1 Modulo: Core Veterinaria (VET-001)

| Entity | Archivo | Tabla BD | Descripcion |
|--------|---------|----------|-------------|
| Especie | `especie.entity.ts` | veterinaria.especies | Catalogo de especies |
| Raza | `raza.entity.ts` | veterinaria.razas | Catalogo de razas |
| Propietario | `propietario.entity.ts` | veterinaria.propietarios | Duenos de mascotas |
| Mascota | `mascota.entity.ts` | veterinaria.mascotas | Pacientes (mascotas) |

### 2.2 Modulo: Vacunacion (VET-002)

| Entity | Archivo | Tabla BD | Descripcion |
|--------|---------|----------|-------------|
| Vacuna | `vacuna.entity.ts` | veterinaria.vacunas | Catalogo de vacunas |
| CartillaVacunacion | `cartilla-vacunacion.entity.ts` | veterinaria.cartilla_vacunacion | Historial vacunas |

### 2.3 Modulo: Desparasitaciones (VET-003)

| Entity | Archivo | Tabla BD | Descripcion |
|--------|---------|----------|-------------|
| Desparasitacion | `desparasitacion.entity.ts` | veterinaria.desparasitaciones | Historial desparasitaciones |

### 2.4 Modulo: Hospitalizacion (VET-004)

| Entity | Archivo | Tabla BD | Descripcion |
|--------|---------|----------|-------------|
| Hospitalizacion | `hospitalizacion.entity.ts` | veterinaria.hospitalizacion | Registro internamiento |
| HospitalizacionMonitoreo | `hospitalizacion-monitoreo.entity.ts` | veterinaria.hospitalizacion_monitoreo | Monitoreo signos vitales |

### 2.5 Modulo: Estetica (VET-005)

| Entity | Archivo | Tabla BD | Descripcion |
|--------|---------|----------|-------------|
| Estetica | `estetica.entity.ts` | veterinaria.estetica | Servicios grooming |

### 2.6 Modulo: Farmacia (VET-006)

| Entity | Archivo | Tabla BD | Descripcion |
|--------|---------|----------|-------------|
| Medicamento | `medicamento.entity.ts` | veterinaria.medicamentos | Catalogo medicamentos |
| MedicamentoLote | `medicamento-lote.entity.ts` | veterinaria.medicamentos_lotes | Lotes con caducidad |
| Dispensacion | `dispensacion.entity.ts` | veterinaria.dispensaciones | Despacho medicamentos |
| MovimientoFarmacia | `movimiento-farmacia.entity.ts` | veterinaria.movimientos_farmacia | Kardex inventario |
| BitacoraControlados | `bitacora-controlados.entity.ts` | veterinaria.bitacora_controlados | Auditoria COFEPRIS |

### 2.7 Entities Heredadas (de erp-clinicas)

| Entity | Origen | Uso en Veterinaria |
|--------|--------|-------------------|
| Doctor | erp-clinicas | Veterinarios |
| Appointment | erp-clinicas | Citas |
| Consultation | erp-clinicas | Consultas (extendida con mascota_id) |
| Patient | erp-clinicas | Base (reemplazado por Mascota) |

---

## 3. RELACIONES ENTRE ENTITIES

```yaml
relaciones:
  Propietario:
    has_many:
      - Mascota

  Mascota:
    belongs_to:
      - Propietario
      - Especie
      - Raza (opcional)
    has_many:
      - CartillaVacunacion
      - Desparasitacion
      - Hospitalizacion
      - Estetica
      - Dispensacion

  Hospitalizacion:
    belongs_to:
      - Mascota
      - Consultation (opcional)
    has_many:
      - HospitalizacionMonitoreo

  Medicamento:
    has_many:
      - MedicamentoLote
      - Dispensacion
      - MovimientoFarmacia

  MedicamentoLote:
    belongs_to:
      - Medicamento
    has_many:
      - Dispensacion
      - MovimientoFarmacia

  Dispensacion:
    belongs_to:
      - Medicamento
      - MedicamentoLote
      - Mascota
      - Consultation (opcional)
```

---

## 4. ESTRUCTURA DE DIRECTORIOS (Planificada)

```
backend/src/modules/
├── veterinaria/
│   ├── entities/
│   │   ├── especie.entity.ts
│   │   ├── raza.entity.ts
│   │   ├── propietario.entity.ts
│   │   └── mascota.entity.ts
│   ├── services/
│   ├── controllers/
│   └── veterinaria.module.ts
│
├── vacunacion/
│   ├── entities/
│   │   ├── vacuna.entity.ts
│   │   └── cartilla-vacunacion.entity.ts
│   └── ...
│
├── hospitalizacion/
│   ├── entities/
│   │   ├── hospitalizacion.entity.ts
│   │   └── hospitalizacion-monitoreo.entity.ts
│   └── ...
│
├── estetica/
│   ├── entities/
│   │   └── estetica.entity.ts
│   └── ...
│
└── farmacia/
    ├── entities/
    │   ├── medicamento.entity.ts
    │   ├── medicamento-lote.entity.ts
    │   ├── dispensacion.entity.ts
    │   ├── movimiento-farmacia.entity.ts
    │   └── bitacora-controlados.entity.ts
    └── ...
```

---

## 5. REFERENCIAS

- Database Schema: @PROJ_DEF_DB
- Services: @PROJ_DEF_SERVICES
- Ubicacion planificada: `backend/src/modules/*/entities/`

---

*Template v1.0.0 - clinica-veterinaria - Pendiente implementacion backend*