BV 用户系统功能介绍

摘要

BV 用户系统是 BV 产品线的统一用户、组织、认证和权限管理服务，为接入应用提供用户管理、角色与数据权限、应用菜单、API Key 授权、基础配置及运行审计能力。

本文基于 2026 年 9 月 18 日实际获取的已发布前端资源整理，尚未完成账号登录和后台接口核验。因此，文中功能入口、页面字段与操作流程可作为当前版本的使用参考；当前账号可见范围、接口执行结果和具体业务数据权限，仍应以登录后验证结果为准。

一、系统概述

BV 用户系统是面向多业务应用的统一用户、组织、身份认证与权限管理平台。系统集中维护用户、部门、岗位、职务、角色和应用信息，并提供菜单权限、数据范围与 API Key 授权配置，为业务应用提供统一的管理入口。

从已部署前端的功能定义看，系统围绕三个主要场景展开：

1. 人员与组织管理：维护用户身份及组织归属，为用户配置岗位、角色和职务。
2. 应用接入与授权管理：维护接入应用、应用菜单和业务权限，为人员及程序调用方配置访问范围。
3. 运行管理与追溯：通过统计首页、操作日志、登录日志、在线会话和运行监控了解系统使用情况。

二、功能总览

以下按业务用途归类；实际导航层级以登录后返回的菜单为准。

三、登录与个人中心

3.1 账户登录

登录页采用用户名、密码和图片验证码组合认证。用户可以点击验证码刷新图片，也可以通过登录按钮或回车提交登录。

页面对用户名、密码和验证码设置非空校验。登录成功后按照访问来源跳转到目标页面；本次提供的链接指向登录后的 API Key 页面。

3.2 个人中心

个人中心包含基本资料、修改密码、第三方绑定和注册访问控制四个页签。

“注册访问控制”是页面实际名称，其当前表单主要用于密码与登录限制策略。前端提供数字、大写字母、小写字母、特殊字符等复杂度选项，以及10分钟、20分钟、30分钟的禁止登录时间选项。策略实际作用范围和后台执行效果仍需登录后进一步确认。

四、首页与运行概览

首页汇总平台使用情况，主要包括：

• 核心数量指标：用户数量、在线用户、关联应用、角色数量。
• 操作统计：按操作类别展示操作数量变化。
• 最新动态：展示用户、业务模块、操作类型、操作时间和处理结果，并提供进入全部操作日志的入口。
• 应用活跃度：按应用展示访问量随日期的变化。

最新动态区分成功、失败和结果未知，并提供加载失败后的重新加载入口。首页适合用于日常巡查及进入详细日志前的概览查看。

五、人员与组织管理

5.1 用户管理

用户管理集中维护平台账号，并建立用户与部门、岗位、角色和职务之间的关联。

主要能力：

• 按部门树筛选用户，并按用户名称、手机号码、状态及创建时间检索。
• 新增、修改、删除用户，配置账号状态。
• 维护用户名称、昵称、部门、手机、邮箱、性别和备注。
• 为用户选择岗位、角色及职务。
• 提供管理员重置用户密码入口。
• 支持用户数据导入、导出及导入模板下载。

导入界面支持 .xls 和 .xlsx 文件，并提供是否更新已存在用户数据的选项。用户列表展示用户编号、名称、昵称、部门、手机号码、状态和创建时间等信息。

5.2 部门管理

部门管理用于维护组织层级。表单包含上级部门、部门名称、显示排序、负责人、联系电话、邮箱和状态。

部门信息既用于人员归属，也用于角色数据权限中的部门范围配置。管理员可以按部门名称和状态检索，并通过新增、修改、删除入口维护组织结构。

5.3 岗位管理

岗位管理用于维护岗位编码、岗位名称、显示顺序、状态和备注。提供查询、新增、修改、删除和导出能力，并可在用户管理中关联岗位。

5.4 职务管理

职务管理支持创建职务层级，并为职务配置业务权限。

• 维护职务名称、上级职务和备注。
• 按职务名称查询，支持单条和批量删除。
• 查看职务已有权限，并按权限名称检索。
• 从权限组中选择权限加入职务，或移除已有权限。

岗位和职务是独立配置对象。已发布前端中，职务具有专门的业务权限关联界面，不宜将两者视作同一功能。

六、用户权限与业务权限管理

6.1 角色管理

