# DTS Monitor Android

DTS 光纤温度传感器监控系统 Android 客户端

## 功能

- 🌡️ **实时温度监控** - 实时温度曲线、最高/最低/平均温度、状态指示
- 🚨 **报警管理** - 报警统计（今日/本周/本月/累计）、报警记录列表、时间筛选
- 📊 **历史数据** - 温度快照列表、历史温度曲线查看
- ⚙️ **设置** - 服务器地址配置，支持保存

## 技术栈

- **语言**: Kotlin
- **最低支持**: Android 7.0 (API 24)
- **目标版本**: Android 13 (API 33)
- **UI**: Material Design 3
- **图表**: MPAndroidChart
- **网络**: OkHttp + Gson
- **构建**: Gradle 8.4

## 项目结构

```
app/src/main/java/com/dtsmonitor/app/
├── MainActivity.kt          # 主Activity，底部导航管理
├── ui/
│   ├── realtime/            # 实时温度监控页
│   ├── alarm/               # 报警管理页
│   ├── history/             # 历史数据页
│   └── settings/            # 设置页
├── api/
│   ├── DtsApiService.kt     # REST API 客户端
│   └── Models.kt            # 数据模型
└── util/
    └── Preferences.kt       # SharedPreferences 工具
```

## 编译

### 环境要求

- JDK 11+
- Android SDK (API 33)
- Gradle 8.4

### 编译步骤

```bash
export ANDROID_HOME=/path/to/android-sdk
./gradlew assembleDebug
```

APK 输出: `app/build/outputs/apk/debug/app-debug.apk`

## 配置

首次运行后，进入「设置」页面输入 DTS Monitor 服务器地址（如 `192.168.1.100:8086`），保存后返回其他页面即可自动连接。

## 对接 API

| 端点 | 说明 |
|------|------|
| GET /api/realtime | 实时温度数据 |
| GET /api/status | 系统状态 |
| GET /api/alarm | 报警记录（分页） |
| GET /api/snapshots | 温度快照列表 |
| GET /api/history?time=xxx | 历史温度数据 |

## 仓库

- **Gogs**: https://git.zhonjin.com:40717/steven_roc/dts_monitor_android
- **服务端**: https://git.zhonjin.com:40717/steven_roc/dts_monitor

## License

MIT