rckrdmrd/clinica-veterinaria
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
master
clinica-veterinaria/docs/00-vision-general/VISION.md
rckrdmrd 2b5c1d7e3f feat: Add orchestration configuration and project documentation 
- Add CONTEXT-MAP.yml and PROJECT-STATUS.md
- Add _MAP.md for documentation index
- Update orchestration structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 05:40:58 -06:00

9.4 KiB
Raw Permalink Blame History

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)

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

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

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

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

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

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

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

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