使用文档
更新日期: 2026-03-04
适用系统: AI种植专家管理系统 v2.8.8
系统概述
AI种植专家系统是一个基于Django 5.0.3框架开发的Web管理平台,用于管理农业数据、用户信息、API接口、AI交互记录和设备管理。系统采用响应式设计,支持多种设备访问,提供实时数据统计和监控功能。
主要功能
- 农业数据可视化展示和管理(支持图表展示和数据分页)
- 用户注册信息管理和注册趋势分析
- API接口状态管理和监控(支持分组管理和批量操作)
- 数据接口调用日志记录和详细分析
- AI交互记录管理和分析
- 设备管理和监控
- 实时数据统计和监控仪表板
- API调用统计和趋势分析
登录说明
访问后端管理系统需要管理员权限,请按照以下步骤登录:
访问地址
在浏览器中输入:https://f4f2d4c236c04913b4e61e61543ec0db.hn.takin.cc/admin-panel/
登录步骤
- 输入管理员用户名
- 输入管理员密码
- 点击"登录"按钮
退出登录
点击页面右上角的"退出登录"按钮即可安全退出系统。
农业数据管理
农业数据管理页面用于查看和管理农业传感器数据,包括水分值、温度值、电导率、PH值等指标。
数据可视化
页面顶部展示四个实时图表(使用最近100条数据):
- 水分值变化趋势:显示水分值随时间的变化
- 温度值变化趋势:显示温度值随时间的变化
- 电导率变化趋势:显示电导率随时间的变化
- PH值变化趋势:显示PH值随时间的变化
数据聚合
系统会按4小时为单位聚合数据,计算平均值,用于趋势图表展示,平衡可视化需求和性能消耗。
数据表格
表格显示详细的农业数据,包括:
- 数据时间
- 水分值和水分标记
- 温度值和温度标记
- 电导率和电导率标记
- PH值和PH标记
- N值、P值、K值及其标记
- 肥力值和肥力标记
分页功能
数据采用分页显示,每页20条记录。使用页面底部的分页导航可以:
- 跳转到首页或末页
- 上一页或下一页
- 点击具体页码
数据接口记录
数据接口记录页面显示所有API调用的详细日志,包括用户请求和系统响应。
日志信息
| 字段 | 说明 |
|---|---|
| 请求时间 | API调用的时间戳 |
| 请求方法 | HTTP请求方法(GET/POST) |
| API路径 | 调用的API接口路径 |
| 请求参数 | 用户发送的请求参数(点击展开查看) |
| 响应数据 | 系统返回的响应数据(点击展开查看) |
| 响应状态 | HTTP响应状态码 |
| 执行时间 | API处理耗时(毫秒) |
| 用户IP | 发起请求的用户IP地址 |
| 用户代理 | 发起请求的浏览器或客户端信息 |
特殊响应处理
系统会对特殊类型的响应进行标记:
- [Streaming Response]:流式响应(如AI接口的实时输出)
- [Binary Response]:二进制响应(如图片或文件)
- [No Content]:无响应数据
查看详细信息
点击"点击查看请求参数"或"点击查看响应数据"可以展开查看详细内容。
删除记录
支持单条删除和批量删除:
- 单条删除:点击每行右侧的"删除"按钮
- 全部删除:点击页面顶部的"全部删除"按钮
分页功能
日志记录采用分页显示,每页20条记录,使用分页导航可以快速浏览大量日志。
AI接口记录
AI接口记录页面显示用户与AI的所有交互记录,排除空的用户输入。
交互记录
每个交互记录卡片包含:
- 交互时间:用户与AI交互的时间
- 用户输入:用户发送给AI的问题或指令
- AI输出:AI返回的响应内容
- 执行时间:AI处理请求的耗时(毫秒)
- 用户IP:发起请求的用户IP地址
删除记录
支持单条删除和批量删除:
- 单条删除:点击卡片右上角的"删除"按钮
- 全部删除:点击页面顶部的"全部删除"按钮
分页功能
AI交互记录采用分页显示,每页10条记录,使用分页导航可以快速浏览大量记录。
设备管理
设备管理页面用于添加、编辑、删除和管理农业设备,支持多种通信协议。
访问地址
在浏览器中输入:https://f4f2d4c236c04913b4e61e61543ec0db.hn.takin.cc/access-equipment/equipment/
功能说明
- 设备列表:显示所有已添加的设备,包括设备名称、ID、类型、状态等信息
- 添加设备:点击"添加设备"按钮,填写设备信息并保存
- 编辑设备:点击设备列表中的"编辑"按钮,修改设备信息
- 删除设备:点击设备列表中的"删除"按钮,确认后删除设备
- 刷新状态:点击设备列表中的"刷新"按钮,更新设备状态
设备类型
- 综合设备:支持多种参数采集的设备
- 土壤传感器:专门采集土壤参数的设备
- 环境传感器:专门采集环境参数的设备
通信协议
- Modbus:串口通信协议,需要配置串口参数
- MQTT:物联网通信协议,需要配置 broker 信息
- 蓝牙:短距离无线通信,需要配置蓝牙设备信息
设备地图
设备地图页面用于在地图上可视化显示设备位置和状态。
访问地址
在浏览器中输入:https://f4f2d4c236c04913b4e61e61543ec0db.hn.takin.cc/access-equipment/equipment/map/
功能说明
- 设备标记:在地图上显示设备位置,不同状态的设备显示不同颜色
- 添加标记:点击"添加标记"按钮,在地图上添加新设备
- 设备状态:通过标记颜色直观显示设备状态(在线/离线/警告)
- 区域管理:按区域管理设备,方便查看不同区域的设备分布
实时监控
实时监控页面用于实时监测设备状态和采集数据。
访问地址
在浏览器中输入:https://f4f2d4c236c04913b4e61e61543ec0db.hn.takin.cc/access-equipment/monitor/
功能说明
- 设备状态:实时显示设备在线/离线/警告状态
- 数据采集:实时显示设备采集的数据,包括湿度、温度、PH值等
- 状态统计:显示在线、离线、警告设备数量
- 分页显示:设备列表采用分页显示,每页10条记录
历史数据
历史数据页面用于查看和分析设备采集的历史数据。
访问地址
在浏览器中输入:https://f4f2d4c236c04913b4e61e61543ec0db.hn.takin.cc/access-equipment/history/
功能说明
- 数据查询:根据日期范围查询历史数据
- 数据统计:显示数据平均值,包括湿度、PH值、温度等
- 详细数据:显示详细的历史数据记录,包括时间、湿度、温度、PH值、电导率、氮磷钾等
- 分页显示:历史数据采用分页显示,每页20条记录
告警中心
告警中心页面用于管理设备异常告警。
访问地址
在浏览器中输入:https://f4f2d4c236c04913b4e61e61543ec0db.hn.takin.cc/access-equipment/alerts/
功能说明
- 告警列表:显示所有告警设备,包括严重、警告、信息等不同级别的告警
- 告警处理:点击"忽略"按钮,将告警标记为已忽略
- 告警统计:显示不同级别告警的数量
- 已忽略告警:查看已被忽略的告警记录
- 分页显示:告警列表采用分页显示,每页10条记录
系统设置
系统设置页面用于配置设备管理系统的参数。
访问地址
在浏览器中输入:https://f4f2d4c236c04913b4e61e61543ec0db.hn.takin.cc/access-equipment/settings/
功能说明
- 系统配置:配置系统参数,如数据采集间隔、告警阈值等
- 设备配置:配置设备默认参数,如通信协议、采样频率等
- 更新设置:点击"更新设置"按钮,保存系统配置
常见问题
Q1: 忘记管理员密码怎么办?
A: 请联系物联网与硬件集成工程师更改密码。
Q2: 为什么某些数据无法显示?
A: 可能的原因包括:
- 数据库连接失败
- 数据格式不正确
- 浏览器缓存问题(尝试清除缓存或使用隐私模式)
- 数据表不存在(请运行初始化命令)
Q3: 如何优化系统性能?
A: 系统已内置性能优化:
- 数据分页加载,减少流量消耗
- 查询集延迟执行,只在需要时获取数据
- 图表数据限制为最近100条,平衡可视化和性能
- 数据按4小时聚合,减少图表数据点数量
Q4: API被禁用后如何恢复?
A: 在API管理页面找到对应的API接口,点击状态切换按钮即可重新启用。也可以通过分组批量启用API接口。
Q5: 删除操作可以撤销吗?
A: 不可以。所有删除操作(用户、API日志、AI记录)都是永久性的,无法撤销。请谨慎操作。
Q6: 系统支持哪些浏览器?
A: 系统支持所有现代浏览器,包括:
- Chrome(推荐)
- Firefox
- Safari
- Edge
Q7: 如何导出数据?
A: 当前版本暂不支持数据导出功能,如需导出请联系开发团队添加此功能。
Q8: 如何初始化API状态数据?
A: 运行命令 python manage.py init_api_status 即可初始化API状态数据。
Q9: 如何查看API调用统计?
A: 在仪表盘页面可以查看API调用的趋势图表,在API管理页面可以查看详细的API调用统计。
Q10: 系统如何处理流式响应和二进制响应?
A: 系统会对特殊类型的响应进行标记:
- [Streaming Response]:流式响应(如AI接口的实时输出)
- [Binary Response]:二进制响应(如图片或文件)
- [No Content]:无响应数据
附录
系统要求
- Python 3.x
- Django 5.0.3
- MySQL数据库
- 现代Web浏览器
- 必要的Python依赖包:
- pymodbus==3.12.1(Modbus设备通信)
- pymysql==1.1.2(MySQL数据库连接)
- openpyxl(Excel文件导出)
- corsheaders(跨域请求支持)
- pytz(时区支持)
安全建议
- 定期更换管理员密码
- 及时退出登录
- 定期清理日志记录
- 定期备份数据库
- 限制管理员账号的使用范围
初始化命令
系统初始化相关命令:
python manage.py migrate- 执行数据库迁移python manage.py init_api_status- 初始化API状态数据python manage.py init_all_data- 初始化所有必要数据
© 2026 农业项目后端管理系统 - 使用文档