Plataforma de gestión de contrataciones de profesionales de la salud
Industria
Salud y ciencias de la vida
Cliente
Confidencial
País
Costa Rica
Las empresas de ciencias de la vida necesitan coordinar contrataciones de profesionales de la salud para asesorías, conferencias, investigación y consultoría, manteniendo controles financieros, cumplimiento normativo y trazabilidad de las decisiones.
La plataforma SaaS desarrollada por Arkkosoft centraliza este proceso mediante una solución multiempresa que administra cada contratación desde la planificación hasta el cierre.
Contexto operativo:
Múltiples clientes dentro de una plataforma compartida.
Accesos diferenciados para personal interno, administradores y profesionales de la salud.
Evaluaciones de valor justo de mercado (FMV) y administración de tarifarios.
Requisitos de cumplimiento por participante.
Modificaciones posteriores a la aprobación que requieren supervisión.
Necesidad de negocio:
Centralizar contrataciones, participantes y aprobaciones.
Estandarizar controles de cumplimiento y evaluaciones FMV.
Preservar tarifas aprobadas y registrar cambios.
Garantizar la separación de datos entre clientes.
Desafío para Arkkosoft:
Coordinar estos procesos entre dos aplicaciones, utilizando un backend compartido, con aislamiento de datos, permisos diferenciados y entregas controladas.
Solución y enfoque de implementación
La plataforma SaaS desarrollada por Arkkosoft combina una API compartida con dos aplicaciones independientes: Platform, para personal interno y administradores, y Portal, para profesionales de la salud.
Implementación de la gestión de contrataciones
- Administración de estados: Borrador, Pendiente de aprobación, Aprobada, Activa y Cerrada.
- Soporte para rechazo y cancelación.
- Gestión de participantes y verificaciones de cumplimiento que condicionan las transiciones.
- Cuestionarios FMV y selección de tarifas según rol y actividad.
- Conservación de tarifas confirmadas al aprobar.
- Registro de modificaciones por campo, con edición y conciliación de las pestañas afectadas.
Enfoque de implementación
- Backend compartido con FastAPI y SQLAlchemy.
- Aplicaciones Next.js con componentes y bibliotecas compartidos.
- Autenticación mediante Auth0 y validación JWT por solicitud.
- Audiencias y permisos específicos para cada aplicación.
- Aislamiento mediante particionamiento y seguridad a nivel de fila.
- Migraciones de base de datos con Alembic.
- Pruebas y controles automatizados en Azure DevOps.
- Despliegue mediante Docker y Octopus Deploy sobre Linux y nginx.
Resultado de la implementación
Una plataforma integrada con flujos estructurados, controles por participante, tarifas preservadas, modificaciones trazables y separación de datos por cliente.
Tecnología aplicada
Autenticación e identidad
Auth0, tokens JWT y permisos diferenciados por audiencia.
Integración de backend
Python 3.12, FastAPI, SQLAlchemy 2.0, ReportLab y SMTP.
Base de datos y almacenamiento
PostgreSQL 15+, Alembic, Redis y almacenamiento compartido con ubicaciones permanentes y de cuarentena.
Infraestructura y DevOps
Azure DevOps Pipelines, Docker, registro de contenedores del cliente, Octopus Deploy, Linux, nginx, SonarQube y pruebas automatizadas.
Frontend web
Next.js App Router, TypeScript, Tailwind CSS y Radix UI/shadcn UI.
Observabilidad
OpenTelemetry y Elastic APM.
Complejidad técnica
La complejidad radica en coordinar procesos sujetos a requisitos normativos para múltiples clientes y usuarios, preservando aislamiento, consistencia financiera y capacidad de auditoría.
Los principales desafíos incluyen aplicar permisos consistentemente, condicionar transiciones al cumplimiento individual, conservar tarifas aprobadas y registrar modificaciones sin sobrescribir la información original.
La arquitectura incorpora controles por capas, reglas explícitas y seguimiento de cambios, manteniendo compatibilidad entre ambas aplicaciones y despliegues controlados.
Impacto y beneficios
- Gobernanza: flujos y aprobaciones definidos.
- Trazabilidad financiera: conservación de tarifas confirmadas.
- Auditoría: identificación de cambios posteriores.
- Seguridad: acceso restringido y aislamiento por cliente.
- Experiencia: portal dedicado para profesionales.
- Escalabilidad: incorporación de múltiples organizaciones.
- Calidad: pruebas automatizadas y promoción controlada entre ambientes.
