需求 2.5.1 用户账号管理,全部要求管理员权限(require_admin 依赖):
- 接口:列表/详情/新增/编辑/删除/重置密码/启停/角色下拉,
角色下拉放 /users/meta/roles 以避开 /{user_id} 的路由匹配冲突
- 删除、禁用、改角色三处自我保护:不允许对当前登录账号执行,
避免管理员误操作后立刻失去全部管理权限且无法自行恢复
- 重置密码与禁用均提升 token_version,使已签发令牌立即失效,
不依赖 Redis 黑名单
- 密码按字节数校验(bcrypt 5.0 硬上限 72 字节,中文一字 3 字节)
- 用户列表按 id 倒序:create_time 为秒级精度,同秒数据分页结果不确定
- 修复 replace_roles 未同步关系集合的缺陷:改用 user.user_roles
集合追加,此前 session.add(UserRole(...)) 会表现为保存成功但返回空角色
- update_user 的自我保护原先依赖返回 None 的占位函数,恒不生效,
改为显式传入 operator_id
Co-Authored-By: Claude Code <noreply@anthropic.com>
28 lines
754 B
Python
28 lines
754 B
Python
"""API 路由汇总。
|
||
|
||
各业务模块的路由在此挂载。业务接口统一放在 `/api/v1/` 之下,
|
||
健康检查作为运维探针不带版本号,直接位于 `/api/health`。
|
||
"""
|
||
|
||
from fastapi import APIRouter
|
||
|
||
from app.api import health
|
||
from app.api.v1 import auth
|
||
from app.api.v1.system import users as system_users
|
||
|
||
api_router = APIRouter()
|
||
|
||
# 运维探针:/api/health
|
||
api_router.include_router(health.router)
|
||
|
||
# 业务接口:/api/v1/*
|
||
v1_router = APIRouter(prefix="/v1")
|
||
v1_router.include_router(auth.router)
|
||
|
||
# 系统管理(需求 2.5.1):/api/v1/system/*
|
||
system_router = APIRouter(prefix="/system")
|
||
system_router.include_router(system_users.router)
|
||
v1_router.include_router(system_router)
|
||
|
||
api_router.include_router(v1_router)
|