Saltar a contenido

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

Bases: BaseModel

username = Field(..., max_length=50) class-attribute instance-attribute

password = Field(..., max_length=200) class-attribute instance-attribute

RegistroRequest

Bases: BaseModel

username = Field(..., max_length=50) class-attribute instance-attribute

full_name = Field(..., min_length=3, max_length=120) class-attribute instance-attribute

password = Field(..., max_length=200) class-attribute instance-attribute

CambioContrasenaRequest

Bases: BaseModel

actual = Field(..., max_length=200) class-attribute instance-attribute

nueva = Field(..., max_length=200) class-attribute instance-attribute

UsuarioCrear

Bases: BaseModel

username = Field(..., max_length=50) class-attribute instance-attribute

full_name = Field(None, max_length=120) class-attribute instance-attribute

password = Field(..., max_length=200) class-attribute instance-attribute

role = 'TESTER' class-attribute instance-attribute

UsuarioActualizar

Bases: BaseModel

full_name = Field(None, max_length=120) class-attribute instance-attribute

role = None class-attribute instance-attribute

active = None class-attribute instance-attribute

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».