StructBERT WebUI 权限管理扩展：RBAC 角色控制、分析记录审计日志功能实现
1. 项目背景与需求分析
StructBERT 情感分类模型作为中文 NLP 领域的经典工具，在各类业务场景中发挥着重要作用。随着使用范围的扩大，原有的 WebUI 界面在权限管理和操作审计方面逐渐显现出不足。
当前痛点分析：
- 所有用户共享同一界面，无法区分不同角色的操作权限
- 缺乏用户身份验证机制，存在数据安全风险
- 没有操作记录追踪，出现问题难以定位
- 无法统计不同用户的使用情况和分析量
扩展需求：
- 实现基于角色的访问控制（RBAC）
- 记录所有用户操作并生成审计日志
- 提供用户管理和权限分配界面
- 保持原有功能的完整性和易用性
2. 技术架构设计
2.1 整体架构升级
在原有 Gradio + Flask 架构基础上，我们增加了以下组件：
# 新增核心组件 - auth_manager.py # 认证授权管理 - rbac_handler.py # 角色权限控制 - audit_logger.py # 审计日志记录 - user_management.py # 用户管理界面 - database.py # 数据存储层
2.2 数据库设计
使用 SQLite 作为轻量级数据存储，包含以下表结构：
-- 用户表 CREATE TABLE users ( id INTEGER PRIMARY KEY, username TEXT UNIQUE, password_hash TEXT, role_id INTEGER, created_at DATETIME ); -- 角色表 CREATE TABLE roles ( id INTEGER PRIMARY KEY, name TEXT UNIQUE, permissions TEXT -- JSON格式权限配置 ); -- 审计日志表 CREATE TABLE audit_logs ( id INTEGER PRIMARY KEY, user_id INTEGER, action_type TEXT, target TEXT, result TEXT, timestamp DATETIME, ip_address TEXT );
3. RBAC 角色权限控制实现
3.1 角色定义与权限划分
我们设计了四种基础角色，满足不同使用场景的需求：
| 角色 | 权限说明 | 适用场景 |
|---|---|---|
| 管理员 | 所有功能权限 + 用户管理 | 系统维护人员 |
| 高级用户 | 无限次情感分析 + 批量处理 | 业务分析人员 |
| 普通用户 | 每日有限次分析 + 查看历史 | 一般使用者 |
| 只读用户 | 仅查看分析结果 | 演示或审计人员 |
3.2 权限验证实现
在原有 WebUI 基础上增加权限验证层：
def check_permission(user, required_permission): """检查用户是否拥有指定权限""" user user.is_authenticated: user_role = get_user_role(user.) permissions = get_role_permissions(user_role) required_permission permissions
