修正接口文档内容

更新日志.md

@@ -31,27 +31,17 @@
 {
   "Status": 1, // 1成功，0失败，-1异常
   "Message": "写入成功", // 操作结果描述
-  "Count": 3 // 写入记录数量
+  "Count": 2 // 成功插入的记录数
 }
 ```
 
 **功能描述**：
-该接口用于向数据库表 `tbl_roomvisitlogform` 写入房间设备访问日志，支持批量写入多个设备的信息。
+该接口用于向数据库表 `tbl_roomvisitlogform` 写入房间设备访问日志，支持批量写入多个设备的信息。UpdateDate 由服务器自动生成，格式为 `yyyy-MM-dd HH:mm:ss`。
 
-**数据库表结构**：
-```sql
-CREATE TABLE `tbl_roomvisitlogform` (
-  `ID` int NOT NULL AUTO_INCREMENT,
-  `HotelID` varchar(254) DEFAULT NULL COMMENT '酒店id',
-  `RoomNumber` varchar(254) DEFAULT NULL COMMENT '房号',
-  `EquipmentStatus` varchar(254) DEFAULT NULL COMMENT '设备状态',
-  `FaultDescription` varchar(254) DEFAULT NULL COMMENT '故障描述',
-  `UpdateDate` varchar(254) DEFAULT NULL COMMENT '更新时间',
-  `DevName` varchar(254) DEFAULT NULL COMMENT '设备名称',
-  PRIMARY KEY (`ID`),
-  KEY `idx_hotel_room` (`HotelID`,`RoomNumber`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3
-```
+**实现说明 / 变更**：
+- 修复说明：修复了 Controller 中原先使用匿名对象列表通过 Ado.ExecuteCommand 插入导致的不稳定/编译隐患，改为使用 SqlSugar 的 `Insertable` 批量插入 POCO（写入到 `tbl_roomvisitlogform`），返回实际插入的行数（Count）。
+- 校验：当 `HotelID` 或 `RoomNumber` 为空，或 `EquipmentList` 为空时，接口返回 `Status=0` 并给出相应错误消息。
+- 时间字段：`UpdateDate` 由服务器生成，客户端无需提供。
 
 **使用示例**：
 ```javascript
@@ -65,22 +55,15 @@ fetch('/Upgrade/WriteRoomVisitLog', {
     HotelID: '123',
     RoomNumber: '101',
     EquipmentList: [
-      {
-        EquipmentStatus: '正常',
-        DevName: '灯光设备'
-      },
-      {
-        EquipmentStatus: '故障',
-        FaultDescription: '无法正常开关',
-        DevName: '空调设备'
-      }
+      { EquipmentStatus: '正常', DevName: '灯光设备' },
+      { EquipmentStatus: '故障', FaultDescription: '无法正常开关', DevName: '空调设备' }
     ]
   })
 })
 .then(response => response.json())
 .then(data => {
   console.log(data);
-  // 输出：{"Status":1,"Message":"写入成功","Count":2}
+  // 输出示例：{"Status":1,"Message":"写入成功","Count":2}
 });
 ```
 
@@ -88,7 +71,8 @@ fetch('/Upgrade/WriteRoomVisitLog', {
 系统开发团队
 
 **备注**：
-该接口用于记录房间设备的访问和状态信息，方便后续查询和分析。
+- 本次更新修复了导致编译或插入异常的实现方式，现已使用稳定的批量插入方案。
+- `Count` 字段表示成功写入数据库的行数。
 
 #### 2. 房间设备访问日志查询接口
 
@@ -135,7 +119,13 @@ fetch('/Upgrade/WriteRoomVisitLog', {
 ```
 
 **功能描述**：
-该接口用于查询房间设备访问日志，根据酒店ID、房号和时间范围进行筛选。如果开始时间和结束时间为空，则查询该房间的所有记录。
+该接口用于查询房间设备访问日志，根据酒店ID、房号和时间范围进行筛选。若 `StartTime`/`EndTime` 未提供，则返回该房间全部记录；若提供则按时间过滤并按 `UpdateDate` 降序返回。
+
+**实现说明 / 变更**：
+- 修复说明：解决了原实现中使用匿名类型在不同条件下重新赋值导致的编译错误（CS0029），改为使用可变参数集合并对时间参数做格式校验。
+- 时间参数行为：
+  - `StartTime` / `EndTime` 必须为 `yyyy-MM-dd HH:mm:ss` 格式；格式错误时接口返回 `Status=0` 并带提示信息（例如：`StartTime 格式错误，应为 yyyy-MM-dd HH:mm:ss`）。
+  - 支持单边过滤：仅传 `StartTime` 表示 `UpdateDate >= StartTime`；仅传 `EndTime` 表示 `UpdateDate <= EndTime`；同时传则表示 `StartTime <= UpdateDate <= EndTime`。
 
 **使用示例**：
 ```javascript