clinica-veterinaria/docs/00-vision-general/VISION.md

# VISION - Sistema de Gestion Clinica Veterinaria

**Proyecto:** clinica-veterinaria
**Version:** 1.0.0
**Fecha:** 2026-01-07
**Estado:** Fase 0 - Documentacion

---

## 1. PROPOSITO

Sistema de gestion integral para clinicas veterinarias que permite administrar mascotas (pacientes), propietarios, expedientes clinicos, cartilla de vacunacion, hospitalizacion, farmacia veterinaria y servicios de estetica.

### Problema que Resuelve

- Falta de registro digitalizado de mascotas y sus propietarios
- Control manual de esquemas de vacunacion por especie
- Seguimiento deficiente de pacientes hospitalizados
- Gestion inadecuada de inventario de medicamentos veterinarios
- Dificultad para cumplir reportes a SENASICA

### Propuesta de Valor

- **Registro multi-especie** con catalogos especializados por tipo de animal
- **Cartilla de vacunacion digital** con recordatorios automaticos
- **Control de hospitalizacion** con monitoreo de signos vitales
- **Farmacia integrada** con control de lotes y caducidades
- **Reportes SENASICA** para cumplimiento normativo

---

## 2. OBJETIVOS PRINCIPALES

### O1: Gestion de Mascotas y Propietarios
- Registro completo de datos de la mascota
- Vinculacion con propietario(s)
- Historial clinico por mascota
- Microchip y documentacion

### O2: Cartilla de Vacunacion
- Esquemas de vacunacion por especie
- Control de aplicaciones con lote y fecha
- Alertas de proximas vacunas
- Certificados digitales

### O3: Consultas Veterinarias
- Registro de signos vitales (peso, temperatura)
- Diagnosticos y tratamientos
- Recetas veterinarias
- Estudios de laboratorio

### O4: Hospitalizacion
- Ingreso y asignacion de espacios
- Monitoreo continuo
- Administracion de medicamentos
- Alta y seguimiento

### O5: Farmacia y Estetica
- Inventario de medicamentos veterinarios
- Control de lotes y caducidades
- Servicios de grooming
- Ventas de productos

---

## 3. USUARIOS Y ROLES

| Rol | Descripcion | Permisos Principales |
|-----|-------------|---------------------|
| **Veterinario** | Medico tratante | Consultas, diagnosticos, prescripciones, cirugias |
| **Auxiliar Veterinario** | Apoyo clinico | Ver expedientes, hospitalización, administrar medicamentos |
| **Recepcionista** | Atencion al cliente | Agendar citas, cobros, registro de mascotas |
| **Estilista** | Servicios grooming | Banos, cortes, tratamientos esteticos |
| **Farmaceutico** | Control de medicamentos | Inventario, dispensacion, control de lotes |
| **Administrador** | Gestion general | Configuracion, reportes, usuarios |

---

## 4. FUNCIONALIDADES CORE

### 4.1 Modulo Mascotas (Pacientes)

```yaml
entidad_principal: mascota
campos:
  - id: UUID
  - nombre: VARCHAR(100)
  - especie_id: UUID (FK)
  - raza_id: UUID (FK)
  - sexo: ENUM (macho, hembra)
  - fecha_nacimiento: DATE
  - peso_actual: DECIMAL(6,2)
  - color: VARCHAR(100)
  - microchip: VARCHAR(50) UNIQUE
  - esterilizado: BOOLEAN
  - fecha_esterilizacion: DATE
  - propietario_id: UUID (FK)
  - foto_url: VARCHAR(500)
  - notas: TEXT
  - estado: ENUM (activo, fallecido, perdido, dado_de_baja)

funcionalidades:
  - Registro con foto
  - Busqueda por microchip
  - Historial de pesos
  - Vinculacion de multiples propietarios
  - QR para acceso rapido a expediente
```

### 4.2 Modulo Propietarios

