Logo Clínica Veterinaria Pradera
Bitácora de desarrollo

Sistema Veterinaria Pradera

Para Cristian y Pilar. Aquí queda, día por día, todo lo que se construyó y cómo se usa cada parte del sistema.

4días de trabajo
8módulos del sistema
16tablas en la base de datos
2páginas para clientes

Avances por día

Del domingo 11 de octubre a hoy.

Planeación y bases

Domingo 11 de octubreCompletado

Se definió cómo iba a funcionar el sistema y se armó su esqueleto: la estructura de las pantallas, la navegación y la forma de guardar la información.

Plan del sistema

  • Se definieron las secciones: Inicio, Agenda, Pacientes, Inventario, Finanzas y Marketing.
  • Se decidió que funcione desde el celular primero, con una barra de navegación abajo.
  • Se definió que solo el equipo entra al panel, con usuario y contraseña.

Estructura de pantallas

  • Se armó la pantalla de inicio de sesión.
  • Se construyó el panel con barra superior y menú inferior fijo.
  • Se crearon los formularios y ventanas que usan todas las secciones.

Modelo de información

  • Se definió qué se guarda de cada tutor, mascota, cita, visita, producto, venta y gasto.
  • Se dejó cada mascota unida a su tutor, para ver el historial completo de la familia.

Datos de ejemplo

  • Se cargaron 9 tutores y 12 mascotas de ejemplo con historial real de varios meses.
  • Incluyen citas, ventas, gastos e inventario para poder practicar sin miedo a dañar nada.

Agenda, consultorio y carnet

Lunes 12 de octubreCompletado

Se construyó el corazón del trabajo diario: la agenda de citas, el apartado de consultorio con la ficha clínica de cada mascota, y el carnet digital con código QR.

Agenda

  • Se elaboró la vista por día y por semana, con filtro por veterinario o estilista.
  • Se agregaron 5 tipos de cita con color propio: consulta, baño/grooming, vacunación, cirugía menor y control.
  • Se agregaron los estados: programada, confirmada, completada, cancelada y no asistió.
  • El sistema avisa si un profesional ya tiene otra cita a la misma hora.

Consultorio: ficha clínica

  • Se elaboró la ficha de cada mascota: especie, raza, edad, sexo, señas, esterilización, alergias y enfermedades crónicas.
  • Las alergias y condiciones crónicas se ven en rojo, arriba, para que nadie las pase por alto.
  • Historial de visitas con peso, temperatura, diagnóstico, tratamiento y próxima cita sugerida.
  • Al completar una cita, la visita queda guardada sola en la ficha.

Gráfica de peso y métricas

  • Se agregó la gráfica de peso en el tiempo, con aviso automático si la mascota pierde o sube de peso de forma preocupante.
  • Métricas de cada paciente: visitas totales, motivo más frecuente, última visita y próxima vacuna.

Vacunas y desparasitaciones

  • Al aplicar una vacuna o desparasitante, el sistema calcula sola la fecha del refuerzo.
  • Estados claros: al día, por vencer (próximos 30 días) y vencida.
  • Se pueden registrar antecedentes aplicados en otra veterinaria.

Carnet digital con QR

  • Se le agregó a cada mascota un carnet digital que se abre escaneando un código QR.
  • Muestra solo lo esencial: nombre, especie, raza, edad, vacunas y próxima cita. Nunca datos del tutor ni de pagos.
  • El QR se puede descargar para el collar y se puede cambiar si se pierde.

Página pública para pedir cita

  • Se elaboró una página para clientes, sin usuario ni contraseña, donde piden su cita.
  • La solicitud llega al panel como "pendiente" y el equipo la confirma como cita real.
  • Si el cliente es nuevo, el sistema crea solo el tutor y la mascota al confirmar.

Consentimientos, inventario, finanzas y marca

Martes 13 de octubreCompletado

Se completaron las secciones administrativas y se le dio la identidad de Veterinaria Pradera.

Consentimientos informados

  • Se elaboró la plantilla de consentimiento para baño y grooming, con sus riesgos.
  • El documento se llena solo con los datos reales de la mascota y del tutor.
  • Firma en pantalla con el dedo o el mouse, más nombre, documento y aceptación.
  • Al firmarse queda bloqueado para siempre y se descarga en PDF.
  • Se pueden crear más plantillas (cirugía, sedación) desde Catálogo.

Inventario

  • Productos con lote y fecha de vencimiento obligatorios en vacunas y medicamentos.
  • Alertas de productos vencidos, por vencer en 30 días y con stock bajo.
  • Historial de cada entrada, salida y ajuste; el stock no se puede cambiar a mano.
  • Al vender o aplicar un producto, el stock baja solo. Lo vencido no se deja vender.

