# mome-location

**Repository Path**: j326598/mome-location

## Basic Information

- **Project Name**: mome-location
- **Description**: mome守护是一套基于 Flutter、Spring Boot 和 MongoDB 开发的双向授权情侣守护系统，支持实时位置、设备状态、地点提醒、轨迹回放、应用使用统计、周守护报告及单次远程请求。项目包含 Android 客户端、管理后台、产品官网和在线版本发布功能，强调双方知情、主动授权、数据真实与隐私边界。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-02
- **Last Updated**: 2026-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mome守护

基于 Flutter、Android 原生能力、Spring Boot 和 MongoDB 构建的双向授权情侣守护系统。项目包含 Android 客户端、业务 API、MongoDB 持久化、运营管理后台、产品官网和 App 在线版本发布能力。

> 本项目以双方知情和主动授权为前提。位置、使用统计、轨迹及远程操作均受隐私设置或系统权限约束；无真实数据时不使用模拟业务数据填充。

## 在线地址

- 产品官网：<https://mome.bbroot.com/>

## 功能特性

- 手机号注册、登录、邀请码绑定和一对一情侣关系管理
- 双方实时位置、距离、设备型号、电量、网络和在线状态
- GPS 与网络定位融合、低质量坐标过滤及后台持续定位
- 地点进入/离开提醒和历史轨迹查询回放
- 对方授权后的应用使用时长、分类、启动次数和解锁统计
- 对方授权后的周守护报告、活跃热力和周期趋势
- 精确位置、模糊位置、使用数据和报告等分级共享策略
- 单次截屏、锁屏、电话状态和伴侣提醒请求
- 用户、情侣、设备、轨迹、反馈和管理员账户管理
- APK 上传、校验、发布、下线、下载和客户端更新检查

## 技术栈

| 模块 | 技术 |
|---|---|
| 移动客户端 | Flutter、Dart |
| Android 原生层 | Java、MethodChannel、EventChannel、Foreground Service |
| 地图与定位 | 高德地图 Android SDK、Android LocationManager |
| 后端 | Spring Boot 3.3.4、Java 17、Spring Security |
| 数据库 | MongoDB、Spring Data MongoDB |
| 管理后台与官网 | HTML、CSS、JavaScript |

## 项目结构

```text
mome守护-前后端源码/
|-- flutter_app/    Flutter 客户端和 Android 原生源码
|-- backend/        Spring Boot 后端、官网和管理后台源码
`-- README.md       项目说明
```

## 环境要求

- Flutter 稳定版，支持 Dart `^3.12.2`
- JDK 17
- Maven 3.9+
- MongoDB 7.0+（建议）
- Android SDK 及对应 Build Tools
- 有效的高德 Android API Key

## 本地运行

启动后端：

```powershell
cd backend
$env:MONGODB_URI="mongodb://localhost:27017/coupleguard"
$env:APP_JWT_SECRET="仅用于本地开发且至少32字节的随机字符串"
mvn spring-boot:run
```

健康检查：

```text
http://127.0.0.1:8081/api/health
```

运行客户端：

```powershell
cd flutter_app
flutter pub get
flutter run
```

开发联调时修改 `flutter_app/lib/main.dart` 中的 `kBaseUrl`。真机使用开发电脑的局域网地址，Android 模拟器可使用 `http://10.0.2.2:8081/api`，生产构建必须使用 HTTPS。

高德 Key 在 `flutter_app/android/app/src/main/AndroidManifest.xml` 中配置，并且必须匹配包名 `com.qinglv.coupleguard` 和当前构建签名的 SHA1。

## 测试与构建

```powershell
cd flutter_app
flutter analyze
flutter test
flutter build apk --release
```

```powershell
cd backend
mvn test
mvn -DskipTests package
```

Release APK 需要自行配置 `flutter_app/android/keystore.properties` 和发布签名库。签名文件、密码、JWT 密钥和数据库密码不得提交到 Git。

## 生产要求

- 使用 HTTPS 和 Nginx 反向代理。
- 更换默认管理员密码与开发 JWT 密钥。
- MongoDB 和 Spring Boot `8081` 端口不得直接暴露到公网。
- 持久化保存头像、发布 APK 和数据库备份。
- 配置与 Release 签名匹配的高德 Key。
- 敏感远程操作必须保留对方逐次确认流程。

## 使用声明

项目涉及位置、设备状态和使用情况等敏感信息。部署者应遵守所在地法律法规，向用户清晰说明数据用途、保存期限和删除方式，确保数据采集及远程请求均经过用户明确授权。禁止用于隐蔽监控、骚扰或其他未经授权的用途。

## License

源码副本未附带开源许可证。未经版权所有者明确授权，不代表允许复制、修改、分发或商用。