角色用于将一组功能权限和数据范围分配给用户。角色维护项包括角色名称、权限字符、显示顺序、状态和备注。

角色配置界面包含菜单权限和应用权限，另提供独立的数据权限配置入口。

角色列表支持按名称、权限字符、状态和创建时间查询，并提供新增、修改、删除、启用或停用及导出入口。数据范围配置是否在具体业务接口中执行，应以接入应用的实际实现为准。

6.2 菜单管理

菜单管理用于配置目录、菜单和按钮三类权限节点。

主要配置项包括上级菜单、菜单名称、类型、图标、显示排序、是否外链、路由地址、组件路径、权限标识、显示状态和菜单状态。

目录和菜单构成用户的导航结构，按钮节点用于描述操作级权限。配置完成后可在角色中分配对应菜单权限。

6.3 权限组与权限项

系统提供独立的权限组管理功能，用于组织业务权限目录。

• 权限组信息包括权限组ID、名称、简称或别名、备注。
• 可在权限组下新增权限项，维护权限编号、名称、别名、链接URL及是否必选。
• 可查询权限组、查看权限详情并删除权限组或权限项。
• 权限项可通过职务管理分配给对应职务。

6.4 各类权限的用途

上述是系统中不同的配置入口。其后台判定顺序、权限叠加规则及跨应用执行方式，尚未通过本次访问验证。

七、应用管理与应用菜单

7.1 应用基础管理

应用管理维护接入系统的身份与基础属性，提供新增、修改、删除及多条件查询入口。

主要信息包括应用名称、appId、appSecret、应用状态、应用类型、是否允许多点登录、是否展示活跃度、默认部门、默认岗位、默认角色和描述。

可按应用名称、状态、类型、多点登录设置及活跃度展示设置筛选应用。

前端要求应用名称全局不重复，比较时忽略英文大小写、全半角和首尾空格。应用默认部门、岗位和角色字段用于接入配置，实际触发和分配规则需结合后台进一步确认。

7.2 按应用维护菜单

应用列表提供“菜单配置”入口。系统根据应用名称定位“权限控制 / 应用名称”下的菜单树，在该范围内提供新增、修改、删除和查询能力。

菜单配置支持目录、菜单、按钮节点，维护属性与全局菜单管理一致。界面包含应用范围检查，避免将当前操作保存到其他应用的菜单节点。

应用改名时，前端会提示同步修改对应菜单根节点名称，否则菜单配置入口可能无法关联。若存在重复应用名称或同名根菜单，界面会提示先处理重复配置。

7.3 应用菜单导入导出

应用菜单支持导出为 JSON 文件，并通过导入预览将缺失菜单补齐到目标应用。

导出能力：导出完整应用菜单节点，前端提示包含隐藏和停用节点。

导入流程：选择文件 → 校验文件 → 查看预览 → 处理待确认节点 → 确认补齐 → 查看导入结果。

导入预览展示新增、已有、保留差异、待确认及随父级跳过的节点，并列出菜单位置、权限标识和配置差异。缺失的应用根菜单可在确认导入时一并创建。

该功能采用补齐方式：不删除、不覆盖已有配置，也不会自动给角色授权。存在待确认项时，可确认跳过对应节点及其子树后处理其余节点。

当前前端限制为不超过2 MB的 JSON 文件，支持系统规定的文件格式及版本，节点数量上限为2,000个。功能还依赖菜单导入导出权限及相应后台接口，当前账号是否可用尚待核验。

八、API Key 与接口授权

8.1 功能定位

API Key 是分配给后端服务、自动化脚本或第三方系统的接口访问凭证。每个 Key 按应用选择业务权限，并受启用状态与有效期限制。

系统提供的使用说明要求调用已授权应用时，在 HTTP 请求头中携带：

bv-api-key: <您的 API Key>

8.2 API Key 管理

有效期可选择永久或自定义时间。前端校验自定义时间不可早于当前时间，并要求至少选择一个应用权限范围。

8.3 按应用选择授权范围

授权界面以应用为分组，支持：

• 按应用名称或ID搜索应用。
• 切换应用并选择其业务权限。
• 按权限名称、权限代码或说明搜索权限。
• 全选当前应用的权限。
• 统计已选应用数及权限项总数。

如果没有可授权应用，页面提示先在应用管理中启用 API Key 并配置权限目录。

8.4 应用 API Key 权限配置

应用管理中的“API Key权限”入口用于配置应用接入规则，主要包含：