Finanzas

  • Registro de ventas y gastos, con resumen por período.
  • Ganancia real: ventas menos el costo real de los productos menos los gastos.
  • Recibo en PDF por cada venta. Las ventas no se borran: se anulan, y el producto vuelve al inventario.

Marketing por WhatsApp

  • Listas de vacunas vencidas o por vencer y de cumpleaños del mes.
  • Cada fila trae un botón de WhatsApp con el mensaje ya escrito; solo hay que darle Enviar.
  • Solo aparecen los clientes que autorizaron que los contactemos.

Inicio

  • Saludo, accesos rápidos, próxima cita y cifras del día.
  • Gráfico de ventas de la semana y lista de lo que requiere atención.

Identidad Veterinaria Pradera

  • Se puso el nombre Veterinaria Pradera en todo el sistema, los recibos y los consentimientos.
  • Se aplicó el logo y los colores azules del corazón.

En línea y en la nube

Miércoles 14 de octubreCompletado

El sistema dejó de ser una prueba: ahora vive en internet, guarda todo en una base de datos segura y se puede usar desde cualquier celular o computador.

Base de datos

  • Se elaboró la base de datos en la nube (Supabase), con 16 tablas.
  • La información se sincroniza al instante entre todos los dispositivos donde se inicie sesión.
  • Las operaciones importantes (vender, completar una cita, mover inventario) se hacen completas o no se hacen, para que nunca queden a medias.

Seguridad

  • Sin iniciar sesión no se puede ver ni cambiar ningún dato.
  • La base de datos misma impide borrar ventas, editar consentimientos firmados o cambiar el stock a mano.
  • Se desactivó el registro público: las cuentas solo las crea el administrador.

Publicación en internet

  • Se publicó en veterinaria-pradera.pages.dev (Cloudflare Pages).
  • Se creó la cuenta de acceso de la veterinaria.
  • Se corrigió un error que no dejaba entrar al panel después de iniciar sesión.
  • Primer ingreso con opción de cargar los datos de ejemplo para capacitación.

Logo nuevo y tipografía

  • Se aplicó el logo nuevo de Clínica Veterinaria Pradera.
  • Los títulos ahora usan una letra redondeada parecida a la del logo.
  • Se preparó el paquete para el diseñador, con referencias y capturas, para el nuevo diseño visual.

Manual de funciones

Cómo se usa cada parte del sistema. Toca cada sección para abrirla.

Entrar al sistema

Inicio de sesión y primer ingreso

  1. Abre veterinaria-pradera.pages.dev desde el celular o el computador.
  2. Escribe el correo y la contraseña de la veterinaria y toca Entrar.
  3. La primera vez, elige "Cargar datos de ejemplo" para practicar, o "Empezar vacío".
  4. Para salir, toca el círculo azul de arriba a la derecha.

En el celular puedes agregarlo a la pantalla de inicio desde el menú del navegador ("Agregar a pantalla de inicio") y se abre como una aplicación.

Inicio

El resumen del día

  • Accesos rápidos: los círculos llevan directo a cada sección o abren "Nueva cita" y "Vender".
  • Próxima cita: el siguiente paciente, la hora y quién lo atiende.
  • Cifras: citas de hoy, ventas de hoy, ventas de los últimos 7 días y pacientes activos.
  • Requiere atención: productos vencidos o por vencer, stock bajo, vacunas vencidas y solicitudes de cita nuevas.

Agenda

Citas y solicitudes de clientes

Agendar una cita
  1. Toca "+ Nueva cita".
  2. Elige el paciente, el servicio y quién lo atiende.
  3. Elige fecha y hora, y toca Guardar.
Atender una cita
  1. En la cita, toca "Completar".
  2. Escribe peso, temperatura, diagnóstico y tratamiento.
  3. Si aplicaste una vacuna o un medicamento, agrégalo en "Productos aplicados": se descuenta del inventario y queda el recordatorio del refuerzo.
  4. Deja marcado "Registrar el cobro ahora" para generar el recibo.
  5. Toca "Guardar en la ficha".
Solicitudes web
  1. Entra a la pestaña "Solicitudes web": ahí llegan las citas que piden los clientes.
  2. Escríbele por WhatsApp para acordar la hora.
  3. Toca "Confirmar como cita" o "Descartar" con el motivo.

Usa "No asistió" cuando el paciente no llegue y "Cancelar" cuando el cliente cancele: así quedan las estadísticas reales.

Pacientes y consultorio

Fichas clínicas, tutores y carnet

Registrar un paciente nuevo
  1. Si el dueño es nuevo, toca "+ Tutor" y llena sus datos (marca si autoriza mensajes por WhatsApp).
  2. Luego toca "+ Mascota", elige el tutor y llena los datos.
  3. Anota alergias y enfermedades crónicas: se mostrarán en rojo en la ficha.
