weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/ehr/operations/hr-report.js

@@ -0,0 +1,386 @@
+import { ehrValidationError } from '../errors.js';
+import { READ, SCHEMA_DATE, SCHEMA_ID, SCHEMA_ID_LIST, SCHEMA_STRING_LIST, ehrSuccess, schemaOf, } from './types.js';
+import { assertEnum, compact, normalizePaged, toIdList, toNumber, toPositiveInt } from './shared.js';
+const EST_DATA_TYPES = [
+    'numberingCount',
+    'numberingCountWithSub',
+    'preAddEmpCount',
+    'preAddEmpCountWithSub',
+    'preSubEmpCount',
+    'preSubEmpCountWithSub',
+];
+const TURN_DATA_TYPES = [
+    'begin_emp_count',
+    'end_emp_count',
+    'join_emp_count',
+    'dismiss_emp_count',
+    'org_in_emp_count',
+    'org_out_emp_count',
+];
+const CHANGE_TYPES = ['loss', 'dismiss', 'quit', 'retire'];
+const pageSchema = { current: SCHEMA_ID, pageSize: SCHEMA_ID };
+/** 报表类接口共用的人员范围过滤（对应 permissionType 语义）。 */
+const reportFilterSchema = {
+    hiredate: { type: 'array', items: SCHEMA_DATE, minItems: 2, maxItems: 2, description: '入职日期区间 [起, 止]' },
+    location: SCHEMA_ID_LIST,
+    personnelStatus: SCHEMA_STRING_LIST,
+    subcompany: SCHEMA_ID_LIST,
+    department: SCHEMA_ID_LIST,
+};
+function buildReportFilter(args) {
+    return {
+        hiredate: Array.isArray(args.hiredate) ? args.hiredate : [],
+        location: toIdList(args.location, 'location') ?? [],
+        personnelStatus: Array.isArray(args.personnelStatus) ? args.personnelStatus : ['normal'],
+        subcompany: toIdList(args.subcompany, 'subcompany') ?? [],
+        department: toIdList(args.department, 'department') ?? [],
+    };
+}
+function buildPage(args) {
+    const page = {};
+    const current = toPositiveInt(args.current, 'current');
+    const pageSize = toNumber(args.pageSize, 'pageSize');
+    if (current !== undefined)
+        page.current = current;
+    if (pageSize !== undefined)
+        page.pageSize = pageSize;
+    return page;
+}
+/** dept/posi/job/jobType 四个报表接口结构一致，仅名称模糊筛选字段名不同。 */
+function buildPersonReport(args, nameField) {
+    const body = {
+        searchCount: true,
+        type: '',
+        ...buildReportFilter(args),
+        ...buildPage(args),
+    };
+    if (args[nameField] !== undefined)
+        body[nameField] = args[nameField];
+    return body;
+}
+const reportDeptTable = {
+    name: 'ehr.hr.report.dept.table',
+    resource: 'hr',
+    method: 'report.dept.table',
+    action: 'ehr.hr.report.dept.table',
+    summary: '部门人数列表（按人数从大到小）；pageSize 被页面配置固定为 100，全量需递增 current 翻页',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...reportFilterSchema, departmentName: { type: 'string' }, ...pageSchema }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/report/person/dept/table',
+            body: buildPersonReport(args, 'departmentName'),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.report.dept.table', data, { page });
+    },
+};
+const reportPosiTable = {
+    name: 'ehr.hr.report.posi.table',
+    resource: 'hr',
+    method: 'report.posi.table',
+    action: 'ehr.hr.report.posi.table',
+    summary: '岗位人数列表（按人数从大到小）；名称筛选用 positionName，不是 departmentName',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...reportFilterSchema, positionName: { type: 'string' }, ...pageSchema }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/report/person/posi/table',
+            body: buildPersonReport(args, 'positionName'),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.report.posi.table', data, { page });
+    },
+};
+const reportJobTable = {
+    name: 'ehr.hr.report.job.table',
+    resource: 'hr',
+    method: 'report.job.table',
+    action: 'ehr.hr.report.job.table',
+    summary: '职务人数列表（按人数从大到小）；需「职务人员统计」查看权限',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...reportFilterSchema, jobName: { type: 'string' }, ...pageSchema }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/report/person/job/table',
+            body: buildPersonReport(args, 'jobName'),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.report.job.table', data, { page });
+    },
+};
+const reportJobTypeTable = {
+    name: 'ehr.hr.report.jobtype.table',
+    resource: 'hr',
+    method: 'report.jobtype.table',
+    action: 'ehr.hr.report.jobtype.table',
+    summary: '职务类别人数列表（按人数从大到小）；名称筛选用 jobTypeName',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...reportFilterSchema, jobTypeName: { type: 'string' }, ...pageSchema }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/report/person/jobType/table',
+            body: buildPersonReport(args, 'jobTypeName'),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.report.jobtype.table', data, { page });
+    },
+};
+const reportChangeDeptTable = {
+    name: 'ehr.hr.report.change.dept.table',
+    resource: 'hr',
+    method: 'report.change.dept.table',
+    action: 'ehr.hr.report.change.dept.table',
+    summary: '部门流失/离职/解聘/退休人数列表（按人数从大到小）；该模块没有 personnelStatus/hiredate/location 过滤',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        type: { type: 'string', enum: [...CHANGE_TYPES], description: 'loss 流失(离职+解聘+退休) / dismiss 离职 / quit 解聘 / retire 退休' },
+        changeDate: { type: 'array', items: SCHEMA_DATE, minItems: 2, maxItems: 2, description: '变更时间区间 [起, 止]，空数组=不限' },
+        subcompany: SCHEMA_ID_LIST,
+        department: SCHEMA_ID_LIST,
+        departmentName: { type: 'string' },
+        ...pageSchema,
+    }, { required: ['type'] }),
+    handler: async (args, { host }) => {
+        const type = assertEnum(args.type, CHANGE_TYPES, 'type');
+        const body = {
+            searchCount: true,
+            type,
+            changeDate: Array.isArray(args.changeDate) ? args.changeDate : [],
+            subcompany: toIdList(args.subcompany, 'subcompany') ?? [],
+            department: toIdList(args.department, 'department') ?? [],
+            ...buildPage(args),
+        };
+        if (args.departmentName !== undefined)
+            body.departmentName = args.departmentName;
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/report/change/dept/table',
+            body,
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.report.change.dept.table', data, { page });
+    },
+};
+const estDataTypeSchema = {
+    type: 'string',
+    enum: [...EST_DATA_TYPES],
+    description: 'numberingCount 在编本级 / numberingCountWithSub 在编含下级 / preAddEmpCount 预增本级 / preAddEmpCountWithSub 预增含下级 / preSubEmpCount 预减本级 / preSubEmpCountWithSub 预减含下级',
+};
+const monthOrDateSchema = {
+    type: 'string',
+    pattern: '^\\d{4}-\\d{2}(-\\d{2})?$',
+    description: 'YYYY-MM 或 YYYY-MM-DD',
+};
+const estEmpTable = {
+    name: 'ehr.hr.est.emp.table',
+    resource: 'hr',
+    method: 'est.emp.table',
+    action: 'ehr.hr.est.emp.table',
+    summary: '部门（组织编制）占编人员明细；cfgId 必须先从组织编制数据源(754217732232708751)记录取 id，不得编造',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        cfgId: { oneOf: [{ type: 'integer' }, { type: 'string', minLength: 1 }] },
+        dataType: estDataTypeSchema,
+        month: monthOrDateSchema,
+        keyword: { type: 'string' },
+        hisId: SCHEMA_ID,
+        ...pageSchema,
+    }, { required: ['cfgId', 'dataType', 'month'] }),
+    handler: async (args, { host }) => {
+        if (args.cfgId === undefined || args.cfgId === null || args.cfgId === '') {
+            throw ehrValidationError('cfg_id_required', 'cfgId 必填，且必须取自组织编制数据源记录 id');
+        }
+        const dataType = assertEnum(args.dataType, EST_DATA_TYPES, 'dataType');
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/est/cfg/emp/table',
+            body: {
+                cfgId: String(args.cfgId),
+                dataType,
+                formDatas: { month: [{ month: args.month }] },
+                ...(args.keyword !== undefined ? { keyword: args.keyword } : {}),
+                ...(args.hisId !== undefined ? { hisId: Number(args.hisId) } : {}),
+            },
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.est.emp.table', data, { page });
+    },
+};
+const estDcEmpTable = {
+    name: 'ehr.hr.est.dc.emp.table',
+    resource: 'hr',
+    method: 'est.dc.emp.table',
+    action: 'ehr.hr.est.dc.emp.table',
+    summary: '控编维度占编人员明细；id 与 cfgId 必须先从控编维度数据源(754217732232709056)记录获取，不得编造',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        id: { oneOf: [{ type: 'integer' }, { type: 'string', minLength: 1 }], description: '控编维度 id' },
+        cfgId: { oneOf: [{ type: 'integer' }, { type: 'string', minLength: 1 }], description: '编制方案配置 id' },
+        dataType: estDataTypeSchema,
+        month: monthOrDateSchema,
+        overCtrl: { type: 'string' },
+        keyword: { type: 'string' },
+        hisId: SCHEMA_ID,
+        ...pageSchema,
+    }, { required: ['id', 'cfgId', 'dataType', 'month'] }),
+    handler: async (args, { host }) => {
+        for (const key of ['id', 'cfgId']) {
+            if (args[key] === undefined || args[key] === null || args[key] === '') {
+                throw ehrValidationError('est_dc_id_required', `${key} 必填，且必须取自控编维度数据源记录`);
+            }
+        }
+        const dataType = assertEnum(args.dataType, EST_DATA_TYPES, 'dataType');
+        const formDatas = { month: [{ month: args.month }] };
+        if (args.overCtrl !== undefined)
+            formDatas.overCtrl = [{ overCtrl: args.overCtrl }];
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/est/cfg/dc/emp/table',
+            body: {
+                id: String(args.id),
+                cfgId: String(args.cfgId),
+                dataType,
+                formDatas,
+                ...(args.keyword !== undefined ? { keyword: args.keyword } : {}),
+                ...(args.hisId !== undefined ? { hisId: Number(args.hisId) } : {}),
+            },
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.est.dc.emp.table', data, { page });
+    },
+};
+const turnEmpTable = {
+    name: 'ehr.hr.turn.emp.table',
+    resource: 'hr',
+    method: 'turn.emp.table',
+    action: 'ehr.hr.turn.emp.table',
+    summary: '人员流动明细名单（期初/期末/入职/离职/调入/调出）；startDate/endDate/dataType 三者必填',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        startDate: SCHEMA_DATE,
+        endDate: SCHEMA_DATE,
+        dataType: {
+            type: 'string',
+            enum: [...TURN_DATA_TYPES],
+            description: 'begin_emp_count 期初(起始日前一天在职) / end_emp_count 期末 / join_emp_count 入职 / dismiss_emp_count 离职 / org_in_emp_count 调入 / org_out_emp_count 调出',
+        },
+        departmentId: SCHEMA_ID,
+        subcompanyId: SCHEMA_ID,
+        keyword: { type: 'string' },
+        ...pageSchema,
+    }, { required: ['startDate', 'endDate', 'dataType'] }),
+    handler: async (args, { host }) => {
+        const dataType = assertEnum(args.dataType, TURN_DATA_TYPES, 'dataType');
+        if (args.startDate > args.endDate) {
+            throw ehrValidationError('date_range_invalid', 'startDate 不得晚于 endDate');
+        }
+        const body = {
+            startDate: args.startDate,
+            endDate: args.endDate,
+            dataType,
+            ...buildPage(args),
+        };
+        if (args.departmentId !== undefined)
+            body.departmentId = String(args.departmentId);
+        if (args.subcompanyId !== undefined)
+            body.subcompanyId = String(args.subcompanyId);
+        if (args.keyword !== undefined)
+            body.keyword = args.keyword;
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/tpReport/turn/emp/table',
+            body,
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.turn.emp.table', data, { page });
+    },
+};
+const propsSa = {
+    name: 'ehr.hr.props.sa',
+    resource: 'hr',
+    method: 'props.sa',
+    action: 'ehr.hr.props.sa',
+    summary: '获取人员属性合计报表的高级搜索条件定义；body 固定 {"type":"deptEmpProps"}',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({}),
+    handler: async (_args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/report/v2/sa',
+            body: { type: 'deptEmpProps' },
+        });
+        return ehrSuccess('ehr.hr.props.sa', normalizePaged(response).data);
+    },
+};
+const propsTable = {
+    name: 'ehr.hr.props.table',
+    resource: 'hr',
+    method: 'props.table',
+    action: 'ehr.hr.props.table',
+    summary: '人员属性合计报表：性别/年龄/工龄/司龄/婚姻/子女/学历/学位/职级/职称人数分布，按公司/分部/部门统计',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        calcLevel: {
+            type: 'string',
+            enum: ['department', 'subcompany', 'total'],
+            description: '统计维度；缺省按 department。total 与 department 粒度相同，subcompany 按分部聚合',
+        },
+        sa: { type: 'object', description: '高级搜索条件 Map；每个 key 的 value 为对象数组，对象内须含与 key 同名的数组字段' },
+        personnelStatus: SCHEMA_STRING_LIST,
+        departmentIds: SCHEMA_ID_LIST,
+        subcompanyIds: SCHEMA_ID_LIST,
+        ...pageSchema,
+    }),
+    handler: async (args, { host }) => {
+        const sa = {};
+        if (args.sa && typeof args.sa === 'object' && !Array.isArray(args.sa)) {
+            Object.assign(sa, args.sa);
+        }
+        sa.personnel_status = [{ personnel_status: Array.isArray(args.personnelStatus) ? args.personnelStatus : ['normal'] }];
+        const departmentIds = toIdList(args.departmentIds, 'departmentIds');
+        const subcompanyIds = toIdList(args.subcompanyIds, 'subcompanyIds');
+        if (departmentIds?.length)
+            sa.department = [{ department: departmentIds.map(String) }];
+        if (subcompanyIds?.length)
+            sa.subcompany = [{ subcompany: subcompanyIds.map(String) }];
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/report/v2/deptEmpProps',
+            body: {
+                sa,
+                calcLevel: args.calcLevel ?? 'department',
+                ...buildPage(args),
+            },
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.props.table', data, { page });
+    },
+};
+export const hrReportOperations = [
+    reportDeptTable,
+    reportPosiTable,
+    reportJobTable,
+    reportJobTypeTable,
+    reportChangeDeptTable,
+    estEmpTable,
+    estDcEmpTable,
+    turnEmpTable,
+    propsSa,
+    propsTable,
+];
+export { compact };