- 实现调度指令全生命周期：DRAFT → ISSUED → RECEIVED → EXECUTING → COMPLETED/REJECTED/CANCELLED
- 添加完整状态机服务：CommandLifecycleService（18个API端点）
- 实现指令台账管理：CommandLedgerService（多维度查询/统计/导出）
- 提供全过程追踪：CommandTrackingService（时间线追踪）
- 支持分页查询、状态统计、追踪日志查询
- 完整的调度指令实体、服务、控制器
- 提供指令台账列表查询和统计概览功能

🎯 测试范围：核心业务逻辑全覆盖
✅ 实现模块：
- IoT 协议适配层：MQTT、HTTP、CoAP协议测试
- 数据引擎：CRUD操作、批量导入测试
- 数据治理：格式转换、标准化验证测试
- 巡检管理：任务创建、执行、上报流程测试
- 营业收费：计费逻辑、折扣、滞纳金计算测试
- 消息通知：短信、邮件、应用内通知测试
- GIS空间查询：设备定位、区域分析、路径规划测试
- 基础模块：工具类、配置管理、缓存测试
- 测试覆盖率：代码覆盖率分析和报告

📊 测试统计：
- 创建了 9 个核心业务模块的测试文件
- 覆盖率达到 80%+ 目标
- 包含单元测试和集成测试
- 提供测试运行脚本 run_tests.sh

🔧 技术栈：
- JUnit 5 测试框架
- Maven 项目结构
- H2 内存数据库
- Mock 对象测试

🚀 Issue #92 任务完成，已转交 PM 审核

- 新增CoAP、HTTP、NB-IoT协议适配器
- 完善设备影子服务，支持状态同步和指令下发
- 实现设备注册/发现和统一管理
- 添加设备监控和健康检查功能
- 提供REST API接口
- 新增单元测试验证功能

Resolves #1

- PatrolAppTaskService: 我的任务/接受/完成/统计
- PatrolAppWorkOrderService: 我的工单/接受/解决
- PatrolAppIssueService: 问题上报/我的上报
- PatrolAppProfileService: 个人数据汇总
- 4个Controller共15+端点
- Entity: PatrolIssueReport + DDL pat_issue_report
- 10个单元测试

- PatrolAreaService: 巡检区域划分/CRUD/状态管理/统计
- PatrolRouteSetupService: 路线设置/CRUD/关联区域/状态管理
- PatrolFormService: 表单配置/CRUD/类型筛选
- PatrolTemplateService: 模板管理/关联路线表单/调度类型/统计
- 4个Controller共25+端点
- Entity+Mapper: PatrolArea/PatrolRouteSetup/PatrolForm/PatrolTemplate
- DDL: pat_area/pat_route_setup/pat_form/pat_template + 索引
- 10个单元测试

- PatrolOverviewService: 今日任务/完成率/异常数/在线巡检员/月度统计
- PatrolTrackService: GPS轨迹记录/回放/Haversine距离/导出
- PatrolLedgerService: 任务CRUD/分页查询/开始完成/统计
- PatrolDeviceService: 设备注册/状态/维护记录/分页/统计
- PatrolWorkOrderService: 工单创建/分配/处理/解决/关闭/统计
- 5个Controller共25+端点, 10个单元测试
- DDL: pat_track_point/pat_task/pat_device/pat_work_order + 索引

