nayota-show-sdk 1.3.52 → 1.3.55

package/api/area.js

@@ -27,6 +27,8 @@ import { requestShow } from '../utils'
  * @property {string} managerName - 管理人姓名
  * @property {number} areaSize - 区域面积（平方米）
  * @property {Array} centerCoordinate - 区域中心坐标 [x, y]
+ * @property {boolean} isPointDisplay - 是否显示点位
+ * @property {Object} pointJson - 点位样式自定义json
  * @property {string} creator - 创建人id
  * @property {string} linkType - 区域关联类型 'none'|'depart'|'device'|'link'|'scada'
  * @property {string} targetDepartId - 关联部门ID（跳转楼栋/楼层）
@@ -49,6 +51,12 @@ import { requestShow } from '../utils'
     "managerName": "张三",
     "creator": "667d2ecc52d21700095b58b5",
     "centerCoordinate": [116.404, 39.915],
+    "isPointDisplay": true,
+    "pointJson": {
+        "icon": "warning",
+        "color": "#ff5a36",
+        "size": 24
+    },
     "linkType": "scada",
     "targetDeviceId": "67073bfe463d6e00099becde",
     "targetDeviceIds": ["67073bfe463d6e00099becde", "67073bfe463d6e00099becdf"],

package/api/attendanceRecord.js

