clinica-veterinaria/docs/02-definicion-modulos/_MAP.md

# Clinica Veterinaria - Mapa de Modulos

**Proyecto:** clinica-veterinaria
**Seccion:** 02-definicion-modulos
**Fecha:** 2026-01-07

---

## Estructura de Modulos

```
02-definicion-modulos/
├── _MAP.md                      <- ESTE ARCHIVO
├── modulo-mascotas.md           <- Registro de pacientes
├── modulo-propietarios.md       <- Duenos de mascotas
├── modulo-vacunacion.md         <- Cartilla de vacunas
├── modulo-consultas.md          <- Atencion veterinaria
├── modulo-hospitalizacion.md    <- Internamiento
├── modulo-farmacia.md           <- Medicamentos veterinarios
├── modulo-estetica.md           <- Grooming
├── modulo-laboratorio.md        <- Analisis clinicos
└── modulo-cirugia.md            <- Procedimientos quirurgicos
```

---

## Modulos Especializados (Veterinaria)

### Core - Prioridad P1

| Modulo | Archivo | Estado | Descripcion |
|--------|---------|--------|-------------|
| Mascotas | modulo-mascotas.md | EN_PROGRESO | Registro de pacientes animales |
| Propietarios | modulo-propietarios.md | PENDIENTE | Gestion de duenos |
| Vacunacion | modulo-vacunacion.md | EN_PROGRESO | Cartilla de vacunas por especie |
| Consultas | modulo-consultas.md | PENDIENTE | Atencion veterinaria |

### Especializados - Prioridad P2

| Modulo | Archivo | Estado | Descripcion |
|--------|---------|--------|-------------|
| Hospitalizacion | modulo-hospitalizacion.md | PENDIENTE | Internamiento y seguimiento |
| Farmacia | modulo-farmacia.md | PENDIENTE | Medicamentos con control de lotes |
| Estetica | modulo-estetica.md | PENDIENTE | Bano, corte, grooming |
| Laboratorio | modulo-laboratorio.md | PENDIENTE | Analisis clinicos |
| Cirugia | modulo-cirugia.md | PENDIENTE | Procedimientos quirurgicos |

---

## Modulos Heredados (de erp-clinicas)

| Modulo | Fuente | Adaptacion |
|--------|--------|------------|
| Expedientes | erp-clinicas | Adaptar a mascotas (no humanos) |
| Citas | erp-clinicas | Sin cambios |
| Consultas | erp-clinicas | Signos vitales animales |
| Recetas | erp-clinicas | Medicamentos veterinarios |

---

## Modulos Heredados (de erp-core)

| Modulo | Fuente | Adaptacion |
|--------|--------|------------|
| Autenticacion | erp-core | Sin cambios |
| Usuarios | erp-core | Sin cambios |
| Roles/Permisos | erp-core | Agregar roles veterinarios |
| Facturacion | erp-core | Sin cambios |
| Inventario | erp-core | Productos veterinarios |
| Catalogos | erp-core | Especies, razas, vacunas |

---

## Entidades por Modulo

### Mascotas
- `mascota` - Paciente animal
- `especie` - Catalogo de especies
- `raza` - Catalogo de razas por especie
- `historial_peso` - Registro de pesos

### Propietarios
- `propietario` - Dueno de mascota(s)
- `mascota_propietario` - Relacion N:M
- `contacto_emergencia` - Contactos adicionales

### Vacunacion
- `vacunacion` - Aplicacion de vacuna
- `vacuna` - Catalogo de vacunas
- `esquema_vacunacion` - Esquema por especie/edad
- `certificado_vacunacion` - Documentos generados

### Hospitalizacion
- `hospitalizacion` - Ingreso
- `espacio` - Jaulas, kennels, peceras
- `monitoreo` - Signos vitales periodicos
- `evolucion` - Notas clinicas

### Farmacia
- `medicamento` - Producto
- `lote` - Control de lotes
- `movimiento_inventario` - Entradas/salidas
- `dispensacion` - Entrega a paciente

---

## Relaciones entre Modulos

```
                    ┌─────────────┐
                    │ Propietario │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │   Mascota   │
                    └──────┬──────┘
                           │
    ┌──────────────┬───────┼───────┬──────────────┐
    │              │       │       │              │
┌───▼───┐   ┌──────▼──────┐│ ┌─────▼─────┐ ┌──────▼──────┐
│Vacuna-│   │   Citas     ││ │Hospitaliza│ │  Estetica   │
│cion   │   └──────┬──────┘│ │cion       │ └─────────────┘
└───────┘          │       │ └─────┬─────┘
                   │       │       │
            ┌──────▼──────┐│ ┌─────▼─────┐
            │  Consulta   ││ │ Monitoreo │
            └──────┬──────┘│ └───────────┘
                   │       │
            ┌──────▼──────┐│
            │   Receta    │◄─────────────────┐
            └──────┬──────┘                  │
                   │                         │
            ┌──────▼──────┐           ┌──────┴──────┐
            │ Dispensacion│◄──────────│  Farmacia   │
            └─────────────┘           └─────────────┘
```

---

## Especies y Vacunas

### Caninos (Perros)

| Vacuna | Edad Inicial | Refuerzo | Frecuencia |
|--------|--------------|----------|------------|
| Parvovirus | 6 semanas | 8, 12 semanas | Anual |
| Quintuple | 8 semanas | 12 semanas | Anual |
| Rabia | 16 semanas | - | Anual |
| Bordetella | 12 semanas | - | 6 meses |

### Felinos (Gatos)

| Vacuna | Edad Inicial | Refuerzo | Frecuencia |
|--------|--------------|----------|------------|
| Triple Felina | 8 semanas | 12 semanas | Anual |
| Leucemia Felina | 12 semanas | 16 semanas | Anual |
| Rabia | 16 semanas | - | Anual |

---

## Integraciones Externas

| Sistema | Modulo Relacionado | Prioridad |
|---------|-------------------|-----------|
| SENASICA | Vacunacion (Rabia) | P1 |
| Laboratorios | Laboratorio | P1 |
| Proveedores | Farmacia | P2 |

---

## Estado de Documentacion

| Modulo | README | ESPECIFICACION | FLUJOS | TESTS |
|--------|--------|----------------|--------|-------|
| Mascotas | PENDIENTE | PENDIENTE | PENDIENTE | PENDIENTE |
| Propietarios | PENDIENTE | PENDIENTE | PENDIENTE | PENDIENTE |
| Vacunacion | PENDIENTE | PENDIENTE | PENDIENTE | PENDIENTE |
| Hospitalizacion | PENDIENTE | PENDIENTE | PENDIENTE | PENDIENTE |
| Farmacia | PENDIENTE | PENDIENTE | PENDIENTE | PENDIENTE |

---

## Proximos Pasos

1. **Completar modulo-mascotas.md** - Especificacion completa
2. **Documentar modulo-vacunacion.md** - Esquemas por especie
3. **Definir entidades** en DATABASE_INVENTORY.yml
4. **Crear User Stories** para Sprint 1

---

**Ultima actualizacion:** 2026-01-07
**Version:** 1.0.0