巡检记录接口对接

wuye-manager-uniapp/jsdoc.types.js

@@ -1,24 +1,35 @@
 // 全局 JSDoc 类型定义  全项目所有文件通用
 
 /**
- * 【全局】通用分页接口返回结构1
+ * 【全局】通用分页接口返回结构
  * @template T - 列表项类型
- * @typedef {Object} RowsResult
+ * @typedef  RowsResult 分页结构
  * @property {number} code 响应码，200=成功
  * @property {string} msg 响应消息
  * @property {number} total 总条数
  * @property {T[]} rows 数据列表
  */
-
 /**
- * 【全局】通用接口返回结构2
- * @template T - 列表项类型
+ * 返回结果
+ * @template T
  * @typedef {Object} DataResult
+ * @property {T} data 列表数据
  * @property {number} code 响应码，200=成功
  * @property {string} msg 响应消息
- * @property {T} data 数据列表
  */
 
+/**
+ * 分页参数
+ * @typedef {Object} PageType
+ * @property {number} pageSize 每页条数
+ * @property {number} pageNum 当前页码
+ */
+
+/**
+ * 通用请求参数（T 不传时 = PageType）
+ * @template [T=undefined]
+ * @typedef {T extends undefined ? PageType : PageType & T} RequestParams
+ */
 
 /**
  * 【全局】角色标识枚举