@@ -0,0 +1,201 @@
+import { requestShow } from '../utils'
+
+/**
+ * @file 考勤记录api
+ * @module 考勤记录接口
+ * @category 人员管理
+ * @import
+ * import { attendanceRecord } from 'nayota-show-sdk'
+ * const { list, create, getOne, updateOne, deleteOne, deleteMany } = attendanceRecord
+ * list({ page: 1, limit: 10 })
+ */
+
+/**
+ * @typedef {Object} AttendanceLocation - 打卡定位
+ * @property {'Point'} type - GeoJSON 类型
+ * @property {Array<number>} coordinates - 经纬度数组，[经度, 纬度]
+ */
+
+/**
+ * @typedef {Object} AttendanceRecord - 考勤记录
+ * @property {string} _id - 考勤记录id
+ * @property {string|Object} user - 关联用户
+ * @property {Date} date - 考勤日期
+ * @property {number} [shiftType] - 班次类型，1 早班，2 中班，3 晚班
+ * @property {Date} [clockInTime] - 上班打卡时间
+ * @property {Date} [clockOutTime] - 下班打卡时间
+ * @property {number} [clockInMethod] - 上班打卡方式，1 扫码拍照，2 GPS定位，3 人脸识别
+ * @property {number} [clockOutMethod] - 下班打卡方式，1 扫码拍照，2 GPS定位，3 人脸识别
+ * @property {string} [clockInPhoto] - 上班打卡照片
+ * @property {string} [clockOutPhoto] - 下班打卡照片
+ * @property {AttendanceLocation} [clockInLocation] - 上班打卡定位
+ * @property {AttendanceLocation} [clockOutLocation] - 下班打卡定位
+ * @property {string} [clockInAddress] - 上班打卡地址
+ * @property {string} [clockOutAddress] - 下班打卡地址
+ * @property {number} status - 考勤状态，0 未打卡，1 正常，2 迟到，3 早退，4 缺勤，5 迟到且早退
+ * @property {number} [workDuration] - 实际工作时长，单位分钟
+ * @property {boolean} isOvertime - 是否加班
+ * @property {number} [overtimeDuration] - 加班时长，单位分钟
+ * @property {string} [remark] - 备注
+ * @property {string} [creator] - 创建者
+ * @property {Date} createdAt - 创建时间
+ * @property {Date} updatedAt - 更新时间
+ * @example
+ * {
+ *   "_id": "67f8f0000000000000000001",
+ *   "user": "67f8f0000000000000000002",
+ *   "date": "2026-03-31T00:00:00.000Z",
+ *   "shiftType": 1,
+ *   "clockInTime": "2026-03-31T00:03:00.000Z",
+ *   "clockOutTime": "2026-03-31T08:02:00.000Z",
+ *   "clockInMethod": 2,
+ *   "clockOutMethod": 2,
+ *   "clockInAddress": "浙江省宁波市鄞州区xxx",
+ *   "clockOutAddress": "浙江省宁波市鄞州区xxx",
+ *   "status": 1,
+ *   "workDuration": 479,
+ *   "isOvertime": false,
+ *   "overtimeDuration": 0,
+ *   "remark": "正常出勤",
+ *   "creator": "67f8f0000000000000000003",
+ *   "createdAt": "2026-03-31T08:05:00.000Z",
+ *   "updatedAt": "2026-03-31T08:05:00.000Z"
+ * }
+ */
+
+/**
+ * 获取考勤记录列表
+ * @param {Object} query - 请求对象
+ * @param {number} [query.page] - 页码
+ * @param {number} [query.limit] - 每页数量
+ * @param {string} [query.label] - 模糊查询字段
+ * @param {string} [query.search] - 模糊查询值
+ * @param {string} [query.user] - 用户id
+ * @param {string|Date} [query.date] - 考勤日期
+ * @param {number} [query.shiftType] - 班次类型
+ * @param {number} [query.status] - 考勤状态
+ * @param {string} [query.sort] - 排序字段
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {number} total - 总数
+ * @returns {Array<AttendanceRecord>} rows - 列表数据
+ */
+export function list(query) {
+  return requestShow({
+    url: '/attendance-records',
+    method: 'get',
+    params: query
+  })
+}
+
+/**
+ * 新增考勤记录
+ * @param {Object} data - 请求体
+ * @param {string} data.user - 用户id
+ * @param {string|Date} data.date - 考勤日期
+ * @param {number} [data.shiftType] - 班次类型，1 早班，2 中班，3 晚班
+ * @param {string|Date|null} [data.clockInTime] - 上班打卡时间
+ * @param {string|Date|null} [data.clockOutTime] - 下班打卡时间
+ * @param {number} [data.clockInMethod] - 上班打卡方式
+ * @param {number} [data.clockOutMethod] - 下班打卡方式
+ * @param {string|null} [data.clockInPhoto] - 上班打卡照片
+ * @param {string|null} [data.clockOutPhoto] - 下班打卡照片
+ * @param {AttendanceLocation|null} [data.clockInLocation] - 上班打卡定位
+ * @param {AttendanceLocation|null} [data.clockOutLocation] - 下班打卡定位
+ * @param {string|null} [data.clockInAddress] - 上班打卡地址
+ * @param {string|null} [data.clockOutAddress] - 下班打卡地址
+ * @param {number} [data.status] - 考勤状态
+ * @param {number} [data.workDuration] - 实际工作时长，单位分钟
+ * @param {boolean} [data.isOvertime] - 是否加班
+ * @param {number} [data.overtimeDuration] - 加班时长，单位分钟
+ * @param {string|null} [data.remark] - 备注
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {AttendanceRecord} data - 新增成功的数据
+ */
+export function create(data) {
+  return requestShow({
+    url: '/attendance-records',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 获取考勤记录详情
+ * @param {string} id - 考勤记录id
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {AttendanceRecord} data - 详情对象
+ */
+export function getOne(id) {
+  return requestShow({
+    url: `/attendance-records/${id}`,
+    method: 'get'
+  })
+}
+
+/**
+ * 编辑考勤记录
+ * @param {Object} data - 修改数据对象
+ * @param {string} data._id - 考勤记录id
+ * @param {string} [data.user] - 用户id
+ * @param {string|Date} [data.date] - 考勤日期
+ * @param {number} [data.shiftType] - 班次类型
+ * @param {string|Date|null} [data.clockInTime] - 上班打卡时间
+ * @param {string|Date|null} [data.clockOutTime] - 下班打卡时间
+ * @param {number} [data.clockInMethod] - 上班打卡方式
+ * @param {number} [data.clockOutMethod] - 下班打卡方式
+ * @param {string|null} [data.clockInPhoto] - 上班打卡照片
+ * @param {string|null} [data.clockOutPhoto] - 下班打卡照片
+ * @param {AttendanceLocation|null} [data.clockInLocation] - 上班打卡定位
+ * @param {AttendanceLocation|null} [data.clockOutLocation] - 下班打卡定位
+ * @param {string|null} [data.clockInAddress] - 上班打卡地址
+ * @param {string|null} [data.clockOutAddress] - 下班打卡地址
+ * @param {number} [data.status] - 考勤状态
+ * @param {number} [data.workDuration] - 实际工作时长，单位分钟
+ * @param {boolean} [data.isOvertime] - 是否加班
+ * @param {number} [data.overtimeDuration] - 加班时长，单位分钟
+ * @param {string|null} [data.remark] - 备注
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {AttendanceRecord} data - 修改后的数据
+ */
+export function updateOne(data) {
+  return requestShow({
+    url: `/attendance-records/${data._id}`,
+    method: 'put',
+    data
+  })
+}
+
+/**
+ * 删除考勤记录
+ * @param {string} id - 考勤记录id
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {AttendanceRecord} data - 删除的数据
+ */
+export function deleteOne(id) {
+  return requestShow({
+    url: `/attendance-records/${id}`,
+    method: 'delete'
+  })
+}
+
+/**
+ * 批量删除考勤记录
+ * @param {Array<string>} ids - 考勤记录id数组
+ * @returns {number} code - 返回码，0表示成功
+ */
+export function deleteMany(ids) {
+  return requestShow({
+    url: '/attendance-records',
+    method: 'delete',
+    data: ids
+  })
+}
+
+export default {
+  list,
+  create,
+  getOne,
+  updateOne,
+  deleteOne,
+  deleteMany
+}

package/api/workSchedule.js

@@ -0,0 +1,173 @@
+import { requestShow } from '../utils'
+
+/**
+ * @file 排班表api
+ * @module 排班表接口
+ * @category 人员管理
+ * @import
+ * import { workSchedule } from 'nayota-show-sdk'
+ * const { list, create, getOne, updateOne, deleteOne, deleteMany } = workSchedule
+ * list({ page: 1, limit: 10 })
+ */
+
+/**
+ * @typedef {Object} WorkScheduleDetail - 排班明细
+ * @property {number} day - 日期，1-31
+ * @property {number} [shiftType] - 当日班次，1 早班，2 中班，3 晚班
+ * @property {boolean} isRestDay - 是否休息日
+ */
+
+/**
+ * @typedef {Object} WorkSchedule - 排班表
+ * @property {string} _id - 排班表id
+ * @property {string|Object} user - 关联用户
+ * @property {number} year - 年份
+ * @property {number} month - 月份，1-12
+ * @property {number} shiftType - 默认班次类型，1 早班，2 中班，3 晚班
+ * @property {Array<WorkScheduleDetail>} scheduleDetails - 每日排班明细
+ * @property {number} status - 状态，0 草稿，1 已发布
+ * @property {string} [remark] - 备注
+ * @property {string} [creator] - 创建者
+ * @property {Date} createdAt - 创建时间
+ * @property {Date} updatedAt - 更新时间
+ * @example
+ * {
+ *   "_id": "67f8f0000000000000000101",
+ *   "user": "67f8f0000000000000000002",
+ *   "year": 2026,
+ *   "month": 3,
+ *   "shiftType": 1,
+ *   "scheduleDetails": [
+ *     {
+ *       "day": 8,
+ *       "shiftType": 2,
+ *       "isRestDay": false
+ *     },
+ *     {
+ *       "day": 16,
+ *       "isRestDay": true
+ *     }
+ *   ],
+ *   "status": 1,
+ *   "remark": "三月排班",
+ *   "creator": "67f8f0000000000000000003",
+ *   "createdAt": "2026-03-01T00:00:00.000Z",
+ *   "updatedAt": "2026-03-20T00:00:00.000Z"
+ * }
+ */
+
+/**
+ * 获取排班表列表
+ * @param {Object} query - 请求对象
+ * @param {number} [query.page] - 页码
+ * @param {number} [query.limit] - 每页数量
+ * @param {string} [query.label] - 模糊查询字段
+ * @param {string} [query.search] - 模糊查询值
+ * @param {string} [query.user] - 用户id
+ * @param {number} [query.year] - 年份
+ * @param {number} [query.month] - 月份
+ * @param {number} [query.shiftType] - 默认班次类型
+ * @param {number} [query.status] - 状态
+ * @param {string} [query.sort] - 排序字段
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {number} total - 总数
+ * @returns {Array<WorkSchedule>} rows - 列表数据
+ */
+export function list(query) {
+  return requestShow({
+    url: '/work-schedules',
+    method: 'get',
+    params: query
+  })
+}
+
+/**
+ * 新增排班表
+ * @param {Object} data - 请求体
+ * @param {string} data.user - 用户id
+ * @param {number} data.year - 年份
+ * @param {number} data.month - 月份，1-12
+ * @param {number} data.shiftType - 默认班次类型，1 早班，2 中班，3 晚班
+ * @param {Array<WorkScheduleDetail>|null} [data.scheduleDetails] - 每日排班明细
+ * @param {number} [data.status] - 状态，0 草稿，1 已发布
+ * @param {string|null} [data.remark] - 备注
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {WorkSchedule} data - 新增成功的数据
+ */
+export function create(data) {
+  return requestShow({
+    url: '/work-schedules',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 获取排班表详情
+ * @param {string} id - 排班表id
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {WorkSchedule} data - 详情对象
+ */
+export function getOne(id) {
+  return requestShow({
+    url: `/work-schedules/${id}`,
+    method: 'get'
+  })
+}
+
+/**
+ * 编辑排班表
+ * @param {Object} data - 修改数据对象
+ * @param {string} data._id - 排班表id
+ * @param {string} [data.user] - 用户id
+ * @param {number} [data.year] - 年份
+ * @param {number} [data.month] - 月份，1-12
+ * @param {number} [data.shiftType] - 默认班次类型
+ * @param {Array<WorkScheduleDetail>|null} [data.scheduleDetails] - 每日排班明细
+ * @param {number} [data.status] - 状态，0 草稿，1 已发布
+ * @param {string|null} [data.remark] - 备注
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {WorkSchedule} data - 修改后的数据
+ */
+export function updateOne(data) {
+  return requestShow({
+    url: `/work-schedules/${data._id}`,
+    method: 'put',
+    data
+  })
+}
+
+/**
+ * 删除排班表
+ * @param {string} id - 排班表id
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {WorkSchedule} data - 删除的数据
+ */
+export function deleteOne(id) {
+  return requestShow({
+    url: `/work-schedules/${id}`,
+    method: 'delete'
+  })
+}
+
+/**
+ * 批量删除排班表
+ * @param {Array<string>} ids - 排班表id数组
+ * @returns {number} code - 返回码，0表示成功
+ */
+export function deleteMany(ids) {
+  return requestShow({
+    url: '/work-schedules',
+    method: 'delete',
+    data: ids
+  })
+}
+
+export default {
+  list,
+  create,
+  getOne,
+  updateOne,
+  deleteOne,
+  deleteMany
+}

package/index.js

@@ -38,6 +38,8 @@ import energyConsumption from "./api/energyConsumption";
 import maintenancePlan from "./api/maintenancePlan";
 import maintenanceRecord from "./api/maintenanceRecord";
 import sensorStatusConfig from "./api/sensorStatusConfig";
+import attendanceRecord from "./api/attendanceRecord";
+import workSchedule from "./api/workSchedule";
 const api = {
   alarmRecord,
   alarmProgress,
@@ -76,6 +78,8 @@ const api = {
   maintenancePlan,
   maintenanceRecord,
   sensorStatusConfig,
+  attendanceRecord,
+  workSchedule,
 };
 
 export default {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nayota-show-sdk",
-  "version": "1.3.52",
+  "version": "1.3.55",
   "description": "nayota-show-server rest-api",
   "type": "module",
   "main": "index.js",