nayota-show-sdk 1.3.103 → 1.3.105

package/api/attendanceRecord.js

@@ -15,11 +15,13 @@ import { requestShow } from '../utils'
  * @property {string} _id - 考勤记录id
  * @property {string|Object} user - 关联用户
  * @property {Date} date - 考勤日期
- * @property {number} [shiftType] - 班次类型，1 早班，2 中班，3 晚班（当天结束后跨到次日 00:00-08:00）
+ * @property {string} [shiftType] - 班次类型，如：早班、中班、晚班
  * @property {Date} [clockInTime] - 上班打卡时间
  * @property {Date} [clockOutTime] - 下班打卡时间
  * @property {string} [clockInPhoto] - 上班打卡照片
+ * @property {number} [clockInDistance] - 上班打卡距离
  * @property {string} [clockOutPhoto] - 下班打卡照片
+ * @property {number} [clockOutDistance] - 下班打卡距离
  * @property {number} [clockInStatus] - 上班状态，1 上班打卡，2 上班迟到，3 上班未打卡
  * @property {number} [clockOutStatus] - 下班状态，4 下班打卡，5 下班早退，6 下班未打卡
  * @property {number} status - 汇总考勤状态，优先保留上班异常，其次下班异常；1 上班打卡，2 上班迟到，3 上班未打卡，4 下班打卡，5 下班早退，6 下班未打卡，7 缺勤
@@ -35,11 +37,13 @@ import { requestShow } from '../utils'
  *   "_id": "67f8f0000000000000000001",
  *   "user": "67f8f0000000000000000002",
  *   "date": "2026-03-31T00:00:00.000Z",
- *   "shiftType": 1,
+ *   "shiftType": "早班",
  *   "clockInTime": "2026-03-31T00:03:00.000Z",
  *   "clockOutTime": "2026-03-31T08:02:00.000Z",
  *   "clockInPhoto": "https://example.com/clock-in.jpg",
+ *   "clockInDistance": 12.5,
  *   "clockOutPhoto": "https://example.com/clock-out.jpg",
+ *   "clockOutDistance": 10,
  *   "clockInStatus": 2,
  *   "clockOutStatus": 4,
  *   "status": 2,
@@ -59,7 +63,7 @@ import { requestShow } from '../utils'
  * @property {string|Date} endTime - 结束时间
  * @property {'week'|'month'|'year'} [dimension] - 查询维度，不传时由服务端按时间跨度自动推断
  * @property {string} [user] - 用户id
- * @property {number} [shiftType] - 班次类型，1 早班，2 中班，3 晚班
+ * @property {string} [shiftType] - 班次类型，如：早班、中班、晚班
  * @property {string} [creator] - 创建者 UUID
  */
 
