Struct UserContext 

pub struct UserContext {
    pub user_id: i64,
    pub is_super: bool,
    pub roles: Vec<String>,
    pub permissions: Vec<String>,
}

用户上下文 — 扩展 AuthenticatedUser，提供权限信息

由业务层在登录时构建并注入到 request extensions（在 Auth 中间件之后、Guard 之前）。 Guard 通过 UserContext 进行权限判断。

PHP 对齐

对齐 PHP szoa RBAC 模型：

• is_super=true 绕过所有 RBAC（对齐 PHP is_super=1）
• roles 对齐 PHP role 表（通过 user_role 关联）
• permissions 对齐 PHP access 表（格式：controller/action，如 user/list）

注入时机

Auth 中间件（注入 AuthenticatedUser）
    ↓
业务中间件（查 DB 获取 roles/permissions，注入 UserContext）
    ↓
Guard（基于 UserContext 进行鉴权决策）
    ↓
Handler

如果业务代码未注入 UserContext，AdminGuard / PermissionGuard / RoleGuard 将返回 Forbidden（无权限访问）。

Fields

user_id: i64

用户 ID（对齐 AuthenticatedUser::user_id）

is_super: bool

是否超级管理员（对齐 PHP is_super=1，绕过所有 RBAC）

roles: Vec<String>

角色列表（对齐 PHP role 表）

permissions: Vec<String>

权限列表（对齐 PHP access 表，格式：controller/action）

Implementations

impl UserContext

pub fn new(user_id: i64) -> Self

创建 UserContext（默认非超级管理员，无角色，无权限）

pub fn with_super(self, is_super: bool) -> Self

设置是否超级管理员

pub fn with_roles(self, roles: Vec<String>) -> Self

设置角色列表

pub fn with_permissions(self, permissions: Vec<String>) -> Self

设置权限列表

pub fn has_role(&self, role: &str) -> bool

检查是否具有指定角色

对齐 PHP User::hasRole() 角色 检查

pub fn has_permission(&self, permission: &str) -> bool

检查是否具有指定权限

对齐 PHP AuthService::check() 权限检查：

• 精确匹配：user/list == user/list → true
• 通配符匹配：user/* 匹配 user/list → true（对齐 PHP 通配符权限）

注意：is_super=true 的绕过逻辑由 Guard 负责，本方法仅检查权限列表。

Trait Implementations

impl Clone for UserContext

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UserContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for UserContext

fn default() -> Self

Returns the “default value” for a type.

impl From<AuthenticatedUser> for UserContext

fn from(user: AuthenticatedUser) -> Self

从 AuthenticatedUser 创建 UserContext

默认非超级管理员，无角色，无权限（业务层需后续调用 with_super / with_roles / with_permissions 补充权限信息）。