weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/ehr/operations/attend-read.js

@@ -0,0 +1,373 @@
+import { READ, SCHEMA_DATE, SCHEMA_ID, SCHEMA_ID_LIST, SCHEMA_STRING_LIST, ehrSuccess, schemaOf, } from './types.js';
+import { ehrValidationError } from '../errors.js';
+import { compact, normalizePaged, pickDefined, requireDateRange, toIdList, toNumber, toPageQuery, } from './shared.js';
+const ATTEND_STATUS = [
+    'SIGN_IN_LATE',
+    'SIGN_OUT_EARLY',
+    'SIGN_IN_ABSENTEEISM',
+    'SIGN_OUT_ABSENTEEISM',
+    'ABSENTEEISM',
+    'LOST',
+];
+const attendPageSchema = {
+    current: SCHEMA_ID,
+    pageSize: SCHEMA_ID,
+};
+const attendSummaryGet = {
+    name: 'ehr.attend.summary.get',
+    resource: 'attend',
+    method: 'summary.get',
+    action: 'ehr.attend.summary.get',
+    summary: '查询指定时间范围内的出勤情况统计：出勤统计、出勤汇总、请假信息、外勤、假期余额',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        userId: SCHEMA_ID,
+        type: { type: 'string' },
+        date: SCHEMA_DATE,
+        missingCardType: { type: 'string', enum: ['all', 'leaveReturn', 'outCard'], default: 'all' },
+        signType: { type: 'string' },
+        containOcheck: { type: 'boolean' },
+        onlyMine: { type: 'boolean' },
+        empIds: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['type', 'date', 'missingCardType', 'signType', 'containOcheck', 'onlyMine']),
+            empIds: toIdList(args.empIds, 'empIds'),
+        };
+        if (args.userId !== undefined)
+            body.userId = Number(args.userId);
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/attendInfoV2/getAttendInfoStatis',
+            body: compact(body),
+        });
+        return ehrSuccess('ehr.attend.summary.get', normalizePaged(response).data);
+    },
+};
+const attendAbnormalList = {
+    name: 'ehr.attend.abnormal.list',
+    resource: 'attend',
+    method: 'abnormal.list',
+    action: 'ehr.attend.abnormal.list',
+    summary: '查询指定时间范围内的异常考勤明细：迟到、早退、缺卡、缺勤、失联等',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        attendStatus: { type: 'array', items: { type: 'string', enum: [...ATTEND_STATUS] } },
+        employeeRange: { type: 'array', items: { type: 'string', enum: ['MINE', 'DIRECT_SURBODINATE', 'OTHER_SURBODINATE'] } },
+        employeeType: SCHEMA_STRING_LIST,
+        processResult: SCHEMA_STRING_LIST,
+        hrmStatus: SCHEMA_STRING_LIST,
+        keyword: { type: 'string' },
+        departments: SCHEMA_ID_LIST,
+        resourceids: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['attendStatus', 'employeeRange', 'employeeType', 'processResult', 'hrmStatus', 'keyword']),
+            departments: toIdList(args.departments, 'departments'),
+            resourceids: toIdList(args.resourceids, 'resourceids'),
+        };
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/abnormal/getAbnormalList',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.attend.abnormal.list', data, { page });
+    },
+};
+const attendReportGet = {
+    name: 'ehr.attend.report.get',
+    resource: 'attend',
+    method: 'report.get',
+    action: 'ehr.attend.report.get',
+    summary: '查询出勤汇总报表：工作时长、加班（工作日/周末/节假日）、迟到早退、缺勤、调休；返回 recalcPermission',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        unit: { type: 'string', enum: ['day', 'hour'] },
+        keyword: { type: 'string' },
+        accountType: { type: 'string', enum: ['0', '1', '2'], description: '0 全部，1 主身份，2 次身份' },
+        searchAndOr: { type: 'string', enum: ['OR', 'AND'] },
+        containOcheck: { type: 'boolean' },
+        rules: SCHEMA_ID_LIST,
+        onlyEmpIds: SCHEMA_ID_LIST,
+        hrmStatus: SCHEMA_STRING_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['unit', 'keyword', 'accountType', 'searchAndOr', 'containOcheck', 'hrmStatus']),
+            rules: toIdList(args.rules, 'rules'),
+            onlyEmpIds: toIdList(args.onlyEmpIds, 'onlyEmpIds'),
+        };
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/attendWorkTimeSummaryReport/getAttendWorkTimeSummaryReport',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.attend.report.get', data, { page });
+    },
+};
+const attendWorktimeList = {
+    name: 'ehr.attend.worktime.list',
+    resource: 'attend',
+    method: 'worktime.list',
+    action: 'ehr.attend.worktime.list',
+    summary: '查询工作时长报表：应出勤天数、实际工作时长、加班时长等',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        keyword: { type: 'string' },
+        unit: { type: 'string' },
+        employeeRange: SCHEMA_STRING_LIST,
+        hrmStatus: SCHEMA_STRING_LIST,
+        departments: SCHEMA_ID_LIST,
+        resourceids: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['keyword', 'unit', 'employeeRange', 'hrmStatus']),
+            departments: toIdList(args.departments, 'departments'),
+            resourceids: toIdList(args.resourceids, 'resourceids'),
+        };
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/worktime/getWorktimeList',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.attend.worktime.list', data, { page });
+    },
+};
+const attendSignrecordList = {
+    name: 'ehr.attend.signrecord.list',
+    resource: 'attend',
+    method: 'signrecord.list',
+    action: 'ehr.attend.signrecord.list',
+    summary: '查询原始打卡记录：打卡时间、打卡方式（GPS/WiFi/蓝牙）、打卡地点',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        keyword: { type: 'string' },
+        employeeRange: SCHEMA_STRING_LIST,
+        departments: SCHEMA_ID_LIST,
+        resourceids: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['keyword', 'employeeRange']),
+            departments: toIdList(args.departments, 'departments'),
+            resourceids: toIdList(args.resourceids, 'resourceids'),
+        };
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/signRecord/getSignRecordList',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.attend.signrecord.list', data, { page });
+    },
+};
+const attendOrbitList = {
+    name: 'ehr.attend.orbit.list',
+    resource: 'attend',
+    method: 'orbit.list',
+    action: 'ehr.attend.orbit.list',
+    summary: '查询外勤轨迹记录：外勤打卡地点、签到签退时间、签到距离',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        employeeRange: SCHEMA_STRING_LIST,
+        hrmStatus: SCHEMA_STRING_LIST,
+        departments: SCHEMA_ID_LIST,
+        resourceids: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['employeeRange', 'hrmStatus']),
+            departments: toIdList(args.departments, 'departments'),
+            resourceids: toIdList(args.resourceids, 'resourceids'),
+        };
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/orbit/queryOcheckList',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.attend.orbit.list', data, { page });
+    },
+};
+const attendLeaveReport = {
+    name: 'ehr.attend.leave.report',
+    resource: 'attend',
+    method: 'leave.report',
+    action: 'ehr.attend.leave.report',
+    summary: '查询假期统计报表：各类假期使用量与剩余额度，支持按部门、人员、年份筛选',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        keyword: { type: 'string' },
+        year: { type: 'integer', minimum: 1000, maximum: 9999 },
+        employeeRange: SCHEMA_STRING_LIST,
+        departments: SCHEMA_ID_LIST,
+        resourceids: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['keyword', 'employeeRange']),
+            departments: toIdList(args.departments, 'departments'),
+            resourceids: toIdList(args.resourceids, 'resourceids'),
+        };
+        if (args.year !== undefined)
+            body.year = toNumber(args.year, 'year');
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/leavestatis/getReportList',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.attend.leave.report', data, { page });
+    },
+};
+const attendAppealFormid = {
+    name: 'ehr.attend.appeal.formid',
+    resource: 'attend',
+    method: 'appeal.formid',
+    action: 'ehr.attend.appeal.formid',
+    summary: '获取发起申诉所需的表单 ID 与可申诉状态；创建申诉前必须先调用，stillShowAppeal=false 时不得继续',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({ userId: { oneOf: [{ type: 'integer', minimum: 1 }, { type: 'string', minLength: 1 }] } }, { required: ['userId'] }),
+    handler: async (args, { host }) => {
+        if (args.userId === undefined || args.userId === null || args.userId === '') {
+            throw new Error('userId 必填');
+        }
+        if (!/^\d+$/.test(String(args.userId))) {
+            throw ehrValidationError('user_id_invalid', 'userId 必须是人员 ID');
+        }
+        const response = await host.request({
+            method: 'GET',
+            path: '/api/attend/web/attendinfo/getAppealformId',
+            query: { userId: String(args.userId) },
+        });
+        return ehrSuccess('ehr.attend.appeal.formid', normalizePaged(response).data);
+    },
+};
+const attendAppealCalendar = {
+    name: 'ehr.attend.appeal.calendar',
+    resource: 'attend',
+    method: 'appeal.calendar',
+    action: 'ehr.attend.appeal.calendar',
+    summary: '获取某一天的考勤日历详情，供申诉取 periodId/timecardId/attendStatus 等参数',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        date: SCHEMA_DATE,
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        employeeRange: SCHEMA_STRING_LIST,
+        empIds: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['date'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            date: args.date,
+            ...toPageQuery(args),
+            ...pickDefined(args, ['beginDate', 'endDate', 'employeeRange']),
+            empIds: toIdList(args.empIds, 'empIds'),
+        };
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/attendInfoV2/getCalendarDetailByDate',
+            body: compact(body),
+        });
+        return ehrSuccess('ehr.attend.appeal.calendar', normalizePaged(response).data);
+    },
+};
+const attendAppealList = {
+    name: 'ehr.attend.appeal.list',
+    resource: 'attend',
+    method: 'appeal.list',
+    action: 'ehr.attend.appeal.list',
+    summary: '查询申诉记录列表；处理申诉前用它取得申诉记录 ID',
+    capability: 'attend',
+    risk: READ,
+    inputSchema: schemaOf({
+        beginDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        keyword: { type: 'string' },
+        attendStatus: SCHEMA_STRING_LIST,
+        processResult: SCHEMA_STRING_LIST,
+        employeeRange: SCHEMA_STRING_LIST,
+        departments: SCHEMA_ID_LIST,
+        resourceids: SCHEMA_ID_LIST,
+        ...attendPageSchema,
+    }, { required: ['beginDate', 'endDate'] }),
+    handler: async (args, { host }) => {
+        const body = {
+            ...requireDateRange(args),
+            ...toPageQuery(args),
+            ...pickDefined(args, ['keyword', 'attendStatus', 'processResult', 'employeeRange']),
+            departments: toIdList(args.departments, 'departments'),
+            resourceids: toIdList(args.resourceids, 'resourceids'),
+        };
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/attend/web/appeal/getAppealList',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.attend.appeal.list', data, { page });
+    },
+};
+export const attendReadOperations = [
+    attendSummaryGet,
+    attendAbnormalList,
+    attendReportGet,
+    attendWorktimeList,
+    attendSignrecordList,
+    attendOrbitList,
+    attendLeaveReport,
+    attendAppealFormid,
+    attendAppealCalendar,
+    attendAppealList,
+];