```yaml
entidad_principal: propietario
campos:
  - id: UUID
  - nombre: VARCHAR(200)
  - telefono: VARCHAR(20)
  - telefono_emergencia: VARCHAR(20)
  - email: VARCHAR(255)
  - direccion: TEXT
  - codigo_postal: VARCHAR(10)
  - rfc: VARCHAR(13)
  - notas: TEXT

funcionalidades:
  - Multiples mascotas por propietario
  - Historial de visitas
  - Preferencias de comunicacion
  - Saldo a favor / adeudos
```

### 4.3 Modulo Vacunacion

```yaml
entidad_principal: vacunacion
campos:
  - id: UUID
  - mascota_id: UUID (FK)
  - vacuna_id: UUID (FK catalogo)
  - fecha_aplicacion: DATE
  - fecha_proxima: DATE
  - lote: VARCHAR(50)
  - fabricante: VARCHAR(100)
  - veterinario_id: UUID (FK)
  - certificado_url: VARCHAR(500)
  - notas: TEXT

funcionalidades:
  - Esquemas automaticos por especie/edad
  - Alertas de proximas vacunas (email, SMS, push)
  - Generacion de certificados
  - Reporte para SENASICA
```

### 4.4 Modulo Hospitalizacion

```yaml
entidad_principal: hospitalizacion
campos:
  - id: UUID
  - mascota_id: UUID (FK)
  - fecha_ingreso: TIMESTAMP
  - fecha_alta: TIMESTAMP
  - motivo: TEXT
  - espacio_id: UUID (FK jaulas/kennels)
  - estado: ENUM (activo, alta, fallecido, referido)
  - dieta: TEXT
  - indicaciones: TEXT
  - veterinario_responsable_id: UUID (FK)

funcionalidades:
  - Asignacion de espacios (jaulas, kennels)
  - Monitoreo de signos vitales cada X horas
  - Administracion de medicamentos
  - Notas de evolucion
  - Comunicacion con propietario
  - Costos acumulados
```

### 4.5 Modulo Farmacia

```yaml
entidad_principal: medicamento
campos:
  - id: UUID
  - nombre: VARCHAR(200)
  - principio_activo: VARCHAR(200)
  - presentacion: VARCHAR(100)
  - laboratorio: VARCHAR(100)
  - requiere_receta: BOOLEAN
  - controlado: BOOLEAN
  - stock_actual: INTEGER
  - stock_minimo: INTEGER
  - precio_compra: DECIMAL
  - precio_venta: DECIMAL

lote:
  - id: UUID
  - medicamento_id: UUID (FK)
  - numero_lote: VARCHAR(50)
  - fecha_caducidad: DATE
  - cantidad_inicial: INTEGER
  - cantidad_actual: INTEGER

funcionalidades:
  - Control de existencias por lote
  - Alertas de caducidad proxima
  - Alertas de stock minimo
  - Trazabilidad de dispensacion
  - Medicamentos controlados
```

---

## 5. ESPECIES SOPORTADAS

### Principales

| Especie | Codigo | Vacunas Requeridas |
|---------|--------|-------------------|
| Canino (Perro) | CAN | Parvovirus, Moquillo, Hepatitis, Rabia, Leptospirosis, Bordetella |
| Felino (Gato) | FEL | Triple Felina, Leucemia Felina, Rabia |

### Otras Especies

| Especie | Codigo | Notas |
|---------|--------|-------|
| Ave | AVE | Paramixovirus, Viruela aviar (segun tipo) |
| Reptil | REP | Sin vacunas estandar, control de parasitos |
| Roedor | ROE | Sin vacunas estandar |
| Pez | PEZ | Sin vacunas, tratamientos de agua |
| Exotico | EXO | Segun especie especifica |

### Esquemas de Vacunacion por Especie

#### Caninos
```yaml
cachorro:
  - 6_semanas: Parvovirus
  - 8_semanas: Quintuple (Parvovirus, Moquillo, Hepatitis, Parainfluenza, Leptospirosis)
  - 12_semanas: Refuerzo Quintuple
  - 16_semanas: Rabia
  - anual: Refuerzos + Rabia

adulto:
  - anual: Quintuple + Rabia
  - cada_6_meses: Bordetella (opcional, perros sociales)
```

