feat(hardware): 新增电池故障列表查询工具 (REQ-20260921-0006)

2026-09-21 10:43:30 +02:00
parent c47668f6b9
commit 315f9bafff
10 changed files with 541 additions and 0 deletions
@@ -782,6 +782,21 @@

 ---

+## 31. battery.fault.list.query
+
+分页查询电池故障记录，对应旧系统 `POST /batteryFault/batteryFaultLogList`。
+
+- 分类：hardware ｜ 类型：读
+- 数据来源：m0 `battery_fault_log`，固定 `soft_delete=0`。
+- 入参：`districtId/propertyId/agentId`（正整数）、`snCode`（模糊匹配）、`deviceType`（0 厕纸机/出纸机、1 擦手纸机）、`faultType`（0 温度、1 电压、2 电流、3 充电次数）、`faultState`（0 未恢复、1 已恢复）、`faultDateFrom/faultDateTo`（yyyy-MM-dd，结束日期含当天）、`page/rows`。
+- 分页默认 1/20、上限 100，固定按 `fault_start_time DESC, id DESC` 稳定排序。
+- 行级权限与 `hardware.list.query` 一致：总部查看全部；代理查看自己、直属下级、代管代理及代管物业；销售非负责人限自己创建及授权范围内物业。服务身份仍由 MCP scope 控制。
+- 返回 `id/snCode/deviceType/deviceTypeText/faultType/faultTypeText/faultState/faultStateText/peakValue/standardValue/faultStartTime/faultAddTime/faultRecoveryTime/installPosition/agentId/agentName/propertyId/propertyName/districtId/districtName`。时间按 Asia/Shanghai 输出；峰值和标准值保留数据库原始整数，不推断单位。
+
+详细设计见 `battery-fault-mcp-tool-design.md`。
+
+---
+
 ## 附录：在线查看工具清单

 ```bash