Proyecto institucional · Fullstack + Gestión clínica
TF-Clínica
Plataforma clínica centralizada para gestionar pacientes, sesiones y reportes de la clínica de fisioterapia de la UPMyS — construida con PHP, Supabase, JavaScript y Tailwind CSS.
- PHP
- Tailwind CSS
- Supabase
- JavaScript
Contexto y objetivo
TF-Clínica fue desarrollada para resolver la fragmentación de los procesos clínicos de la clínica de fisioterapia de la UPMyS: expedientes en papel, agendas dispersas y sin trazabilidad del historial terapéutico. El sistema unifica en una sola plataforma el registro de pacientes, la programación de sesiones, los reportes clínicos y la colaboración entre terapeutas y estudiantes.
El proyecto demuestra capacidad de desarrollo fullstack completo sobre requerimientos clínicos reales: modelado de datos sensibles, control de acceso por rol, diseño de flujos multi-actor y entrega de un sistema en producción para una institución educativa.
Arquitectura del sistema
Frontend PHP + JS
Vistas renderizadas en servidor con PHP puro y enriquecidas con JavaScript vanilla para interactividad, validaciones en cliente y actualizaciones dinámicas sin recarga completa de página.
Backend Supabase
Supabase actúa como BaaS completo: autenticación segura con JWT, API auto-generada sobre PostgreSQL, suscripciones en tiempo real y almacenamiento de archivos clínicos, todo bajo un modelo serverless gestionado.
Modelo de datos clínico
PostgreSQL estructurado para gestión de expedientes, sesiones, evoluciones terapéuticas y usuarios con roles diferenciados. Diseño relacional orientado a trazabilidad y consultas eficientes sobre el historial de cada paciente.
Control de acceso por roles
Sistema de permisos diferenciados para terapeutas, estudiantes y administradores — cada rol accede exclusivamente a los módulos, datos y operaciones correspondientes a su función dentro de la clínica.
Infraestructura: Supabase elimina la necesidad de gestionar servidores de base de datos o servicios de autenticación propios, permitiendo enfocar el desarrollo en la lógica clínica y la experiencia de usuario. El almacenamiento de documentos y archivos se gestiona de forma segura mediante Supabase Storage.
Retos técnicos resueltos
Gestión de datos clínicos sensibles
Modelado y almacenamiento seguro de expedientes médicos con trazabilidad completa, validación de integridad y acceso restringido por política de roles en base de datos.
Agenda dinámica con conflictos
Sistema de programación de sesiones que detecta y previene solapamientos de horario, con soporte para reprogramación y cancelación manteniendo el historial de cambios.
Dashboard clínico en tiempo real
Indicadores de sesiones, pacientes activos y progreso terapéutico actualizados mediante suscripciones Supabase Realtime, sin necesidad de recargas manuales.
Integración PHP puro + Supabase API
Consumo de la API REST de Supabase desde PHP sin frameworks intermedios, implementando autenticación JWT, manejo de errores y renovación de tokens de forma manual.
Decisiones técnicas clave
PHP puro seleccionado para mantener control total sobre el ciclo de vida de las peticiones sin la abstracción de frameworks, facilitando la integración directa con la API de Supabase.
Supabase como BaaS elimina la complejidad operativa de gestionar autenticación, base de datos y almacenamiento de forma independiente, reduciendo superficie de fallos.
JavaScript vanilla para interactividad del cliente, evitando dependencias de frameworks en una aplicación cuyo estado complejo reside en el servidor.
Tailwind CSS garantiza consistencia visual en todos los módulos del sistema sin CSS personalizado que acumule deuda técnica en una plataforma con múltiples vistas.
Consideraciones técnicas
- Protección de datos clínicos con autenticación JWT y RLS en Supabase
- Validación de datos en cliente y servidor antes de toda escritura
- Manejo de estados de carga y errores en todas las operaciones async
- Diseño responsivo accesible desde móvil y escritorio
- Buscador con filtros múltiples sin degradar el rendimiento
- Estructura modular preparada para incorporar nuevas funcionalidades clínicas
Capacidades demostradas
- Desarrollo fullstack sin frameworks con PHP y JavaScript vanilla
- Integración con BaaS (Supabase) desde backend propio
- Modelado de datos relacionales para dominios clínicos complejos
- Implementación de autenticación y control de acceso por roles
- Diseño de sistemas de gestión para instituciones educativas
- Entrega de productos en producción con usuarios reales
Stack técnico
PHP puro
Lógica de servidor, enrutamiento, renderizado de vistas y consumo de la API REST de Supabase.
Supabase
BaaS completo: autenticación JWT, PostgreSQL, API auto-generada, Realtime y Storage.
Tailwind CSS
Sistema de diseño utility-first para interfaz responsiva y consistente en todos los módulos.
JavaScript
Interactividad en cliente, validaciones en tiempo real y consumo de actualizaciones Realtime.
¿Quieres ver más proyectos?
← Volver al portafolio