La ficha de cada mascota
  • Datos, alertas médicas, métricas, gráfica de peso, vacunas, historial de visitas, próximas citas y consentimientos.
  • "+ Registrar visita" sirve para atenciones sin cita previa.
  • "Corregir notas" arregla errores de escritura en una visita; los productos y cobros no se cambian.
  • "+ Antecedente" registra vacunas que la mascota recibió en otra parte.
Carnet digital
  1. Al final de la ficha está el código QR.
  2. "Descargar QR" para imprimirlo o ponerlo en el collar; "Copiar enlace" para enviarlo por WhatsApp.
  3. Si el collar se pierde, "Generar enlace nuevo" anula el QR anterior.

Si una mascota fallece o deja de venir, usa "Archivar paciente": desaparece de las listas pero su historial se conserva.

Consentimientos

Firma digital y PDF

  1. En la ficha de la mascota, toca "Consentimiento".
  2. Revisa el documento: los datos del paciente y del tutor aparecen resaltados.
  3. El tutor firma en el recuadro, se confirman su nombre y documento, y marca la aceptación.
  4. Toca "Firmar y guardar" y luego "Descargar PDF".

Un consentimiento firmado no se puede editar ni borrar. Si hubo un error, se firma uno nuevo. Para agregar plantillas (cirugía, sedación), entra a Catálogo → Consentimientos.

Inventario

Productos, lotes y vencimientos

  • Producto nuevo: "+ Producto". En vacunas, medicamentos y antiparasitarios el lote y el vencimiento son obligatorios. Cada lote nuevo se registra como un producto aparte.
  • Llegó mercancía: abre el producto → "Registrar movimiento" → Entrada, con el costo de la compra.
  • Merma o daño: Registrar movimiento → Salida, con el motivo.
  • Conteo físico: Registrar movimiento → Ajuste (negativo para restar).
  • Recordatorios: en vacunas y antiparasitarios indica cada cuántos días se repiten; así el sistema calcula los refuerzos.

Los productos vencidos aparecen en rojo y el sistema no deja venderlos ni aplicarlos: dales salida como merma.

Finanzas

Ventas, gastos y ganancia

  • Venta de mostrador: "+ Venta", agrega servicios o productos, forma de pago y descuento si aplica. Al guardar se descarga el recibo.
  • Gasto: "+ Gasto" para arriendo, nómina, servicios públicos, etc. Las compras de inventario no van aquí.
  • Período: hoy, 7 días, 30 días, este mes, mes anterior o un rango.
  • Anular una venta: abre la venta → "Anular" con el motivo. Los productos vuelven al inventario.

El recibo es un comprobante de venta. No es factura electrónica de la DIAN.

Marketing

Recordatorios por WhatsApp

  1. Pestaña "Vacunas y despar.": vencidas y por vencer en los próximos 30 días.
  2. Pestaña "Cumpleaños": las mascotas que cumplen este mes.
  3. Toca "WhatsApp": se abre con el mensaje escrito, revísalo y dale Enviar. Queda anotado que ya avisaste.
  4. Pestaña "Contactos": marca o desmarca quién autoriza mensajes y exporta la lista.

Los textos de los mensajes se cambian en "Editar mensajes".

Catálogo y ajustes

Servicios, equipo, plantillas y datos del negocio

  • Servicios: nombre, tipo de cita, precio y duración.
  • Equipo: veterinarios, estilistas y recepción, para asignarlos a las citas.
  • Consentimientos: editar o crear plantillas.
  • Negocio: NIT, dirección y teléfono que salen en recibos, consentimientos y carnet.

Páginas para clientes

Pedir cita y carnet

  • Pedir cita: veterinaria-pradera.pages.dev/agendar. Se puede compartir en Instagram, WhatsApp o Google. El cliente no necesita usuario.
  • Carnet: cada mascota tiene su enlace y QR. Muestra solo datos esenciales, nunca información del tutor.

Pendientes

Lo que falta y de quién depende.

Llenar NIT, dirección y teléfono de la veterinaria (Catálogo → Negocio).Cristian y Pilar
Revisar con el médico veterinario el texto legal del consentimiento de baño y grooming.Cristian y Pilar
Confirmar los precios reales de los servicios.Cristian y Pilar
Cargar el equipo real (veterinarios y estilistas) y reemplazar los datos de ejemplo cuando terminen de practicar.Cristian y Pilar
Nuevo diseño visual de las pantallas, con fotos de mascotas, a partir del trabajo del diseñador.Desarrollo
Permitir subir la foto de cada mascota a su ficha.Desarrollo
Verificar en la base de datos la carga de los datos de ejemplo del primer ingreso.Desarrollo