weaver-work-cli 0.1.40 → 0.1.44

package/dist/shortcuts/recruit-stage/operations/interview-feedback.js

@@ -0,0 +1,269 @@
+import { rsSuccess, schemaOf } from './types.js';
+import { rsFail, rsValidationError, rsConfirmationError } from '../errors.js';
+import { objIdOf, formIdOf, saveFormData, runEsb, getDsOptions, cachedDsMap, getFormButtonsForData, findSubmitButton, analyzeButtonActions, getFormDataRecord, toSubmitDetails, randHex32, } from '../shared.js';
+// InterviewStatusEnum.INVALID（已失效）：系统反馈按钮（填写/编辑/代评价）均要求非此状态
+const INVALID_STATUS_ID = '841052191228968977';
+const R = (v) => String(v ?? '').replace(/^<p>|<\/p>$/g, '').trim();
+async function locateTalentId(host, cache, args) {
+    if (args.talentId)
+        return String(args.talentId);
+    if (!args.mobile)
+        throw rsValidationError('locate_required', '请提供 talentId 或 mobile');
+    const listId = cache.forms?.talent_pool?.listId;
+    if (!listId)
+        throw rsFail('环境缓存缺少人才列表 listId');
+    const poolObjId = cache.forms.talent_pool.objId;
+    const r = await host.request({
+        path: '/api/ebuilder/form/list/getListDatas?passid=' + poolObjId + '&cid=' + poolObjId,
+        body: {
+            listId, cid: poolObjId, passid: poolObjId,
+            searchParamData: JSON.stringify({ searchParamList: [{ key: 'field_mobile', value: args.mobile, operator: '=' }] }),
+            current: 1, pageSize: 10, tableuid: randHex32(),
+        },
+    });
+    const rows = r?.data?.rows || r?.data || [];
+    if (!rows.length)
+        throw rsFail('未找到手机号为 ' + args.mobile + ' 的候选人');
+    if (rows.length > 1)
+        throw rsFail('该手机号命中多条候选人，请提供 talentId 精确定位');
+    return String(rows[0].talentId || rows[0].form_data_id);
+}
+async function getBatchId(host, talentId) {
+    const rk = 'randomkey_' + randHex32().slice(0, 6);
+    const r = await host.request({ path: '/api/recruit/candidate/getCandidateCardPrepareQuery?talentId=' + talentId + '&' + rk + '=' + rk.split('_')[1], method: 'GET' });
+    return r?.data?.batchId;
+}
+async function listInterviewFeedback(host, talentId, batchId) {
+    const r = await host.request({
+        path: '/api/recruit/candidate/getCandidateCardInterviewInfo', method: 'POST',
+        body: { talentId, batchId, current: 1, pageSize: 20 },
+    });
+    const list = r?.data?.list || [];
+    const out = [];
+    for (let i = 0; i < list.length; i++) {
+        const it = list[i];
+        const fbs = it?.interviewFeedBack || [];
+        if (fbs.length) {
+            const fb = fbs[0];
+            out.push({
+                index: i,
+                planId: (fb.interviewPlanId || [])[0]?.id,
+                planName: (fb.interviewPlanId || [])[0]?.name || (it.subject || ''),
+                interviewer: (fb.interviewer || []).map((x) => x.name).join('、') || (it.interviewer || ''),
+                feedbackId: fb.id || fb.formDataId,
+                result: (fb.result || []).map((x) => x.name).join('、') || '',
+                judgement: R(fb.judgement),
+                unionStatusId: (it.unionStatus || [])[0]?.id || '',
+                unionStatusName: (it.unionStatus || [])[0]?.name || '',
+            });
+        }
+    }
+    return out;
+}
+async function buildTarget(env, args) {
+    const host = env.host;
+    const session = await host.getSession();
+    const cache = await env.recruitContext();
+    const baseUrl = session.baseUrl.replace(/\/+$/, '');
+    const talentId = await locateTalentId(host, cache, args);
+    const batchId = await getBatchId(host, talentId);
+    const list = await listInterviewFeedback(host, talentId, batchId);
+    if (!list.length)
+        throw rsFail('该候选人没有可编辑的面试反馈记录');
+    let target;
+    if (args.feedbackId) {
+        target = list.find((x) => String(x.feedbackId) === String(args.feedbackId));
+        if (!target)
+            throw rsFail('未找到反馈记录 id=' + args.feedbackId + '，可选：' + list.map((x) => x.feedbackId).join(','));
+    }
+    else {
+        const idx = args.planIndex !== undefined ? Number(args.planIndex) : 0;
+        if (args.planIndex !== undefined && !list[idx])
+            throw rsFail('planIndex 超出范围，共 ' + list.length + ' 场含反馈');
+        target = list[idx];
+    }
+    if (target.unionStatusId === INVALID_STATUS_ID) {
+        throw rsFail('该面试状态为「已失效」，不允许填写/编辑面试反馈（与系统按钮条件一致：已失效不显示反馈按钮）。面试=' + target.planName + '，反馈记录Id=' + target.feedbackId);
+    }
+    const objId = objIdOf(cache, 'interview_detail');
+    const formId = formIdOf(cache, 'interview_detail');
+    const fields = cache.fields?.[objId] || {};
+    const resultFid = fields.result;
+    const judgementFid = fields.judgement;
+    if (!resultFid || !judgementFid)
+        throw rsFail('环境缓存缺少面试反馈的 result/judgement 字段映射');
+    return { host, baseUrl, appId: cache.appId, cache, talentId, batchId, list, target, objId, formId, fields, resultFid, judgementFid };
+}
+async function prepare(args, env) {
+    if (!args.result && args.comment === undefined) {
+        throw rsValidationError('result_or_comment_required', '请提供 result（通过/不通过/待定）和/或 comment（评价）');
+    }
+    const t = await buildTarget(env, args);
+    // 反馈记录当前数据（updateTimeStamp + 全字段集）
+    const rec = await getFormDataRecord(t.host, t.formId, String(t.target.feedbackId), t.objId);
+    if (!rec.id)
+        throw rsFail('无法获取反馈记录数据（formData 为空），可能无权限或记录不存在');
+    // 粗定位提交按钮 + 精核验
+    const btns = await getFormButtonsForData(t.host, t.objId, t.formId, String(t.target.feedbackId));
+    const submitBtn = findSubmitButton(btns);
+    const analysis = submitBtn ? analyzeButtonActions(submitBtn) : null;
+    // result optionId
+    let newOptionId = null;
+    if (args.result) {
+        const opts = cachedDsMap(t.cache, t.objId, 'result') || await getDsOptions(t.host, t.objId, t.resultFid, t.appId);
+        newOptionId = opts[String(args.result)];
+        if (!newOptionId)
+            throw rsFail('未识别的面试结果「' + args.result + '」，可选：' + Object.keys(opts).join('/'));
+    }
+    const newComment = args.comment !== undefined ? String(args.comment) : t.target.judgement;
+    const newResultName = args.result ? String(args.result) : t.target.result;
+    const willSubmit = { feedbackId: String(t.target.feedbackId), result: newResultName, comment: newComment };
+    const { createHash } = await import('node:crypto');
+    const fp = createHash('sha256').update(JSON.stringify(willSubmit)).digest('hex');
+    const continuation = await env.continuation.issue({ operation: 'recruit-stage.interview.feedback.edit.apply', fingerprint: fp });
+    return rsSuccess('recruit-stage.interview.feedback.edit.prepare', {
+        mode: 'prepare',
+        talentId: t.talentId,
+        batchId: t.batchId,
+        面试: t.target.planName,
+        面试官: t.target.interviewer,
+        反馈记录Id: t.target.feedbackId,
+        当前反馈: (t.target.result ? '结果 ' + t.target.result : '') + (t.target.judgement ? '；评价 ' + t.target.judgement : ''),
+        新反馈: (args.result ? '结果 ' + newResultName : '') + (args.comment !== undefined ? '；评价 ' + newComment : ''),
+        将执行动作: analysis
+            ? {
+                保存反馈表单: 'saveFormData（全字段集 + updateTimeStamp 乐观锁）',
+                动作流: analysis.esbIds.length ? analysis.esbIds : '（该按钮无 esb 动作流）',
+                招聘API: analysis.jsCalls.map((c) => c.url + (Object.keys(c.data).length ? ' data=' + Object.keys(c.data).join(',') : '')),
+            }
+            : '⚠️ 未定位到「提交评价」按钮（getFormButtons 未取到保存按钮），仅能执行保存+写过程日志',
+        willSubmit,
+    }, { continuation, fingerprint: fp, confirmHint: '用户明确确认后，携带 confirm:true 与 continuation 调用 apply' });
+}
+async function apply(args, env) {
+    if (args.confirm !== true)
+        throw rsConfirmationError('recruit-stage.interview.feedback.edit.apply', { hint: '写操作必须显式 confirm:true' });
+    if (!args.continuation)
+        throw rsValidationError('continuation_required', '缺少 continuation（来自 prepare 的 meta）');
+    const payload = await env.continuation.verify(String(args.continuation), 'recruit-stage.interview.feedback.edit.apply');
+    const t = await buildTarget(env, args);
+    // 重新取最新 updateTimeStamp（乐观锁）
+    const rec2 = await getFormDataRecord(t.host, t.formId, String(t.target.feedbackId), t.objId);
+    const details2 = toSubmitDetails(rec2.dataDetails);
+    let newOptionId = null;
+    if (args.result) {
+        const opts = cachedDsMap(t.cache, t.objId, 'result') || await getDsOptions(t.host, t.objId, t.resultFid, t.appId);
+        newOptionId = opts[String(args.result)];
+        if (!newOptionId)
+            throw rsFail('未识别的面试结果「' + args.result + '」，可选：' + Object.keys(opts).join('/'));
+    }
+    const newComment = args.comment !== undefined ? String(args.comment) : t.target.judgement;
+    const newResultName = args.result ? String(args.result) : t.target.result;
+    const willSubmit = { feedbackId: String(t.target.feedbackId), result: newResultName, comment: newComment };
+    const { createHash } = await import('node:crypto');
+    if (payload.fingerprint !== createHash('sha256').update(JSON.stringify(willSubmit)).digest('hex')) {
+        throw rsValidationError('fingerprint_mismatch', '待提交内容与 prepare 确认摘要不一致，请重新 prepare 确认后再 apply');
+    }
+    // 覆盖 result/judgement 字段（原详情缺失则追加，避免整条提交时字段不写入）
+    const newDetails = details2.map((x) => {
+        const fid = x.formField.id;
+        if (fid === t.resultFid && newOptionId)
+            return { formField: { id: fid }, dataOptions: [{ optionId: newOptionId, content: newResultName }] };
+        if (fid === t.judgementFid)
+            return { formField: { id: fid }, dataText: { content: '<p>' + (newComment || '') + '</p>' } };
+        return x;
+    });
+    if (newOptionId && !newDetails.some((x) => x.formField.id === t.resultFid)) {
+        newDetails.push({ formField: { id: t.resultFid }, dataOptions: [{ optionId: newOptionId, content: newResultName }] });
+    }
+    if (args.comment !== undefined && !newDetails.some((x) => x.formField.id === t.judgementFid)) {
+        newDetails.push({ formField: { id: t.judgementFid }, dataText: { content: '<p>' + (newComment || '') + '</p>' } });
+    }
+    // saveFormData（layoutId 用 getFormDataAndLayout 的 formLayout.id，getFormLayout 405 不可靠）
+    const savedId = await saveFormData(t.host, {
+        appId: t.appId, formId: t.formId, objId: t.objId,
+        name: '面试反馈-' + t.target.planName, formDataId: String(t.target.feedbackId),
+        updateTimeStamp: rec2.updateTimeStamp, dataDetails: newDetails, rightType: '2',
+        layoutId: rec2.formLayoutId,
+        extraCustomParam: { secretLevel: '', secretLevelValidity: '' },
+    });
+    // runEsb 动作流（按钮配置解析）
+    const btns = await getFormButtonsForData(t.host, t.objId, t.formId, String(t.target.feedbackId));
+    const submitBtn = findSubmitButton(btns);
+    const analysis = submitBtn ? analyzeButtonActions(submitBtn) : null;
+    let esbRes = null;
+    if (analysis?.esbIds?.length) {
+        esbRes = await runEsb(t.host, { objId: t.objId, dataIds: String(t.target.feedbackId), esbActionIds: analysis.esbIds.join(',') });
+    }
+    // addProcessLog 写招聘过程日志（jsCode 里的招聘 API，按标准契约直接调）
+    let processRes = null;
+    if (analysis?.jsCalls?.length) {
+        const call = analysis.jsCalls.find((c) => c.url.includes('/api/recruit/')) || analysis.jsCalls[0];
+        processRes = await t.host.request({
+            path: call.url, method: (call.method || 'post').toUpperCase(),
+            body: {
+                talentId: String(t.talentId), batchId: String(t.batchId),
+                result: newOptionId || t.target.result, judgement: '<p>' + (newComment || '') + '</p>',
+                businessId: String(t.target.feedbackId), processEnum: '20',
+            },
+        });
+    }
+    // 回查校验
+    const back = await listInterviewFeedback(t.host, t.talentId, t.batchId);
+    const backFb = back.find((x) => String(x.feedbackId) === String(t.target.feedbackId));
+    const changed = backFb && String(backFb.result).includes(newResultName) && (args.comment === undefined || String(backFb.judgement).includes(newComment));
+    // 产物链接：人才卡片（点进去可看该候选人的面试与反馈）+ 面试管理列表
+    const cardPageId = String(t.cache.ebdDetailPageId || '');
+    const talentExtra = String(t.cache.selfUse) === '1' ? '&recruitType=useSelf' : '';
+    const talentCardUrl = cardPageId ? `${t.baseUrl}/sp/ebdpage/view/${cardPageId}?talentId=${t.talentId}${talentExtra}` : null;
+    const interviewListId = String((t.cache.lists?.interview?.listId) || '');
+    const interviewListUrl = interviewListId ? `${t.baseUrl}/sp/ebdfpage/list/${interviewListId}` : null;
+    return rsSuccess('recruit-stage.interview.feedback.edit.apply', {
+        mode: 'apply', result: 'success',
+        saveFormData: { 成功: !!savedId, 记录Id: savedId },
+        runEsb: esbRes ? { 动作流数: analysis?.esbIds.length ?? 0, 返回: esbRes?.successNum ?? esbRes?.status ?? 'ok' } : '无 esb 动作流',
+        addProcessLog: processRes ? { 返回: processRes?.data ?? processRes?.status ?? 'ok' } : '无 jsCode 招聘 API',
+        回查: backFb ? { 结果: backFb.result, 评价: backFb.judgement, 已生效: changed } : '回查未取到该反馈',
+        talentId: t.talentId, batchId: t.batchId, 面试: t.target.planName,
+        talentCardUrl,
+        interviewListUrl,
+    });
+}
+export const interviewFeedbackOperations = [
+    {
+        name: 'recruit-stage.interview.feedback.edit.prepare',
+        resource: 'recruit.interview',
+        method: 'prepare',
+        action: 'interview.feedback.edit.prepare',
+        summary: '面试反馈确认摘要：定位反馈记录（feedbackId 或 planIndex）、按钮动作智能解析（保存+esb+招聘API）、当前/新反馈对照，不写入',
+        capability: 'recruit.interview.feedback',
+        risk: 'write',
+        requiresConfirmation: true,
+        inputSchema: schemaOf({
+            talentId: { type: 'string', description: '人才 id（与 mobile 二选一）' },
+            mobile: { type: 'string', pattern: '^\\d{6,20}$', description: '手机号定位（唯一命中）' },
+            feedbackId: { type: 'string', description: '反馈记录 id（最稳；缺省用 planIndex 选第几场）' },
+            planIndex: { type: 'integer', minimum: 0, description: '第几场含反馈的面试（默认 0）' },
+            result: { type: 'string', description: '面试结果（如 通过/不通过/待定，按环境枚举）' },
+            comment: { type: 'string', description: '评价正文' },
+        }, {}),
+        handler: prepare,
+    },
+    {
+        name: 'recruit-stage.interview.feedback.edit.apply',
+        resource: 'recruit.interview',
+        method: 'apply',
+        action: 'interview.feedback.edit.apply',
+        summary: '用户确认后提交反馈：saveFormData（乐观锁全字段集）→ runEsb 动作流 → addProcessLog 过程日志 → 回查校验',
+        capability: 'recruit.interview.feedback',
+        risk: 'write',
+        requiresConfirmation: true,
+        inputSchema: schemaOf({
+            talentId: { type: 'string' }, mobile: { type: 'string', pattern: '^\\d{6,20}$' },
+            feedbackId: { type: 'string' }, planIndex: { type: 'integer', minimum: 0 },
+            result: { type: 'string' }, comment: { type: 'string' },
+            confirm: { type: 'boolean' }, continuation: { type: 'string' },
+        }, {}),
+        handler: apply,
+    },
+];