系统管理员手册 - 系统设置管理

本章节指导系统管理员配置系统的基础参数、文件上传、通知服务等核心设置。

2.1 基础参数配置

基础参数是系统运行的核心配置，包括系统名称、Logo、知识库API等重要设置。

访问路径

系统管理 → 系统设置 → 参数配置

前端路由: /system/settings

配置项说明

系统参数采用 键值对 的方式存储，每个配置项包含：

配置标签：配置项的显示名称
配置键（config_key）：系统内部使用的唯一标识
配置值（config_value）：具体的配置内容

必要配置项

系统基础信息

配置标签	配置键	说明	示例值
系统名称	system_name	显示在页面标题和Logo旁	iTrainer 智能培训系统
系统Logo	system_logo	Logo图片URL	/media/logo.png
版权信息	copyright	页面底部显示	© 2025 Your Company
系统描述	system_desc	系统简介	AI驱动的智能CRM系统

知识库配置（重要）⭐

配置标签	配置键	说明	示例值
知识库API地址	kb_api_url	Dify API地址	http://difyedu.mycache.cn/v1
知识库API密钥	kb_api_key	Dataset API Key	dataset-xxxxxx

⚠️ 重要说明：

知识库API配置锁定机制：

🔴 首次配置必须准确
- 一旦系统中创建了任何知识库，这两个配置将被锁定
- 配置项会变为灰色不可编辑状态
- 如需修改，必须删除所有知识库后才能重新配置
配置键名称必须完全一致：
- 配置键必须是：kb_api_url 和 kb_api_key
- 区分大小写，不能有拼写错误或多余空格
API地址格式要求：
- 必须包含 /v1 后缀
- ✅ 正确：http://difyedu.mycache.cn/v1
- ❌ 错误：http://difyedu.mycache.cn（缺少 /v1）
区分两种地址：
- API地址（程序调用）：需要包含 /v1
- 管理界面地址（人工登录）：不需要 /v1
- 示例：API地址是 http://difyedu.mycache.cn/v1，管理界面地址是 http://difyedu.mycache.cn

配置步骤：

获取Dify凭证
- 登录Dify管理界面（不含/v1的地址）
- 进入"知识库"管理
- 点击"设置" → "API密钥"
- 复制Dataset API Key（以 dataset- 开头）
在系统中配置
- 进入：系统管理 → 系统设置 → 参数配置
- 点击"新增配置"
- 创建两个配置项：

配置项1：知识库API地址

配置标签：知识库API地址
配置键：kb_api_url
配置值：http://your-dify-url/v1  （注意必须包含/v1）

配置项2：知识库API密钥

配置标签：知识库API密钥
配置键：kb_api_key
配置值：dataset-xxxxxxxxxxxxxx  （从Dify复制）

验证配置
- 保存后立即验证
- 创建一个测试知识库
- 上传一个测试文档
- 检查是否能正常同步和向量化

⚠️ 验证成功后的提醒：

如果验证成功，配置将在创建知识库后被锁定
如果验证失败，请立即修改配置，不要创建知识库
确认配置完全正确后，再开始创建正式的知识库

如果配置已锁定需要修改：

方法一：保持现有配置（推荐）

如果当前配置是正确的，无需修改
继续使用现有配置即可

方法二：删除知识库后重新配置（慎重）

⚠️ 警告：删除知识库将导致所有向量化数据丢失
备份重要文档（从文档管理模块导出）
访问：智能体管理 → 知识库管理
删除所有知识库
返回系统设置，配置项将恢复可编辑状态
重新配置正确的API地址和密钥
重新创建知识库并同步文档

添加配置项

步骤1：进入配置页面

访问：系统管理 → 系统设置 → 参数配置
点击 "新增配置" 按钮

步骤2：填写配置信息

字段	说明	是否必填
配置标签	显示名称	必填
配置键	英文标识，必须唯一	必填
配置值	具体配置内容	必填
备注	配置说明	可选

步骤3：保存配置

点击 "确定" 保存。

修改配置项

在配置列表中找到要修改的配置
点击 "编辑" 按钮
修改配置值
保存

⚠️ 注意：

