app.api.users¶
Ingreso, solicitud de cuenta y administración de usuarios.
Flujo: una persona solicita una cuenta (queda como TESTER inactiva) → un ADMIN la aprueba → la persona ingresa. El primer ADMIN se crea con APP_ACCESS_USERNAME / APP_ACCESS_PASSWORD (ver app/security/acceso.py).
router = APIRouter()
module-attribute
¶
HORAS_SESION = 8
module-attribute
¶
log = obtener('acceso')
module-attribute
¶
limite_registro = LimiteDeIntentos(maximo=10, ventana=3600)
module-attribute
¶
LoginRequest
¶
RegistroRequest
¶
CambioContrasenaRequest
¶
UsuarioCrear
¶
UsuarioActualizar
¶
RestablecerRequest
¶
Bases: BaseModel
nueva = Field(..., max_length=200)
class-attribute
instance-attribute
¶
UsuarioResponse
¶
Bases: BaseModel
id
instance-attribute
¶
username
instance-attribute
¶
full_name = None
class-attribute
instance-attribute
¶
role
instance-attribute
¶
active
instance-attribute
¶
bloqueado = False
class-attribute
instance-attribute
¶
created_at = None
class-attribute
instance-attribute
¶
last_login_at = None
class-attribute
instance-attribute
¶
model_config = ConfigDict(from_attributes=True)
class-attribute
instance-attribute
¶
login(creds, request, db=Depends(get_db))
¶
Ingresa con usuario y contraseña. Bloquea la cuenta tras 5 fallos seguidos y la IP tras 20 fallos en 15 minutos.
logout(request, db=Depends(get_db))
¶
Cierra la sesión: borra la cookie y anula el token (también en otros equipos donde se haya ingresado).
solicitar_cuenta(datos, request, db=Depends(get_db))
¶
Solicitud de cuenta: queda como TESTER inactiva hasta que un ADMIN la apruebe.
mi_cuenta(user=Depends(usuario_actual))
¶
Usuario de la sesión. Sin control de acceso (modo local) responde como administrador local.
cambiar_mi_contrasena(datos, user=Depends(usuario_actual), db=Depends(get_db))
¶
Cambia la contraseña propia; cierra las otras sesiones y renueva la actual.
listar_usuarios(_=Depends(requiere_admin), db=Depends(get_db))
¶
Todos los usuarios; primero los pendientes de aprobación.
crear_usuario(datos, _=Depends(requiere_admin), db=Depends(get_db))
¶
El administrador crea una cuenta ya activa.
actualizar_usuario(user_id, datos, admin=Depends(requiere_admin), db=Depends(get_db))
¶
Aprobar/desactivar una cuenta o cambiar su rol. No permite quitarse el rol a uno mismo ni dejar el sistema sin administradores.
restablecer_contrasena(user_id, datos, _=Depends(requiere_admin), db=Depends(get_db))
¶
El administrador asigna una contraseña nueva (y desbloquea la cuenta). Cierra las sesiones de ese usuario.
eliminar_usuario(user_id, admin=Depends(requiere_admin), db=Depends(get_db))
¶
Elimina una cuenta (por ejemplo, una solicitud rechazada). El historial conserva el nombre en «ejecutado por».