// 全局 JSDoc 类型定义  全项目所有文件通用

/**
 * 【全局】通用分页接口返回结构1
 * @template T - 列表项类型
 * @typedef {Object} RowsResult
 * @property {number} code 响应码，200=成功
 * @property {string} msg 响应消息
 * @property {number} total 总条数
 * @property {T[]} rows 数据列表
 */

/**
 * 【全局】通用接口返回结构2
 * @template T - 列表项类型
 * @typedef {Object} DataResult
 * @property {number} code 响应码，200=成功
 * @property {string} msg 响应消息
 * @property {T} data 数据列表
 */


/**
 * 【全局】角色标识枚举
 * @typedef {'manage'|'repair'|'inspection'|'EquipmentMaintenance'|'complainUser'} RoleKeyEnum
 *
 * @enum {RoleKeyEnum}
 * @property {'manage'} manage - 物业管理员
 * @property {'repair'} repair - 小区维修人员
 * @property {'inspection'} inspection - 巡检人员
 * @property {'EquipmentMaintenance'} EquipmentMaintenance - 设备维护人员
 * @property {'complainUser'} complainUser - 投诉处理人员
 */