配置键创建后不可修改
修改配置后立即生效（部分配置可能需要重新登录）
核心配置（如知识库API）可能在特定条件下被锁定

删除配置项

找到要删除的配置
点击 "删除" 按钮
确认删除

⚠️ 警告：删除系统核心配置可能导致功能异常

常用配置项列表

业务配置

配置标签	配置键	说明	示例值
客户默认跟进周期	customer_follow_days	多少天未跟进算待跟进	7
线索自动进入公海天数	clue_to_sea_days	多少天未跟进的线索进公海	30
商机预警提前天数	business_warning_days	预计成交前多少天提醒	7

功能开关

配置标签	配置键	说明	可选值
开启线索公海	enable_clue_sea	是否启用线索公海功能	true/false
开启客户成交统计	enable_deal_stats	是否统计成交客户	true/false
开启AI应用审计	enable_ai_audit	记录AI应用使用情况	true/false

限制配置

配置标签	配置键	说明	示例值
单次上传文件大小限制	max_upload_size	单位：MB	100
批量导入最大行数	max_import_rows	Excel导入限制	1000
AI应用单次调用超时	ai_call_timeout	单位：秒	120

最佳实践

配置管理建议：

首次配置前仔细规划
- 特别是知识库API配置，创建知识库后无法修改
- 先在测试环境验证，再在生产环境配置
记录配置变更
- 修改重要配置前做好记录
- 记录修改原因和时间
定期备份配置
- 导出配置列表备份
- 重要配置做好文档记录
避免随意删除
- 不确定的配置不要删除
- 删除前确认没有功能依赖

2.2 文件上传配置

系统支持用户上传文档、图片等文件，需要配置上传规则和存储方式。

访问路径

系统管理 → 系统设置 → 文件上传配置

前端路由: /system/settings（同参数配置页面）

文件上传方式

系统支持两种上传方式：

方式	说明	适用场景
本地存储	文件保存在服务器本地	小规模使用、内网环境
阿里云OSS	文件保存在阿里云对象存储	大规模使用、外网环境

配置本地存储（默认）

本地存储无需额外配置，文件直接保存在服务器上。

存储路径：/www/wwwroot/itrainer/media/uploads/

配置项：

配置标签	配置键	说明	推荐值
文件上传大小限制	max_upload_size	单位：MB	100
允许上传的文件类型	allowed_file_types	用逗号分隔	pdf,doc,docx,xls,xlsx,ppt,pptx,txt,md,jpg,png

优点：

✅ 配置简单，无需第三方服务
✅ 适合内网或小规模使用

缺点：

⚠️ 占用服务器存储空间
⚠️ 大文件上传可能影响服务器性能
⚠️ 不适合大规模文件存储

配置阿里云OSS（可选）

如果需要使用阿里云OSS存储文件：

步骤1：开通阿里云OSS服务

登录阿里云控制台
开通对象存储OSS服务
创建Bucket（存储空间）
获取访问凭证：
- Access Key ID
- Access Key Secret
- Bucket名称
- Endpoint（地域节点）

步骤2：在系统中配置

访问：系统管理 → 系统设置 → 参数配置

添加以下配置项：

配置标签	配置键	说明	示例值
OSS Access Key ID	oss_access_key_id	阿里云密钥ID	LTAI5txxxx
OSS Access Key Secret	oss_access_key_secret	阿里云密钥	xxxxxxxxxxxx
OSS Bucket名称	oss_bucket	存储空间名称	itrainer-files
OSS Endpoint	oss_endpoint	地域节点	oss-cn-hangzhou.aliyuncs.com
启用OSS存储	enable_oss	是否使用OSS	true

步骤3：测试上传

进入文档管理模块
尝试上传一个测试文件
检查阿里云OSS控制台是否有文件
尝试下载文件验证

文件类型限制

文档类型：

PDF：.pdf
Word：.doc, .docx
Excel：.xls, .xlsx
PowerPoint：.ppt, .pptx
文本：.txt, .md

图片类型：

.jpg, .jpeg, .png, .gif, .bmp

压缩包：

.zip, .rar, .7z

其他：

可根据业务需要自定义

文件大小限制

建议配置：

