Guía para Gestionar Usuarios - Administradores¶

Esta guía explica cómo los administradores crean y gestionan cuentas de usuario en el sistema.

IMPORTANTE: Esta documentación está completamente en español para servir al personal del laboratorio y veterinarios de habla hispana.

Resumen de roles¶

Rol	Código	Alta en el sistema	Verificación de email
Veterinario	`VETERINARIO`	Autoregistro en `/accounts/register/`	Obligatoria
Personal de laboratorio	`PERSONAL_LAB`	Solo administrador (flujo unificado)	Obligatoria
Histopatólogo (legacy)	`HISTOPATOLOGO`	Sin altas nuevas; cuentas existentes	No requerida
Administrador	`ADMIN`	Django Admin o superusuario	No requerida

Crear personal de laboratorio (flujo unificado)¶

Desde julio 2026, todos los usuarios internos de laboratorio (técnicos, patólogos, personal con informes) se crean con un único formulario. El alta antigua de «Histopatólogo» quedó deprecada y redirige automáticamente al flujo nuevo.

Dónde acceder¶

Iniciar sesión como administrador
Ir al Panel de Administración (/dashboard/admin/)
En Gestión de Usuarios, elegir Crear Personal de Laboratorio

También puede abrirse directamente: /accounts/lab-staff/create/

[Espacio para captura de pantalla: Tarjeta «Crear Personal de Laboratorio» en el panel admin]

Datos del formulario¶

Cuenta de acceso

Email (será el usuario de login)
Nombre y apellido
Contraseña inicial (mínimo 8 caracteres; compartirla de forma segura con el empleado)

Perfil profesional

Número de matrícula (único en el sistema)
Cargo y especialidad (opcionales)
Teléfono (opcional)
Firma digital (opcional en el alta; ver más abajo)

Permisos

Campo	Efecto
Puede crear informes	Habilita cola de informes, elaboración, firma en PDF y enlace Reportes en la barra superior
Acceso a órdenes de trabajo y panel admin	Activa `is_staff` en Django (órdenes de trabajo y acceso al admin de Django)

Por defecto, Puede crear informes viene desactivado: el empleado puede hacer recepción y procesamiento; el admin debe marcarlo si también elaborará informes.

Qué hace el sistema al guardar¶

Crea el usuario con rol PERSONAL_LAB, activo y email sin verificar
Crea el perfil LaboratoryStaff vinculado
Envía un email de verificación al empleado (enlace válido 24 horas)
Registra el alta y el envío del email en el log de auditoría (AuthAuditLog)
Redirige al listado de personal de laboratorio en Django Admin

Si el envío de email falla (SMTP no configurado), la cuenta se crea igual; el admin debe reenviar la verificación desde Django Admin.

[Espacio para captura de pantalla: Formulario de alta unificada de personal de laboratorio]

Primer ingreso del empleado¶

Flujo que debe completar el nuevo usuario:

1. Recibir email → Verificar cuenta (clic en el enlace)
2. Iniciar sesión con email y contraseña
3. Cargar firma digital (obligatorio en el primer ingreso)
4. (Opcional) Cambiar contraseña desde Perfil
5. Si tiene «Puede crear informes»: usar Reportes en el menú superior

Verificación de email¶

Sin verificar el email, no puede iniciar sesión (rol PERSONAL_LAB)
Si el enlace expiró: pantalla de login → Reenviar verificación
Los histopatólogos legacy (HISTOPATOLOGO) y administradores no requieren este paso

Firma digital obligatoria¶

Todo el personal de laboratorio debe subir su firma en el primer ingreso, aunque no elabore informes. El sistema redirige automáticamente a /accounts/lab-staff/signature/ hasta completar este paso.

El administrador puede pre-cargar la firma en el formulario de alta (campo opcional)
Si no se precarga, el empleado la sube en el primer acceso
Para elaborar informes además se necesita el permiso Puede crear informes

Ver: Firma digital para personal de laboratorio

Crear veterinarios¶

Los veterinarios se registran solos:

Página pública Registrarse (/accounts/register/)
Completan datos profesionales y verifican el email
Completan el perfil veterinario en el primer acceso si falta información
Un administrador debe habilitar la cuenta antes de que puedan crear protocolos

Hasta la habilitación, el veterinario puede iniciar sesión, completar su perfil y ver sus informes, pero no puede crear protocolos de histopatología ni citología.