• 是否允许 API Key 访问。
• 授权变更同步模式。
• 应用服务地址及通知接口信息。
• 缓存TTL，单位为秒。
• 应用独立的内部鉴权密钥及生成、轮换入口。
• 权限代码、权限名称、说明、状态和排序。
• 连接测试入口。

权限代码需要以大写字母开头，仅使用大写字母、数字和下划线；前端校验长度不超过64个字符，并检查重复代码。启用 API Key 时至少需要一个有效权限项。

在系统中登记权限代码只是接入配置的一部分。应用服务或网关还需使用同一代码实现接口鉴权，才能使授权范围落实到具体接口。页面使用说明将这一过程分为盘点接口、应用实现、登记权限和授权验证四步。

8.5 授权变更同步方式

仅固定TTL模式的页面说明为变更最长延迟一个缓存TTL。实际失效时效、通知重试和异常处理结果尚未通过本次访问测试。

8.6 两类凭证的区别

界面明确提示内部鉴权密钥轮换后，应用端当前密钥将失效，需要同步更新应用服务配置。文档示例均使用占位符，不展示实际凭证。

九、基础配置与通知公告

9.1 字典管理

字典管理维护字典类型及对应数据项。

• 字典类型维护名称、类型标识、状态和备注。
• 字典数据维护标签、键值、排序、状态和备注。
• 提供查询、新增、修改、删除、导出及字典缓存清理入口。

字典用于集中维护状态、分类等选项，减少各功能模块重复配置。

9.2 参数配置

参数配置维护参数名称、键名、键值、是否系统内置和备注，提供查询、新增、修改、删除、导出及缓存清理入口。

9.3 通知公告

通知公告维护标题、公告类型、状态和内容，提供按标题、操作人员和类型查询，以及新增、修改、删除入口。内容区使用富文本编辑组件。

十、日志审计与运行监控

10.1 操作日志

操作日志支持按系统模块、操作人员、操作类型、状态和时间范围查询。

详情包含操作模块、登录信息、请求地址、请求方式、操作方法、请求参数、返回参数、操作状态和时间等信息，提供导出、删除及清空入口。

10.2 登录日志

登录日志展示用户名称、登录地址、地点、浏览器、操作系统、状态、操作信息和登录日期，支持按用户、登录地址、状态和时间检索，并提供导出、删除及清空入口。

10.3 在线用户

在线用户模块展示会话编号、登录名称、部门、主机、地点、浏览器、操作系统和登录时间，提供在线会话查询与强制退出入口。

10.4 服务与数据监控

这些模块在发布资源中存在，但是否已向当前账号开放、内嵌监控服务是否可访问，仍需登录确认。

十一、定时任务与开发辅助

11.1 定时任务

定时任务支持维护任务名称、任务分组、调用目标、Cron表达式、是否并发、错误策略及任务状态，提供新增、修改、删除、启停、执行一次、详情和导出入口。

调度日志支持查看执行时间、调用目标、日志信息、执行状态及异常信息，用于追溯任务运行结果。

11.2 开发辅助工具

上述工具属于已发布前端中的开发辅助能力，不应据此认定当前账号全部可用。

十二、典型使用流程

12.1 为新用户配置访问权限

1. 在部门和岗位管理中准备组织基础数据。
2. 在角色管理中配置菜单权限、应用权限及数据范围。
3. 如业务采用职务授权，在权限组中维护权限项，并关联到职务。
4. 在用户管理中创建用户，选择部门、岗位、角色和职务。
5. 使用目标用户登录，检查可见菜单及数据范围。

12.2 接入一个业务应用

1. 在应用管理中维护应用名称、类型、状态及默认配置。
2. 在应用菜单配置中维护菜单树，或导入已有菜单配置文件。
3. 通过角色管理分配应用及菜单权限。
4. 配合业务应用完成认证授权接入，并验证实际访问结果。

菜单导入不会自动完成角色授权，因此导入后仍需进行第3步。

12.3 为程序配置 API Key

1. 应用服务或网关实现需要保护的业务权限代码。
2. 在应用管理中启用 API Key，登记权限目录并配置同步方式。
3. 完成内部鉴权配置及必要的连接检查。
4. 创建 API Key，设置用途、有效期和具体应用权限。
5. 调用方通过 bv-api-key 请求头携带凭证访问接口。
6. 分别验证允许访问、未授权拒绝、禁用及过期场景。