文件类型	建议限制	说明
文档	50-100 MB	PDF、Word等
图片	10 MB	头像、截图等
压缩包	500 MB	批量文件

设置过大的影响：

上传时间长，用户体验差
占用大量带宽
服务器负载高

设置过小的影响：

无法上传正常大小的文件
影响业务使用

安全建议

文件上传安全：

限制文件类型
- 不允许上传可执行文件（.exe, .bat等）
- 不允许上传脚本文件（.php, .jsp等）
文件名处理
- 系统自动重命名上传文件
- 避免文件名冲突
病毒扫描（可选）
- 对上传文件进行病毒扫描
- 拦截可疑文件
定期清理
- 清理未使用的文件
- 释放存储空间

2.3 邮件短信配置

系统支持邮件和短信通知功能，用于密码重置、任务提醒等场景。

访问路径

系统管理 → 系统设置 → 通知配置

前端路由: /system/settings

邮件配置（可选）

如果需要使用邮件通知功能：

步骤1：准备邮箱

准备一个企业邮箱或第三方邮箱（如QQ邮箱、163邮箱）
开启SMTP服务
获取SMTP授权码（如果是QQ、163等邮箱）

常用邮箱SMTP配置：

邮箱类型	SMTP服务器	端口	说明
QQ邮箱	smtp.qq.com	465（SSL）或 587（TLS）	需要授权码
163邮箱	smtp.163.com	465（SSL）或 25	需要授权码
阿里企业邮	smtp.qiye.aliyun.com	465（SSL）	使用邮箱密码
腾讯企业邮	smtp.exmail.qq.com	465（SSL）	使用邮箱密码

步骤2：在系统中配置

访问：系统管理 → 系统设置 → 参数配置

添加以下配置项：

配置标签	配置键	说明	示例值
SMTP服务器	smtp_host	邮件服务器地址	smtp.qq.com
SMTP端口	smtp_port	端口号	465
发件人邮箱	smtp_user	系统发件邮箱	noreply@company.com
邮箱密码/授权码	smtp_password	密码或授权码	xxxxxxxx
发件人名称	smtp_from_name	显示的发件人名称	iTrainer系统
启用邮件通知	enable_email	是否启用邮件	true

步骤3：测试邮件发送

进入：系统管理 → 系统设置 → 通知测试
输入测试邮箱地址
点击"发送测试邮件"
检查是否收到邮件

短信配置（可选）

系统支持阿里云短信服务。

步骤1：开通阿里云短信服务

登录阿里云控制台
开通短信服务
创建短信签名（需要审核）
创建短信模板（需要审核）
获取Access Key

步骤2：在系统中配置

访问：系统管理 → 系统设置 → 参数配置

添加以下配置项：

配置标签	配置键	说明	示例值
阿里云Access Key ID	sms_access_key_id	访问密钥ID	LTAI5txxxx
阿里云Access Key Secret	sms_access_key_secret	访问密钥	xxxxxxxxxxxx
短信签名	sms_sign_name	已审核的签名	iTrainer
短信模板代码	sms_template_code	已审核的模板代码	SMS_12345678
启用短信通知	enable_sms	是否启用短信	true

步骤3：测试短信发送

进入：系统管理 → 系统设置 → 通知测试
输入测试手机号
点击"发送测试短信"
检查是否收到短信

通知场景配置

配置哪些场景发送通知：

场景	配置键	说明	推荐值
密码重置	notify_password_reset	用户重置密码时通知	true
任务分配	notify_task_assign	任务分配给用户时通知	true
任务到期提醒	notify_task_deadline	任务即将到期时提醒	true
合同审批	notify_contract_approve	合同审批通知	true
客户待跟进提醒	notify_customer_follow	客户需要跟进时提醒	true

最佳实践

通知配置建议：

合理控制通知频率
- 避免频繁发送通知
- 影响用户体验
重要事项使用多渠道
- 密码重置：短信 + 邮件
- 任务提醒：系统内通知 + 邮件
成本控制
- 短信有费用，合理控制发送场景
- 非紧急通知使用邮件
内容规范
- 通知内容简洁明了
- 包含必要的操作链接

2.4 系统日志查看

