clinica-veterinaria/docs/_definitions/ENTITIES-CATALOG.md
2026-01-16 04:14:26 -06:00

182 lines
5.1 KiB
Markdown

# 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*