Reservas Médicas: Sistema Integrado de Gestión de Turnos Médicos - ReservasMedicasMobile/ReservasMedicasFinal2025 GitHub Wiki

Proyecto Reservas Médicas

Introducción

El sistema Reservas Médicas nació como respuesta a la creciente necesidad de centros médicos por digitalizar sus servicios de gestión de turnos. Desarrollado inicialmente como proyecto académico, la plataforma ha evolucionado hasta convertirse en una solución dual (web y móvil) que permite a pacientes gestionar sus consultas médicas de forma remota y a los profesionales organizar mejor su agenda.

La principal motivación detrás del desarrollo fue abordar las dificultades que enfrentan tanto pacientes como personal médico en el proceso tradicional de reserva de turnos: largos tiempos de espera telefónica, desorganización en agendas, y falta de seguimiento centralizado de historiales clínicos.

El objetivo principal del sistema es facilitar el acceso a la salud mediante una herramienta tecnológica intuitiva, segura y eficiente que optimice el tiempo tanto de los pacientes como del personal médico. Asimismo, busca reducir los errores administrativos y mejorar la trazabilidad de la información clínica.

Está orientado a centros médicos de tamaño pequeño y mediano, profesionales independientes de la salud, y pacientes que requieren un canal digital para organizar sus consultas sin depender de llamadas telefónicas o visitas presenciales.

La plataforma permite el registro y autenticación de usuarios, visualización de especialidades médicas disponibles, reserva de turnos, notificaciones automáticas, carga de observaciones clínicas por parte del profesional, y un historial de turnos para seguimiento. A futuro, se proyecta integrar funcionalidades como recetas digitales y videollamadas para teleconsultas.

A diferencia de otras soluciones comerciales, Reservas Médicas se destaca por ser adaptable, escalable y accesible. Fue diseñado teniendo en cuenta contextos donde los recursos tecnológicos pueden ser limitados, priorizando una experiencia de usuario sencilla, incluso en dispositivos con baja capacidad.

El sistema fue desarrollado utilizando tecnologías modernas como Angular para el frontend, Django como framework backend, y una base de datos relacional. La versión móvil fue implementada con Android Studio en Java, permitiendo un acceso multiplataforma para mayor comodidad de los usuarios.

Arquitectura del Sistema

Actualmente, el proyecto se divide en dos componentes principales interconectados mediante un backend compartido:

Reservas Médicas Web

Repositorio: https://github.com/ReservasMedicasMobile/ReservasMedicasWeb

Stack tecnológico:

  • Frontend: HTML5, CSS3, JavaScript con framework Bootstrap
  • Backend: Django con Django REST Framework
  • Base de datos: Gestionada mediante el ORM de Django
  • Pagos: Integración con Stripe mediante microservicio en Node.js

Reservas Médicas Mobile

Repositorio: https://github.com/ReservasMedicasMobile/ReservasMedicasMobile

Stack tecnológico:

  • Desarrollo: Android Studio
  • Lenguaje principal: Java
  • Comunicación API: Biblioteca Volley
  • Auth: Tokens JWT
  • UI: XML siguiendo principios de Material Design

Funcionalidades Implementadas

Plataforma Web

La versión web del sistema permite:

  • Autenticación multirrol: Registro e inicio de sesión diferenciado para pacientes, profesionales y administradores
  • Gestión de turnos: Búsqueda y visualización de disponibilidad
  • Sistema básico de carrito: Permite seleccionar varios turnos antes de finalizar
  • Perfil de usuario: Visualización y edición de datos personales
  • Procesamiento de pagos: Integración con pasarela Stripe

Aplicación Móvil

La versión Android ofrece:

  • Autenticación de pacientes: Registro e inicio de sesión exclusivo para usuarios-pacientes
  • Reserva simplificada: Proceso directo de selección y confirmación de turnos
  • Seguimiento de consultas: Panel de visualización de turnos confirmados y pasados
  • Historial clínico: Acceso a información médica del paciente
  • Perfil personal: Visualización y modificación de datos del usuario

Estado Actual y Puntos de Mejora

Durante las pruebas de uso y evaluación del proyecto, identificamos varios aspectos que requieren atención en la próxima fase de desarrollo:

Componente Estado Actual Propuesta de Mejora
Carrito de compras Implementación básica en web, inexistente en móvil Desarrollar versión robusta en web e incorporar funcionalidad en móvil
Historial clínico Disponible solo en versión móvil Extender funcionalidad a plataforma web
Pagos Funcional en web mediante Stripe Incorporar pasarela de pagos en la app móvil
Persistencia de datos Carrito temporal por sesión Implementar persistencia asociada a cuenta de usuario
Experiencia de usuario Diferenciada entre plataformas Unificar flujos de trabajo y diseño visual

Hoja de Ruta

Para la próxima versión del sistema, hemos establecido las siguientes prioridades:

  1. Rediseño del carrito de compras:

    • Persistencia asociada a usuario registrado
    • Sincronización entre dispositivos y plataformas
    • Mejora visual del proceso de checkout
  2. Uniformidad de experiencia:

    • Implementar historial clínico en versión web
    • Estandarizar flujos de reserva entre plataformas
  3. Integración completa de pagos:

    • Incorporar pasarela de pagos nativa en la app móvil
    • Mejorar validaciones y seguridad en transacciones
  4. Posibles expansiones futuras:

    • Evaluación de incorporación de productos relacionados (medicamentos, servicios adicionales)
    • Implementación de sistema de recordatorios y notificaciones
    • Desarrollo de estadísticas e informes para profesionales

Conclusiones

El proyecto Reservas Médicas ha demostrado ser una solución viable para la digitalización de servicios de salud en entornos académicos y podría expandirse hacia implementaciones profesionales con las mejoras propuestas.

Los desafíos principales encontrados durante el desarrollo incluyeron la sincronización de datos entre plataformas y la gestión segura de información médica sensible, aspectos que continuarán siendo prioritarios en futuras iteraciones.

El código fuente está disponible en los repositorios vinculados anteriormente, donde se aceptan contribuciones que se alineen con los objetivos del proyecto y los estándares establecidos por el equipo de desarrollo. Además, el desarrollo del proyecto permitió aplicar de forma práctica conceptos clave como la arquitectura cliente-servidor, la autenticación basada en tokens, el consumo de APIs RESTful y el diseño responsive. Esta experiencia fortaleció las habilidades del equipo en metodologías ágiles, control de versiones y pruebas de software, sentando una base sólida para futuros proyectos colaborativos en el ámbito del desarrollo web y móvil.

⚠️ **GitHub.com Fallback** ⚠️