系统日志帮助管理员了解系统使用情况和排查问题。

日志类型

系统记录三种日志：

日志类型	说明	访问路径
登录日志	记录用户登录情况	系统管理 → 日志管理 → 登录日志
操作日志	记录用户操作行为	系统管理 → 日志管理 → 操作日志
任务执行日志	记录定时任务执行情况	系统管理 → 定时任务 → 执行日志

登录日志

前端路由: /system/record/login

记录内容：

字段	说明
用户	登录用户名
登录时间	登录发生时间
登录IP	登录来源IP地址
登录设备	浏览器和操作系统信息
登录结果	成功/失败
失败原因	如果失败，显示原因

查看登录日志：

访问：系统管理 → 日志管理 → 登录日志
可以按以下条件筛选：
- 用户名
- 登录时间范围
- 登录结果（成功/失败）
- IP地址

应用场景：

审计：查看谁在什么时候登录了系统
安全：发现异常登录行为（如异地登录）
排查：用户反馈无法登录时查看失败原因

示例场景：

场景：用户张三反馈无法登录

排查步骤：
1. 进入登录日志
2. 筛选用户：张三
3. 查看最近的登录记录
4. 发现：多次登录失败，原因"密码错误"
5. 解决：为张三重置密码

操作日志

前端路由: /system/record/operation

记录内容：

字段	说明
操作用户	谁执行的操作
操作时间	操作发生时间
操作模块	哪个功能模块
操作类型	增加/修改/删除/查询
操作对象	操作了什么数据
操作结果	成功/失败
IP地址	操作来源IP

查看操作日志：

访问：系统管理 → 日志管理 → 操作日志
可以按以下条件筛选：
- 操作用户
- 操作时间范围
- 操作模块
- 操作类型

应用场景：

审计：追溯数据的修改历史
安全：发现异常操作行为
排查：数据异常时查找原因

示例场景：

场景：客户A的数据突然被删除了

排查步骤：
1. 进入操作日志
2. 筛选操作类型：删除
3. 筛选操作模块：客户管理
4. 查找客户A相关的删除记录
5. 发现：用户李四在昨天下午3点删除了客户A
6. 解决：联系李四确认原因，必要时恢复数据

任务执行日志

访问路径: 系统管理 → 定时任务 → 任务列表 → 查看执行日志

记录内容：

字段	说明
任务名称	定时任务的名称
执行时间	任务执行时间
执行状态	成功/失败
执行耗时	任务执行用时
执行结果	详细的执行信息
错误信息	如果失败，显示错误

应用场景：

监控：定时任务是否正常运行
排查：任务失败时查看原因
优化：分析任务执行耗时

日志管理

日志清理

日志会占用数据库空间，建议定期清理：

清理策略建议：

登录日志：保留最近3个月
操作日志：保留最近6个月
任务执行日志：保留最近1个月

清理方法：

进入对应的日志页面
点击"清理日志"按钮
选择清理时间范围
确认清理

⚠️ 注意：清理后无法恢复

日志导出

如需长期保存或分析日志：

进入日志页面
设置筛选条件
点击"导出"按钮
下载Excel文件

日志配置

可以控制是否记录日志：

配置项	配置键	说明	推荐值
记录登录日志	log_login	是否记录登录	true
记录操作日志	log_operation	是否记录操作	true
记录请求日志	log_request	是否记录所有请求	false（性能考虑）

访问：系统管理 → 系统设置 → 参数配置

最佳实践

日志管理建议：

定期检查
- 每周查看一次登录日志，发现异常登录
- 每月查看一次操作日志，审计重要操作
定期清理
- 设置定时任务自动清理过期日志
- 避免日志占用过多空间
重要日志归档
- 重要操作日志导出备份
- 保留完整的审计轨迹
关注异常
- 多次登录失败：可能账号被攻击
- 异地登录：可能账号被盗用
- 大量删除操作：可能误操作或恶意删除

本章小结

本章介绍了系统设置管理的四个核心内容：

配置内容回顾

1. 基础参数配置
   ├─ 系统基础信息（名称、Logo）
   └─ 知识库API配置（⭐ 重要）

