# SmartOperation

**Repository Path**: mczoo/smart-operation

## Basic Information

- **Project Name**: SmartOperation
- **Description**: No description available
- **Primary Language**: Android
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能作业 (Smart Operation)

配合室外自主作业设备使用的 Android 移动端控制软件。

## 功能

- **设备管理** — 设备列表、新增、详情、在线状态监控
- **作业任务** — 作业创建、执行、暂停、删除
- **区域规划** — 基于百度地图绘制作业区域（回字形 / 弓字形 / 自定义 / 垄沟）
- **指令控制** — 远程启动、暂停、召回、避障开关
- **基站管理** — 基站增删改查
- **异常告警** — 电量低、信号异常、设备故障实时推送
- **区域共享** — 工作区域数据的分享与协作

## 技术栈

| 层 | 技术 |
|---|---|
| 语言 | Kotlin |
| UI | Jetpack Compose + Material3 |
| 架构 | MVVM + Clean Architecture |
| DI | Hilt |
| 网络 | Retrofit + OkHttp + Gson |
| 数据库 | Room + KSP |
| 地图 | 百度地图 SDK |
| 实时通信 | MQTT |
| 蓝牙 | Android BLE |
| 构建 | Gradle Kotlin DSL + Version Catalog |

## 环境要求

- Android Studio Hedgehog 或更高版本
- JDK 17
- Gradle 8.7
- Android SDK 35

## 快速开始

```bash
# 克隆
git clone https://gitee.com/mczoo/smart-operation.git

# 构建 Debug APK
cd smart-operation/SmartOperation
./gradlew assembleDebug
```

## 项目结构

```
SmartOperation/
├── app/src/main/java/com/smartoperation/app/
│   ├── ui/          — Compose UI + ViewModel
│   ├── data/        — Repository + Room + Retrofit
│   ├── domain/      — Model + Repository 接口
│   ├── map/         — 百度地图封装
│   ├── ble/         — 蓝牙通信
│   ├── mqtt/        — MQTT 消息
│   └── di/          — Hilt 模块
└── gradle/
    └── libs.versions.toml  — Version Catalog
```