📝 docs: Add documentation

This commit is contained in:
web@ppanel
2025-12-11 03:29:07 +00:00
parent 50e695a1bb
commit 99e7f6062d
135 changed files with 79115 additions and 8 deletions
+468
View File
@@ -0,0 +1,468 @@
# 文档管理
文档管理模块用于创建和维护帮助文档、知识库,为用户提供自助服务支持。
## 功能概述
### 文档列表
查看和管理所有文档:
- **文档标题**: 文档名称
- **文档分类**: 所属分类
- **文档状态**: 草稿/已发布/已下线
- **作者**: 文档创建者
- **创建时间**: 文档创建日期
- **更新时间**: 最后修改时间
- **浏览量**: 文档查看次数
- **评价**: 用户评分和评价
### 创建文档
创建新的帮助文档:
#### 基本信息
- **文档标题**: 清晰明确的标题
- **文档分类**: 选择所属分类
- **文档标签**: 添加关键词标签
- **文档摘要**: 简短内容摘要
#### 文档内容
- **富文本编辑**: 所见即所得编辑器
- **Markdown支持**: 支持Markdown格式
- **代码高亮**: 代码块语法高亮
- **图片上传**: 插入图片和截图
- **视频嵌入**: 嵌入视频教程
- **表格支持**: 插入表格数据
#### 文档设置
- **访问权限**: 公开/仅会员/指定用户组
- **显示顺序**: 设置显示优先级
- **相关文档**: 关联相关文档
- **SEO设置**: 设置SEO关键词
### 编辑文档
修改已有文档:
- 更新文档内容
- 优化文档结构
- 添加新的信息
- 修正错误内容
::: tip 提示
文档支持版本控制,可查看历史版本并恢复。
:::
### 删除文档
删除不需要的文档:
- **软删除**: 下线但保留数据
- **硬删除**: 彻底删除文档
- 保留浏览记录用于统计
## 文档分类
### 新手入门
帮助新用户快速上手:
**内容包括**:
- 注册账户
- 首次使用
- 基础配置
- 常见问题
### 使用教程
详细功能使用指南:
**内容包括**:
- 功能说明
- 操作步骤
- 配置方法
- 最佳实践
### 常见问题
FAQ问答:
**内容包括**:
- 高频问题
- 快速解答
- 问题排查
- 解决方案
### 技术文档
技术相关文档:
**内容包括**:
- API文档
- 协议说明
- 技术参数
- 开发指南
### 政策条款
法律相关文档:
**内容包括**:
- 服务协议
- 隐私政策
- 使用条款
- 退款政策
## 文档组织
### 分类管理
管理文档分类:
- **创建分类**: 新建文档分类
- **编辑分类**: 修改分类信息
- **排序**: 调整分类顺序
- **删除分类**: 删除空分类
### 标签管理
管理文档标签:
- **添加标签**: 创建新标签
- **编辑标签**: 修改标签名称
- **合并标签**: 合并相似标签
- **删除标签**: 删除无用标签
### 目录结构
组织文档目录:
- **多级目录**: 支持多级分类
- **树形结构**: 清晰的层级关系
- **拖拽排序**: 拖拽调整顺序
- **快速导航**: 目录树快速跳转
## 文档编辑
### 富文本编辑器
强大的编辑功能:
- **格式化**: 文字格式化
- **列表**: 有序/无序列表
- **引用**: 引用块
- **代码**: 代码块
- **链接**: 超链接
- **图片**: 图片插入
- **表格**: 表格编辑
- **视频**: 视频嵌入
### Markdown编辑
支持Markdown语法:
```markdown
# 标题
## 二级标题
- 列表项
- 列表项
**粗体** *斜体*
[链接](url)
\`代码\`
\`\`\`language
代码块
\`\`\`
```
### 版本控制
文档版本管理:
- **自动保存**: 编辑时自动保存草稿
- **版本记录**: 记录每次修改
- **版本对比**: 对比不同版本
- **版本回滚**: 恢复到历史版本
## 文档发布
### 发布设置
配置文档发布:
- **立即发布**: 立即向用户展示
- **定时发布**: 设置发布时间
- **草稿保存**: 保存为草稿
- **预览**: 发布前预览效果
### 访问控制
控制文档访问权限:
- **公开文档**: 所有人可访问
- **会员文档**: 仅会员可看
- **VIP文档**: 仅VIP可看
- **内部文档**: 仅内部人员
### 多语言支持
多语言文档:
- **语言版本**: 创建不同语言版本
- **语言切换**: 用户切换语言
- **翻译管理**: 管理翻译版本
- **同步更新**: 同步更新各语言版本
## 文档搜索
### 搜索功能
帮助用户快速找到文档:
- **全文搜索**: 搜索文档内容
- **标题搜索**: 按标题查找
- **标签搜索**: 按标签筛选
- **分类筛选**: 按分类过滤
- **搜索建议**: 智能搜索建议
### 搜索优化
优化搜索体验:
- **搜索排序**: 按相关度排序
- **高亮显示**: 高亮匹配关键词
- **搜索历史**: 记录搜索历史
- **热门搜索**: 展示热门搜索
## 文档互动
### 用户评价
收集用户反馈:
- **有用/无用**: 简单评价
- **评分**: 星级评分
- **评论**: 文字评论
- **改进建议**: 收集改进意见
### 文档反馈
用户反馈问题:
- **报告错误**: 报告文档错误
- **提出建议**: 提出改进建议
- **请求更新**: 请求更新内容
- **在线咨询**: 直接咨询客服
### 社交分享
分享文档:
- **分享链接**: 生成分享链接
- **社交媒体**: 分享到社交平台
- **二维码**: 生成文档二维码
- **嵌入代码**: 嵌入到其他网站
## 文档统计
### 浏览统计
统计文档浏览:
- **浏览量**: 文档查看次数
- **独立访客**: 独立用户数
- **浏览趋势**: 浏览量变化趋势
- **热门文档**: 最受欢迎的文档
### 用户行为
分析用户行为:
- **阅读时长**: 平均阅读时长
- **跳出率**: 快速离开的比例
- **搜索关键词**: 用户搜索内容
- **点击路径**: 用户访问路径
### 效果评估
评估文档效果:
- **有用率**: 用户觉得有用的比例
- **解决率**: 解决问题的比例
- **工单减少**: 相关工单减少情况
- **用户满意度**: 整体满意度
## 知识库
### 知识库结构
构建系统化知识库:
- **产品知识**: 产品功能和使用
- **技术知识**: 技术原理和方法
- **业务知识**: 业务流程和规范
- **问题知识**: 常见问题和解决方案
### 知识沉淀
积累和沉淀知识:
- **工单转化**: 工单问题转为文档
- **经验总结**: 总结典型案例
- **最佳实践**: 记录最佳实践
- **专家贡献**: 专家分享经验
### 知识更新
保持知识库更新:
- **定期审查**: 定期审查文档
- **及时更新**: 及时更新内容
- **废弃标记**: 标记过时内容
- **版本管理**: 管理文档版本
## 文档模板
### 常用模板
预设文档模板:
- **教程模板**: 操作教程格式
- **FAQ模板**: 问答格式
- **故障排查模板**: 排查步骤格式
- **API文档模板**: API文档格式
### 自定义模板
创建自定义模板:
- 设计文档结构
- 定义内容格式
- 保存为模板
- 重复使用
## 协作功能
### 多人协作
团队协作编辑:
- **权限管理**: 分配编辑权限
- **协同编辑**: 多人同时编辑
- **评论讨论**: 添加评论讨论
- **审核流程**: 文档审核流程
### 审核发布
文档审核机制:
1. **创建草稿**: 编辑文档内容
2. **提交审核**: 提交给审核人
3. **审核**: 审核人员审核
4. **发布**: 审核通过后发布
5. **监控**: 发布后效果监控
## 最佳实践
### 内容编写
- 标题清晰明确
- 内容准确详细
- 步骤清晰易懂
- 配图辅助说明
- 定期更新维护
### 组织结构
- 合理规划分类
- 清晰的层级结构
- 统一的命名规范
- 完善的索引体系
### 用户体验
- 简洁的界面设计
- 快速的搜索功能
- 便捷的导航系统
- 友好的移动体验
### 持续优化
- 收集用户反馈
- 分析使用数据
- 优化文档内容
- 完善知识体系
## 文档示例
### 新手入门示例
**标题**: 如何开始使用
**内容结构**:
1. 注册账户
2. 选择套餐
3. 配置使用
4. 常见问题
### 使用教程示例
**标题**: XX功能使用教程
**内容结构**:
1. 功能介绍
2. 使用场景
3. 操作步骤
4. 注意事项
5. 常见问题
### FAQ示例
**标题**: 连接问题FAQ
**内容结构**:
- Q: 无法连接怎么办?
- A: 详细解决步骤...
## 常见问题
### 文档无法保存
检查:
1. 网络连接是否正常
2. 是否有编辑权限
3. 内容是否过大
4. 浏览器是否兼容
### 搜索找不到文档
可能原因:
1. 文档未发布
2. 访问权限不足
3. 关键词不匹配
4. 搜索索引未更新
### 文档格式错乱
解决方法:
1. 使用标准格式
2. 清理复制格式
3. 使用模板
4. 检查HTML代码
## 下一步
- [工单管理](/zh/admin/users-support/tickets) - 处理用户问题
- [用户管理](/zh/admin/users-support/users) - 分析用户需求
- [系统配置](/zh/admin/system/config) - 配置文档系统
+479
View File
@@ -0,0 +1,479 @@
# 工单管理
工单管理模块用于处理用户提交的各类问题和请求,提供高效的客户支持服务。
## 功能概述
### 工单列表
查看和管理所有工单:
- **工单编号**: 唯一工单ID
- **工单标题**: 问题简述
- **工单类型**: 技术支持/账户问题/投诉建议
- **优先级**: 紧急/高/中/低
- **状态**: 待处理/处理中/已解决/已关闭
- **提交用户**: 工单提交者
- **负责人**: 工单处理人员
- **创建时间**: 工单提交时间
- **更新时间**: 最后更新时间
- **响应时间**: 首次响应时长
- **解决时间**: 问题解决时长
### 工单详情
查看工单完整信息:
- **基本信息**: 标题、类型、优先级
- **工单内容**: 详细问题描述
- **附件**: 用户上传的截图、文件
- **沟通记录**: 完整的对话历史
- **处理记录**: 工单流转记录
- **用户信息**: 提交用户的详细信息
- **关联订单**: 相关订单信息
## 工单类型
### 技术支持
技术相关问题:
**常见问题**:
- 连接问题
- 配置问题
- 性能问题
- 兼容性问题
- 使用教程
**处理要点**:
- 快速诊断问题
- 提供解决方案
- 必要时远程协助
- 跟进直到解决
### 账户问题
账户相关问题:
**常见问题**:
- 登录问题
- 密码重置
- 账户安全
- 信息修改
- 账户注销
**处理要点**:
- 验证用户身份
- 保护账户安全
- 及时处理请求
- 记录操作日志
### 订单问题
订单相关问题:
**常见问题**:
- 订单查询
- 支付问题
- 退款申请
- 发票开具
- 订单修改
**处理要点**:
- 核实订单信息
- 按流程处理
- 及时反馈进度
- 确保用户满意
### 产品咨询
产品相关咨询:
**常见问题**:
- 产品功能
- 套餐选择
- 使用建议
- 升级方案
- 价格政策
**处理要点**:
- 专业解答问题
- 推荐合适方案
- 提供详细资料
- 促进转化购买
### 投诉建议
用户反馈:
**常见内容**:
- 服务投诉
- 产品建议
- 功能需求
- 体验反馈
**处理要点**:
- 认真倾听
- 及时响应
- 妥善处理
- 跟踪改进
## 工单处理流程
### 工单创建
用户提交工单:
1. **选择类型**: 选择工单类型
2. **填写标题**: 简要描述问题
3. **详细描述**: 详细说明情况
4. **上传附件**: 上传相关截图
5. **提交工单**: 提交等待处理
### 工单分配
系统自动或手动分配:
**自动分配**:
- 根据工单类型自动分配
- 按负责人工作量分配
- 根据专业领域分配
**手动分配**:
- 管理员手动指派
- 支持人员主动领取
- 根据优先级分配
### 工单处理
处理人员处理工单:
1. **接收工单**: 查看工单详情
2. **分析问题**: 了解问题情况
3. **沟通确认**: 与用户沟通
4. **提供方案**: 给出解决方案
5. **执行操作**: 执行必要操作
6. **确认解决**: 确认问题解决
7. **关闭工单**: 关闭已解决工单
### 工单升级
无法解决时升级:
- **一级升级**: 提交给高级支持
- **二级升级**: 提交给技术团队
- **紧急升级**: 提交给管理层
- **跨部门协作**: 多部门协同处理
### 工单关闭
完成处理后关闭:
- **已解决**: 问题成功解决
- **用户确认**: 用户确认满意
- **自动关闭**: 超时自动关闭
- **无需处理**: 无效工单关闭
## 工单状态管理
### 待处理
新提交的工单:
- 等待分配处理人员
- 需要尽快响应
- 按优先级排序
- SLA计时开始
### 处理中
正在处理的工单:
- 处理人员已接手
- 正在沟通解决
- 可能需要时间
- 定期更新进度
### 待用户
等待用户反馈:
- 需要用户提供信息
- 等待用户确认
- 暂停SLA计时
- 超时自动提醒
### 已解决
问题已解决:
- 解决方案已提供
- 用户问题已解决
- 等待用户确认
- 可能重新打开
### 已关闭
工单已关闭:
- 处理流程结束
- 归档保存记录
- 可查看历史记录
- 不可再次修改
## 优先级管理
### 紧急
最高优先级:
**适用场景**:
- 服务完全中断
- 安全漏洞
- 数据丢失
- 重大bug
**处理要求**:
- 立即响应
- 优先处理
- 快速解决
- 全程跟踪
### 高
高优先级:
**适用场景**:
- 核心功能故障
- 影响多个用户
- 重要客户问题
**处理要求**:
- 2小时内响应
- 当日解决
- 及时反馈
### 中
普通优先级:
**适用场景**:
- 一般功能问题
- 使用咨询
- 常规请求
**处理要求**:
- 24小时内响应
- 3天内解决
- 按流程处理
### 低
低优先级:
**适用场景**:
- 功能建议
- 体验优化
- 文档问题
**处理要求**:
- 3天内响应
- 合理安排处理
- 计划解决
## 工单沟通
### 回复工单
与用户沟通:
- **公开回复**: 用户可见的回复
- **内部备注**: 内部沟通备注
- **附件**: 上传文件、截图
- **模板**: 使用快捷回复模板
### 快捷回复
预设回复模板:
- 常见问题解答
- 标准回复话术
- 操作指引
- 一键发送
### 沟通技巧
有效沟通:
- 语气友好专业
- 回复清晰明确
- 提供具体方案
- 及时跟进反馈
- 确认用户满意
## 工单统计
### 工单数量
统计工单数量:
- **总工单量**: 所有工单数量
- **新增工单**: 每日新增数量
- **待处理**: 待处理工单数
- **已解决**: 已解决工单数
- **趋势分析**: 工单量变化趋势
### 处理效率
分析处理效率:
- **平均响应时间**: 首次响应时长
- **平均解决时间**: 问题解决时长
- **解决率**: 成功解决比例
- **超时率**: SLA超时比例
### 人员绩效
统计人员表现:
- **处理数量**: 每人处理工单数
- **解决率**: 成功解决比例
- **用户满意度**: 用户评分
- **响应速度**: 平均响应时长
### 问题分析
分析常见问题:
- **问题分类**: 各类问题占比
- **高频问题**: 最常见的问题
- **难点问题**: 难以解决的问题
- **改进建议**: 问题改进方向
## SLA管理
### SLA标准
服务水平协议:
**响应时间**:
- 紧急: 15分钟内
- 高: 2小时内
- 中: 24小时内
- 低: 3天内
**解决时间**:
- 紧急: 4小时内
- 高: 1天内
- 中: 3天内
- 低: 7天内
### SLA监控
监控SLA达成:
- 实时监控SLA状态
- 预警即将超时工单
- 统计SLA达成率
- 分析超时原因
## 工单自动化
### 自动分配
自动分配工单:
- 按类型自动分配
- 负载均衡分配
- 轮询分配
- 智能分配
### 自动回复
自动回复常见问题:
- 常见问题自动答复
- 接收确认自动回复
- 状态变更自动通知
### 自动升级
自动升级超时工单:
- 超时自动升级
- 紧急问题自动升级
- 重复问题自动升级
### 自动关闭
自动关闭工单:
- 已解决超时自动关闭
- 无响应自动关闭
- 重复工单自动合并
## 知识库集成
### 常见问题
建立FAQ知识库:
- 整理常见问题
- 提供标准答案
- 用户自助查询
- 减少工单量
### 解决方案库
沉淀解决方案:
- 记录典型案例
- 总结解决方法
- 团队知识共享
- 提高处理效率
## 最佳实践
- 及时响应用户工单
- 准确理解用户问题
- 提供专业的解决方案
- 保持友好的沟通态度
- 跟进直到问题解决
- 总结经验完善知识库
- 定期分析工单数据
- 持续优化服务流程
## 常见问题
### 工单响应慢
可能原因:
1. 工单量过大
2. 人手不足
3. 分配不合理
4. 优先级设置问题
### 工单处理质量差
改进方法:
1. 加强培训
2. 完善知识库
3. 优化流程
4. 建立考核机制
### 用户满意度低
提升方法:
1. 提高响应速度
2. 改善服务态度
3. 提升解决能力
4. 加强沟通反馈
## 下一步
- [用户管理](/zh/admin/users-support/users) - 查看用户信息
- [文档管理](/zh/admin/users-support/documents) - 完善帮助文档
- [系统配置](/zh/admin/system/config) - 配置工单系统
+335
View File
@@ -0,0 +1,335 @@
# 用户管理
用户管理模块用于管理系统中的所有用户账户,是系统运营的基础模块。
## 功能概述
### 用户列表
查看和管理所有用户:
- **用户信息**: 用户名、邮箱、手机号
- **用户组**: VIP/普通/试用等
- **账户状态**: 正常/已禁用/已过期
- **余额**: 账户余额
- **流量**: 已用流量/总流量
- **有效期**: 订阅到期时间
- **注册时间**: 账户注册日期
- **最后登录**: 最后登录时间
### 用户筛选
快速查找用户:
- **按状态**: 正常/禁用/过期
- **按用户组**: VIP/普通用户
- **按注册时间**: 时间范围筛选
- **按流量**: 按流量使用情况筛选
- **按设备**: 在线/离线用户
- **搜索**: 用户名/邮箱/手机号搜索
### 添加用户
手动创建新用户账户:
#### 基本信息
- **用户名**: 登录用户名(唯一)
- **邮箱**: 用户邮箱地址
- **手机号**: 联系电话(可选)
- **密码**: 初始密码
#### 订阅信息
- **用户组**: 选择用户组
- **流量配额**: 设置流量额度
- **有效期**: 设置到期时间
- **速度限制**: 设置速率上限
- **设备限制**: 同时在线设备数
#### 账户设置
- **余额**: 初始账户余额
- **积分**: 初始积分
- **推广码**: 自定义邀请码
- **备注**: 用户备注信息
### 编辑用户
修改用户信息和配置:
- **更新基本信息**: 修改邮箱、手机等
- **调整订阅**: 修改流量、有效期
- **余额操作**: 充值或扣减余额
- **重置密码**: 为用户重置密码
- **更改用户组**: 升级或降级用户组
### 删除用户
删除用户账户:
- **软删除**: 标记删除但保留数据
- **硬删除**: 彻底删除用户及相关数据
- **批量删除**: 批量删除多个用户
::: warning 警告
删除用户会清除其所有订阅和使用记录,请谨慎操作。
:::
## 用户操作
### 禁用/启用
控制用户账户状态:
- **禁用账户**: 暂停用户服务访问
- **启用账户**: 恢复用户正常使用
- **禁用原因**: 记录禁用理由
- **自动解封**: 设置自动解封时间
### 流量操作
管理用户流量:
- **增加流量**: 为用户添加流量
- **扣减流量**: 扣除用户流量
- **重置流量**: 重置流量到初始值
- **流量记录**: 查看流量变更历史
### 时长操作
管理用户订阅时长:
- **延长时间**: 延长订阅有效期
- **缩短时间**: 减少订阅时长
- **设置到期**: 设置具体到期日期
- **永久订阅**: 设为永不过期
### 余额操作
管理用户余额:
- **充值**: 为用户账户充值
- **扣款**: 从账户扣除余额
- **转账**: 用户间余额转移
- **余额日志**: 查看余额变动记录
## 用户详情
### 基本信息
查看用户完整信息:
- 账户基本资料
- 订阅状态和配额
- 余额和积分
- 推广信息
### 订阅信息
查看用户订阅详情:
- 当前订阅套餐
- 流量使用情况
- 剩余有效期
- 节点访问权限
### 使用统计
分析用户使用数据:
- **流量统计**: 每日/每周/每月流量
- **在线时长**: 使用时长统计
- **节点偏好**: 常用节点分析
- **设备统计**: 使用的设备数量
### 订单记录
查看用户购买记录:
- 历史订单列表
- 订单金额统计
- 购买频率分析
- 续费情况
### 登录记录
查看用户登录历史:
- 登录时间
- 登录IP
- 登录设备
- 登录地点
### 在线设备
查看用户在线设备:
- 设备类型和系统
- 连接的节点
- 在线时长
- 强制下线功能
## 用户分组
### 用户组管理
创建和管理用户组:
- **组名称**: 用户组显示名称
- **组权限**: 节点访问权限
- **流量配额**: 组默认流量
- **速度限制**: 组速率上限
- **其他限制**: 设备数、并发数等
### 批量分组
批量设置用户组:
- 选择多个用户
- 指定目标用户组
- 批量更新用户组
- 保留或重置配额
## 用户搜索
### 高级搜索
使用多条件搜索用户:
- **组合条件**: 多个条件组合搜索
- **范围搜索**: 流量、余额范围
- **时间范围**: 注册、到期时间
- **自定义字段**: 备注等字段搜索
### 保存搜索
保存常用搜索条件:
- 快速应用搜索条件
- 管理已保存的搜索
- 共享搜索条件
## 用户导出
导出用户数据:
### 导出选项
- **导出格式**: Excel/CSV
- **导出字段**: 自定义导出字段
- **数据范围**: 全部或筛选结果
- **数据脱敏**: 敏感信息处理
### 批量导入
批量导入用户:
- 下载导入模板
- 填写用户数据
- 上传Excel文件
- 验证并导入
## 用户通知
### 发送通知
向用户发送消息:
- **站内信**: 系统消息通知
- **邮件**: 发送邮件通知
- **短信**: 发送短信通知
- **批量通知**: 批量发送消息
### 通知模板
管理通知模板:
- 创建消息模板
- 使用变量替换
- 多语言模板
- 定时发送
## 用户分析
### 用户画像
分析用户特征:
- **基础属性**: 年龄、地区分布
- **行为特征**: 使用习惯、活跃度
- **消费特征**: 客单价、复购率
- **流失风险**: 流失预警分析
### 用户价值
评估用户价值:
- **RFM分析**: 最近购买、频率、金额
- **生命周期**: 用户生命周期阶段
- **贡献度**: 收入贡献排名
- **活跃度**: 使用活跃程度
## 用户安全
### 安全设置
增强用户账户安全:
- **强制2FA**: 要求两步验证
- **IP白名单**: 限制登录IP
- **设备管理**: 管理授权设备
- **异常检测**: 检测异常登录
### 风控措施
防范恶意用户:
- **行为监控**: 监控异常行为
- **风险评分**: 用户风险等级
- **自动封禁**: 触发规则自动禁用
- **黑名单**: 永久拉黑用户
## 最佳实践
- 定期审查用户账户状态
- 及时处理到期用户续费
- 关注高价值用户需求
- 分析流失用户原因
- 保护用户隐私数据
- 建立用户分级服务体系
## 常见问题
### 用户无法登录
检查以下几点:
1. 账户是否被禁用
2. 密码是否正确
3. 是否触发了安全限制
4. 系统服务是否正常
### 流量异常
可能的原因:
1. 统计服务故障
2. 节点上报异常
3. 用户设备问题
4. 恶意使用
### 批量操作失败
检查:
1. 选择的用户数量
2. 操作权限
3. 数据格式是否正确
4. 系统资源是否充足
## 下一步
- [工单管理](/zh/admin/users-support/tickets) - 处理用户工单
- [订单管理](/zh/admin/commerce/orders) - 查看用户订单
- [登录日志](/zh/admin/logs/login) - 查看登录记录