2. 文件上传配置
   ├─ 本地存储（默认）
   └─ 阿里云OSS（可选）

3. 邮件短信配置
   ├─ SMTP邮件服务
   └─ 阿里云短信服务

4. 系统日志查看
   ├─ 登录日志
   ├─ 操作日志
   └─ 任务执行日志

关键要点

✅ 知识库API配置最重要：首次配置必须准确，创建知识库后无法修改 ✅ 配置立即生效：大部分配置保存后立即生效 ✅ 日志定期清理：避免占用过多空间 ✅ 测试后再使用：新配置测试通过后再正式使用

配置检查清单

完成本章配置后，请确认：

[ ] 系统名称和Logo已配置
[ ] 知识库API已配置（如使用AI功能）
[ ] 知识库API已验证通过（创建测试知识库成功）
[ ] 文件上传配置已完成（本地或OSS）
[ ] 文件类型和大小限制已设置
[ ] 邮件服务已配置（如需要邮件通知）
[ ] 短信服务已配置（如需要短信通知）
[ ] 已了解如何查看各类日志
[ ] 已设置日志清理策略

下一步

完成系统设置管理后，请继续：

第3章：字典数据管理 - 配置CRM业务字典
第4章：AI应用接入管理 - 接入Dify应用
第5章：应用分配管理 - 分配应用给用户

本章完成！ 您已经掌握了 iTrainer 的系统设置管理方法。

系统管理员手册 - 系统设置管理 ​

2.1 基础参数配置 ​

访问路径 ​

配置项说明 ​

必要配置项 ​

系统基础信息 ​

知识库配置（重要）⭐ ​

添加配置项 ​

步骤1：进入配置页面 ​

步骤2：填写配置信息 ​

步骤3：保存配置 ​

修改配置项 ​

删除配置项 ​

常用配置项列表 ​

业务配置 ​

功能开关 ​

限制配置 ​

最佳实践 ​

2.2 文件上传配置 ​

访问路径 ​

文件上传方式 ​

配置本地存储（默认） ​

配置阿里云OSS（可选） ​

步骤1：开通阿里云OSS服务 ​

步骤2：在系统中配置 ​

步骤3：测试上传 ​

文件类型限制 ​

文件大小限制 ​

安全建议 ​

2.3 邮件短信配置 ​

访问路径 ​

邮件配置（可选） ​

步骤1：准备邮箱 ​

步骤2：在系统中配置 ​

步骤3：测试邮件发送 ​

短信配置（可选） ​

步骤1：开通阿里云短信服务 ​

步骤2：在系统中配置 ​

步骤3：测试短信发送 ​

通知场景配置 ​

最佳实践 ​

2.4 系统日志查看 ​

日志类型 ​

登录日志 ​

操作日志 ​

任务执行日志 ​

日志管理 ​

日志清理 ​

日志导出 ​

日志配置 ​

最佳实践 ​

本章小结 ​

配置内容回顾 ​

关键要点 ​

配置检查清单 ​

下一步 ​

系统管理员手册 - 系统设置管理

2.1 基础参数配置

访问路径

配置项说明

必要配置项

系统基础信息

知识库配置（重要）⭐

添加配置项

步骤1：进入配置页面

步骤2：填写配置信息

步骤3：保存配置

修改配置项

删除配置项

常用配置项列表

业务配置

功能开关

限制配置

最佳实践

2.2 文件上传配置

访问路径

文件上传方式

配置本地存储（默认）

配置阿里云OSS（可选）

步骤1：开通阿里云OSS服务

步骤2：在系统中配置

步骤3：测试上传

文件类型限制

文件大小限制

安全建议

2.3 邮件短信配置

访问路径

邮件配置（可选）

步骤1：准备邮箱

步骤2：在系统中配置

步骤3：测试邮件发送

短信配置（可选）

步骤1：开通阿里云短信服务

步骤2：在系统中配置

步骤3：测试短信发送

通知场景配置

最佳实践

2.4 系统日志查看

日志类型

登录日志

操作日志

任务执行日志

日志管理

日志清理

日志导出

日志配置

最佳实践

本章小结

配置内容回顾

关键要点

配置检查清单

下一步