weaver-work-cli 0.1.2 → 0.1.5

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

@@ -0,0 +1,363 @@
+import { ehrValidationError } from '../errors.js';
+import { READ, SCHEMA_DATE, SCHEMA_ID, SCHEMA_ID_LIST, ehrSuccess, schemaOf, } from './types.js';
+import { assertDateRange, assertEnum, compact, normalizePaged, pickDefined, toIdList, toNumber, toPositiveInt, } from './shared.js';
+const BROWSER_TYPES = ['department', 'subcompany', 'position', 'resource', 'jobsetid', 'grade'];
+const USERNAME_OPERATORS = ['in', 'notIn', 'eq', 'notEq'];
+const PERSONNEL_STATUS = ['all', 'normal', '1', '2', '3', '4', '5', '6', '7', '9', '10'];
+const CHANGE_TYPES = [
+    'trial',
+    'hire',
+    'extend',
+    'redeploy',
+    'dismiss',
+    'retire',
+    'quit',
+    'rehire',
+    'custom',
+];
+const CHANGE_STATUSES = ['ineffective', 'effective', 'disuse'];
+const pageSchema = { current: SCHEMA_ID, pageSize: SCHEMA_ID };
+/**
+ * 通讯录高级搜索条件（saCondition）。
+ * 结构由 /api/bs/hr/contact/main/sa 动态返回，此处不固化字段集合，
+ * 只要求「对象 -> 条件对象数组」的形状。
+ */
+function normalizeSaCondition(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const result = {};
+    for (const [key, list] of Object.entries(value)) {
+        if (!Array.isArray(list)) {
+            throw ehrValidationError('sa_condition_invalid', `saCondition.${key} 必须是条件对象数组`);
+        }
+        result[key] = list;
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+function buildSaCondition(args) {
+    const explicit = normalizeSaCondition(args.saCondition);
+    if (explicit)
+        return explicit;
+    const sa = {};
+    if (args.username) {
+        // 姓名必须按「数组包对象」结构传并带条件操作符，扁平传文本会返回 500。
+        const operator = args.usernameOperator
+            ? assertEnum(args.usernameOperator, USERNAME_OPERATORS, 'usernameOperator')
+            : 'in';
+        sa.username = [{ username_condition: operator, username: args.username }];
+    }
+    if (args.jobNum) {
+        sa.job_num = [{ job_num_condition: 'in', job_num: args.jobNum }];
+    }
+    if (args.sex) {
+        sa.sex = [{ sex: assertEnum(args.sex, ['all', 'male', 'female'], 'sex') }];
+    }
+    // 通讯录默认只查在职，这是与 empchange（默认含离职）相反的关键差异。
+    const status = Array.isArray(args.personnelStatus) ? args.personnelStatus : ['normal'];
+    for (const item of status)
+        assertEnum(item, PERSONNEL_STATUS, 'personnelStatus');
+    sa.personnel_status = [{ personnel_status: status }];
+    return sa;
+}
+const contactFields = {
+    name: 'ehr.hr.contact.fields',
+    resource: 'hr',
+    method: 'contact.fields',
+    action: 'ehr.hr.contact.fields',
+    summary: '获取通讯录全部可展示字段及 key（按基本信息/个人信息/账号信息分组），是 contact.search 的前置步骤',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({}),
+    handler: async (_args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/contact/col/list',
+            body: { formEnable: true },
+        });
+        return ehrSuccess('ehr.hr.contact.fields', normalizePaged(response).data);
+    },
+};
+const contactSa = {
+    name: 'ehr.hr.contact.sa',
+    resource: 'hr',
+    method: 'contact.sa',
+    action: 'ehr.hr.contact.sa',
+    summary: '获取通讯录高级搜索条件定义与可选项，用于确认 saCondition 的字段 id、itemType 与 browserBean.type',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({}),
+    handler: async (_args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/contact/main/sa',
+            body: { formEnable: true },
+        });
+        return ehrSuccess('ehr.hr.contact.sa', normalizePaged(response).data);
+    },
+};
+const contactSearchProperties = {
+    username: { type: 'string', description: '姓名，按「包含」模糊匹配；重名返回多条时必须让用户选择，不得自动取第一条' },
+    usernameOperator: { type: 'string', enum: [...USERNAME_OPERATORS], description: 'in 包含 / notIn 不包含 / eq 等于 / notEq 不等于' },
+    jobNum: { type: 'string' },
+    sex: { type: 'string', enum: ['all', 'male', 'female'] },
+    personnelStatus: {
+        type: 'array',
+        items: { type: 'string', enum: [...PERSONNEL_STATUS] },
+        description: '默认 ["normal"] 在职；["all"] 不限状态。不要用 ["normal","6"] 这类组合，实测无法覆盖离职人员',
+    },
+    saCondition: { type: 'object', description: '完整高级搜索条件；传入后将忽略上面的便捷字段' },
+    onlyFieldList: { type: 'array', items: { type: 'string' }, description: '只返回这些字段，key 以 contact.fields 返回的 fieldList[].id 为准' },
+    keyword: { type: 'string' },
+    saMatchType: { type: 'string', enum: ['and', 'or'] },
+    queryType: { type: 'string', enum: ['nomarl', 'monthActive', 'monthDimission', 'monthRetire'] },
+};
+const contactSearch = {
+    name: 'ehr.hr.contact.search',
+    resource: 'hr',
+    method: 'contact.search',
+    action: 'ehr.hr.contact.search',
+    summary: '按高级搜索条件分页查询通讯录在职人员；pageSize 被页面配置固定为 100，全量需递增 current 翻页',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...contactSearchProperties, ...pageSchema }),
+    handler: async (args, { host }) => {
+        const body = {
+            formEnable: true,
+            searchCount: true,
+            ...pickDefined(args, ['onlyFieldList', 'keyword', 'saMatchType', 'queryType']),
+            saCondition: buildSaCondition(args),
+        };
+        const current = toPositiveInt(args.current, 'current');
+        const pageSize = toNumber(args.pageSize, 'pageSize');
+        if (current !== undefined)
+            body.current = current;
+        if (pageSize !== undefined)
+            body.pageSize = pageSize;
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/contact/main/table',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.contact.search', data, { page });
+    },
+};
+const contactCount = {
+    name: 'ehr.hr.contact.count',
+    resource: 'hr',
+    method: 'contact.count',
+    action: 'ehr.hr.contact.count',
+    summary: '只统计符合高级搜索条件的通讯录人员数量，不返回列表',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf(contactSearchProperties),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/contact/main/count',
+            body: {
+                formEnable: true,
+                ...pickDefined(args, ['keyword', 'saMatchType', 'queryType']),
+                saCondition: buildSaCondition(args),
+            },
+        });
+        return ehrSuccess('ehr.hr.contact.count', normalizePaged(response).data);
+    },
+};
+const browserComplete = {
+    name: 'ehr.hr.browser.complete',
+    resource: 'hr',
+    method: 'browser.complete',
+    action: 'ehr.hr.browser.complete',
+    summary: '按名称查询浏览器选择器条目取 id（部门/分部/岗位/职级/职务/上级等），供 saCondition 构造使用',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        type: { type: 'string', enum: [...BROWSER_TYPES], description: 'browserBean.type，取自 contact.sa 返回的字段定义' },
+        searchValue: { type: 'string', minLength: 1 },
+    }, { required: ['type', 'searchValue'] }),
+    handler: async (args, { host }) => {
+        const type = assertEnum(args.type, BROWSER_TYPES, 'type');
+        if (!args.searchValue || !String(args.searchValue).trim()) {
+            throw ehrValidationError('search_value_required', 'searchValue 必填');
+        }
+        const response = await host.request({
+            method: 'POST',
+            path: `/api/hrm/common/browser/complete/${type}`,
+            body: { browserMultiple: true, newly: 0, searchValue: String(args.searchValue) },
+        });
+        const data = normalizePaged(response).data;
+        const candidates = Array.isArray(data?.data) ? data.data : [];
+        return ehrSuccess('ehr.hr.browser.complete', {
+            candidates,
+            total: candidates.length,
+            // 多条命中时严禁自动取第一条，必须列候选让用户选择。
+            requiresDisambiguation: candidates.length > 1,
+            hint: candidates.length > 1
+                ? '存在多个匹配项，必须列出候选让用户确认选择哪一个，不得自动取第一条'
+                : undefined,
+        });
+    },
+};
+const birthdayConditions = {
+    name: 'ehr.hr.birthday.conditions',
+    resource: 'hr',
+    method: 'birthday.conditions',
+    action: 'ehr.hr.birthday.conditions',
+    summary: '获取过生日人员查询的高级搜索条件定义；该接口只能用 GET，POST 会返回 405',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({}),
+    handler: async (_args, { host }) => {
+        const response = await host.request({
+            method: 'GET',
+            path: '/api/hr/birthday/getSearchCondition',
+        });
+        return ehrSuccess('ehr.hr.birthday.conditions', normalizePaged(response).data);
+    },
+};
+const birthdayList = {
+    name: 'ehr.hr.birthday.list',
+    resource: 'hr',
+    method: 'birthday.list',
+    action: 'ehr.hr.birthday.list',
+    summary: '按生日月/日、姓名、工号、部门、分部查询过生日人员；pageSize 被页面配置固定为 100',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        birthdayM: { type: 'string', pattern: '^(0[1-9]|1[0-2])$', description: '生日月 01-12，缺省取当前月' },
+        birthdayD: { type: 'string', pattern: '^(0[1-9]|[12][0-9]|3[01])$', description: '生日日 01-31；与 birthdayM 组合为单日' },
+        username: { type: 'string' },
+        jobNum: { type: 'string' },
+        departmentIds: SCHEMA_ID_LIST,
+        subcompanyIds: SCHEMA_ID_LIST,
+        ...pageSchema,
+    }),
+    handler: async (args, { host }) => {
+        const params = {};
+        if (args.birthdayM)
+            params.birthdayM = [{ birthdayM: args.birthdayM }];
+        if (args.birthdayD)
+            params.birthdayD = [{ birthdayD: args.birthdayD }];
+        if (args.username)
+            params.username = [{ username: args.username }];
+        if (args.jobNum)
+            params.jobNum = [{ jobNum: args.jobNum }];
+        const departmentIds = toIdList(args.departmentIds, 'departmentIds');
+        const subcompanyIds = toIdList(args.subcompanyIds, 'subcompanyIds');
+        if (departmentIds?.length) {
+            params.department = [{ department: departmentIds.map((id) => ({ id: String(id) })) }];
+        }
+        if (subcompanyIds?.length) {
+            params.subcompany = [{ subcompany: subcompanyIds.map((id) => ({ id: String(id) })) }];
+        }
+        const body = {
+            // menuCode 固定，来源文档明确可直接调 tableData。
+            menuCode: 'birthdaylist',
+            params,
+        };
+        const current = toPositiveInt(args.current, 'current');
+        const pageSize = toNumber(args.pageSize, 'pageSize');
+        if (current !== undefined)
+            body.current = current;
+        if (pageSize !== undefined)
+            body.pageSize = pageSize;
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/hr/birthday/tableData',
+            body,
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.birthday.list', data, { page });
+    },
+};
+const empchangeConditions = {
+    name: 'ehr.hr.empchange.conditions',
+    resource: 'hr',
+    method: 'empchange.conditions',
+    action: 'ehr.hr.empchange.conditions',
+    summary: '获取人员状态变更记录的筛选字段定义与枚举；该接口只能用 GET，POST 实测返回 405',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({}),
+    handler: async (_args, { host }) => {
+        const response = await host.request({
+            method: 'GET',
+            path: '/api/bs/hrm/empchange/record/searchCondition',
+        });
+        return ehrSuccess('ehr.hr.empchange.conditions', normalizePaged(response).data);
+    },
+};
+const empchangeList = {
+    name: 'ehr.hr.empchange.list',
+    resource: 'hr',
+    method: 'empchange.list',
+    action: 'ehr.hr.empchange.list',
+    summary: '查询人员状态变更台账（试用/转正/续签/调动/离职/退休/解聘/返聘）；默认包含离职人员，与通讯录默认在职相反',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({
+        userName: { type: 'string', description: '姓名模糊匹配；可能重名，查个人建议用 resourceId' },
+        jobNum: { type: 'string' },
+        keySearch: { type: 'string' },
+        resourceId: SCHEMA_ID,
+        resource: SCHEMA_ID_LIST,
+        department: { ...SCHEMA_ID_LIST, description: '部门 id 数组；过滤的是人员当前所在部门' },
+        position: { ...SCHEMA_ID_LIST, description: '岗位 id 数组' },
+        changeDateStart: SCHEMA_DATE,
+        changeDateEnd: SCHEMA_DATE,
+        changeType: { type: 'array', items: { type: 'string', enum: [...CHANGE_TYPES] } },
+        changeStatuses: { type: 'array', items: { type: 'string', enum: [...CHANGE_STATUSES] } },
+        containUnavailable: { type: 'boolean', description: '是否包含离职人员，默认 true。注意：2026-09-04 实测该字段对服务端无效（true/false 均返回相同 total），已透传但被忽略，不要依赖它过滤离职人员' },
+        containPartTimeJob: { type: 'boolean' },
+        ...pageSchema,
+    }),
+    handler: async (args, { host }) => {
+        // 变更日期必须用两个独立字段传起止，传 changeDate 数组格式实测无效。
+        assertDateRange(args, 'changeDateStart', 'changeDateEnd');
+        const body = {
+            ...pickDefined(args, [
+                'userName',
+                'jobNum',
+                'keySearch',
+                'changeDateStart',
+                'changeDateEnd',
+                'changeType',
+                'changeStatuses',
+                'containUnavailable',
+                'containPartTimeJob',
+            ]),
+        };
+        const current = toPositiveInt(args.current, 'current');
+        const pageSize = toNumber(args.pageSize, 'pageSize');
+        if (current !== undefined)
+            body.current = current;
+        if (pageSize !== undefined)
+            body.pageSize = pageSize;
+        if (args.resourceId !== undefined)
+            body.resourceId = Number(args.resourceId);
+        for (const key of ['department', 'position', 'resource']) {
+            const list = toIdList(args[key], key);
+            if (list?.length)
+                body[key] = list;
+        }
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hrm/empchange/getTable',
+            body: compact(body),
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.empchange.list', data, { page });
+    },
+};
+export const hrContactOperations = [
+    contactFields,
+    contactSa,
+    contactSearch,
+    contactCount,
+    browserComplete,
+    birthdayConditions,
+    birthdayList,
+    empchangeConditions,
+    empchangeList,
+];

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

