REC - Mejoras en rutas de recetas med/insumos ANDES

[aldoEMatamala]

Requerimiento

https://proyectos.andes.gob.ar/browse/REC-262

Funcionalidad desarrollada

1. Nuevas Operaciones y Endpoint PATCH para Insumos
   Archivos: receta-insumo.routes.ts y recetaInsumosController.ts

Habilitación de PATCH: Se habilitó el método PATCH para el recurso /recetasInsumos en el enrutador.
suspender: Cambia el estado de una receta de insumo a suspendida.
dispensar / dispensa-parcial: Registra una dispensa (total o parcial) guardando los detalles de los insumos entregados, cantidades, fechas, organización y el ID externo de la transacción.
sin-dispensar (actualizarAppNotificada): Permite que una aplicación externa libere/desmarque una receta de insumo que fue consultada pero no dispensada.
cancelar-dispensa: Revierte una dispensa registrada previamente buscando por su ID de dispensa (idDispensaApp) y guardando los motivos y la organización que realizó la cancelación.

2. Optimización y Flexibilización en la Búsqueda de Recetas

Búsquedas por ID o ID de Registro sin requerir Paciente:
Ahora, si se busca por un id específico de receta o por idRegistro (ID de tratamiento prolongado o agrupador), no es obligatorio enviar datos de identificación del paciente (pacienteId, documento y sexo).
Se agregó el mapeo del parámetro idRegistro para permitir filtrar y agrupar recetas vinculadas a un mismo tratamiento.
Resolución de conflictos al filtrar por Estado:
Medicamentos: Se eliminó la lógica restrictiva que forzaba a establecer estadoActual.tipo = null cuando no se proporcionaba un estadoDispensa en la consulta. Esto permite filtrar libremente por el estado de la receta.
Insumos: Se eliminó el filtro por defecto 'sin-dispensa' cuando no se especificaba el estado de la dispensa.

3. Filtros Avanzados y Sincronización con Apps Externas en Insumos
   Filtros Temporales Inteligentes: Se implementó una lógica de rangos de fechas dinámicos según el estado consultado (pendiente limita a próximos 10 días si no se especifica fin, vigente limita a los últimos 30 días atrás).
   Control de Notificaciones e Integración (appNotificada):
   Al realizar consultas con un token de aplicación (user.type === 'app-token'), el sistema ahora registra automáticamente la consulta (registrarAppNotificadas).
   Si la receta de insumo ya registra una dispensa activa en otro sistema externo conectado, el controlador sincroniza y replica ese estado localmente antes de devolver el resultado.

UserStories llegó a completarse

• Si
• No

Requiere actualizaciones en la base de datos

• Si
• No