Roles y permisos

Objetivo

Enseñar qué responsabilidad asume cada rol, qué puede hacer en la versión actual y cuándo debe derivar una tarea. Los permisos se aplican tanto en la interfaz como en las APIs.

Matriz funcional

Acción	Propietario	Administración	Recepción	Profesional	Asistente	Facturación	Auditoría	Solo lectura
Consultar fichas	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Crear ficha	Sí	Sí	Sí	No	Sí	No	No	No
Actualizar datos administrativos	Sí	Sí	Sí	No	No	No	No	No
Consultar agenda	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Gestionar agenda	Sí	Sí	Sí	Sí	Sí	No	No	No
Consultar información clínica	Sí	Sí	No	Sí	Sí	No	Sí	No
Crear/actualizar clínica	Sí	Sí	No	Sí	No	No	No	No
Firmar clínica	Sí*	No	No	Sí*	No	No	No	No
Gestionar adjuntos	Sí	Sí	No	Sí	No	No	No	No
Administrar usuarios	Sí	Sí	No	No	No	No	No	No
Configurar espacio	Sí	Sí	No	No	No	No	No	No
Consultar auditoría	Sí	Sí	No	No	No	No	Sí	No
Crear exportaciones	Sí	Sí	No	No	No	No	Sí	No

* La firma exige además una identidad vinculada a un profesional habilitado y vigente cuando el circuito lo requiere.

Propietario

Misión: gobernar el espacio y asegurar que personas, configuración y controles sean correctos.

Responsabilidades:

• completar la puesta en marcha;
• definir administradores y roles;
• controlar suscripción y continuidad;
• revisar auditoría e incidentes;
• garantizar que las cuentas profesionales estén vinculadas correctamente.

No debe usar su acceso total para firmar como otra persona. El permiso amplio no reemplaza autoría profesional.

Práctica: crear un usuario de recepción, comprobar su menú y demostrar que no puede abrir Equipo.

Administración

Misión: mantener la operación configurada y resolver necesidades institucionales.

Puede administrar fichas, agenda, equipo, configuración, adjuntos, auditoría y exportaciones. No posee clinical.sign.

Derivá cuando: una nota, receta, informe o protocolo necesita firma profesional.

Práctica: crear ubicación, servicio y disponibilidad; luego obtener un horario válido sin firmar documentación clínica.

Recepción

Misión: identificar correctamente y coordinar la atención.

Puede crear y actualizar fichas administrativas, consultar y gestionar agenda y revisar información de facturación habilitada. No debe acceder a controles clínicos de edición.

Antes de crear: buscar por los identificadores adecuados a la experiencia. En veterinaria, priorizar teléfono o DNI del tutor y comparar los datos de la mascota; usar microchip sólo cuando haya sido informado.

Derivá cuando: se requiere interpretación clínica, firma, auditoría o modificación de configuración.

Práctica: encontrar una ficha existente, confirmar contacto, crear un turno y explicar por qué no puede editar una nota clínica.

Profesional

Misión: documentar la atención y su seguimiento con autoría.

Puede consultar pacientes y agenda, gestionar turnos, crear y actualizar registros clínicos y administrar adjuntos. Puede firmar cuando la cuenta está vinculada y habilitada.

No puede administrar usuarios ni configuración general.

Práctica: crear una nota borrador, revisarla, firmarla y comprobar que la versión firmada no se edita como borrador.

Asistente

Misión: apoyar el ingreso y la coordinación sin asumir responsabilidades de administración o firma.

Puede consultar fichas, crear altas básicas, gestionar agenda y leer información clínica o adjuntos autorizados. No puede actualizar datos administrativos existentes, crear clínica, firmar ni gestionar archivos.

Práctica: crear una ficha ficticia y un turno; luego comprobar que no puede firmar.

Facturación

Misión: consultar la información administrativa necesaria para la gestión económica.

Puede consultar fichas y agenda y acceder a lectura de facturación. No puede crear o modificar pacientes, agenda ni información clínica.

Práctica: localizar un turno y verificar datos administrativos sin abrir o modificar contenido clínico.

Auditoría

Misión: reconstruir eventos sin intervenir en la operación.

Puede consultar fichas, clínica, agenda y auditoría, y crear exportaciones autorizadas. No modifica registros.

Práctica: identificar quién realizó un cambio, cuándo ocurrió y sobre qué entidad; registrar la evidencia sin alterar el caso.

Solo lectura

Misión: consultar información básica sin modificarla.

Puede ver fichas y agenda. La interfaz debe explicar que no puede crear turnos.

Práctica: recorrer una ficha y la agenda y confirmar que no hay una vía habilitada de modificación.

Administración de Atenlia

Es un alcance privado de plataforma, no un rol operativo de la institución. Atenlia admite un único Super Admin activo. No se publica un enlace a su consola, la página no se indexa y cada endpoint exige una sesión platform_admin sin institución asociada.

Cuando necesita revisar una organización, el Super Admin debe indicar el motivo. Atenlia crea una sesión separada de 30 minutos, asocia cada consulta y acción al clinic_id elegido y registra la entrada y la salida. El acceso no reemplaza al profesional firmante ni debe utilizarse como cuenta diaria del cliente.

Los integrantes con rol de soporte de plataforma no pueden abrir la consola ni sus APIs. La recuperación excepcional del único Super Admin se realiza mediante un procedimiento operativo con acceso a infraestructura; no existe una promoción pública desde la aplicación.

Roles que no existen de forma independiente

“Laboratorio” y “Diagnóstico por imágenes” son áreas funcionales mencionadas en material anterior, pero no son roles independientes del modelo vigente. Para operarlas debe asignarse uno de los roles implementados con permisos suficientes. No prometas perfiles separados hasta que existan en el sistema.

Cómo elegir un rol

1. Listá las tareas habituales de la persona.
2. Elegí el rol mínimo que las cubre.
3. Probalo con datos ficticios.
4. Revisá accesos sensibles.
5. Documentá quién aprobó la asignación.
6. Retirá el acceso cuando cambie la función.