@@ -149,7 +153,7 @@ export function violationStatistics(query) {
  * @param {number} [query.month] - 统计月份，1-12；不传表示查询整年
  * @param {string} [query.creator] - 创建者 UUID
  * @param {string} [query.user] - 用户id
- * @param {number} [query.shiftType] - 班次类型，1 早班，2 中班，3 晚班
+ * @param {string} [query.shiftType] - 班次类型，如：早班、中班、晚班
  * @returns {number} code - 返回码，0 表示成功
  * @returns {Object} data - 统计结果
  * @returns {'year'|'month'} data.dimension - 明细维度
@@ -215,7 +219,7 @@ export function dutyStatistics(query) {
  * @param {string} [query.search] - 模糊查询值
  * @param {string} [query.user] - 用户id
  * @param {string|Date} [query.date] - 考勤日期
- * @param {number} [query.shiftType] - 班次类型
+ * @param {string} [query.shiftType] - 班次类型，如：早班、中班、晚班
  * @param {number} [query.status] - 考勤状态
  * @param {string} [query.sort] - 排序字段
  * @returns {number} code - 返回码，0表示成功
@@ -235,11 +239,13 @@ export function list(query) {
  * @param {Object} data - 请求体
  * @param {string} data.user - 用户id
  * @param {string|Date} data.date - 考勤日期
- * @param {number} [data.shiftType] - 班次类型，1 早班，2 中班，3 晚班（当天结束后跨到次日 00:00-08:00）
+ * @param {string} [data.shiftType] - 班次类型，如：早班、中班、晚班
  * @param {string|Date|null} [data.clockInTime] - 上班打卡时间
  * @param {string|Date|null} [data.clockOutTime] - 下班打卡时间
  * @param {string|null} [data.clockInPhoto] - 上班打卡照片
+ * @param {number|null} [data.clockInDistance] - 上班打卡距离
  * @param {string|null} [data.clockOutPhoto] - 下班打卡照片
+ * @param {number|null} [data.clockOutDistance] - 下班打卡距离
  * @param {number} [data.clockInStatus] - 上班状态，通常由服务端自动计算
  * @param {number} [data.clockOutStatus] - 下班状态，通常由服务端自动计算
  * @param {number} [data.status] - 考勤状态，服务端会按班次和打卡时间自动修正
@@ -277,11 +283,13 @@ export function getOne(id) {
  * @param {string} data._id - 考勤记录id
  * @param {string} [data.user] - 用户id
  * @param {string|Date} [data.date] - 考勤日期
- * @param {number} [data.shiftType] - 班次类型，1 早班，2 中班，3 晚班（当天结束后跨到次日 00:00-08:00）
+ * @param {string} [data.shiftType] - 班次类型，如：早班、中班、晚班
  * @param {string|Date|null} [data.clockInTime] - 上班打卡时间
  * @param {string|Date|null} [data.clockOutTime] - 下班打卡时间
  * @param {string|null} [data.clockInPhoto] - 上班打卡照片
+ * @param {number|null} [data.clockInDistance] - 上班打卡距离
  * @param {string|null} [data.clockOutPhoto] - 下班打卡照片
+ * @param {number|null} [data.clockOutDistance] - 下班打卡距离
  * @param {number} [data.clockInStatus] - 上班状态，通常由服务端自动计算
  * @param {number} [data.clockOutStatus] - 下班状态，通常由服务端自动计算
  * @param {number} [data.status] - 考勤状态，服务端会按班次和打卡时间自动修正

package/api/controlRoom.js

@@ -0,0 +1,225 @@
+import urlcfg from '../config/urlcfg'
+import { requestShow } from '../utils'
+
+const baseUrl = '/control-rooms'
+
+function isPlainObject(value) {
+  return Object.prototype.toString.call(value) === '[object Object]'
+}
+
+function mapAreaFieldToSpace(value) {
+  if (!isPlainObject(value)) {
+    return value
+  }
+
+  const next = { ...value }
+  if (next.space === undefined && Object.prototype.hasOwnProperty.call(next, 'area')) {
+    next.space = next.area
+  }
+  delete next.area
+  return next
+}
+
+function mapControlRoomRequestFields(value) {
+  if (!urlcfg.isV2() || !isPlainObject(value)) {
+    return value
+  }
+
+  const next = mapAreaFieldToSpace(value)
+  if (isPlainObject(next.query)) {
+    next.query = mapAreaFieldToSpace(next.query)
+  } else if (typeof next.query === 'string') {
+    try {
+      const queryObject = JSON.parse(next.query)
+      if (isPlainObject(queryObject)) {
+        next.query = JSON.stringify(mapAreaFieldToSpace(queryObject))
+      }
+    } catch (error) {
+      // 保留原始 query 字符串，交给服务端按原行为处理。
+    }
+  }
+  return next
+}
+
+function mapControlRoomEntity(entity) {
+  if (!urlcfg.isV2() || !isPlainObject(entity)) {
+    return entity
+  }
+
+  return {
+    ...entity,
+    area: entity.area !== undefined ? entity.area : entity.space
+  }
+}
+
+function mapControlRoomResponse(response) {
+  if (!urlcfg.isV2() || !isPlainObject(response)) {
+    return response
+  }
+
+  if (Array.isArray(response.rows)) {
+    return {
+      ...response,
+      rows: response.rows.map(mapControlRoomEntity)
+    }
+  }
+
+  if (response.data !== undefined) {
+    return {
+      ...response,
+      data: Array.isArray(response.data)
+        ? response.data.map(mapControlRoomEntity)
+        : mapControlRoomEntity(response.data)
+    }
+  }
+
+  return mapControlRoomEntity(response)
+}
+
+async function requestControlRoom(config) {
+  const response = await requestShow(config)
+  return mapControlRoomResponse(response)
+}
+
+/**
+ * @file 消控室api
+ * @module 消控室接口
+ * @category 人员管理
+ * @import
+ * import { controlRoom } from 'nayota-show-sdk'
+ * const { list, create, getOne, updateOne, deleteOne, deleteMany } = controlRoom
+ * list({ page: 1, limit: 10 })
+ */
+
+/**
+ * @typedef {Object} ControlRoomContact - 消控室联系人
+ * @property {string|null} [name] - 姓名
+ * @property {string|null} [phone] - 电话
+ */
+
+/**
+ * @typedef {Object} ControlRoomLocation - 消控室定位
+ * @property {number|null} [longitude] - 经度
+ * @property {number|null} [latitude] - 纬度
+ */
+
+/**
+ * @typedef {Object} ControlRoomShift - 消控室班次
+ * @property {string} name - 班次名称，例如早班、中班、晚班
+ * @property {string} startTime - 开始时间，格式 HH:mm，支持 24:00
+ * @property {string} endTime - 结束时间，格式 HH:mm，支持 24:00
+ */
+
+/**
+ * @typedef {Object} ControlRoom - 消控室
+ * @property {string} _id - 消控室 UUID
+ * @property {string|null} [name] - 消控室名称
+ * @property {Date|null} [commissionedDate] - 投用日期
+ * @property {string|null} [managementUnit] - 管理（使用）单位
+ * @property {ControlRoomContact} [fireSafetyResponsiblePerson] - 消防安全责任人及电话
+ * @property {ControlRoomContact} [controlRoomManager] - 消控室负责人/管理人及电话
+ * @property {string|null} [space] - 关联空间 UUID
+ * @property {string|null} [area] - v2 SDK 兼容字段，映射自 space
+ * @property {ControlRoomLocation} [location] - 经纬度定位
+ * @property {Array<string|Object>} [users] - 关联人员 UUID 数组
+ * @property {Array<ControlRoomShift>} [shifts] - 班次配置
+ * @property {string|null} [creator] - 创建者 UUID
+ * @property {Date} createdAt - 创建时间
+ * @property {Date} updatedAt - 更新时间
+ */
+
+/**
+ * 获取消控室列表
+ * @param {Object} query - 请求对象
+ * @param {number} [query.page] - 页码
+ * @param {number} [query.limit] - 每页数量
+ * @param {string} [query.name] - 消控室名称
+ * @param {string} [query.space] - 空间 UUID
+ * @param {string} [query.area] - v2 兼容别名，发送时映射为 space
+ * @param {string} [query.sort] - 排序字段
+ */
+export function list(query) {
+  return requestControlRoom({
+    url: baseUrl,
+    method: 'get',
+    params: mapControlRoomRequestFields(query)
+  })
+}
+
+/**
+ * 新增消控室
+ * @param {Object} data - 请求体
+ * @param {string|null} [data.name] - 消控室名称
+ * @param {Date|null} [data.commissionedDate] - 投用日期
+ * @param {string|null} [data.managementUnit] - 管理（使用）单位
+ * @param {ControlRoomContact|null} [data.fireSafetyResponsiblePerson] - 消防安全责任人及电话
+ * @param {ControlRoomContact|null} [data.controlRoomManager] - 消控室负责人/管理人及电话
+ * @param {string|Object|null} [data.space] - 空间 UUID，支持传入 UUID 字符串或包含 id/_id 的对象
+ * @param {string|Object|null} [data.area] - v2 兼容别名，发送时映射为 space
+ * @param {ControlRoomLocation|null} [data.location] - 经纬度定位
+ * @param {Array<string|Object>} [data.users] - 关联人员 UUID 数组，支持传入 UUID 字符串或包含 id/_id 的对象数组
+ * @param {Array<ControlRoomShift>} [data.shifts] - 班次配置
+ */
+export function create(data) {
+  return requestControlRoom({
+    url: baseUrl,
+    method: 'post',
+    data: mapControlRoomRequestFields(data)
+  })
+}
+
+/**
+ * 获取消控室详情
+ * @param {string} id - 消控室 ID
+ */
+export function getOne(id) {
+  return requestControlRoom({
+    url: `${baseUrl}/${id}`,
+    method: 'get'
+  })
+}
+
+/**
+ * 编辑消控室
+ * @param {Object} data - 修改数据对象
+ * @param {string} data._id - 消控室 UUID
+ */
+export function updateOne(data) {
+  return requestControlRoom({
+    url: `${baseUrl}/${data._id || data.id}`,
+    method: 'put',
+    data: mapControlRoomRequestFields(data)
+  })
+}
+
+/**
+ * 删除消控室
+ * @param {string} id - 消控室 ID
+ */
+export function deleteOne(id) {
+  return requestControlRoom({
+    url: `${baseUrl}/${id}`,
+    method: 'delete'
+  })
+}
+
+/**
+ * 批量删除消控室
+ * @param {Array<string>} ids - 消控室 ID 数组
+ */
+export function deleteMany(ids) {
+  return requestControlRoom({
+    url: baseUrl,
+    method: 'delete',
+    data: ids
+  })
+}
+
+export default {
+  list,
+  create,
+  getOne,
+  updateOne,
+  deleteOne,
+  deleteMany
+}

package/api/controlRoom.test.js

@@ -0,0 +1,98 @@
+jest.mock('../utils', () => ({
+  requestShow: jest.fn()
+}))
+
+const urlcfg = require('../config/urlcfg').default
+const { requestShow } = require('../utils')
+const controlRoom = require('./controlRoom').default
+
+describe('controlRoom api v2 field compatibility', () => {
+  const originalVersion = urlcfg.version
+
+  afterEach(() => {
+    urlcfg.version = originalVersion
+    jest.clearAllMocks()
+  })
+
+  test('keeps legacy area payload in v1', async () => {
+    const query = {
+      area: 'space-legacy'
+    }
+    requestShow.mockResolvedValue({ code: 0, rows: [] })
+
+    await controlRoom.list(query)
+
+    expect(requestShow).toHaveBeenCalledWith({
+      url: '/control-rooms',
+      method: 'get',
+      params: query
+    })
+  })
+
+  test('maps legacy area request field to space in v2', async () => {
+    urlcfg.version = 'v2'
+    const data = {
+      _id: 'control-room-1',
+      name: '一号消控室',
+      area: '22222222-2222-4222-8222-222222222222',
+      shifts: [{ name: '早班', startTime: '08:00', endTime: '16:00' }]
+    }
+    requestShow.mockResolvedValue({ code: 0, data: {} })
+
+    await controlRoom.updateOne(data)
+
+    expect(requestShow).toHaveBeenCalledWith({
+      url: '/control-rooms/control-room-1',
+      method: 'put',
+      data: {
+        _id: 'control-room-1',
+        name: '一号消控室',
+        space: '22222222-2222-4222-8222-222222222222',
+        shifts: [{ name: '早班', startTime: '08:00', endTime: '16:00' }]
+      }
+    })
+  })
+
+  test('maps legacy area inside query filter to space in v2', async () => {
+    urlcfg.version = 'v2'
+    requestShow.mockResolvedValue({ code: 0, rows: [] })
+
+    await controlRoom.list({
+      query: {
+        area: '22222222-2222-4222-8222-222222222222',
+        name: '一号消控室'
+      }
+    })
+
+    expect(requestShow).toHaveBeenCalledWith({
+      url: '/control-rooms',
+      method: 'get',
+      params: {
+        query: {
+          name: '一号消控室',
+          space: '22222222-2222-4222-8222-222222222222'
+        }
+      }
+    })
+  })
+
+  test('maps v2 response space back to legacy area alias', async () => {
+    urlcfg.version = 'v2'
+    requestShow.mockResolvedValue({
+      code: 0,
+      data: {
+        id: 'control-room-1',
+        name: '一号消控室',
+        space: '22222222-2222-4222-8222-222222222222'
+      }
+    })
+
+    const response = await controlRoom.getOne('control-room-1')
+
+    expect(response.data).toEqual(expect.objectContaining({
+      name: '一号消控室',
+      space: '22222222-2222-4222-8222-222222222222',
+      area: '22222222-2222-4222-8222-222222222222'
+    }))
+  })
+})

package/api/workSchedule.js

@@ -1,5 +1,84 @@
+import urlcfg from '../config/urlcfg'
 import { requestShow } from '../utils'
 
+function isPlainObject(value) {
+  return Object.prototype.toString.call(value) === '[object Object]'
+}
+
+function mapAreaFieldToSpace(value) {
+  if (!isPlainObject(value)) {
+    return value
+  }
+
+  const next = { ...value }
+  if (next.space === undefined && Object.prototype.hasOwnProperty.call(next, 'area')) {
+    next.space = next.area
+  }
+  delete next.area
+  return next
+}
+
+function mapWorkScheduleRequestFields(value) {
+  if (!urlcfg.isV2() || !isPlainObject(value)) {
+    return value
+  }
+
+  const next = mapAreaFieldToSpace(value)
+  if (isPlainObject(next.query)) {
+    next.query = mapAreaFieldToSpace(next.query)
+  } else if (typeof next.query === 'string') {
+    try {
+      const queryObject = JSON.parse(next.query)
+      if (isPlainObject(queryObject)) {
+        next.query = JSON.stringify(mapAreaFieldToSpace(queryObject))
+      }
+    } catch (error) {
+      // 保留原始 query 字符串，交给服务端按原行为处理。
+    }
+  }
+  return next
+}
+
+function mapWorkScheduleEntity(entity) {
+  if (!urlcfg.isV2() || !isPlainObject(entity)) {
+    return entity
+  }
+
+  return {
+    ...entity,
+    area: entity.area !== undefined ? entity.area : entity.space
+  }
+}
+
+function mapWorkScheduleResponse(response) {
+  if (!urlcfg.isV2() || !isPlainObject(response)) {
+    return response
+  }
+
+  if (Array.isArray(response.rows)) {
+    return {
+      ...response,
+      rows: response.rows.map(mapWorkScheduleEntity)
+    }
+  }
+
+  if (response.data !== undefined) {
+    return {
+      ...response,
+      data: Array.isArray(response.data)
+        ? response.data.map(mapWorkScheduleEntity)
+        : mapWorkScheduleEntity(response.data)
+    }
+  }
+
+  return mapWorkScheduleEntity(response)
+}
+
+async function requestWorkSchedule(config) {
+  const response = await requestShow(config)
+  return mapWorkScheduleResponse(response)
+}
+
 /**
  * @file 排班表api
  * @module 排班表接口
@@ -13,7 +92,7 @@ import { requestShow } from '../utils'
 /**
  * @typedef {Object} WorkScheduleDetail - 排班明细
  * @property {number} day - 日期，1-31
- * @property {number} [shiftType] - 当日班次，1 早班，2 中班，3 晚班（当天结束后跨到次日 00:00-08:00）
+ * @property {string} [shiftType] - 当日班次，如：早班、中班、晚班
  * @property {boolean} isRestDay - 是否休息日
  * @property {string|Object} [attendanceRecord] - 当日关联考勤记录id或考勤记录对象，联表对象通常包含 clockInTime、clockOutTime、clockInPhoto、clockOutPhoto、clockInStatus、clockOutStatus、status、remark
  */
@@ -21,12 +100,14 @@ import { requestShow } from '../utils'
 /**
  * @typedef {Object} WorkSchedule - 排班表
  * @property {string} _id - 排班表 UUID
- * @property {string|Object} user - 关联用户 UUID
+ * @property {string|Object|null} [user] - 关联用户 UUID
  * @property {Array<string|Object>} users - 关联用户 UUID 数组
  * @property {string|null} [space] - 关联空间 UUID，引用外部配置服务空间
+ * @property {string|null} [area] - v2 SDK 兼容字段，映射自 space
+ * @property {string|Object|null} [controlRoom] - 关联消控室 UUID，支持传入 UUID 字符串或包含 id/_id 的对象
  * @property {number} year - 年份
  * @property {number} month - 月份，1-12
- * @property {number} shiftType - 默认班次类型，1 早班，2 中班，3 晚班（当天结束后跨到次日 00:00-08:00）
+ * @property {string} shiftType - 默认班次类型，如：早班、中班、晚班
  * @property {Array<WorkScheduleDetail>} scheduleDetails - 每日排班明细
  * @property {number} status - 状态，0 草稿，1 已发布
  * @property {string} [remark] - 备注
@@ -42,13 +123,14 @@ import { requestShow } from '../utils'
  *     "33333333-3333-4333-8333-333333333333"
  *   ],
  *   "space": "44444444-4444-4444-8444-444444444444",
+ *   "controlRoom": "77777777-7777-4777-8777-777777777777",
  *   "year": 2026,
  *   "month": 3,
- *   "shiftType": 1,
+ *   "shiftType": "早班",
  *   "scheduleDetails": [
  *     {
  *       "day": 8,
- *       "shiftType": 2,
+ *       "shiftType": "中班",
  *       "isRestDay": false,
  *       "attendanceRecord": "55555555-5555-4555-8555-555555555555"
  *     },
@@ -74,9 +156,11 @@ import { requestShow } from '../utils'
  * @param {string} [query.search] - 模糊查询值
  * @param {string} [query.user] - 用户 UUID
  * @param {string} [query.space] - 空间 UUID
+ * @param {string} [query.area] - v2 兼容别名，发送时映射为 space
+ * @param {string} [query.controlRoom] - 消控室 UUID
  * @param {number} [query.year] - 年份
  * @param {number} [query.month] - 月份
- * @param {number} [query.shiftType] - 默认班次类型
+ * @param {string} [query.shiftType] - 默认班次类型，如：早班、中班、晚班
  * @param {number} [query.status] - 状态
  * @param {string} [query.sort] - 排序字段
  * @returns {number} code - 返回码，0表示成功
@@ -84,22 +168,24 @@ import { requestShow } from '../utils'
  * @returns {Array<WorkSchedule>} rows - 列表数据
  */
 export function list(query) {
-  return requestShow({
+  return requestWorkSchedule({
     url: '/work-schedules',
     method: 'get',
-    params: query
+    params: mapWorkScheduleRequestFields(query)
   })
 }
 
 /**
  * 新增排班表
  * @param {Object} data - 请求体
- * @param {string|Object} data.user - 用户 UUID，支持传入 UUID 字符串或包含 id/_id 的对象
+ * @param {string|Object|null} [data.user] - 用户 UUID，支持传入 UUID 字符串或包含 id/_id 的对象
  * @param {Array<string|Object>} [data.users] - 用户 UUID 数组，支持传入 UUID 字符串或包含 id/_id 的对象数组
  * @param {string|Object|null} [data.space] - 空间 UUID，引用外部配置服务空间，支持传入 UUID 字符串或包含 id/_id 的对象
+ * @param {string|Object|null} [data.area] - v2 兼容别名，发送时映射为 space
+ * @param {string|Object|null} [data.controlRoom] - 消控室 UUID，支持传入 UUID 字符串或包含 id/_id 的对象
  * @param {number} data.year - 年份
  * @param {number} data.month - 月份，1-12
- * @param {number} data.shiftType - 默认班次类型，1 早班，2 中班，3 晚班（当天结束后跨到次日 00:00-08:00）
+ * @param {string} data.shiftType - 默认班次类型，如：早班、中班、晚班
  * @param {Array<WorkScheduleDetail>|null} [data.scheduleDetails] - 每日排班明细
  * @param {number} [data.status] - 状态，0 草稿，1 已发布
  * @param {string|null} [data.remark] - 备注
@@ -107,10 +193,10 @@ export function list(query) {
  * @returns {WorkSchedule} data - 新增成功的数据
  */
 export function create(data) {
-  return requestShow({
+  return requestWorkSchedule({
     url: '/work-schedules',
     method: 'post',
-    data
+    data: mapWorkScheduleRequestFields(data)
   })
 }
 
@@ -121,7 +207,7 @@ export function create(data) {
  * @returns {WorkSchedule} data - 详情对象
  */
 export function getOne(id) {
-  return requestShow({
+  return requestWorkSchedule({
     url: `/work-schedules/${id}`,
     method: 'get'
   })
@@ -134,9 +220,11 @@ export function getOne(id) {
  * @param {string|Object} [data.user] - 用户 UUID，支持传入 UUID 字符串或包含 id/_id 的对象
  * @param {Array<string|Object>} [data.users] - 用户 UUID 数组，支持传入 UUID 字符串或包含 id/_id 的对象数组
  * @param {string|Object|null} [data.space] - 空间 UUID，引用外部配置服务空间，支持传入 UUID 字符串或包含 id/_id 的对象
+ * @param {string|Object|null} [data.area] - v2 兼容别名，发送时映射为 space
+ * @param {string|Object|null} [data.controlRoom] - 消控室 UUID，支持传入 UUID 字符串或包含 id/_id 的对象
  * @param {number} [data.year] - 年份
  * @param {number} [data.month] - 月份，1-12
- * @param {number} [data.shiftType] - 默认班次类型，1 早班，2 中班，3 晚班（当天结束后跨到次日 00:00-08:00）
+ * @param {string} [data.shiftType] - 默认班次类型，如：早班、中班、晚班
  * @param {Array<WorkScheduleDetail>|null} [data.scheduleDetails] - 每日排班明细
  * @param {number} [data.status] - 状态，0 草稿，1 已发布
  * @param {string|null} [data.remark] - 备注
@@ -144,10 +232,10 @@ export function getOne(id) {
  * @returns {WorkSchedule} data - 修改后的数据
  */
 export function updateOne(data) {
-  return requestShow({
-    url: `/work-schedules/${data._id}`,
+  return requestWorkSchedule({
+    url: `/work-schedules/${data._id || data.id}`,
     method: 'put',
-    data
+    data: mapWorkScheduleRequestFields(data)
   })
 }
 
@@ -158,7 +246,7 @@ export function updateOne(data) {
  * @returns {WorkSchedule} data - 删除的数据
  */
 export function deleteOne(id) {
-  return requestShow({
+  return requestWorkSchedule({
     url: `/work-schedules/${id}`,
     method: 'delete'
   })
@@ -170,7 +258,7 @@ export function deleteOne(id) {
  * @returns {number} code - 返回码，0表示成功
  */
 export function deleteMany(ids) {
-  return requestShow({
+  return requestWorkSchedule({
     url: '/work-schedules',
     method: 'delete',
     data: ids

package/api/workSchedule.test.js

@@ -0,0 +1,104 @@
+jest.mock('../utils', () => ({
+  requestShow: jest.fn()
+}))
+
+const urlcfg = require('../config/urlcfg').default
+const { requestShow } = require('../utils')
+const workSchedule = require('./workSchedule').default
+
+describe('workSchedule api v2 field compatibility', () => {
+  const originalVersion = urlcfg.version
+
+  afterEach(() => {
+    urlcfg.version = originalVersion
+    jest.clearAllMocks()
+  })
+
+  test('keeps legacy area payload in v1', async () => {
+    const query = {
+      area: 'space-legacy'
+    }
+    requestShow.mockResolvedValue({ code: 0, rows: [] })
+
+    await workSchedule.list(query)
+
+    expect(requestShow).toHaveBeenCalledWith({
+      url: '/work-schedules',
+      method: 'get',
+      params: query
+    })
+  })
+
+  test('maps legacy area request field to space in v2', async () => {
+    urlcfg.version = 'v2'
+    const data = {
+      _id: 'schedule-1',
+      area: '22222222-2222-4222-8222-222222222222',
+      controlRoom: '77777777-7777-4777-8777-777777777777',
+      year: 2026,
+      month: 6,
+      shiftType: '早班'
+    }
+    requestShow.mockResolvedValue({ code: 0, data: {} })
+
+    await workSchedule.updateOne(data)
+
+    expect(requestShow).toHaveBeenCalledWith({
+      url: '/work-schedules/schedule-1',
+      method: 'put',
+      data: {
+        _id: 'schedule-1',
+        space: '22222222-2222-4222-8222-222222222222',
+        controlRoom: '77777777-7777-4777-8777-777777777777',
+        year: 2026,
+        month: 6,
+        shiftType: '早班'
+      }
+    })
+  })
+
+  test('maps legacy area inside query filter to space in v2', async () => {
+    urlcfg.version = 'v2'
+    requestShow.mockResolvedValue({ code: 0, rows: [] })
+
+    await workSchedule.list({
+      page: 1,
+      query: JSON.stringify({
+        area: '22222222-2222-4222-8222-222222222222',
+        year: 2026
+      })
+    })
+
+    expect(requestShow).toHaveBeenCalledWith({
+      url: '/work-schedules',
+      method: 'get',
+      params: {
+        page: 1,
+        query: JSON.stringify({
+          year: 2026,
+          space: '22222222-2222-4222-8222-222222222222'
+        })
+      }
+    })
+  })
+
+  test('maps v2 response space back to legacy area alias', async () => {
+    urlcfg.version = 'v2'
+    requestShow.mockResolvedValue({
+      code: 0,
+      rows: [{
+        id: 'schedule-1',
+        space: '22222222-2222-4222-8222-222222222222',
+        controlRoom: '77777777-7777-4777-8777-777777777777'
+      }]
+    })
+
+    const response = await workSchedule.list({})
+
+    expect(response.rows[0]).toEqual(expect.objectContaining({
+      space: '22222222-2222-4222-8222-222222222222',
+      area: '22222222-2222-4222-8222-222222222222',
+      controlRoom: '77777777-7777-4777-8777-777777777777'
+    }))
+  })
+})

package/index.js

@@ -42,6 +42,7 @@ import sensorStatusConfig from "./api/sensorStatusConfig";
 import attendanceRecord from "./api/attendanceRecord";
 import workSchedule from "./api/workSchedule";
 import fireDrillRecords from "./api/fireDrillRecords";
+import controlRoom from "./api/controlRoom";
 const api = {
   alarmRecord,
   alarmProgress,
@@ -84,6 +85,7 @@ const api = {
   attendanceRecord,
   workSchedule,
   fireDrillRecords,
+  controlRoom,
 };
 
 export default {

package/package.json

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