更新完善页面

utils/pagination.js

@@ -1,3 +1,17 @@
+/**
+ * 数据库分页查询工具函数
+ * @module services/utils/pagination
+ */
+
+/**
+ * 分页查询函数
+ * @param {Function} queryFn - 数据库查询函数
+ * @param {string} sql - SQL 查询语句
+ * @param {Array} params - SQL 参数
+ * @param {number} [page=1] - 页码
+ * @param {number} [pageSize=20] - 每页大小
+ * @returns {Promise<Object>} 分页结果 { data, total, page, pageSize, totalPages }
+ */
 async function paginate(queryFn, sql, params, page = 1, pageSize = 20) {
   const p = Math.max(1, parseInt(page) || 1)
   const ps = Math.min(100, Math.max(1, parseInt(pageSize) || 20))