@@ -0,0 +1,298 @@
+import { ehrValidationError } from '../errors.js';
+import { READ, SCHEMA_ID, ehrSuccess, schemaOf, } from './types.js';
+import { assertEnum, compact, normalizePaged, toNumber, toPositiveInt } from './shared.js';
+/**
+ * 聚才林数据源（HR 报表）固定 formId 对照表。
+ * 文档明确：formId 固定、不区分租户，groupId 恒为 weaver-hr-service。
+ */
+export const HR_DATA_SOURCE_IDS = {
+    // 历史时点（必填 timePoint，eq）
+    tp: '754217732232708651',
+    // 编制
+    estCalc: '754217732232708751',
+    estDcCalc: '754217732232709056',
+    // 基本状况分析
+    basicAge: '754217732232708200',
+    basicSex: '754217732232708188',
+    basicWorkYear: '754217732232708201',
+    basicEdu: '754217732232708202',
+    basicMarry: '754217732232708203',
+    basicJobCall: '754217732232708204',
+    basicJobLevel: '754217732232708205',
+    basicStatus: '754217732232708207',
+    basicSecLevel: '754217732232708208',
+    // 流失统计
+    changeLossPersonCount: '754217732232708374',
+    changeLossDeptCount: '754217732232708375',
+    changeLossPer: '754217732232708376',
+    changeDismissPersonCount: '754217732232708378',
+    changeDismissDeptCount: '754217732232708379',
+    changeDismissPer: '754217732232708380',
+    changeQuitPersonCount: '754217732232708382',
+    changeQuitDeptCount: '754217732232708383',
+    changeQuitPer: '754217732232708384',
+    changeRetirePersonCount: '754217732232708386',
+    changeRetireDeptCount: '754217732232708387',
+    changeRetirePer: '754217732232708388',
+    // 部门人数
+    deptPanelDeptCount: '754217732232708426',
+    deptPanelPersonCount: '754217732232708427',
+    deptPanelMaxPersonCount: '754217732232708428',
+    deptPanelMinPersonCount: '754217732232708429',
+    // 离职名册（过滤字段 dismissDate 可选）
+    dismiss: '754217732232708654',
+    // 历史曾在职（必填 dutyDate）
+    hw: '754217732232708653',
+    // 职务状况
+    jobPanelPersonCount: '754217732232708445',
+    jobPanelJobTypeCount: '754217732232708446',
+    jobPanelJobCount: '754217732232708447',
+    // 岗位人数
+    posiPanelPosiCount: '754217732232708440',
+    posiPanelPersonCount: '754217732232708441',
+    posiPanelMaxPersonCount: '754217732232708442',
+    posiPanelMinPersonCount: '754217732232708443',
+    // 人员流动分析（必填 dateRange）
+    turn: '754217732232708655',
+    // 人员情况合计（必填 month）
+    v2DeptEmpMove: '754217732232709010',
+};
+const HR_GROUP_ID = 'weaver-hr-service';
+/**
+ * 数据源条件操作符白名单。不同字段支持的操作符不同，以 ehr.hr.ds.fields 返回的
+ * conditionType 为准；此处只做兜底，避免误拦截（真正决定成败的是传法，见下）。
+ *
+ * 两类易混操作符在源资料中都存在，必须都保留：
+ * - `gtAndEq` / `ltAndEq`：见 tp（历史时点）文档
+ * - `gte` / `lte`：见 hw / turn / v2DeptEmpMove / dismiss 文档
+ *
+ * 日期范围条件的正确传法（2026-09-04 依源资料修正，此前判错）：
+ * hw 的 dutyDate、turn 的 dateRange、v2DeptEmpMove 的 month、dismiss 的 dismissDate
+ * **必须拆成 2 个条件**——`gte` 起 + `lte` 止，引擎取前 2 个 conditionValue 作为起止日期。
+ * 用单个 between 传 "起,止" 会报 500「日期范围过滤条件错误」。
+ * 只有 tp 的 timePoint 是单条件，用 `eq`。
+ */
+const COMPARE_TYPES = [
+    'eq',
+    'in',
+    'like',
+    'gtAndEq',
+    'ltAndEq',
+    'gte',
+    'lte',
+    'between',
+];
+const PERMISSION_TYPE_KEYS = [
+    'hiredate',
+    'location',
+    'personnelStatus',
+    'subcompany',
+    'department',
+    'baseAgeSplit',
+    'baseWorkYearSplit',
+];
+function buildPermissionType(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const raw = value;
+    if (Object.keys(raw).length === 0)
+        return undefined;
+    const payload = {
+        hiredate: Array.isArray(raw.hiredate) ? raw.hiredate : [],
+        location: Array.isArray(raw.location) ? raw.location.map(String) : [],
+        // personnelStatus 未提供时按 normal（在职）处理，这是报表类的默认语义。
+        personnelStatus: Array.isArray(raw.personnelStatus) ? raw.personnelStatus : ['normal'],
+        subcompany: Array.isArray(raw.subcompany) ? raw.subcompany.map(String) : [],
+        department: Array.isArray(raw.department) ? raw.department.map(String) : [],
+    };
+    if (raw.baseAgeSplit !== undefined)
+        payload.baseAgeSplit = String(raw.baseAgeSplit);
+    if (raw.baseWorkYearSplit !== undefined)
+        payload.baseWorkYearSplit = String(raw.baseWorkYearSplit);
+    return JSON.stringify(payload);
+}
+function buildQueryFields(formId, fields) {
+    if (!Array.isArray(fields) || fields.length === 0)
+        return undefined;
+    return fields.map((name, index) => ({
+        objId: formId,
+        fieldId: String(name),
+        fieldName: String(name),
+        ...(index === 0 ? { mainPrimaryKey: true } : {}),
+    }));
+}
+function buildConditionTrees(conditions) {
+    if (!Array.isArray(conditions) || conditions.length === 0)
+        return undefined;
+    return {
+        isParent: true,
+        relationship: '1',
+        conditionList: conditions.map((item, index) => {
+            if (!item || typeof item !== 'object' || Array.isArray(item)) {
+                throw ehrValidationError('condition_invalid', `conditions[${index}] 必须是对象`);
+            }
+            const record = item;
+            if (!record.field) {
+                throw ehrValidationError('condition_invalid', `conditions[${index}].field 必填`);
+            }
+            return {
+                isParent: false,
+                conditionId: String(record.field),
+                conditionValue: String(record.value ?? ''),
+                compareType: assertEnum(record.compareType, COMPARE_TYPES, `conditions[${index}].compareType`),
+            };
+        }),
+    };
+}
+const dsQueryProperties = {
+    formId: { oneOf: [{ type: 'string', minLength: 1 }, { type: 'integer' }], description: '数据源 formId，见 schema 中的 dataSourceIds' },
+    conditions: {
+        type: 'array',
+        description: '条件列表。日期范围条件必须拆成 2 项：{field,value:起始,compareType:"gte"} + {field,value:截止,compareType:"lte"}；不要用单个 between 传 "起,止"。可用操作符以 ehr.hr.ds.fields 返回的 conditionType 为准',
+        items: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                field: { type: 'string', minLength: 1, description: '字段 name，来自 ds.fields' },
+                value: { oneOf: [{ type: 'string' }, { type: 'number' }, { type: 'boolean' }], description: '条件值；日期范围 gte 传起始、lte 传截止' },
+                compareType: { type: 'string', enum: [...COMPARE_TYPES] },
+            },
+            required: ['field', 'value', 'compareType'],
+        },
+    },
+    queryFields: { type: 'array', items: { type: 'string' }, description: '查询字段 name 列表，来自 ds.fields' },
+    permissionType: {
+        type: 'object',
+        additionalProperties: false,
+        description: '人员范围过滤，JSON 字符串化后内嵌到 queryDto',
+        properties: {
+            hiredate: { type: 'array', items: { type: 'string' }, minItems: 2, maxItems: 2 },
+            location: { type: 'array', items: { type: 'string' } },
+            personnelStatus: { type: 'array', items: { type: 'string' }, description: '默认 ["normal"]；["all"] 不限状态' },
+            subcompany: { type: 'array', items: { type: 'string' } },
+            department: { type: 'array', items: { type: 'string' } },
+            baseAgeSplit: { type: 'string' },
+            baseWorkYearSplit: { type: 'string' },
+        },
+    },
+    pageNo: SCHEMA_ID,
+    pageSize: SCHEMA_ID,
+    queryCount: { type: 'boolean' },
+    rawQueryDto: {
+        type: 'object',
+        description: '逃生舱：直接传完整 queryDto 对象，将覆盖上面的结构化构造结果',
+    },
+};
+function buildQueryDto(args, queryType) {
+    if (args.formId === undefined || args.formId === null || args.formId === '') {
+        throw ehrValidationError('form_id_required', 'formId 必填');
+    }
+    const formId = String(args.formId);
+    if (args.rawQueryDto && typeof args.rawQueryDto === 'object' && !Array.isArray(args.rawQueryDto)) {
+        return { ...args.rawQueryDto, tableId: formId, groupId: HR_GROUP_ID };
+    }
+    const queryDto = {
+        tableId: formId,
+        groupId: HR_GROUP_ID,
+        queryType,
+        pageNo: toPositiveInt(args.pageNo, 'pageNo') ?? 1,
+        pageSize: toNumber(args.pageSize, 'pageSize') ?? 100,
+        queryCount: args.queryCount !== false,
+    };
+    const conditionTrees = buildConditionTrees(args.conditions);
+    if (conditionTrees)
+        queryDto.conditionTrees = conditionTrees;
+    const queryFields = buildQueryFields(formId, args.queryFields);
+    if (queryFields)
+        queryDto.queryFields = queryFields;
+    const permissionType = buildPermissionType(args.permissionType);
+    if (permissionType)
+        queryDto.permissionType = permissionType;
+    return queryDto;
+}
+const dsFields = {
+    name: 'ehr.hr.ds.fields',
+    resource: 'hr',
+    method: 'ds.fields',
+    action: 'ehr.hr.ds.fields',
+    summary: '获取 HR 数据源的字段结构（哪些字段可作查询条件、支持的操作符），是构造 ds.list/ds.count/ds.chart 的唯一依据',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ formId: { oneOf: [{ type: 'string', minLength: 1 }, { type: 'integer' }] } }, { required: ['formId'] }),
+    handler: async (args, { host }) => {
+        if (args.formId === undefined || args.formId === null || args.formId === '') {
+            throw ehrValidationError('form_id_required', 'formId 必填');
+        }
+        // 数据源接口全部是 form-urlencoded 提交，不是 JSON body。
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/ds/fields',
+            form: {
+                sourceType: 'LOGIC',
+                sourceId: String(args.formId),
+                groupId: HR_GROUP_ID,
+            },
+        });
+        return ehrSuccess('ehr.hr.ds.fields', normalizePaged(response).data);
+    },
+};
+const dsList = {
+    name: 'ehr.hr.ds.list',
+    resource: 'hr',
+    method: 'ds.list',
+    action: 'ehr.hr.ds.list',
+    summary: '查询 HR 数据源列表数据（历史时点名册、离职名册、历史曾在职、编制、流动分析、人员情况合计等）',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...dsQueryProperties }, { required: ['formId'] }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            // /api/bs/hr/ds/getListData 已废弃 404，必须走 /ai/ 路径。
+            path: '/api/bs/hr/ai/ds/getListData',
+            form: { sourceType: 'LOGIC', queryDto: buildQueryDto(args, 'list') },
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.ds.list', data, { page });
+    },
+};
+const dsCount = {
+    name: 'ehr.hr.ds.count',
+    resource: 'hr',
+    method: 'ds.count',
+    action: 'ehr.hr.ds.count',
+    summary: '查询 HR 数据源数量统计，返回 totalCount/totalPage/pageSize/tableId（不是 count 字段）',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...dsQueryProperties }, { required: ['formId'] }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/ai/ds/getCountData',
+            form: { sourceType: 'LOGIC', queryDto: buildQueryDto(args, 'count') },
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.ds.count', data, { page });
+    },
+};
+const dsChart = {
+    name: 'ehr.hr.ds.chart',
+    resource: 'hr',
+    method: 'ds.chart',
+    action: 'ehr.hr.ds.chart',
+    summary: '查询 HR 数据源图表分布数据（基本状况分析：年龄/性别/工龄/学历/婚姻/职称/职级/状态/安全级别）',
+    capability: 'hr',
+    risk: READ,
+    inputSchema: schemaOf({ ...dsQueryProperties }, { required: ['formId'] }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/bs/hr/ai/ds/getChartData',
+            form: { sourceType: 'LOGIC', queryDto: buildQueryDto(args, 'chart') },
+        });
+        const { data, page } = normalizePaged(response);
+        return ehrSuccess('ehr.hr.ds.chart', data, { page });
+    },
+};
+export const hrDataSourceOperations = [dsFields, dsList, dsCount, dsChart];
+export { compact, PERMISSION_TYPE_KEYS };