398 lines
9.4 KiB
Markdown
398 lines
9.4 KiB
Markdown
|
|
# 用户手册
|
|||
|
|
|
|||
|
|
## 产品概述
|
|||
|
|
|
|||
|
|
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. 版本更新
|
|||
|
|
|
|||
|
|
#### 更新通知
|
|||
|
|
- 系统内更新公告
|
|||
|
|
- 邮件通知更新信息
|
|||
|
|
- 版本更新说明文档
|
|||
|
|
- 新功能使用指南
|
|||
|
|
|
|||
|
|
#### 更新准备
|
|||
|
|
- 备份重要数据
|
|||
|
|
- 了解更新内容
|
|||
|
|
- 测试新功能
|
|||
|
|
- 培训相关人员
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
*本用户手册会随系统版本更新而更新,请定期查看最新版本。如有任何问题或建议,请联系技术支持团队。*
|