Contents
Nota sobre Política de Soporte
Se brinda soporte para la versión actual y hasta dos releases anteriores a la que se está documentando.
Resumen Ejecutivo
Esta Release 2.68 se centra en la implementación de las siguientes funcionalidades principales:
- Cambios Funcionales y Datos Maestros
- Se incorporó el alta de dos nuevas especialidades en clinical_specialty vía incrementales: Cirugía coloproctología y Cirugía hepatobiliopancreática.
- Agenda de Prácticas
- Se limita la asociación a UN SOLO estudio por turno para órdenes ambulatorias generadas en HSI con la categoría “Diagnóstico por imágenes”, bajo condiciones específicas (responsable de agenda como servicio, agenda de tipo Práctica/Procedimiento y con equipo asociado).
- Turnos
- Se implementa la Cancelación de turnos por motivos estructurados, haciendo obligatoria la selección de un motivo al cancelar, lo cual impacta en turnos, reservas por centro de llamados y cancelaciones por el paciente mediante servicios externos.
- Gestión de Accesos
- Se permite sugerir la modalidad de atención (Presencial, Teleconsulta con paciente, o Teleconsulta de segunda opinión) para solicitudes de referencia, si el feature flag HABILITAR_TELEMEDICINA está activo.
- Se habilita al rol enfermero la creación de solicitudes de referencia en la consulta ambulatoria de enfermería, incluyendo el concepto “Atención de enfermería” en los problemas asociados.
- Se incorpora la Búsqueda iterativa de prácticas (typeahead) en el desplegable de solicitudes de referencia para mejorar la usabilidad y performance.
- Mejoras Clínicas (Indicaciones y Formularios)
- Se incorpora el concepto de Dosis por vez en la prescripción de indicaciones de medicamentos (para internación y guardia), permitiendo el uso de valores decimales (hasta 999999,99) para especialistas médicos y odontólogos.
- En Formularios y Scores Configurables, se añade un botón para deshacer la selección en parámetros de “Lista de Selección Única”.
- Se completa el desarrollo del parámetro Lista de selección múltiple (mediante checkboxes) para permitir la selección de varias opciones en formularios y scores configurables.
Nota Importante sobre feature flags de desarrollo
Un feature flag de Desarrollo es una herramienta para gestionar riesgos y entregas (habilitar/deshabilitar o acotar el alcance de una nueva funcionalidad mientras se valida). Es temporal y se elimina cuando la función se consolida y pasa a formar parte estable del producto.
Todos los feature flags en cuyo nombre figure “EN_DESARROLLO” no deben configurarse en true en ambientes productivos.
Resumen de Feature Flags de desarrollo que afectan el uso de la release
| Feature Flag | Funcionalidad Asociada |
| HABILITAR_FORMULARIOS_CONFIGURABLES_EN_DESARROLLO | Habilita los campos de formularios y scores configurables. |
| HABILITAR_MEJORAS_INDICACIONES_EN_DESARROLLO | Habilita mejoras en indicaciones |
| HABILITAR_INTEGRACION_EQUIPOS_Y_AGENDAS_DE_PRACTICAS_EN_DESARROLLO | Habilita atención de turnos en agendas responsables de servicio |
| HABILITAR_REFERENCIAS_ENFERMERO_EN_DESARROLLO | Habilita solo la creación de solicitudes de referencia en la consulta ambulatoria de enfermería |
| HABILITAR_TELEMEDICINA | Habilita todo lo relacionado a teleconsultas |
Cambios funcionales / Datos maestros
Alta de nuevas especialidades (clinical_specialty) vía incrementales
Se incorporó la creación controlada (mediante script incluido en incrementales) de dos nuevas especialidades en la tabla clinical_specialty, para asegurar consistencia en todos los ambientes y dejar trazabilidad del cambio.
El script es idempotente (no genera duplicados ante múltiples ejecuciones) y carga los campos obligatorios del modelo, incluyendo el tipo de especialidad correspondiente (clinical_specialty_type_id = 2).
Especialidades agregadas:
- Cirugía coloproctología — SNOMED CT: 320431000221102
- Cirugía hepatobiliopancreática — SNOMED CT: 309381001
Impacto funcional / dónde se visualiza:
Las nuevas especialidades quedan disponibles para selección/filtrado en:
- Backoffice: Personas > Profesiones > Asociar Especialidades (a profesionales).
- Agendas: selector de especialidad al crear/editar una agenda.
- Turnos: filtros en Oferta por profesional / institución / servicio.
- Referencias: especialidad destino al crear solicitudes (consulta y práctica, con/sin línea de cuidado).
- Dashboards de solicitudes: filtro de “Especialidad destino” (gestión de turno y gestión de acceso).
- Sectores de internación: asociación en clinical_specialty_sector.
- Reportes: filtros por especialidad en reportes ambulatorios e internación.
- Formularios configurables: selector de especialidades al asociar formularios.
- API pública de turnos online (si aplica): se devuelven por endpoints cuando hay agendas activas asociadas.
Agenda de prácticas
Estudio unico por turno para ordenes con categoria Diagnostico por imagenes
Tener en cuenta el FF: HABILITAR_INTEGRACION_EQUIPOS_Y_AGENDAS_DE_PRACTICAS_EN_DESARROLLO
Se limita la asociación de UN SOLO estudio por turno para los turnos que tengan asociada una orden ambulatoria generada en HSI con la categoría “diagnóstico por imagen”. Esto sucede cuando:
- El responsable de la agenda es un servicio.
- La agenda es de tipo Práctica / Procedimiento.
- La agenda tiene un equipo asociado.
- La orden ambulatoria es generada en HSI con la categoría diagnóstico por imagen.
- La orden cuenta con más de un estudio posible a realizar en la agenda.
A la hora de asignar un turno, al seleccionar una orden del tipo mencionada se visualiza un mensaje informativo indicando al usuario la posibilidad de asociar sólo un estudio.
Una vez seleccionado alguno de los estudios, se deshabilitan todos los botones para agregar otros estudios.
Es importante aclarar que:
- La funcionalidad NO impacta para las órdenes transcritas.
- En caso de hacer clic sobre el botón eliminar se quitará el estudio del modal de “Estudio agregado” y se volverán a habilitar los botones para agregar alguno de los estudios.
- En caso de seleccionar otra de las opciones de tipo de orden en el paso 3 (radiobuttons) se mantendrá el comportamiento actual, es decir, no habrá limitaciones sobre la cantidad de estudios a asignar dentro del turno.
- En caso de seleccionar el tipo de orden “Seleccionar orden” y una categoría de estudio distinta a “Diagnóstico por imagen” se mantendrá el funcionamiento actual, es decir, no habrá limitaciones sobre la cantidad de estudios a asignar pertenecientes a la orden.
- En caso de editar la práctica una vez que el turno es asignado se mantiene el comportamiento mencionado.
Turnos
Cancelación de turnos por motivos estructurados
La funcionalidad está disponible cuando el FF HABILITAR_MOTIVO_ESTRUCTURADO_EN_CANCELACION_DE_TURNO se encuentra en estado true.
A partir de este desarrollo, se brindó una serie de campos estructurados a la hora de cancelar un turno. Es importante mencionar que:
- La funcionalidad impacta tanto en turnos con referencias asociadas como sin.
- La selección del motivo es obligatoria.
- La funcionalidad impacta en la cancelación del turno desde el detalle del turno y desde el detalle de la solicitud de referencia.
- La funcionalidad también abarca las reservas de turnos por centro de llamados
- La funcionalidad abarca la cancelación de turnos/reservas mediante servicios externos por parte del paciente. Esta cancelación hace referencia al email del paciente y al endpoint: https://sgh.pladema.net/api/public-api/institution/225/appointment/246349/cancel?reason=Es
- El motivo seleccionado en la cancelación de turno se informa mediante API a los portales de servicios externos correspondientes.
Dicho esto, en caso de cancelar un turno desde el detalle de la solicitud, desde el detalle del turno o desde el detalle de la reserva, se le muestra al usuario un desplegable con los posibles motivos estructurados que son:
- Falta la orden médica o la imagen no es legible.
- La orden médica no coincide con el turno elegido.
- El profesional no se encuentra disponible.
- Actividad administrativa/institucional.
- Interrupción del servicio por fuerza mayor.
- Turno anulado por error administrativo.
- Cancelación o Reprogramación de cirugía.
- Cancelación solicitada por paciente.
- Otros.
En caso de seleccionar la opción “Otros” se habilita un campo de texto libre obligatorio donde se debe dejar constancia del motivo.
Los turnos cancelados por pacientes mediante servicios externos tienen como motivo estructurado el valor “Cancelación solicitada por paciente”.
Finalmente, dentro del historial de turnos de un paciente se agregó el motivo seleccionado debajo del label actual de “CANCELADO”
.
Gestión de accesos
Agregar sugerencia de modalidad de atención para solicitudes de referencia
La funcionalidad está asociada al FF: HABILITAR_TELEMEDICINA.
En caso de estar en false, al no existir la posibilidad de realizar teleconsultas, no se permite la sugerencia de estas modalidades ya que no se podrían llevar a cabo y la única modalidad permitida sería presencial. Para este caso no se visualiza la opción para realizar la acción. Por otro lado, en caso de estar en true se va a permitir la acción explicada a continuación:
Se incorporó la posibilidad de sugerir la modalidad de atención de un turno con una solicitud de referencia asociada. Para esto, se agregó un checkbox de “Sugerir modalidad” dentro de la creación y transcripción de una solicitud de referencia. El checkbox se muestra desmarcado por defecto.
En caso de marcar el checkbox se muestra un campo obligatorio con el placeholder “Seleccionar modalidad”. En caso de desmarcar el checkbox se vuelve a ocultar el campo mencionado.
Las opciones dentro del desplegable son:
- Presencial
- Teleconsulta con paciente
- Teleconsulta de segunda opinion.
En caso de que el usuario sugiere una modalidad, este dato impacta dentro del detalle de la solicitud. Se visualiza dentro del desplegable “Datos de la referencia” en la columna “Destino”.
Finalmente, cuando el usuario ingresa mediante el detalle de la solicitud a la asignación del turno, en caso de que la solicitud cuente con una modalidad sugerida, esto se visualiza dentro del formulario de búsqueda de turno. Se muestra un cartel informativo debajo del título “Modalidad de atención” con la modalidad sugerida. El mensaje es solo informativo, no es obligatorio seleccionar la modalidad sugerida.
Dato de modalidad de atención del turno en detalle de solicitud de referencia
Se agregó el dato de la modalidad asociada al turno dentro del detalle de las solicitudes de referencia.
Se permite al rol enfermero la creación de solicitudes de referencia
Tener en cuenta el FF: HABILITAR_REFERENCIAS_ENFERMERO_EN_DESARROLLO
Se agregó dentro de la consulta ambulatoria de enfermería el desplegable de “Solicitud de referencia”. El funcionamiento del desplegable permite la creación de una solicitud de referencia como sucede actualmente.
La diferencia que tiene la creación de una solicitud de referencia con este rol es que dentro de los problemas asociados se muestra el concepto “Atención de enfermería” por si el paciente no cuenta con ningún problema asociado a la hora de generar la solicitud. En caso de tener problemas activos, igualmente se visualiza este concepto.
Una vez confirmada la consulta de enfermería, la referencia queda asociada a la consulta correspondiente como sucede actualmente.
Es importante aclarar que la solicitud se visualiza en el histórico de evoluciones y en la solapa “Estudios”(en caso de ser de tipo práctica) pero aún no impacta en los dashboards de solicitudes.
Búsqueda iterativa de prácticas
Actualmente el desplegable de prácticas (cuando se selecciona Solicitar por línea de cuidado? → NO) en una solicitud de referencia carga todas las opciones disponibles. Dependiendo de la configuración del sistema, este listado puede contener miles de registros.
Para mejorar la usabilidad y reducir el impacto en performance, se implementa un mecanismo de búsqueda incremental (typeahead), donde las opciones se recuperen dinámicamente en función del texto ingresado por el usuario a partir de los tres caracteres.
Mejoras Clínicas (Indicaciones y Formularios)
Dosis por vez para prescripción de indicaciones
Se incorpora una mejora en las indicaciones de medicamentos de internación y guardia que permite a especialistas médicos y odontólogos registrar la dosis por vez utilizando valores decimales. El campo previamente llamado “Dosis” pasa a denominarse “Dosis por vez”: solo admite números positivos, permite ingresar hasta dos decimales (incluyendo el formato 0,XX) y requiere que exista una unidad de medida seleccionada.
El uso de valores decimales en la dosis queda habilitado solo mediante el feature flag HABILITAR_MEJORAS_EN_INDICACIONES_EN_DESARROLLO (por defecto en FALSE); el cambio de etiqueta a “Dosis por vez” se visualiza siempre, independientemente del estado del FF.
Validaciones y comportamiento del campo
Para acompañar esta lógica, se definen reglas de validación que limitan el valor máximo de la dosis por vez a 999999,99.
Además, se respeta el comportamiento según el origen del fármaco: cuando la indicación se basa en un fármaco frecuente, el sistema precarga automáticamente el último valor utilizado en la dosis por vez; en cambio, cuando se agrega un nuevo fármaco desde cero, el campo se presenta vacío para que el profesional lo complete intencionalmente.
Unificación del concepto “Dosis por vez” en las pantallas
La mejora también unifica el lenguaje y la forma de mostrar la información en todas las pantallas vinculadas a la indicación y suspensión de medicamentos. En las cards de fármacos y en el modal “Ver detalle” dentro de la Historia Clínica, todas las referencias al antiguo texto “Dosis” se reemplazan por “Dosis por vez”, de modo que el profesional vea siempre el mismo concepto en la prescripción, en el detalle de la indicación y en el detalle de suspensión.
Formularios y Scores Configurables
Deshacer selección en parámetros de Lista de Selección Única
Anteriormente, los profesionales de la salud no podían deseleccionar una opción en las listas de selección única sin tener que reiniciar el formulario. A partir de esta release se ha añadido un botón de limpieza rápida para optimizar su flujo de trabajo. Al hacer click en el ícono ❌, se limpia el campo seleccionado.
Se recuerda que los campos de los formularios configurables no son obligatorios. En el caso de que un profesional decida no seleccionar ninguna respuesta en un campo este se guardará con el valor “Sin información” y se presentará de esa manera en el detalle del formulario.
Esto permite al profesional guardar el formulario sin completar todos los campos si la información no es relevante o no está disponible en el momento de la atención.
Parámetro Lista de selección múltiple en la Nueva Consulta y en histórico de evoluciones
Para resolver la limitación de elegir una sola opción en campos críticos, ahora los médicos, enfermeros y profesionales de salud pueden marcar varias opciones (o ninguna) mediante checkboxes en Formularios y Scores configurables, asegurando que toda la información relevante quede guardada correctamente en la historia clínica
Esta mejora se logró en dos etapas: en la release anterior, se trabajó en el backoffice para permitir la creación de parámetros de tipo “Lista de selección múltiple”. En esta release se completó el desarrollo para que los usuarios de la webapp puedan visualizar estos parámetros en los formularios y scores configurables, y guardar la información seleccionada en la historia clínica.
Cuando un formulario o score están configurado con parámetros de tipo Lista de selección múltiple se visualizan de la siguiente manera:
Se pueden seleccionar una, varias, todas o ninguna opción. Al guardar el formulario o score, se visualiza en el historial de evoluciones y en el PDF de la evolución cada resultado separado por comas. En caso de que no se seleccione ninguna opción se muestra “Sin información”.
