Files
admin-vben/docs/用户手册.md

398 lines
9.4 KiB
Markdown
Raw Permalink Normal View History

# 用户手册
## 产品概述
AIOTAGRO 管理系统是一个基于 Vue3 + TypeScript 的现代化企业级管理系统,提供丰富的功能模块和优秀的用户体验。本文档为用户提供完整的产品使用指南。
## 快速开始
### 1. 系统访问
#### 访问地址
- 生产环境: https://aiotagro.com
- 测试环境: https://test.aiotagro.com
- 开发环境: http://localhost:3000
#### 浏览器要求
- Chrome 90+ (推荐)
- Firefox 88+
- Safari 14+
- Edge 90+
### 2. 首次登录
#### 账号注册
1. 访问系统登录页面
2. 点击"注册新账号"
3. 填写注册信息(邮箱、手机号、密码)
4. 完成邮箱/手机验证
5. 登录系统
#### 密码要求
- 长度至少8位字符
- 包含大写字母、小写字母、数字
- 建议使用特殊字符增强安全性
## 系统功能
### 1. 仪表盘
#### 功能概述
仪表盘是系统的首页,提供关键业务数据的可视化展示和快速访问入口。
#### 主要功能
- **数据概览**: 显示核心业务指标
- **快捷操作**: 常用功能快速入口
- **消息通知**: 系统消息和待办事项
- **图表展示**: 数据趋势和统计分析
#### 使用指南
1. 登录系统后自动进入仪表盘
2. 点击各个卡片查看详细信息
3. 使用搜索框快速查找功能
4. 自定义仪表盘布局(拖拽调整)
### 2. 用户管理
#### 功能概述
用户管理模块用于管理系统用户账号、权限和角色。
#### 用户列表
- **查看用户**: 显示所有用户信息
- **搜索用户**: 按姓名、邮箱、角色搜索
- **筛选用户**: 按状态、部门、角色筛选
- **批量操作**: 批量启用/禁用用户
#### 添加用户
1. 点击"添加用户"按钮
2. 填写用户基本信息
3. 设置用户角色和权限
4. 发送账号激活邮件
#### 用户编辑
- **基本信息**: 修改姓名、邮箱、电话
- **权限设置**: 调整用户角色和权限
- **状态管理**: 启用/禁用用户账号
- **密码重置**: 重置用户登录密码
### 3. 角色管理
#### 功能概述
角色管理用于定义系统权限组,实现精细化的权限控制。
#### 角色列表
- **查看角色**: 显示所有角色信息
- **角色详情**: 查看角色权限配置
- **角色状态**: 启用/禁用角色
#### 创建角色
1. 点击"创建角色"按钮
2. 输入角色名称和描述
3. 配置角色权限
4. 保存角色配置
#### 权限配置
- **菜单权限**: 控制菜单访问权限
- **操作权限**: 控制功能操作权限
- **数据权限**: 控制数据访问范围
- **API权限**: 控制接口调用权限
### 4. 菜单管理
#### 功能概述
菜单管理用于配置系统导航菜单结构和权限。
#### 菜单树
- **层级结构**: 树形结构展示菜单
- **拖拽排序**: 拖拽调整菜单顺序
- **展开收起**: 展开/收起菜单层级
- **搜索菜单**: 快速查找菜单项
#### 添加菜单
1. 选择父级菜单(可选)
2. 点击"添加菜单"按钮
3. 配置菜单基本信息
4. 设置菜单权限和图标
5. 保存菜单配置
#### 菜单配置项
- **菜单名称**: 显示在导航中的名称
- **菜单路径**: 路由路径或外部链接
- **菜单图标**: 图标标识
- **排序号**: 显示顺序
- **可见性**: 控制菜单是否显示
- **权限控制**: 关联权限配置
### 5. 部门管理
#### 功能概述
部门管理用于组织企业组织架构,实现按部门的数据权限控制。
#### 部门树
- **组织架构**: 树形展示部门结构
- **部门详情**: 查看部门信息和成员
- **部门排序**: 调整部门显示顺序
#### 添加部门
1. 选择父级部门(可选)
2. 点击"添加部门"按钮
3. 填写部门基本信息
4. 设置部门负责人
5. 配置部门权限
#### 部门成员
- **成员列表**: 查看部门所有成员
- **添加成员**: 从用户列表添加成员
- **移除成员**: 从部门移除成员
- **调整角色**: 设置成员在部门中的角色
### 6. 系统设置
#### 功能概述
系统设置模块提供系统级配置和管理功能。
#### 基本设置
- **系统名称**: 设置系统显示名称
- **Logo配置**: 上传系统Logo
- **主题设置**: 配置系统主题颜色
- **语言设置**: 多语言支持配置
#### 安全设置
- **密码策略**: 配置密码复杂度要求
- **登录策略**: 配置登录相关设置
- **会话管理**: 配置会话超时时间
- **审计日志**: 查看系统操作日志
#### 邮件设置
- **SMTP配置**: 配置邮件服务器
- **模板管理**: 管理邮件模板
- **测试发送**: 测试邮件发送功能
## 操作指南
### 1. 数据查询
#### 基本查询
1. 进入相应功能模块
2. 使用搜索框输入关键词
3. 点击搜索按钮或按回车键
4. 查看查询结果
#### 高级查询
1. 点击"高级查询"按钮
2. 选择查询条件字段
3. 设置查询条件和值
4. 添加多个查询条件
5. 执行查询操作
#### 查询技巧
- 使用通配符: * 表示多个字符,? 表示单个字符
- 组合查询: 多个条件同时满足
- 保存查询: 将常用查询保存为模板
### 2. 数据导出
#### 导出当前页
1. 在数据列表页面
2. 点击"导出"按钮
3. 选择导出格式Excel/CSV/PDF
4. 设置导出字段
5. 下载导出文件
#### 导出全部数据
1. 在数据列表页面
2. 点击"导出全部"按钮
3. 选择导出格式
4. 系统后台生成文件
5. 下载导出文件
#### 导出设置
- **字段选择**: 选择需要导出的字段
- **格式设置**: 设置导出文件格式
- **编码设置**: 设置文件编码格式
- **分页设置**: 设置导出数据分页
### 3. 批量操作
#### 批量选择
1. 在数据列表页面
2. 使用复选框选择多个项目
3. 或使用"全选"功能选择所有项目
4. 点击批量操作按钮
#### 批量操作类型
- **批量删除**: 删除选中的项目
- **批量启用**: 启用选中的项目
- **批量禁用**: 禁用选中的项目
- **批量分配**: 分配选中的项目
#### 操作确认
- 系统会显示操作确认对话框
- 确认操作影响的项目数量
- 输入确认信息(如删除确认)
- 执行批量操作
### 4. 数据导入
#### 准备数据文件
1. 下载数据导入模板
2. 按照模板格式填写数据
3. 保存为Excel或CSV格式
4. 检查数据格式是否正确
#### 执行导入
1. 点击"数据导入"按钮
2. 选择数据文件
3. 设置导入选项
4. 预览导入数据
5. 确认并执行导入
#### 导入结果
- **成功导入**: 显示成功导入数量
- **导入失败**: 显示失败原因
- **错误报告**: 下载错误数据报告
- **重新导入**: 修正错误后重新导入
## 常见问题
### 1. 登录问题
#### 忘记密码
1. 在登录页面点击"忘记密码"
2. 输入注册邮箱或手机号
3. 接收验证码
4. 设置新密码
5. 使用新密码登录
#### 账号被锁定
1. 联系系统管理员
2. 提供用户信息验证身份
3. 管理员解锁账号
4. 重新尝试登录
#### 登录失败
- 检查用户名和密码是否正确
- 检查网络连接是否正常
- 清除浏览器缓存和Cookie
- 尝试使用其他浏览器
### 2. 权限问题
#### 功能无法访问
1. 检查当前用户角色权限
2. 联系管理员确认权限配置
3. 申请相应功能权限
4. 重新登录系统生效
#### 数据访问受限
1. 检查数据权限设置
2. 确认部门权限配置
3. 联系管理员调整权限
4. 刷新页面重新加载
### 3. 性能问题
#### 页面加载慢
1. 检查网络连接速度
2. 清理浏览器缓存
3. 关闭不必要的浏览器标签
4. 联系技术支持
#### 操作响应慢
1. 检查系统当前负载
2. 避免同时进行大量操作
3. 分批处理大数据量操作
4. 联系管理员优化系统
## 最佳实践
### 1. 数据管理
#### 定期备份
- 重要数据定期导出备份
- 使用系统提供的备份功能
- 存储备份文件到安全位置
- 测试备份文件可恢复性
#### 数据清理
- 定期清理过期数据
- 归档历史数据
- 删除重复数据
- 优化数据存储结构
### 2. 权限管理
#### 最小权限原则
- 为用户分配最小必要权限
- 定期审核用户权限
- 及时回收不再需要的权限
- 使用角色组管理权限
#### 权限审计
- 定期检查权限配置
- 审核权限使用情况
- 发现异常权限及时处理
- 记录权限变更日志
### 3. 系统使用
#### 操作规范
- 按照标准流程操作系统
- 重要操作前进行确认
- 记录关键操作日志
- 定期检查操作结果
#### 问题反馈
- 发现问题及时反馈
- 提供详细的问题描述
- 附上相关截图和日志
- 跟踪问题处理进度
## 技术支持
### 1. 获取帮助
#### 在线帮助
- 系统内置帮助文档
- 操作提示和向导
- 常见问题解答
- 视频教程链接
#### 技术支持
- 技术支持热线: 400-xxx-xxxx
- 技术支持邮箱: support@aiotagro.com
- 在线客服系统
- 技术社区论坛
### 2. 问题反馈
#### 反馈渠道
- 系统内问题反馈功能
- 邮件反馈: feedback@aiotagro.com
- 电话反馈: 400-xxx-xxxx
- 用户调研问卷
#### 反馈内容
- 问题详细描述
- 操作步骤重现
- 系统环境信息
- 期望解决方案
### 3. 版本更新
#### 更新通知
- 系统内更新公告
- 邮件通知更新信息
- 版本更新说明文档
- 新功能使用指南
#### 更新准备
- 备份重要数据
- 了解更新内容
- 测试新功能
- 培训相关人员
---
*本用户手册会随系统版本更新而更新,请定期查看最新版本。如有任何问题或建议,请联系技术支持团队。*