# aifarm

**Repository Path**: aibyte/aifarm

## Basic Information

- **Project Name**: aifarm
- **Description**: Aifarm for Android APP
- **Primary Language**: Kotlin
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智慧农机APP软件需求文档

# 1\. 引言

## 1\.1 文档目的

本文档旨在明确智慧农机APP的全部功能需求、操作流程及业务逻辑，重点说明新增的农机遥控四轴四转功能，为APP开发、测试、部署及后期维护提供标准化依据，确保开发成果符合业务预期，满足农业机械数字化管理、精准作业及远程操控需求。

## 1\.2 文档范围

本文档覆盖智慧农机APP的全部核心模块，包括首页基础工具、装备资源管理、任务管理、系统设置、基准线管理，以及新增的农机远程遥控（四轴四转控制）功能，明确各模块的功能定义、操作路径、业务约束及关联关系，不涉及底层技术实现细节。

## 1\.3 核心业务目标

- 车辆管理：实时监控农业机械的操作轨迹、作业覆盖区域、工作时长，精准采集各类作业数据，实现农机运行状态可视化管理。

- 农场可视化：支持农场边界数据的创建、导入、可视化展示及数字化管理，实现农场地块的精准管控。

- 导引路径规划：生成并下发作业基准路径，引导农机实现精准、高效、标准化作业，提升作业质量与效率。

- 农业任务管理：全流程记录农业作业活动，实时同步耕作进度、作业统计数据，实现任务从创建到完成的全生命周期管理。

- 农业气象信息：展示区域本地化气象数据，为作业排期、农事规划提供科学参考，降低气象因素对作业的影响。

- 农机远程遥控：新增四轴四转全维度运动操控能力，支持农机近距离/远程对位、移位、调试及应急移动，拓展农机操作场景。

# 2\. 总体描述

## 2\.1 系统概述

智慧农机APP是一款面向农业生产场景的数字化管理工具，通过移动端实现对农业机械、农场地块、农事任务、作业路径的全流程管控，新增的农机遥控四轴四转功能，进一步提升农机操作的灵活性与便捷性，构建“设备绑定\-地块管理\-路径规划\-遥控操作\-任务执行\-数据统计”的全业务闭环，助力农业生产数字化、智能化升级。

## 2\.2 用户群体

本APP用户主要为农机管理员、农场操作人员、农事负责人，需具备基础移动端操作能力，其中农机遥控功能仅对管理员及绑定手机号账号开放，保障操作安全。

# 3\. 详细功能需求

## 3\.1 首页基础工具功能

### 3\.1\.1 测量功能

操作路径：首页点击尺子图标，按照页面指引完成地块面积、两点距离的测量，测量结果可直接保存或用于地块绘制参考。

### 3\.1\.2 地图功能

操作路径：首页点击地球图标，支持多语言切换、多类型地图（如卫星图、矢量图）切换，辅助用户清晰查看地块位置、农机分布及作业区域，提升定位准确性。

### 3\.1\.3 搜索功能

操作路径：首页放大镜入口，支持搜索车辆、地块、基准线，输入关键词可快速定位目标对象，提升操作效率。

### 3\.1\.4 地块绘制与管理

- 驾驶绘制地块：首页→地块→加号，选择驾驶模式，通过手机打点圈边，环绕地块完成边界绘制后保存至地块列表，支持自定义地块名称。

- 手动绘制地块：首页→地块→加号→绘制地块，手动添加坐标点，支持不规则地块、空心圆地块等复杂地块的绘制，绘制完成后自定义名称保存。

- 地块导入与编辑：支持外部地块数据导入，同时可对已保存的地块进行边界修改、名称编辑、删除等操作。

## 3\.2 装备资源管理

### 3\.2\.1 农机添加

操作路径：装备→农机→右下角加号，按照页面提示填写农机型号、编号、所属农场、动力参数等资料，完成农机信息新增与绑定，绑定后可在农机列表查看所有已绑定农机。

### 3\.2\.2 终端绑定

操作路径：装备→终端→右下角加号，录入平板SN号及注册绑定手机号，接收短信验证码完成终端绑定；绑定后可查看平板设备信息、安装记录、作业日期、作业明细及作业统计数据，支持终端与农机的关联绑定。

### 3\.2\.3 农具添加

操作路径：装备→农具→右下角加号，填写农具名称、类型、规格、适配农机型号等对应信息，完成农具新增录入，录入后可在农具列表查看、管理所有农具，并可关联至具体农机。

## 3\.3 任务管理

