[agustin1996ra]

Requerimiento

Funcionalidad desarrollada

1. Autorización (RBAC)

• checkAuth ahora expone los roles del usuario (req.user.roleNames).
• Nuevo middleware requirePermission(action, resource) con grants en código (access-control.ts) y 403 unificado.
• Autorización aplicada a las rutas de todos los módulos; chequeo de rol roto en prescriptions corregido.
• Seed idempotente de roles (npm run seed:roles).
• Documentación en docs/authorization.md.

2. Tokens de aplicación (authApps)

• Módulo applications: entidad de aplicación (nombre, organización, permisos, activo) y token vigente.
• Endpoints: POST /applications, POST /applications/:id/token, GET /applications/me.
• Middleware checkAppAuth (valida el token contra el vigente almacenado → revocable) y requireAppPermission(permiso) con soporte de wildcard resource:*.
• Revocación por reemisión (con jti único).
• Documentación en docs/app-tokens.md.

3. Modelo de receta (fuente de verdad)

• identificadoresExternos (praxis / prestacion / registro) con índice multikey y syncExterno por entidad.
• Modelo expandido para no perder interacciones: estados[], estadoActual, estadosDispensa[], estadoDispensaActual, dispensa[] y nuevos estados Suspendida/Rechazada.
• Orden y fechas escalonadas para tratamiento prolongado.

4. Integración con Praxis

• Config PRAXYS_ENDPOINT/PRAXYS_API_KEY; cliente y mapper cableados.
• Envío por insumo, con tratamientoProlongado derivado de los meses, guardando el idPrescripcion (compartido por treatmentGroupId).
• Sincronización local-first con marcado pendiente/no_aplicable/ok.
• Job de reintento sync-praxis-identifiers (cada 15 min, 3 intentos → error).

5. Ingesta desde ANDES

• Endpoint interno POST /prescriptions/andes/ingest (token de aplicación + permiso).
• Adapta el formato de receta de ANDES, preserva idPrestacion/idRegistro, deduplica por idRegistro + conceptId (o magistral) y genera N recetas para tratamiento prolongado.

6. API compatible con ANDES (hub) — /api/modules/recetas

• GET /recetas, /motivos, /filtros, /verificar, /profesional/:id, /por-prestacion/:id, /por-paciente/:dni (con ambito=todas), POST / (ingesta), PATCH / (suspender, dispensar, cancelar-dispensa, rechazar, sin-dispensar, dispensa-parcial), POST /:id/dispensa.
• View adapter que devuelve el shape de receta de ANDES (estadoActual, estadosDispensa, dispensa, medicamento.*, idReceta).
• Notificación de dispensa (SIFAHO → RecetAr) + job de reconciliación actualizar-estados-dispensa.
• OpenAPI del hub.

7. Jobs de estado

• vencimiento-recetas (pendiente→vigente→vencida) y los anteriores, corriendo en agenda-ui

UserStories llegó a completarse

• Si
• No

Requiere actualizaciones en la base de datos

• Si

• No

• Nuevo índice en la colección prescriptions:
  { 'identificadoresExternos.entidad': 1, 'identificadoresExternos.valor': 1 }
  (multikey compuesto, no único; lo crea Mongoose al arrancar).

  db.prescriptions.createIndex(
  { "identificadoresExternos.entidad": 1, "identificadoresExternos.valor": 1 },
  { name: "identificadoresExternos_entidad_valor" })

• Seed de roles del sistema: npm run seed:roles (idempotente).

• RecetAr agrega campos nuevos al schema de recetas (identificadoresExternos,
  syncExterno, estados/estadosDispensa/dispensa). Sin migración de datos.