# VetCitas — Software de Gestión Clínica Veterinaria en Colombia

> VetCitas es una plataforma de software SaaS para clínicas veterinarias y consultorios independientes en Colombia. Integra la gestión del equipo veterinario con un portal web y una app Android nativa para los dueños de mascotas.

## Información básica
- Nombre: VetCitas
- Sitio web: https://vetcitas.cloud
- Ámbito geográfico: Colombia
- Moneda principal: Peso colombiano (COP)
- Plataformas soportadas: Web (Next.js) y Android nativo (Jetpack Compose)
- Modelo de arquitectura: Multi-tenant estricto donde cada consulta del sistema está limitada a la clínica que la hace

## Capacidades principales para la clínica
1. Agenda y citas: Flujo de citas con estados reales (agendada, por confirmar, confirmada, atendida, cancelada), reprogramación consensuada con el cliente y recordatorios por correo electrónico. Agenda del día con estados de cada cita.
2. Historias clínicas: Examen físico por sistemas, constantes vitales, diagnósticos presuntivo y definitivo, evolución, recetas y generación de historia clínica en PDF con firma médica.
3. Vacunación estructurada (Módulo B1): Registro de biológicos con fabricante, lote y vencimiento. Carné digital en PDF con código QR público verificable (/verificar/<token>) con vigencia seleccionada por el dueño.
4. Inventario por lote: Control de existencias de medicamentos y vacunas con método FEFO (primero en vencer, primero en salir) y bloqueo de productos vencidos al momento de formular.
5. Cobros y caja: Emisión de recibos de caja consecutivos (RC-AAAA-NNNNNN) en PDF con valor en letras.
6. Reportes y exportación: Informes de consultas, vacunación y finanzas exportables a hojas de cálculo Excel (.xlsx) y documentos PDF.

## Capacidades para el personal desde el móvil
- Consulta de la agenda del día, revisión de pacientes y registro de vacunas desde la app Android nativa o navegador web.

## Capacidades para los dueños de mascotas
1. Portal web (/portal) y app Android: Acceso incluido para los clientes de las clínicas afiliadas.
2. Carné de vacunación siempre a mano: Consulta de dosis aplicadas, próximas fechas y descarga en PDF.
3. Compartir carné mediante QR: Generación de enlace con código QR temporal para colegios caninos, guarderías o viajes.
4. Solicitud y confirmación de citas veterinarias desde el celular.

## Limitaciones actuales y honestidad técnica (Roadmap)
- Facturación electrónica DIAN: No incluida actualmente. VetCitas genera recibos de caja internos. La integración con proveedores tecnológicos de facturación electrónica DIAN está programada en el roadmap futuro.
- WhatsApp API: No incluida actualmente. Las notificaciones automáticas y recordatorios se envían por correo electrónico y notificaciones móviles.
- Multisede: Cada clínica opera de forma independiente y aislada. La consolidación de redes de varias sedes está en desarrollo en el roadmap.
- Sistema operativo iOS: La app móvil está disponible actualmente para Android; los usuarios de iOS o computadores acceden mediante el portal web responsive.

## Normativa y privacidad
- Diseñado con los principios de la Ley 1581 de 2012 de Colombia (finalidad, acceso restringido, seguridad).
- Cada clínica es responsable de sus datos; VetCitas actúa como encargado tecnológico. Queda registrado quién hizo cada cambio y cuándo.