操作路径：首页右下角功能页面→任务→右下角加号，自定义选择任务类型（如播种、施肥、收割等）、计划作业时间，关联绑定目标地块、农机设备及配套农具，填写作业要求后保存；保存后生成任务清单，用户可在线查看、编辑、删除、跟踪全部农事作业任务，实时掌握作业进度。

## 3\.4 系统设置

操作入口：首页右下角功能页面→设置

- 单位设置：支持自定义修改面积（如亩、公顷）、距离（如米、公里）、速度（如公里/小时）、温度（如摄氏度、华氏度）、日期的展示单位，适配不同用户的使用习惯。

- 地图设置：用户可自主配置首页地图展示内容（如农机位置、地块边界、基准线）、显示图层类型，个性化调整地图展示效果。

## 3\.5 基准线（作业导引）管理

### 3\.5\.1 在线基准线创建与管理

操作路径：功能页面→基准线\-在线→加号，支持绘制、地块平移两种创建模式；填写基准线名称，关联指定地块，添加A、B两点生成作业基准线；生成后支持基准线的编辑、删除操作，可一键下发至关联的农机终端，用于农机作业路径导引。

### 3\.5\.2 终端基准线同步

平板终端绘制并上传AB基准线后，APP终端页面可实时查看、管理所有已上传的基准线，实现基准线的双向同步，保障农机按照统一路径进行导航作业。

## 3\.6 农机远程遥控（四轴四转控制）

### 3\.6\.1 功能概述

针对已绑定终端的智能农机，新增远程遥控操控能力，实现四轴控制与四转向全维度运动操作，支持手机APP近距离或远程控制农机的移动、转向、启停，适配田间移位、作业对位、设备调试、应急调整等场景，提升农机操作的灵活性与便捷性。

### 3\.6\.2 操作入口

- 方式①：装备→对应农机详情页→新增【远程遥控】按钮，点击进入遥控界面。

- 方式②：首页地图农机图标→快捷操作栏→遥控控制，快速进入遥控界面。

### 3\.6\.3 核心控制能力（四轴四转）

- 四轴控制：支持四轮/四轴的独立或联动动力控制，可实现农机前进、后退、怠速、动力启停操作，满足不同作业场景下的动力需求。

- 四转控制：支持四种转向模式，分别为普通左右转向、原地左转、原地右转，适配不同空间场景下的转向需求，提升农机操作灵活性。

- 基础操控：采用方向摇杆或虚拟按键进行操控，确保操作灵敏、无明显延迟；设置一键急停按钮（最高操作优先级），紧急情况下可立即切断农机行走动力，保障操作安全；支持低速安全模式，遥控状态下自动限制农机行驶速度，避免高速操作引发安全隐患。

### 3\.6\.4 操作流程

1. 用户选择已绑定终端且在线的目标农机，通过指定入口进入遥控界面。

2. 系统自动校验设备网络状态、蓝牙/物联网连接状态、农机在线状态，若校验失败，提示用户排查问题（如网络中断、设备离线）。

3. 连接校验成功后，系统自动解锁遥控权限，展示虚拟操控面板（摇杆、按键、急停按钮等）。

4. 用户通过APP虚拟操控面板的按键或摇杆，控制农机完成四轴运转、四向转向、前进后退等操作，实现对位、移位等需求。

5. 作业对位、调试完成后，用户关闭遥控模式，农机自动锁定手动或自动作业模式，恢复正常作业状态。

6. 若出现异常断连、信号微弱、农机超出安全控制范围等情况，系统自动触发停机保护，切断农机动力，避免设备损坏或安全事故。

### 3\.6\.5 配套辅助功能

- 实时状态回传：遥控界面实时显示农机的转速、行驶状态（前进/后退/怠速）、设备信号强度、电量/油量等关键数据，方便用户掌握设备运行情况。

- 可视遥控（可选）：对接农机车载摄像头，实时回传车身周边画面至APP遥控界面，辅助用户远程观察作业环境，提升遥控操作的准确性。

- 权限安全：仅管理员或绑定手机号的账号可开启遥控功能，非授权账号无法访问遥控界面，防止非授权操作引发安全隐患。

- 操作记录：系统自动留存遥控操作日志，包括操作时间、操作人员、设备信息、操作动作（如转向、前进、急停）等，便于后期溯源管理与问题排查。

# 4\. 整体业务闭环

智慧农机APP业务闭环流程如下，各环节无缝衔接，实现农业生产全流程数字化管理：

农机/终端/农具绑定 → 地块绘制/导入 → 基准线规划与下发 → 农机远程遥控对位调试 → 农事任务下发 → 自动化作业执行 → 作业数据实时回传 → 数据统计与可视化展示 → 气象数据辅助运维 → 任务完成归档。