Habilitar veterinarios¶

Dónde acceder¶

Iniciar sesión como administrador
Ir al Panel de Administración (/dashboard/admin/)
Elegir Veterinarios (tarjeta con contador de pendientes) o Habilitar Veterinarios en Gestión de Usuarios

También puede abrirse directamente: /dashboard/admin/veterinarians/

Filtros disponibles¶

Filtro	Descripción
Pendientes (default)	Email verificado, perfil activo, sin habilitación admin
Habilitados	Cuentas aprobadas por un administrador
Inactivos	Cuentas desactivadas
Todos	Sin filtro de estado

Búsqueda por nombre, apellido, email, matrícula o CUIL.

Acciones¶

Acción	Efecto
Habilitar	Marca la cuenta como aprobada; envía email al veterinario
Eliminar	Desactiva la cuenta; si no tiene protocolos, libera el email para nuevo registro
Reactivar	Restaura cuentas inactivas sin anonimizar (p. ej. eliminadas por error)

Al eliminar, debe confirmar con el checkbox «Entiendo que no se puede deshacer».

Pantalla de contacto para pendientes¶

Los veterinarios no habilitados ven una pantalla de contacto al intentar crear un protocolo. El administrador puede editar el contenido en:

/dashboard/admin/veterinarian-pending/

Incluye título, mensaje (Markdown), teléfono y email de contacto del laboratorio.

Relación con carga delegada (personal de lab)¶

En la búsqueda de veterinarios para cargar protocolos a nombre de un MV, solo aparecen cuentas habilitadas (is_verified=True), además de email verificado y cuenta activa.

El administrador puede revisar cuentas también en Django Admin → Veterinarios (acciones bulk para soporte técnico).

Gestionar usuarios existentes¶

Django Admin¶

Usuarios (/admin/accounts/user/): activar/desactivar, roles, reenvío de verificación
Personal de laboratorio (/admin/accounts/laboratorystaff/): permisos, firma, matrícula
Histopatólogos (/admin/accounts/histopathologist/): solo cuentas legacy; no permite altas nuevas

Edición habitual¶

Activar o quitar Puede crear informes según las funciones del empleado
Otorgar Acceso staff solo a quien gestione órdenes de trabajo o el admin de Django
Desactivar cuentas de personal que ya no trabaja en el laboratorio (is_active en usuario o perfil)

Histopatólogo (rol legacy)¶

Situación	Acción recomendada
Usuario histopatólogo existente	Sigue operando; el sistema migra el perfil a `LaboratoryStaff` cuando hace falta
Nuevo empleado con funciones de patología	Usar Crear Personal de Laboratorio y marcar Puede crear informes
URL antigua `/accounts/histopathologist/create/`	Redirige al formulario unificado

Seguridad y buenas prácticas¶

Verificar la identidad del empleado antes de crear la cuenta
Asignar el mínimo de permisos necesarios (can_create_reports, is_staff)
Usar contraseñas iniciales fuertes y pedir cambio en el primer ingreso
Revisar periódicamente cuentas activas y permisos
Confirmar que el SMTP de producción esté configurado antes de dar de alta usuarios (ver Configuración de email)

Auditoría¶

Todas las altas y envíos de verificación quedan en AuthAuditLog con IP y agente de usuario, consultable desde Django Admin.

Protocolos rechazados¶

Ver lista de protocolos con muestras rechazadas
Reenviar protocolos si hubo error en la evaluación inicial
Auditoría del historial de estados

Ver: Gestionar protocolos rechazados

Referencias técnicas (desarrolladores)¶

Vista alta lab staff: CreateLaboratoryStaffView — ruta accounts:create_laboratory_staff
Panel habilitación MV: /dashboard/admin/veterinarians/ — AdminVeterinarianManagementView
Pantalla contacto pendientes: /dashboard/admin/veterinarian-pending/
Servicio: VeterinarianApprovalService — src/accounts/services/veterinarian_approval_service.py
Mixin gate protocolos: VeterinarianApprovedMixin — src/accounts/mixins.py
Filtro búsqueda lab: get_enabled_veterinarians_queryset() — src/protocols/lab_protocol.py
Prueba manual: VETERINARIAN_APPROVAL_TESTING.md
Formulario: LaboratoryStaffCreationForm
Middleware: LabStaffSignatureRequiredMiddleware
Documentación interna: Informes, permisos y firma

Siguiente: Configurar sistema