32 Módulo de Consulta Dental: Registro de Evolución Clínica y Odontograma FDI por Cita Odontológico
Duración: 11 minDescripción
🎓 Lección 32: Módulo de Consulta Dental: Registro de Evolución Clínica y Odontograma FDI por Cita Odontológica
Objetivo General: Integrar y "casar" la gestión del Odontograma FDI directamente con el Historial Clínico por cada cita médica en Laravel 11. Con esto, el profesional de la salud dental puede registrar diagnósticos, tratamientos y la evolución gráfica de la dentadura del paciente en distintas fechas, manteniendo un rastreo histórico e inmutable de su atención.
🚀 Pasos Clave con Timestamps
- ⏱️ 00:00 📌 Introducción y Contexto del Módulo: Revisión general del progreso del proyecto del Sistema de Gestión Odontológica y el propósito de ajustar el odontograma visual hacia un flujo interactivo real.
- ⏱️ 00:48 🤝 Reconocimientos y Comunidad: Agradecimiento a los miembros del canal e interacción con dudas comunes sobre membresías de YouTube y acceso alternativo mediante la plataforma web.
- ⏱️ 00:04:01 💡 Planteamiento del Requerimiento: Análisis de la sugerencia clave para relacionar la llave foránea cita_id en las tablas de historial_clinicos y odontogramas, permitiendo capturar el "antes y después" del estado bucodental.
- ⏱️ 00:05:20 📅 Flujo de Recepción y Citas: Simulación del proceso desde la reserva del paciente, confirmación por parte de la secretaría y el cambio de estado a la consulta médica activa.
- ⏱️ 00:06:07 👨⚕️ Optimización de la Agenda del Doctor: Reestructuración de la interfaz del médico para priorizar la visualización de las citas del día actual y ordenar los registros históricos de manera descendente.
- ⏱️ 00:07:10 📝 Registro del Historial Clínico por Cita: Captura de diagnósticos, prescripciones médicas (recetas) y observaciones vinculadas a una sesión odontológica específica.
- ⏱️ 00:08:15 🦷 Vinculación del Odontograma FDI: Registro del estado gráfico de los dientes y observaciones específicas asociadas al ID de la cita atendida.
- ⏱️ 00:08:50 📊 Trazabilidad y Evolución Clínica: Consulta comparativa de odontogramas entre fechas para evaluar tratamientos aplicados (por ejemplo, colocación de prótesis o coronas).
- ⏱️ 00:09:30 🗄️ Inspección de la Base de Datos: Verificación de las relaciones relacionales de datos entre paciente_id, doctor_id y cita_id en la base de datos MySQL.
- ⏱️ 00:10:14 🏁 Cierre de Atenciones y Próximos Pasos: Finalización del estado de la cita médica y adelanto del siguiente módulo sobre gestión de caja y pagos.
🛠️ Comandos y Rutas Principales
| Tipo / Capa | Comando / Ruta | Propósito |
|---|---|---|
| 💻 Artisan | php artisan make:migration add_cita_id_to_odontogramas_table | Añade la columna cita_id como clave foránea en el odontograma. |
| 💻 Artisan | php artisan migrate | Ejecuta la migración para actualizar la estructura de las tablas en la base de datos. |
| 🌐 Ruta HTTP | GET /doctor/agenda | Muestra la agenda del doctor con las citas programadas para el día y el historial. |
| 🌐 Ruta HTTP | POST /historial/store | Almacena el diagnóstico, síntomas y recetas médicas asociadas a la cita actual. |
| 🌐 Ruta HTTP | POST /odontograma/store | Guarda el diagrama dental FDI y las piezas modificadas vinculadas a la cita. |
| 🌐 Ruta HTTP | GET /historial/paciente/{id} | Recupera la línea de tiempo clínica y los odontogramas históricos del paciente. |
🔒 Buenas Prácticas y Seguridad
- 🔗 Integridad Referencial Estricta: Asegura la integridad relacional mediante claves foráneas con restricción foreignId('cita_id')->constrained()->onDelete('cascade'). Esto previene registros huérfanos de historial clínico u odontogramas cuando se modifique o gestione una cita.
- 🛡️ Control de Acceso mediante Policies/Gates: Implementa verificación de permisos para garantizar que solo el médico asignado o el personal autorizado puedan registrar y modificar datos clínicos dentro de la sesión activa de la consulta.
- 📜 Inmutabilidad del Historial Médico: Aplica la regla de negocio de solo lectura para citas y odontogramas finalizados. La evolución debe reflejarse creando una nueva cita e historial, garantizando la validez legal e histórica de las atenciones pasadas.
- 🩺 Validación de Datos Clinico-Dentales: Centraliza la lógica de validación mediante Form Requests personalizados en Laravel para validar correctamente los códigos de las piezas dentales según la nomenclatura FDI (11 a 48) antes de persistirlos en la base de datos.