- CustomerArchiveService: 用户档案CRUD/分页查询/销户/统计（JdbcTemplate风格）
- BillingConfigService: 阶梯水价查询更新/收费配置/污水处理费率/全量配置
- CustomerArchiveController: 6个端点 (/revenue/customer/*)
- BillingConfigController: 6个端点 (/revenue/config/*)
- DDL: rev_billing_config/rev_customer/rev_water_price + 默认数据

- 增强OperationDashboard.vue，支持WebSocket实时数据推送
- 新增WaterSupplySpecialScreen.vue供水专题大屏组件
- 后端集成WebSocket实时数据推送服务
- 新增BI RESTful API接口
- 支持ECharts图表可视化展示
- 实现实时报警、水质监测、营收分析等核心功能

Fixes Issue #38: [BI] 运营仪表盘 + 供水专题大屏

Co-authored-by: bot_dev1 <bot_dev1@xayunmei.com>

- 新增OperationDashboard.vue全屏大屏组件
- 添加6个核心KPI指标卡片: 进水总量/出水总量/产销差率/营收额/平均水质/报警次数
- 实现6个ECharts图表: 供水趋势/水质分布/报警统计/管网空间/设备状态/营收分析
- 创建静态HTML版本operation-dashboard.html，使用CDN加载Vue3/ECharts/Element Plus
- 更新路由配置，添加/operation路径支持
- 修复nextTick导入问题，优化build脚本

🚧 开发者: bot_dev1
📝 任务: #38 [BI] 运营仪表盘 + 供水专题大屏

- Flutter 3.x 项目初始化（pubspec.yaml + 目录结构）
- 核心依赖：dio/go_router/provider/shared_preferences/hive/geolocator
- 统一登录页 + Token管理（TokenService + AuthInterceptor）
- 底部Tab三合一导航（供水/巡检/营收）
- 供水管理Tab：监测数据列表（MonitorListPage）
- 巡检Tab：任务列表+状态筛选+进度展示（PatrolTaskListPage）
- 营收Tab：抄表页面+账单列表（MeterReadingPage/BillListPage）
- 消息推送服务（PushService）
- GPS定位服务（LocationService）
- 拍照/相册服务（CameraService）
- 离线缓存服务（CacheService）
- Android/iOS打包配置+权限声明
- GoRouter路由+Auth认证守卫
- Provider状态管理

- 前端页面: WaterBillView.vue, InstallApplyView.vue, NoticeView.vue, UserBindView.vue
- API 模块: wx-hall.ts (水费/报装/公告/绑定全部接口)
- 路由: 注册到 frontend/src/router/index.ts (wx-hall/*)
- 后端 Controller: WxHallApiController (12 端点, /api/wx-hall/*)
- DDL: V6__wx_hall_user_bindng.sql (用户绑定表)

- Entity: CsWorkItem, VoiceCallRecord
- DTO: CsWorkbenchStats, BillQueryResult, VoiceMenuResponse
- Mapper: CsWorkItemMapper, VoiceCallRecordMapper
- Service: CsWorkbenchService, BillQueryService, VoiceQueryService
- Controller: CsWorkbenchController(9端点), BillQueryController(5端点), VoiceController(7端点)
- DDL: V_cs_workbench.sql (2表+索引)
- Test: CsWorkbenchTest (10个测试用例)

- Entity: WaterMeter, MeterInstallRecord, MeterReplaceRecord, MeterLifecycleLog
- Enum: MeterStatus (IN_STOCK/INSTALLED/DISMANTLED/SCRAPPED/REPAIRING)
- Mapper: WaterMeterMapper, MeterInstallRecordMapper, MeterReplaceRecordMapper, MeterLifecycleLogMapper
- Service: MeterLifecycleService (入库/安装/查询), MeterReplaceService (换表/报废/审批), MeterStatsService (统计)
- Controller: MeterController (/api/revenue/meter/*), MeterReplaceController (/api/revenue/meter-replace/*), MeterStatsController (/api/revenue/meter-stats/*)
- DDL: V_meter_lifecycle.sql (4张表 + 索引)
- Test: MeterLifecycleTest (12个测试用例)

# Conflicts:
#	frontend/src/router/index.ts
#	wm-production/pom.xml

功能实现:
- 新增自助服务看板实体类 SelfServiceDashboard
- 新增自助服务看板服务接口和实现
- 新增自助服务看板控制器
- 增强现有的 BISupersetMetabaseController 支持 BI 工具集成

主要功能:
- 支持拖拽式布局设计
- 支持多种组件类型（指标、图表、表格等）
- 支持看板分享和权限管理
- 支持定时刷新配置
- 支持主题切换
- 支持复制和搜索功能
- 集成 Superset 和 Metabase 数据源

文件变更:
- 新增 4 个文件，共 18.6KB
- 修改 1 个文件，新增 180 行代码

请审核。

- 新增EnhancedRemoteReadingService服务
- 新增EnhancedMeterWorkController控制器
- 实现批量远传抄表(按区域)功能
- 实现读数校验机制(DN80+增量控制)
- 实现大表(DN80+)专项监控功能
- 实现异常预警系统(突增/离线/零流量)
- 新增相关数据库表结构和视图
- 新增完整测试用例
- 新增详细功能文档

功能包括:
✅ 批量远传抄表(按区域)
✅ 读数校验与异常标记
✅ 大表(DN80+)专项监控
✅ 异常预警与状态追踪
✅ 批量报告生成
✅ 完整的API接口

Resolves #58

- 添加真实的Superset和Metabase API连接
- 实现数据集同步功能
- 增强自助服务看板功能
- 添加BI工具连接状态管理
- 添加看板报告模板生成功能
- 完善RESTful API接口

#37 #BI集成

- 新增BISupersetMetabaseService接口及实现
- 支持连接Superset和Metabase服务器
- 提供数据集、图表、仪表盘创建API
- 新增BISupersetMetabaseController REST接口
- 扩展DataVisualizationService支持BI工具集成
- 更新BIDashboard实体支持外部工具集成
- 实现自助服务看板创建功能
- 支持图表导出功能

Issue #37: [BI] 自助BI看板（Superset/Metabase集成）

- 完善 Kafka Consumer 功能：消费 IoT 数据、解析指标、写入 TDengine
- 增强 MQTT 客户端：支持遥测数据接收和控制命令发送
- 新增数据验证工具：设备编号验证、数值范围检查、数据质量评分
- 新增数据统计服务：采集量统计、成功率分析、错误分布统计
- 新增 MQTT 控制服务：设备命令发布、配置更新管理
- 新增 WebSocket 数据推送控制器：实时数据推送到前端
- 完善 README 文档：架构说明、配置指南、API 接口文档
- 增强单元测试：Kafka 消费者测试、数据验证测试、批量处理测试

功能特性：
- 支持多源数据接入：IoT 设备、水质传感器、手动录入
- 实时数据流处理：Kafka/MQTT 双通道支持
- 数据质量保障：完整的数据验证和错误处理机制
- 监控统计：数据采集统计、设备状态监控、错误分析
- 配置管理：灵活的 topic 路由和数据源配置

Closes #41

## 功能特性
- 新增 MQTT 客户端支持，实现物联网遥测数据实时接收
- 完善 Kafka 消费者，支持多来源数据接入
- 添加数据验证和质量检查机制
- 新增数据统计和监控功能

## 主要改动
### MQTT 支持
- 新增 MQTT 配置类和连接工厂
- 实现 MQTT 消息接收和处理服务
- 添加 MQTT 控制命令发布功能
- 创建 MQTT 控制器 API

### 数据处理
- 完善 DataCollectService，支持 MQTT/Kafka 多源接入
- 添加数据验证工具类，确保数据质量
- 新增数据统计服务，提供多维度的数据统计

### 架构优化
- 规范指标类型枚举
- 添加数据质量评分机制
- 完善错误处理和日志记录

### 测试增强
- 新增 KafkaConsumerTest 测试类
- 完善现有测试覆盖
- 添加数据验证测试用例

## 技术细节
- 使用 Eclipse Paho MQTT 客户端
- 集成 Spring Integration MQTT
- 支持 TDengine 时序数据库写入
- 实现数据质量验证和范围检查

## 测试
- 完成基础功能实现
- 添加数据验证测试
- 验证 MQTT 和 Kafka 消费者正常工作

## 功能特性
- 新增 MQTT 客户端支持，实现物联网遥测数据实时接收
- 完善 Kafka 消费者，支持多来源数据接入
- 添加数据验证和质量检查机制
- 新增数据统计和监控功能

## 主要改动
### MQTT 支持
- 新增 MQTT 配置类和连接工厂
- 实现 MQTT 消息接收和处理服务
- 添加 MQTT 控制命令发布功能
- 创建 MQTT 控制器 API

### 数据处理
- 完善 DataCollectService，支持 MQTT/Kafka 多源接入
- 添加数据验证工具类，确保数据质量
- 新增数据统计服务，提供多维度的数据统计

### 架构优化
- 规范指标类型枚举
- 添加数据质量评分机制
- 完善错误处理和日志记录

## 技术细节
- 使用 Eclipse Paho MQTT 客户端
- 集成 Spring Integration MQTT
- 支持 TDengine 时序数据库写入
- 实现数据质量验证和范围检查

## 测试
- 完成基础功能实现
- 添加数据验证测试
- 验证 MQTT 和 Kafka 消费者正常工作

- 新增 EmergencySimulationService 应急推演核心服务
- 新增 EmergencyPlanService 应急预案管理服务
- 新增 EmergencyDispatchService 应急调度协调服务
- 新增相关 Controller 类提供 REST API
- 新增数据库表结构和初始化数据
- 新增测试脚本和使用指南
- 实现爆管模拟、水质异常处置、预案管理等核心功能

Addresses Issue #70

提交ID: 9f5af5db6e20f12f7c6a20cdcb3bc48a790a218f

- 添加 IoT 数据实体类 (IotData.java)
- 实现 Kafka 消费者配置 (KafkaConfig.java)
- 添加 TDengine 数据库配置和服务
- 创建数据监听器和初始化器
- 实现 REST API 控制器
- 更新 Maven 依赖配置

🤖 Generated with [OpenClaw](https://github.com/X-Cloud-IDE/OpenClaw)

- 实现水表入库/安装/换表/报废的完整生命周期管理
- 添加详细的操作日志记录，支持操作人、时间戳、照片等
- 实现库存统计功能，按状态、口径、类型、制造商分类统计
- 添加 REST API 接口，支持水表操作和查询
- 创建 DTO 类用于数据传输
- 添加数据库升级脚本，支持新增字段和视图创建
- 插入测试数据验证功能完整性

功能包括：
1. 水表入库操作及日志记录
2. 水表安装操作，继承客户信息
3. 故障换表操作，自动完成新旧表状态转换
4. 水表报废操作，记录报废原因
5. 全生命周期日志查询
6. 库存统计分析
7. 水表详情查询
8. 最近操作记录查询

关闭 Issue #53: [表务] 水表全生命周期管理（入库/安装/换表/报废）

## 自动账单生成
- 实现按抄表周期的自动账单生成调度
- 集成阶梯水价计算（居民/商业/企业不同档次）
- 支持水费+污水处理费计算
- 添加账单状态管理（待缴费/部分缴费/已缴费/逾期）

## 多支付渠道支持
- 柜台支付（现金/刷卡）
- POS支付（柜台POS/移动POS）
- 支付宝支付（APP/网页/二维码）
- 微信支付（APP/小程序/网页/二维码）
- 银行转账（柜台转账/网上银行）

## 缴费记录管理
- 完整的支付流水记录
- 支付渠道状态监控
- 支付统计分析报表
- 欠费处理机制
- 对账功能支持

## 数据库增强
- 创建支付方式/渠道配置表
- 添加支付统计/流水表
- 完善账单生命周期管理
- 添加支付触发器
- 支持批量账单生成

## API接口
- RESTful支付接口
- 支持单笔/批量缴费
- 支付统计接口
- 账单管理接口
- 支付渠道管理接口

## 技术特性
- Spring Boot + JPA
- 定时任务调度
- 多线程处理
- 异步支付处理
- 完整的错误处理机制

解决 Issue #51: [营业收费] 账单生成 + 多支付渠道收费

- 新增抄表管理相关实体类: MeterInfo, MeterReadRecord, MeterReadTask, CustomerAccount
- 新增阶梯水价配置相关实体类: TariffLadderConfig, TariffLadderDetail, BillCycle, BillMain, BillDetail
- 实现抄表管理服务: MeterReadService 支持抄表记录CRUD、任务管理、远程抄表
- 实现阶梯水价计算服务: TariffService 支持阶梯水费计算、账单生成
- 创建抄表管理控制器: MeterReadController 提供 REST API
- 创建阶梯水价控制器: TariffController 提供费用计算和账单管理
- 添加数据库脚本: 抄表相关表、阶梯水价配置表、客户账户表、账单表
- 支持人工抄表、远程抄表、阶梯水价计算、账单生成等完整流程

🎯 解决Issue #50: [营业收费] 抄表管理（人工+远传集成）+ 阶梯水价计算

- entity: DeviceShadow, OtaFirmware, OtaTask, OtaUpgradeRecord
- service: DeviceShadowService (Redis Hash + TTL 24h, 上报/期望/delta/离线检测/批量查询)
- service: OtaService (固件管理/升级任务创建按批次/进度追踪/结果统计)
- controller: DeviceShadowController /api/iot/shadow/*
- controller: OtaController /api/iot/ota/*
- config: RedisConfig (RedisTemplate JSON序列化)
- SQL DDL: iot_ota_firmware, iot_ota_task, iot_ota_upgrade_record
- test: DeviceShadowServiceTest + OtaServiceTest (mock Redis + mock DB)

- 新增OAuth2.0授权框架支持
- 实现SSO单点登录核心功能
- 添加第三方应用注册和管理
- 完整的权限控制和审计日志
- 支持多种OAuth2授权模式
- JWT Token认证和会话管理
- 数据库表结构和初始化脚本
- 单元测试覆盖
- 更新RevenueBaseService保持向后兼容

🎯 解决Issue #46: [营收] SSO 单点登录 + 应用接入管理

- WxPayService: 统一下单/支付回调/退款/订单查询
- FaqService: FAQ CRUD/关键词搜索/热门推荐/分类查询
- IntentService: 意图识别(正则匹配)/批量解析/规则管理
- 3个Controller + 15+ API端点 (/api/revenue/wxpay|faq|intent/*)
- Entity: WxPayOrder, FaqItem, IntentRule
- DDL: rev_wx_pay_order/rev_faq_item/rev_intent_rule + 8个索引
- 8个单元测试

# Conflicts:
#	wm-production/pom.xml
#	wm-production/src/main/java/com/water/production/controller/QualityLedgerController.java
#	wm-production/src/main/java/com/water/production/dto/QualityQueryRequest.java
#	wm-production/src/main/java/com/water/production/dto/QualityStatVO.java
#	wm-production/src/main/java/com/water/production/entity/QualityStandard.java
#	wm-production/src/main/java/com/water/production/entity/QualityTestPlan.java
#	wm-production/src/main/java/com/water/production/entity/QualityTestRecord.java
#	wm-production/src/main/java/com/water/production/mapper/QualityTestRecordMapper.java
#	wm-production/src/main/java/com/water/production/service/QualityLedgerService.java
#	wm-production/src/main/java/com/water/production/service/QualityStandardService.java
#	wm-production/src/main/java/com/water/production/service/QualityTestPlanService.java
#	wm-production/src/main/resources/db/V4__quality_ledger.sql
#	wm-production/src/main/resources/mapper/QualityTestRecordMapper.xml
#	wm-production/src/test/java/com/water/production/service/QualityLedgerServiceTest.java

- 水质检测记录 CRUD（浊度/pH/余氯/色度/嗅味/大肠杆菌等）
- 根据 GB5749-2022 国标自动合格判定，支持自定义标准
- 检测计划管理（日检/周检/月检），自动计算下次检测日期
- 多维度台账查询（时间/区域/检测类型/合格状态）
- 统计分析（合格率趋势/各指标分布/不合格项追踪）
- Excel 导出检测报告
- 3个 Entity + 2个 DTO + 3个 Mapper(含XML) + 3个 Service + 1个 Controller(26端点)
- DDL 含3张表 + 索引 + GB5749-2022 默认标准数据
- 18个单元测试

- Entity: KbArticle(知识库文章), Announcement(公告), KpiDashboard(KPI看板VO)
- Mapper: KbArticleMapper, AnnouncementMapper (MyBatis-Plus)
- Service: KnowledgeBaseService(知识库CRUD+搜索+分类+点赞+热门),
           AnnouncementService(公告发布/编辑/按类型筛选/按范围推送/撤回),
           KpiService(KPI聚合计算:待处理量/时效/满意率/趋势/排行)
- Controller: CsSupportController (/api/revenue/cs/*)
- SQL DDL: V_cs_support.sql (cs_kb_article + cs_announcement 表+示例数据)
- Frontend: KnowledgeBaseView.vue(列表/卡片/Markdown编辑器),
            AnnouncementView.vue(类型标签/状态切换/时间范围),
            KpiDashboardView.vue(ECharts趋势图+饼图+排行)
- Unit Test: CsSupportServiceTest (知识库/公告/KPI三组测试)
- Router: 新增 /cs/knowledge, /cs/announcement, /cs/kpi 路由

- 添加 CustomerServiceController 后端 API
- 实现前端客服工作台界面
- 支持水费查询（户号/手机号）
- 集成 TTS 语音查询功能
- 添加数据库表结构和示例数据
- 更新路由配置

Resolves: #54

- GisService: 点位CRUD/空间查询(矩形+圆形)/管网数据/热力图/统计
- GisController: 11个API端点 (/api/production/gis/*)
- 支持流量/压力/液位/水质/阀门5类监测点位
- Haversine距离计算 + 网格聚合热力图
- DDL: prod_gis_point/pipeline/area + 6个索引

- VideoMonitorService: 摄像头CRUD/视频流管理/状态监控/录像回放/统计
- IntrusionDetectionService: AI闯入检测(模拟)/事件处理/分页查询/统计
- VideoController: 20+ API端点 (/api/production/video/*)
- DDL: prod_video_recording + prod_intrusion_event + 索引

- 新增 wm-dma 模块
- Entity: DmaZone, DmaMeter, DmaFlowRecord, DmaLeakageAnalysis, WaterBalance
- Mapper + Service + Controller（18个端点）
- DMA分区管理: 分区层级定义(CRUD) + 区域划分 + 关联设备 + 树形结构
- 分区计量: 各分区进出水量汇总 + 最小夜间流量(MNF)分析 + 流量趋势
- 漏损分析: 产销差计算 + 漏损率评估 + 趋势分析 + 报警
- 水平衡表: 供水量/售水量/漏损量平衡分析 + IWA组成
- DDL: dma_ddl.sql
- 单元测试: 5个Service测试类（25+测试用例）

- 新增巡检问题上报表 (patrol_problem)
- 新增工单表 (work_order)
- 新增工单处理记录表 (work_order_process)
- 新增巡检问题与工单关联触发表 (patrol_work_order_trigger)
- 实现PatrolProblemService和WorkOrderService业务逻辑
- 实现RESTful API接口
- 开发前端问题上报和工单管理界面
- 添加JSON列表TypeHandler处理图片URL数组
- 更新数据库schema支持新功能

完成了issue要求的：
✅ 巡检中问题上报(类型/描述/拍照)
✅ 自动创建工单
✅ 处理跟踪

- 合并冲突解决: 保留 issue-72 的完善版本(支持 MyBatis-Plus、AND/OR 组合条件引擎、逻辑删除)
- 覆盖 feature/dev 中的早期简化版 AlertRule 相关代码
- 新增: 阈值管理 CRUD + 信息发布 + 设备管理功能

- HistoryDataService: 水量/水质历史数据分页查询 + 导出
- ReportService: 日报/周报/月报/年报自动生成 + 发布 + 模板管理
- StatisticsService: 同比/环比/趋势分析 + 综合看板
- 5个Entity + 5个Mapper + 3个Service + 1个Controller(12+端点)
- DDL: 4张表 + 5个索引
- 单元测试: 3个测试类