#### Felinos
```yaml
gatito:
  - 8_semanas: Triple Felina (Rinotraqueitis, Calicivirus, Panleucopenia)
  - 12_semanas: Refuerzo Triple + Leucemia Felina
  - 16_semanas: Rabia
  - anual: Refuerzos

adulto:
  - anual: Triple Felina + Rabia
  - leucemia: Segun riesgo (gatos de exterior)
```

---

## 6. CONSULTA VETERINARIA

### Flujo de Atencion

```
1. Propietario llega con mascota
2. Recepcion verifica/registra cita
3. Pesaje y registro de temperatura
4. Veterinario realiza exploracion fisica
5. Diagnostico y tratamiento
6. Prescripcion de medicamentos
7. Actualizacion de cartilla (si aplica vacuna)
8. Agenda proxima cita
9. Cobro en recepcion
```

### Signos Vitales por Especie

| Especie | Temp Normal | FC Normal | FR Normal |
|---------|-------------|-----------|-----------|
| Canino | 38-39°C | 60-120 lpm | 10-30 rpm |
| Felino | 38-39°C | 120-180 lpm | 20-40 rpm |
| Conejo | 38.5-40°C | 130-325 lpm | 30-60 rpm |
| Ave | 40-42°C | Variable | Variable |

---

## 7. INTEGRACIONES

| Sistema | Proposito | Prioridad |
|---------|-----------|-----------|
| SENASICA | Reportes de vacunacion antirabica | P1 |
| Laboratorios | Resultados de analisis clinicos | P1 |
| Proveedores | Pedidos de medicamentos | P2 |
| Facturacion electronica | CFDI 4.0 | P1 |
| WhatsApp/SMS | Recordatorios de citas y vacunas | P2 |

### SENASICA

```yaml
reporte_rabico:
  frecuencia: Mensual
  datos_requeridos:
    - Numero de vacunas aplicadas
    - Especie (canino/felino)
    - Municipio
    - Veterinario responsable
    - Lote de vacuna
```

---

## 8. METRICAS DE EXITO

| Metrica | Descripcion | Objetivo |
|---------|-------------|----------|
| Consultas/dia | Mascotas atendidas | 15-25 |
| Tasa vacunacion | Esquemas completos | 85% |
| Ocupacion hospital | Uso de espacios | 70% |
| Dias hospitalizacion | Promedio estancia | 2-3 dias |
| Mortalidad | Fallecimientos en hospital | <5% |
| Satisfaccion cliente | NPS | 8.5+ |

---

## 9. FASES DE DESARROLLO

### Fase 1: Core (MVP)
- Registro de mascotas y propietarios
- Consultas basicas
- Agenda de citas
- Facturacion simple

### Fase 2: Vacunacion y Farmacia
- Cartilla de vacunacion completa
- Inventario de medicamentos
- Alertas automaticas
- Control de lotes

### Fase 3: Hospitalizacion
- Ingreso y espacios
- Monitoreo de pacientes
- Evolucion clinica
- Costos por estancia

### Fase 4: Servicios Adicionales
- Estetica (grooming)
- Laboratorio interno
- Tienda de productos
- App para propietarios

### Fase 5: Integraciones
- SENASICA automatizado
- Laboratorios externos
- Proveedores
- Recordatorios multicanal

---

## 10. HERENCIA Y DEPENDENCIAS

### Hereda de erp-clinicas
- Modulo Expedientes (adaptado a mascotas)
- Modulo Citas
- Modulo Consultas
- Modulo Recetas

### Hereda de erp-core
- Autenticacion y usuarios
- Roles y permisos
- Facturacion
- Inventario
- Catalogos base

### Especifico Veterinaria (Nuevo)
- Mascotas (pacientes)
- Propietarios
- Cartilla de vacunacion
- Hospitalizacion
- Farmacia veterinaria
- Estetica (grooming)
- Integracion SENASICA

---

**Documento creado:** 2026-01-07
**Autor:** Agente Orquestador Workspace
**Basado en:** SIMCO v2.5, CONTEXTO-PROYECTO.md