首页 / Java 平台（cloud-java） / prod-gps GPS
prod-gps GPS
GPS 设备、行程、围栏、设备分组与轨迹报表，NATS 消费与 gRPC 服务。
职责概览
GPS 产品模块 独立端口 48098 / gRPC 49098，提供 GPS 设备的业务管理：设备档案、行程、地理围栏、设备分组、追踪模式、报表（日/周）、命令下发与缩略图。
与 Go 数据面分工：Go geosvr/tripsvr 负责轨迹数据与行程计算，Java prod-gps 负责业务配置、围栏管理、报表与对外 gRPC。
接口清单
| 分组 | Controller | 说明 |
|---|---|---|
| 设备 | GpsDeviceController、AppGpsDeviceController | GPS 设备档案与 App 设备列表 |
| 行程 | AppGpsTripController | 行程查询（地图回放） |
| 围栏 | GpsGeofenceController、AppGpsGeofenceController | 围栏 CRUD 与 App 配置 |
| 设备组 | GspDeviceGroupController、AppGspDeviceGroupController | 设备分组管理 |
| 追踪模式 | GpsTrackingModeController、AppGpsTrackingModeController | 上报频率/追踪模式配置 |
| 报表 | GpsReportScheduleController、GpsReportTaskController、AppGpsReportScheduleController、AppGpsDailyReportController、AppGpsWeeklyReportController | 报表任务调度与日/周报 |
| 位置/命令 | AppGpsLocationController、AppGpsCommandController、AppGpsThumbnailController | 实时位置、命令下发、缩略图 |
关键实现
gRPC 对外服务
| 服务 | 用途 |
|---|---|
ProdGpsGeofenceService | 围栏查询/校验，供外部（Go 侧）使用 |
ProdGpsTripService | 行程数据查询 |
ProdGpsTripDataReportService | 行程数据报表上报接口 |
定时任务
GpsReportScheduleJob：报表计划触发GpsReportOutboxPublishJob：报表数据 Outbox 可靠发布GpsReportNotificationJob：报表完成通知
NATS 消费
prod-gps 通过 NATS messagebus 消费轨迹/行程相关事件，维护行程摘要与报表数据；消费需检查 Stream 与消费组配置。
数据与维护注意
核心表：gps_*（8 张），覆盖设备、行程、围栏、设备组与报表。
- 轨迹高频数据在 TDengine（Go 写入），Java 报表只读；不要把轨迹落 MySQL。
- 围栏变更需同步失效 Go 侧缓存，避免旧围栏判断。
- 行程摘要与报表依赖 Go tripsvr 计算结果，排查时先确认 Go 侧任务是否完成。