通用操作约定
一句话：所有菜单页共用的操作模式——查询、导入导出、字典标签、权限提示、页签与外观。学会本页，后面每篇的「常用操作」不再重复解释这些动作。
查询与重置
每个列表页的内容区顶部都是同一套查询区（以「系统管理 → 组织权限 → 用户管理」为例）：
| 控件 | 作用 | 说明 |
|---|---|---|
| 文本 / 下拉条件 | 过滤列表 | 条件之间是「并且」关系 |
| 创建时间 | 时间区间过滤 | 选起止日期，含当天 |
| 搜索 | 按当前条件查询 | 在输入框里按回车等价于点搜索 |
| 重置 | 清空全部条件并重新查询 | 不会保留上次的条件 |
操作步骤：
- 在条件框输入或选择过滤值；
- 点「搜索」（或回车）；
- 想回到全量列表，点「重置」。
结果：列表按条件刷新，右下角显示「共 N 条」与分页器；分页器可改每页条数（默认 20 条/页）。
导入与导出
列表页工具条上固定有三个批量动作：导入、导出、批量删除（后两者需要先勾选行）。
导入是分三步的向导：① 上传文件 → ② 检查数据 → ③ 导入结果。
- 点「导入」打开弹窗，点「下载导入模板」拿标准表头；
- 在模板里填数据（下拉类字段填中文即可，系统会反查成编码），保存为
.xls/.xlsx； - 把文件拖进虚线框或点「点击选择」，点「下一步」；
- 在「检查数据」步看表头与逐行校验结果，有问题的行会标出原因；
- 确认后进入「导入结果」，显示成功 / 失败条数。
表头按列名匹配，不按位置
模板里的列顺序可以打乱、可以删掉不填的列，系统按列名对齐；但列名本身不能改。单次上限 20000 行 / 10MB。
导出没有弹窗
点「导出」直接由浏览器下载一份 Excel（勾选了行就只导出勾选行，没勾选就导出当前查询条件下的全部行）。浏览器若拦了下载，看地址栏右侧的下载提示放行即可。
批量删除不可恢复
勾选行后点「批量删除」，确认框里点确定即物理删除所选记录（审计日志里仍留有操作记录，但数据本身回不来）。删错只能重新录入或导入。
字典标签：同一含义全站同色
列表里的彩色小标签（如角色类型「内置 / 自定义」）不是写死的，而是字典渲染出来的：
- 每个标签属于一个字典类型（如
system_role_type），字典数据在「系统管理 → 字典管理」维护； - 标签的文字与颜色由字典数据的「标签 / 颜色」决定，改一处全站生效；
- 看到不认识的标签值，去字典管理搜该字典类型即可对照含义。
权限提示的三种表现
平台对「没权限」的处理分三层，表现各不相同：
| 层 | 表现 | 原因 |
|---|---|---|
| 菜单 | 侧边菜单里根本没有这一项 | 角色未授权该菜单，或不在租户套餐内 |
| 按钮 | 页面在，但「新增 / 删除」等按钮不显示 | 按钮按权限串显隐（前端 v-hasPermi） |
| 路由 | 直接输地址访问，落到 403 页 | 后端接口校验权限串不通过 |
下图是普通员工视角 salesman01 直接访问「用户管理」地址的结果：
看不到按钮 ≠ 系统坏了
先确认当前视角：超管 admin 靠通配权限全开，不能用来验证按钮显隐；验证请用 docadmin 或 salesman01。需要给角色补按钮权限时，走「系统管理 → 组织权限 → 角色管理」行内「资源授权」，详见角色资源授权。
页签：多页并存与批量关闭
内容区上方的页签栏支持同时开多个页面，切换不丢查询条件：
- 点页签 = 切换页面；页签上的 × = 关闭该页；
- 右键页签弹出批量操作菜单：
| 菜单项 | 作用 |
|---|---|
| 重新加载 | 刷新当前页（等价于 F5 但保留页签） |
| 关闭标签页 | 关掉右键的这一页 |
| 关闭左侧 / 右侧标签页 | 以该页为界批量关闭 |
| 关闭其他标签页 | 只留这一页 |
| 关闭全部标签页 | 清空页签回首页 |
页签栏右端还有三个小图标：展开/收起页签栏、刷新当前页、切换内容区全屏（表格密集时好用）。
外观：主题色、布局与暗黑模式
点顶部工具栏的齿轮图标打开「项目配置」抽屉：
可调整：主题色、导航布局（左侧 / 顶部 / 混合）、界面显示开关（面包屑、页签、全屏图标等）、以及「暗黑模式」开关：
外观配置只存在你自己的浏览器
这些设置保存在本地（localStorage），不影响其他同事；换浏览器或清缓存后恢复默认。手册截图统一使用浅色默认外观，便于对照。
常见问题
Q：点了「导出」没反应？ A：浏览器拦截了自动下载。看地址栏右侧的下载拦截提示，选择「始终允许」后重试。
Q：导入在「检查数据」步全红？ A：九成是表头被改过或用了旧模板。重新下载当前模板，只改数据行不动表头。
Q：查询条件填了但列表没变化？ A：确认点的是「搜索」而不是回车在别的输入框里；仍无效看页签是否需要「重新加载」——列表缓存了上次的查询结果。
Q：暗黑模式下截图里的图表发白？ A：个别图表组件未适配暗色，属已知表现；阅读以浅色模式为准，或临时关掉暗黑模式开关。