weaver-e10-builder 1.0.7-beta → 1.0.9-beta

package/dist/services/actionflow/preflight_service.js

@@ -0,0 +1,1247 @@
+import * as formSource from './form_source.js';
+import * as workflowSource from './workflow_source.js';
+import * as personSource from './person_source.js';
+import * as contextSource from './context_source.js';
+import * as hrmSource from './hrm_source.js';
+import { registerTargetFormFields, registerTargetDetailFields, registerWorkflowFieldIds, registerWorkflowContextFields, getWorkflowFieldIds, getWorkflowDetailFields, getWorkflowDetailNames, getTargetFormFields, } from './runtime_metadata.js';
+// workflow_id → 目标表单 id（进程缓存）
+const FORM_ID_CACHE = {};
+import { ContextStore, PlatformContextProvider } from './context_provider.js';
+import { queryNodeContext } from './context_preflight.js';
+import { get as getComponent } from './components/index.js';
+// 表单字段进程缓存
+const FORM_FIELDS_CACHE = {};
+/** 组件表单引用：兼容 params.dataSource/targetForm 与 event/step 顶层写法。 */
+export function stepFormRef(step) {
+    const params = step.params || {};
+    let ref = params.targetForm || params.dataSource;
+    if (!ref || typeof ref !== 'object')
+        ref = step.dataSource || step.targetForm;
+    return ref && typeof ref === 'object' ? ref : null;
+}
+/** 查 form-fields 返回完整字段列表（id/showName/componentKey/paramType），进程缓存。 */
+export async function getFormFieldsFull(formId, client, tf) {
+    if (formId in FORM_FIELDS_CACHE) {
+        registerTargetFormFields(formId, FORM_FIELDS_CACHE[formId]);
+        return FORM_FIELDS_CACHE[formId];
+    }
+    const fields = [];
+    try {
+        const appId = String((tf || {}).groupId || '');
+        const resp = await formSource.getEbField(client, formId, appId);
+        const raw = resp?.data ?? [];
+        let rows = [];
+        if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+            for (const dt of raw.detail || []) {
+                if (!dt || typeof dt !== 'object' || !dt.detailTableId)
+                    continue;
+                registerTargetDetailFields(formId, String(dt.detailTableId), dt.fields || []);
+            }
+            rows.push(...(raw.main || []));
+            for (const dt of raw.detail || []) {
+                if (dt && typeof dt === 'object')
+                    rows.push(...(dt.fields || []));
+            }
+        }
+        else if (Array.isArray(raw)) {
+            rows = raw;
+        }
+        for (const f of rows) {
+            if (!f || typeof f !== 'object' || !f.id)
+                continue;
+            fields.push({
+                ...f,
+                id: String(f.id),
+                showName: String(f.showName || f.name || ''),
+                name: String(f.name || f.showName || ''),
+                componentKey: String(f.componentKey || ''),
+                paramType: String(f.paramType || f.type || '').toLowerCase(),
+                type: String(f.type || f.paramType || 'String'),
+            });
+        }
+    }
+    catch {
+        // 查询失败返回空，由调用方判定
+    }
+    FORM_FIELDS_CACHE[formId] = fields;
+    registerTargetFormFields(formId, fields);
+    return fields;
+}
+/** 在 plan 里查找 form_id 对应的 groupId（无则空串）。 */
+function findTfGroup(plan, formId) {
+    const search = (steps) => {
+        for (const step of steps || []) {
+            if (!step || typeof step !== 'object')
+                continue;
+            const params = step.params || {};
+            if (params && typeof params === 'object') {
+                if (['ActionEbAdd', 'ActionEbUpdate', 'ActionEbDelete', 'ActionEbRecover', 'ActionEbSaveVersion', 'EbGetDataById'].includes(step.type)) {
+                    const tf = params.targetForm;
+                    if (tf && typeof tf === 'object' && String(tf.id || '') === String(formId))
+                        return String(tf.groupId || '');
+                }
+                if (['EventFormData', 'TimeBatchTrigger', 'DateTrigger', 'EnquiryForm'].includes(step.type)) {
+                    const ds = stepFormRef(step);
+                    if (ds && String(ds.id || '') === String(formId))
+                        return String(ds.groupId || '');
+                }
+                if (step.type === 'Condition') {
+                    for (const branch of step.branches || []) {
+                        if (branch && typeof branch === 'object') {
+                            const g = search(branch.actions || []);
+                            if (g)
+                                return g;
+                        }
+                    }
+                }
+            }
+        }
+        return '';
+    };
+    return search(plan.actions || []);
+}
+/** 回填 plan 里 targetForm 缺失的 groupId/name/text/groupName。返回无法解析的表单 id 列表。 */
+export async function resolveTargetForms(plan, client) {
+    const normalizeRef = (ref) => {
+        if (!ref || typeof ref !== 'object')
+            return;
+        if (!ref.id && ref.tableId)
+            ref.id = String(ref.tableId);
+        if (!ref.groupId && ref.appId)
+            ref.groupId = String(ref.appId);
+    };
+    const normalizeSteps = (steps) => {
+        for (const step of steps || []) {
+            if (!step || typeof step !== 'object')
+                continue;
+            const params = step.params || {};
+            if (params && typeof params === 'object') {
+                normalizeRef(params.targetForm);
+                normalizeRef(params.dataSource);
+            }
+            if (step.type === 'Condition') {
+                for (const branch of step.branches || []) {
+                    if (branch && typeof branch === 'object')
+                        normalizeSteps(branch.actions || []);
+                }
+            }
+        }
+    };
+    const event = plan.event;
+    if (event && typeof event === 'object') {
+        const ep = event.params || {};
+        if (ep && typeof ep === 'object') {
+            normalizeRef(ep.targetForm);
+            normalizeRef(ep.dataSource);
+        }
+    }
+    normalizeSteps(plan.actions || []);
+    const unresolved = [];
+    const collect = (steps) => {
+        for (const step of steps || []) {
+            if (!step || typeof step !== 'object')
+                continue;
+            if (['ActionEbAdd', 'ActionEbUpdate', 'ActionEbDelete', 'ActionEbRecover', 'ActionEbSaveVersion', 'EbGetDataById'].includes(step.type)) {
+                const tf = (step.params || {}).targetForm;
+                if (tf && typeof tf === 'object' && tf.id) {
+                    if (!tf.groupId || !tf.name || !tf.text || !tf.groupName)
+                        unresolved.push(String(tf.id));
+                }
+            }
+            if (step.type === 'Condition') {
+                for (const branch of step.branches || []) {
+                    if (branch && typeof branch === 'object')
+                        collect(branch.actions || []);
+                }
+            }
+            if (['EventFormData', 'TimeBatchTrigger', 'DateTrigger', 'EnquiryForm'].includes(step.type)) {
+                const ds = (step.params || {}).dataSource || (step.params || {}).targetForm;
+                if (ds && typeof ds === 'object' && ds.id) {
+                    if (!ds.groupId || !ds.name || !ds.text || !ds.groupName)
+                        unresolved.push(String(ds.id));
+                }
+            }
+        }
+    };
+    if (event && typeof event === 'object') {
+        const ep = event.params || {};
+        if (ep && typeof ep === 'object') {
+            const es = ep.targetForm || ep.dataSource;
+            if (es && typeof es === 'object' && es.id) {
+                if (!es.groupId || !es.name || !es.text || !es.groupName)
+                    unresolved.push(String(es.id));
+            }
+        }
+    }
+    collect(plan.actions || []);
+    if (!unresolved.length)
+        return [];
+    let appNames = null;
+    const applicationName = async (groupId) => {
+        if (appNames === null) {
+            appNames = {};
+            try {
+                const apps = await formSource.dsGroup(client);
+                for (const app of apps?.data || []) {
+                    if (app && typeof app === 'object' && app.id)
+                        appNames[String(app.id)] = String(app.name || '');
+                }
+            }
+            catch {
+                // 忽略
+            }
+        }
+        return appNames[groupId] || '';
+    };
+    const groupForms = async (groupId) => {
+        const idx = {};
+        try {
+            const forms = await formSource.dsList(client, groupId);
+            for (const f of forms?.data || []) {
+                if (f && typeof f === 'object' && f.id) {
+                    idx[String(f.id)] = { groupId, groupName: await applicationName(groupId), name: String(f.name || '') };
+                }
+            }
+        }
+        catch {
+            // 忽略
+        }
+        return idx;
+    };
+    const groupIds = new Set();
+    const collectGroups = (steps) => {
+        for (const step of steps || []) {
+            if (!step || typeof step !== 'object')
+                continue;
+            const params = step.params || {};
+            if (params && typeof params === 'object') {
+                if (['ActionEbAdd', 'ActionEbUpdate', 'ActionEbDelete', 'ActionEbRecover', 'ActionEbSaveVersion', 'EbGetDataById'].includes(step.type)) {
+                    const tf = params.targetForm;
+                    if (tf && typeof tf === 'object' && tf.groupId)
+                        groupIds.add(String(tf.groupId));
+                }
+                if (['EventFormData', 'TimeBatchTrigger', 'DateTrigger', 'EnquiryForm'].includes(step.type)) {
+                    const ds = params.dataSource || params.targetForm;
+                    if (ds && typeof ds === 'object' && ds.groupId)
+                        groupIds.add(String(ds.groupId));
+                }
+                if (step.type === 'Condition') {
+                    for (const branch of step.branches || []) {
+                        if (branch && typeof branch === 'object')
+                            collectGroups(branch.actions || []);
+                    }
+                }
+            }
+        }
+    };
+    collectGroups(plan.actions || []);
+    if (event && typeof event === 'object') {
+        const ep = event.params || {};
+        if (ep && typeof ep === 'object') {
+            const es = ep.targetForm || ep.dataSource;
+            if (es && typeof es === 'object' && es.groupId)
+                groupIds.add(String(es.groupId));
+        }
+    }
+    const formIndex = {};
+    for (const gid of groupIds) {
+        Object.assign(formIndex, await groupForms(gid));
+    }
+    const stillMissing = [];
+    for (const fid of unresolved) {
+        let info = formIndex[fid];
+        if (!info) {
+            const gid = findTfGroup(plan, fid);
+            if (gid) {
+                Object.assign(formIndex, await groupForms(gid));
+                info = formIndex[fid];
+            }
+        }
+        if (!info) {
+            stillMissing.push(fid);
+            continue;
+        }
+        const patch = (steps) => {
+            for (const step of steps || []) {
+                if (!step || typeof step !== 'object')
+                    continue;
+                if (['ActionEbAdd', 'ActionEbUpdate', 'ActionEbDelete', 'ActionEbRecover', 'ActionEbSaveVersion', 'EbGetDataById'].includes(step.type)) {
+                    const tf = (step.params || {}).targetForm;
+                    if (tf && typeof tf === 'object' && String(tf.id || '') === fid) {
+                        tf.groupId = info.groupId;
+                        if (!String(tf.name || '').trim())
+                            tf.name = info.name;
+                        if (!String(tf.text || '').trim())
+                            tf.text = info.name;
+                        if (!String(tf.groupName || '').trim())
+                            tf.groupName = info.groupName;
+                    }
+                }
+                if (['EventFormData', 'TimeBatchTrigger', 'DateTrigger', 'EnquiryForm'].includes(step.type)) {
+                    const ds = (step.params || {}).dataSource || (step.params || {}).targetForm;
+                    if (ds && typeof ds === 'object' && String(ds.id || '') === fid) {
+                        ds.groupId = info.groupId;
+                        if (!String(ds.name || '').trim())
+                            ds.name = info.name;
+                        if (!String(ds.text || '').trim())
+                            ds.text = info.name;
+                        if (!String(ds.groupName || '').trim())
+                            ds.groupName = info.groupName;
+                    }
+                }
+                if (step.type === 'Condition') {
+                    for (const branch of step.branches || []) {
+                        if (branch && typeof branch === 'object')
+                            patch(branch.actions || []);
+                    }
+                }
+            }
+        };
+        patch(plan.actions || []);
+        if (event && typeof event === 'object') {
+            const ep = event.params || {};
+            if (ep && typeof ep === 'object') {
+                const es = ep.targetForm || ep.dataSource;
+                if (es && typeof es === 'object' && String(es.id || '') === fid) {
+                    es.groupId = info.groupId;
+                    if (!String(es.name || '').trim())
+                        es.name = info.name;
+                    if (!String(es.text || '').trim())
+                        es.text = info.name;
+                    if (!String(es.groupName || '').trim())
+                        es.groupName = info.groupName;
+                }
+            }
+        }
+    }
+    return stillMissing;
+}
+/** 为必填的表单定时触发器补一个当前租户真实操作人。 */
+export async function fillRequiredTriggerOperator(plan, client) {
+    const event = plan.event;
+    if (!event || typeof event !== 'object' || !['DateTrigger', 'TimeBatchTrigger'].includes(event.type))
+        return [];
+    const params = event.params ??= {};
+    if (typeof params !== 'object' || params.operator)
+        return [];
+    const response = await personSource.resourceData(client, '', 1, 30);
+    const rows = response?.data?.data || [];
+    const candidates = rows.filter((r) => r && typeof r === 'object' && r.id && String(r.statusCode || 'normal') === 'normal');
+    if (!candidates.length)
+        return [];
+    const chosen = candidates.sort((a, b) => String(a.id).localeCompare(String(b.id)))[0];
+    const value = { id: String(chosen.id), name: String(chosen.name || chosen.content || '') };
+    params.operator = value;
+    const record = { path: 'event.params.operator', resourceType: 'user_assignment', value, reason: '操作人必填但需求未指定；从当前租户人员浏览器选择真实可用人员' };
+    (plan._autoResources ??= []).push(record);
+    return [record];
+}
+function isBrowserPerson(value) {
+    return value && typeof value === 'object' && Boolean(value.id) && Boolean(value.originTargetType || value.mainId || value.userid);
+}
+function walkPlanSteps(value) {
+    const steps = [];
+    const walk = (v) => {
+        if (v && typeof v === 'object' && !Array.isArray(v)) {
+            if (typeof v.type === 'string' && typeof v.params === 'object')
+                steps.push(v);
+            for (const child of Object.values(v))
+                walk(child);
+        }
+        else if (Array.isArray(v)) {
+            for (const child of v)
+                walk(child);
+        }
+    };
+    walk(value);
+    return steps[Symbol.iterator]();
+}
+/** 把显式固定人员展开为当前租户 Browser 对象。 */
+export async function resolveFixedPeople(plan, client) {
+    const records = [];
+    for (const step of walkPlanSteps(plan.actions || [])) {
+        const componentType = String(step.type || '');
+        const contract = getComponent(componentType);
+        const personKeys = Object.entries(contract?.params || {})
+            .filter(([, definition]) => String(definition?.referenceType || '').startsWith('user_assignment'))
+            .map(([key]) => key);
+        // 会议字段在 meetingFields 中承载，属于组件特有嵌套结构，无法从顶层 params 推导。
+        if (componentType === 'MeetingCreate')
+            personKeys.push('caller', 'contacter', 'hrmMembers');
+        if (!personKeys.length)
+            continue;
+        const params = step.params || {};
+        const fields = params.meetingFields;
+        const containers = [];
+        if (fields && typeof fields === 'object')
+            containers.push(['meetingFields', fields]);
+        containers.push(['params', params]);
+        for (const [containerName, container] of containers) {
+            for (const key of personKeys) {
+                const raw = container[key];
+                if (raw == null)
+                    continue;
+                const values = Array.isArray(raw) ? raw : [raw];
+                if (values.length && values.every((item) => isBrowserPerson(item)))
+                    continue;
+                if (!values.length || !values.every((item) => item && typeof item === 'object' && item.id))
+                    continue;
+                const resolved = [];
+                for (const item of values) {
+                    const query = String(item.name || item.id);
+                    const response = await personSource.resourceData(client, query, 1, 30);
+                    const rows = response?.data?.data || [];
+                    const match = rows.find((r) => r && typeof r === 'object' && String(r.id) === String(item.id));
+                    if (!match)
+                        throw new Error(`${componentType}.${key} 的人员 id=${item.id} 不在当前租户人员浏览器中，无法生成可回显的 Browser 对象`);
+                    resolved.push(match);
+                }
+                container[key] = Array.isArray(raw) ? resolved : resolved[0];
+                records.push({
+                    path: `${componentType}.${containerName}.${key}`,
+                    resourceType: 'user_browser',
+                    value: resolved.map((item) => ({ id: String(item.id), name: String(item.name || item.content || '') })),
+                    reason: '固定人员已从当前租户人员浏览器补全为真实对象，保留头像、部门等设计器展示字段',
+                });
+            }
+        }
+    }
+    if (records.length)
+        (plan._autoResources ??= []).push(...records);
+    return records;
+}
+/** 委托流程的两张设置表在每个租户都有独立字段 ID，生成前必须实时读取。 */
+export async function resolveEntrustFields(plan, client, errors) {
+    for (const step of walkPlanSteps(plan.actions || [])) {
+        if (step.type !== 'ApproveEntrust')
+            continue;
+        const params = step.params || {};
+        try {
+            const response = await contextSource.getComponentContext(client, 'ApproveEntrust', {
+                type: 'ApproveEntrust', module: 'workflow', ebActionId: '-1',
+            });
+            const tables = Array.isArray(response?.data) ? response.data : [];
+            const fields = {};
+            for (const table of tables) {
+                for (const field of table?.tableData || []) {
+                    const key = String(field?.paramKey || '');
+                    if (!key.startsWith('entrysetting.') && !key.startsWith('entrysettingCommon.'))
+                        continue;
+                    const name = key.slice(key.lastIndexOf('.') + 1);
+                    if (name && field?.id)
+                        fields[name] = { id: String(field.id), componentKey: String(field.componentKey || 'Text') };
+                }
+            }
+            const required = ['entrustUserId', 'beAgentIdentities', 'consigneeId', 'entrustType'];
+            const missing = required.filter((key) => !fields[key]);
+            if (missing.length) {
+                errors.push(`ApproveEntrust: 当前租户未返回委托设置字段 ${missing.join(', ')}，拒绝生成。`);
+            }
+            else {
+                params._entrustFields = fields;
+            }
+            const entrustUserId = String(params.entrustUser?.id || '');
+            const identityId = String(params.identityId || '');
+            if (entrustUserId && identityId) {
+                const identities = await client.get(`${client.getBaseUrl()}/api/bs/esb/setting/component/getBeAgentIdentities?empId=${encodeURIComponent(entrustUserId)}`);
+                const rows = Array.isArray(identities?.data) ? identities.data : [];
+                const allowed = new Set(rows.map((item) => String(item.extraInfoId)).filter(Boolean));
+                if (rows.length)
+                    allowed.add('all');
+                if (!allowed.has(identityId)) {
+                    errors.push(`ApproveEntrust.identityId='${identityId}' 不属于委托人 ${entrustUserId} 的当前可用身份；不能伪造身份。`);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`ApproveEntrust: 无法读取当前租户委托设置字段 (${error?.message || error})。`);
+        }
+    }
+}
+/** ApproveCreate 新建流程：调 getWfField 拿目标流程真实表单字段。 */
+export async function resolveBizCreateFields(step, plan, client, errors, path) {
+    const params = (step.params || {});
+    const wfPath = params.workflowPath || {};
+    const wfId = String(wfPath.id || wfPath.createFlowId || '');
+    if (!wfId) {
+        errors.push(`${path}.params.workflowPath.id 缺失 (新建流程必须指定目标流程)`);
+        return;
+    }
+    try {
+        const resp = await workflowSource.getWfField(client, wfId);
+        let data = resp?.data ?? {};
+        if (resp?.code === 200) {
+            if (Array.isArray(data))
+                data = { main: data, detail: [] };
+            if (data && typeof data === 'object') {
+                let main = Array.isArray(data.main) ? data.main : [];
+                const bizFields = {
+                    main: main.map((f) => ({
+                        id: String(f.id || ''), showName: String(f.showName || ''),
+                        componentKey: String(f.componentKey || ''), formId: String(f.formId || ''),
+                        required: Boolean(f.required), custom: Boolean(f.custom), subFormId: String(f.subFormId || '-1'),
+                    })),
+                    detail: data.detail || [],
+                };
+                params._bizFields = bizFields;
+                let formIds = (wfPath.formIds ? (Array.isArray(wfPath.formIds) ? wfPath.formIds : [wfPath.formIds]) : []).map(String);
+                if (!formIds.length) {
+                    formIds = [...new Set(main.map((f) => f && f.formId ? String(f.formId) : '').filter(Boolean))];
+                    if (formIds.length)
+                        wfPath.formIds = formIds;
+                }
+                if (!formIds.length) {
+                    errors.push(`${path}.params.workflowPath.formIds 缺失: getWfField 未返回目标流程主表 formId，无法安全保存新建流程；请确认目标流程已绑定表单。`);
+                }
+                const allFieldIds = new Set(bizFields.main.map((f) => f.id));
+                for (const dt of bizFields.detail) {
+                    if (dt && typeof dt === 'object') {
+                        for (const df of dt.fields || []) {
+                            if (df && typeof df === 'object' && df.id)
+                                allFieldIds.add(String(df.id));
+                        }
+                    }
+                }
+                const mapping = params.mapping || {};
+                if (mapping && typeof mapping === 'object') {
+                    for (const [srcKey, targetFid] of Object.entries(mapping)) {
+                        const tid = targetFid && typeof targetFid === 'object' ? String(targetFid.target || targetFid.fieldId || '') : String(targetFid);
+                        if (tid && !allFieldIds.has(tid))
+                            errors.push(`${path}.params.mapping['${srcKey}'] 目标字段 '${targetFid}' 不存在于目标流程 '${wfId}' 的表单字段中`);
+                    }
+                }
+                const constants = params.constants || {};
+                if (constants && typeof constants === 'object') {
+                    for (const targetFid of Object.keys(constants)) {
+                        if (!allFieldIds.has(String(targetFid)))
+                            errors.push(`${path}.params.constants['${targetFid}'] 目标字段不存在于目标流程 '${wfId}' 的表单字段中`);
+                    }
+                }
+                for (const [di, ditem] of (params.detail || []).entries()) {
+                    if (!ditem || typeof ditem !== 'object')
+                        continue;
+                    const dm = ditem.mapping || {};
+                    if (typeof dm !== 'object')
+                        continue;
+                    for (const [sk, tv] of Object.entries(dm)) {
+                        const tid2 = tv && typeof tv === 'object' ? String(tv.target || tv.fieldId || '') : String(tv);
+                        if (tid2 && !allFieldIds.has(tid2))
+                            errors.push(`${path}.params.detail[${di}].mapping['${sk}'] 目标字段 '${tid2}' 不存在于目标流程 '${wfId}' 的表单字段中 (明细表子字段 id 必须实时查全量, 禁止推算)`);
+                    }
+                }
+            }
+        }
+    }
+    catch (e) {
+        errors.push(`${path}: getWfField 查询目标流程字段失败: ${e?.message || e}`);
+    }
+}
+/** 硬性校验 mapping 源字段引用必须真实存在于 event 上下文中。 */
+export function checkSourceReferences(plan, eventContextFields, errors) {
+    const realKeys = new Set();
+    for (const field of eventContextFields) {
+        if (!field || typeof field !== 'object')
+            continue;
+        const pk = String(field.paramKey || '');
+        if (pk) {
+            realKeys.add(pk);
+            realKeys.add(pk.replace(/\[\]$/, ''));
+        }
+    }
+    const skip = (s) => {
+        const t = s.trim();
+        if (!t || t.startsWith('{'))
+            return true;
+        if (!t.includes('.'))
+            return true;
+        return false;
+    };
+    const checkSourceKey = (sourceKey, where) => {
+        const s = sourceKey.trim();
+        if (skip(s))
+            return;
+        if (!realKeys.has(s.replace(/\[\]$/, ''))) {
+            const wfId = s.split('.', 1)[0];
+            errors.push(`${where}: 源字段 paramKey '${s}' 未在流程 ${wfId} 的真实上下文中找到。请用 workflow-context-fields 确认该流程和字段真实存在。`);
+        }
+    };
+    const checkMapping = (mapping, where) => {
+        if (!mapping || typeof mapping !== 'object')
+            return;
+        for (const srcKey of Object.keys(mapping))
+            checkSourceKey(String(srcKey), where);
+    };
+    const walk = (steps, prefix = 'actions') => {
+        for (const [idx, step] of (steps || []).entries()) {
+            if (!step || typeof step !== 'object')
+                continue;
+            const params = step.params || {};
+            const path = `${prefix}[${idx}]`;
+            if (['ActionEbAdd', 'ActionEbUpdate', 'ActionEbDelete', 'ActionEbRecover', 'ActionEbSaveVersion', 'EbGetDataById'].includes(step.type)) {
+                if (params && typeof params === 'object') {
+                    checkMapping(params.mapping, `${path}.mapping`);
+                    const bv = params.basisValue;
+                    if (bv && typeof bv === 'object')
+                        checkSourceKey(String(bv.paramKey || bv.key || ''), `${path}.basisValue`);
+                    for (const [di, det] of (params.detail || []).entries()) {
+                        if (det && typeof det === 'object')
+                            checkMapping(det.mapping, `${path}.detail[${di}].mapping`);
+                    }
+                }
+            }
+            if (step.type === 'ApproveCreate') {
+                if (params && typeof params === 'object') {
+                    checkMapping(params.mapping, `${path}.mapping`);
+                    for (const [di, det] of (params.detail || []).entries()) {
+                        if (det && typeof det === 'object')
+                            checkMapping(det.mapping, `${path}.detail[${di}].mapping`);
+                    }
+                }
+            }
+            if (step.type === 'MultipleExecution') {
+                for (const fieldName of ['cycleTimes', 'detailData', 'batchDetailData']) {
+                    const formula = params?.[fieldName];
+                    if (formula && typeof formula === 'object' && ['context', 'reference'].includes(String(formula.kind ?? formula.assignmentKind ?? ''))) {
+                        checkSourceKey(String(formula.paramKey || formula.key || formula.fieldKey || ''), `${path}.${fieldName}`);
+                    }
+                }
+                walk(step.actions || [], `${path}.actions`);
+            }
+            if (step.type === 'Condition') {
+                for (const [bi, branch] of (step.branches || []).entries()) {
+                    if (branch && typeof branch === 'object')
+                        walk(branch.actions || [], `${path}.branches[${bi}].actions`);
+                }
+            }
+        }
+    };
+    walk(plan.actions || []);
+}
+function hydrateLoopCycleTimes(plan, eventContextFields) {
+    const byKey = new Map();
+    for (const field of eventContextFields) {
+        if (field && typeof field === 'object' && field.paramKey)
+            byKey.set(String(field.paramKey), field);
+    }
+    const walk = (steps) => {
+        for (const step of steps || []) {
+            if (!step || typeof step !== 'object')
+                continue;
+            if (step.type === 'MultipleExecution') {
+                for (const fieldName of ['cycleTimes', 'detailData', 'batchDetailData']) {
+                    const formula = step.params?.[fieldName];
+                    const kind = String(formula?.kind ?? formula?.assignmentKind ?? '');
+                    if (!formula || typeof formula !== 'object' || !['context', 'reference'].includes(kind))
+                        continue;
+                    const paramKey = String(formula.paramKey ?? formula.key ?? formula.fieldKey ?? '');
+                    const field = byKey.get(paramKey);
+                    if (field) {
+                        const label = String(field.showName || field.paramName || paramKey);
+                        const workflowId = String(plan.event?.params?.workflowPath?.id || '');
+                        formula.paramKey = String(field.paramKey);
+                        formula.label = label;
+                        formula.valueType = String(field.paramType || field.fieldType || 'string');
+                        formula.fieldType = String(field.paramType || field.fieldType || 'string');
+                        formula._resolvedContext = {
+                            fieldId: String(field.id || field.paramId || ''),
+                            fieldType: String(field.paramType || field.fieldType || 'string'),
+                            label,
+                            componentType: 'ApproveTrigger',
+                            tablePrimaryKey: 'ApprovalData',
+                            tableName: '流程数据',
+                            parentName: workflowId ? `${workflowId}.${label}` : label,
+                            rawField: { ...field },
+                        };
+                    }
+                }
+                walk(step.actions || []);
+            }
+            if (step.type === 'Condition')
+                for (const branch of step.branches || [])
+                    walk(branch?.actions || []);
+        }
+    };
+    walk(plan.actions || []);
+}
+/**
+ * 循环体里的 scope=current_loop 引用必须使用循环节点 getComponentContext 返回的
+ * CycleParams 元数据。这里补 fieldId/类型/名称，供 FormulaBean 的 frontId 和
+ * 配置字段直接复用；不将它误识别成流程表单 FormData。
+ */
+function hydrateCurrentLoopReferences(steps, context) {
+    const walkValue = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                walkValue(item);
+            return;
+        }
+        if (!value || typeof value !== 'object')
+            return;
+        if (String(value.scope ?? value.contextScope ?? '') === 'current_loop') {
+            const paramKey = String(value.paramKey ?? value.key ?? value.fieldKey ?? '');
+            const field = context[paramKey];
+            if (field && typeof field === 'object') {
+                const raw = field.raw && typeof field.raw === 'object' ? field.raw : {};
+                const label = String(field.label ?? raw.showName ?? raw.paramName ?? paramKey);
+                const fieldType = String(field.type ?? raw.paramType ?? 'int');
+                value.paramKey = paramKey;
+                value.label = label;
+                value.valueType = fieldType;
+                value.fieldType = fieldType;
+                value._resolvedContext = {
+                    fieldId: String(raw.id ?? raw.paramId ?? value.frontId ?? paramKey),
+                    fieldType,
+                    label,
+                    componentType: 'MultipleExecution',
+                    tablePrimaryKey: 'CycleParams',
+                    tableName: '循环参数',
+                    parentName: `循环.${label}`,
+                    rawField: raw,
+                };
+            }
+        }
+        for (const child of Object.values(value))
+            walkValue(child);
+    };
+    for (const step of steps || [])
+        walkValue(step?.params || {});
+}
+/** 显式 mapping 也必须带实时显示名（label）。 */
+export function hydrateMappingLabels(plan, eventContextFields) {
+    const labelByParamKey = {};
+    for (const field of eventContextFields) {
+        if (field && typeof field === 'object' && field.paramKey) {
+            labelByParamKey[String(field.paramKey)] = String(field.showName || field.paramName || '');
+        }
+    }
+    const hydrate = (steps) => {
+        for (const step of steps || []) {
+            if (!step || typeof step !== 'object')
+                continue;
+            const params = step.params || {};
+            const mapping = params && typeof params === 'object' ? params.mapping : null;
+            if (mapping && typeof mapping === 'object') {
+                for (const [sourceKey, target] of Object.entries(mapping)) {
+                    const label = labelByParamKey[String(sourceKey)] || '';
+                    if (!label)
+                        continue;
+                    if (target && typeof target === 'object') {
+                        target.paramKey ??= String(sourceKey);
+                        target.label ??= label;
+                    }
+                    else {
+                        mapping[sourceKey] = { target: String(target), paramKey: String(sourceKey), label };
+                    }
+                }
+            }
+            if (params && typeof params === 'object') {
+                for (const detail of params.detail || []) {
+                    if (!detail || typeof detail !== 'object' || typeof detail.mapping !== 'object')
+                        continue;
+                    for (const [sourceKey, target] of Object.entries(detail.mapping)) {
+                        const sourceParamKey = target && typeof target === 'object' ? String(target.paramKey || sourceKey) : String(sourceKey);
+                        const label = labelByParamKey[sourceParamKey] || '';
+                        if (!label)
+                            continue;
+                        if (target && typeof target === 'object') {
+                            target.paramKey ??= sourceParamKey;
+                            target.label ??= label;
+                        }
+                        else {
+                            detail.mapping[sourceKey] = { target: String(target), paramKey: sourceParamKey, label };
+                        }
+                    }
+                }
+            }
+            if (step.type === 'Condition') {
+                for (const branch of step.branches || []) {
+                    if (branch && typeof branch === 'object')
+                        hydrate(branch.actions || []);
+                }
+            }
+        }
+    };
+    hydrate(plan.actions || []);
+}
+// ── sync 系列（preflight 注入 plan → 同步到 compile 产物 draft）──
+export function syncAutoMappingsToDraft(draft, plan) {
+    const planActions = plan.actions || [];
+    const draftActions = draft.actions || [];
+    for (let i = 0; i < planActions.length && i < draftActions.length; i++) {
+        const pa = planActions[i], da = draftActions[i];
+        if (!pa || !da || typeof pa !== 'object' || typeof da !== 'object')
+            continue;
+        const pm = pa.params?.mapping, dm = da.params?.mapping;
+        if (pm)
+            da.params.mapping = pm;
+    }
+}
+export function syncFormReferencesToDraft(draft, plan) {
+    const syncStep = (planStep, draftStep) => {
+        if (!planStep || !draftStep || typeof planStep !== 'object' || typeof draftStep !== 'object')
+            return;
+        const pp = planStep.params, dp = draftStep.params;
+        if (pp && typeof pp === 'object' && dp && typeof dp === 'object') {
+            for (const key of ['targetForm', 'dataSource']) {
+                const ref = pp[key];
+                if (ref && typeof ref === 'object' && ref.id)
+                    dp[key] = { ...ref };
+            }
+        }
+        const pb = planStep.branches, db = draftStep.branches;
+        if (Array.isArray(pb) && Array.isArray(db)) {
+            for (let i = 0; i < pb.length && i < db.length; i++) {
+                const pa2 = pb[i]?.actions || [], da2 = db[i]?.actions || [];
+                for (let j = 0; j < pa2.length && j < da2.length; j++)
+                    syncStep(pa2[j], da2[j]);
+            }
+        }
+    };
+    syncStep(plan.event, draft.event);
+    const planActions = plan.actions || [];
+    const draftActions = draft.actions || [];
+    for (let i = 0; i < planActions.length && i < draftActions.length; i++)
+        syncStep(planActions[i], draftActions[i]);
+}
+export function syncEventResourcesToDraft(draft, plan) {
+    const pe = plan.event, de = draft.event;
+    if (!pe || !de || typeof pe !== 'object' || typeof de !== 'object')
+        return;
+    const pp = pe.params, dp = de.params;
+    if (!pp || !dp || typeof pp !== 'object' || typeof dp !== 'object')
+        return;
+    if (['DateTrigger', 'TimeBatchTrigger'].includes(pe.type) && pp.operator)
+        dp.operator = pp.operator;
+}
+export function syncFixedPeopleToDraft(draft, plan) {
+    const syncStep = (planStep, draftStep) => {
+        if (!planStep || !draftStep || typeof planStep !== 'object' || typeof draftStep !== 'object')
+            return;
+        const type = String(planStep.type || '');
+        const contract = getComponent(type);
+        const personKeys = Object.entries(contract?.params || {})
+            .filter(([, definition]) => String(definition?.referenceType || '').startsWith('user_assignment'))
+            .map(([key]) => key);
+        // 会议的召集人/联系人存在 meetingFields 中，是该组件特有的嵌套字段。
+        if (type === 'MeetingCreate')
+            personKeys.push('caller', 'contacter', 'hrmMembers');
+        const pp = planStep.params;
+        const dp = draftStep.params;
+        if (personKeys.length && pp && dp && typeof pp === 'object' && typeof dp === 'object') {
+            const containers = [[pp, dp]];
+            if (typeof pp.meetingFields === 'object' && typeof dp.meetingFields === 'object')
+                containers.push([pp.meetingFields, dp.meetingFields]);
+            for (const [planContainer, draftContainer] of containers) {
+                for (const key of personKeys) {
+                    const value = planContainer[key];
+                    if (value == null)
+                        continue;
+                    const values = Array.isArray(value) ? value : [value];
+                    if (values.length && values.every((item) => isBrowserPerson(item)))
+                        draftContainer[key] = value;
+                }
+            }
+        }
+        const planBranches = planStep.branches || [];
+        const draftBranches = draftStep.branches || [];
+        for (let i = 0; i < planBranches.length && i < draftBranches.length; i++) {
+            const planActions = planBranches[i]?.actions || [];
+            const draftActions = draftBranches[i]?.actions || [];
+            for (let j = 0; j < planActions.length && j < draftActions.length; j++)
+                syncStep(planActions[j], draftActions[j]);
+        }
+        const planActions = planStep.actions || [];
+        const draftActions = draftStep.actions || [];
+        for (let i = 0; i < planActions.length && i < draftActions.length; i++)
+            syncStep(planActions[i], draftActions[i]);
+    };
+    const planActions = plan.actions || [];
+    const draftActions = draft.actions || [];
+    for (let i = 0; i < planActions.length && i < draftActions.length; i++)
+        syncStep(planActions[i], draftActions[i]);
+}
+export function syncBizFieldsToDraft(draft, plan) {
+    const planActions = plan.actions || [];
+    const draftActions = draft.actions || [];
+    for (let i = 0; i < planActions.length && i < draftActions.length; i++) {
+        const pa = planActions[i], da = draftActions[i];
+        if (!pa || !da || typeof pa !== 'object' || typeof da !== 'object')
+            continue;
+        if (pa.type !== 'ApproveCreate')
+            continue;
+        const pp = pa.params;
+        if (!pp || typeof pp !== 'object' || !pp._bizFields)
+            continue;
+        const dp = da.params ??= {};
+        if (typeof dp === 'object')
+            dp._bizFields = pp._bizFields;
+    }
+}
+export function syncEntrustFieldsToDraft(draft, plan) {
+    const syncStep = (planStep, draftStep) => {
+        if (!planStep || !draftStep || typeof planStep !== 'object' || typeof draftStep !== 'object')
+            return;
+        if (planStep.type === 'ApproveEntrust' && planStep.params?._entrustFields && draftStep.params) {
+            draftStep.params._entrustFields = planStep.params._entrustFields;
+        }
+        const planBranches = planStep.branches || [];
+        const draftBranches = draftStep.branches || [];
+        for (let i = 0; i < planBranches.length && i < draftBranches.length; i++) {
+            const pa = planBranches[i]?.actions || [], da = draftBranches[i]?.actions || [];
+            for (let j = 0; j < pa.length && j < da.length; j++)
+                syncStep(pa[j], da[j]);
+        }
+    };
+    for (let i = 0; i < (plan.actions || []).length && i < (draft.actions || []).length; i++)
+        syncStep(plan.actions[i], draft.actions[i]);
+}
+/** 入职/更新人员的字段定义是租户实时数据；只把读取结果注入本次 draft，不落盘到 Skill。 */
+export function syncHrmFieldSchemasToDraft(draft, plan) {
+    const syncNode = (planStep, draftStep) => {
+        if (!planStep || !draftStep || typeof planStep !== 'object' || typeof draftStep !== 'object')
+            return;
+        if (['PersonnelOnboarding', 'HrmEmployeeUpdate'].includes(String(planStep.type)) && planStep.params?._hrmFieldSchema && draftStep.params) {
+            draftStep.params._hrmFieldSchema = planStep.params._hrmFieldSchema;
+        }
+        const planBranches = planStep.branches || [], draftBranches = draftStep.branches || [];
+        for (let i = 0; i < planBranches.length && i < draftBranches.length; i++)
+            syncSteps(planBranches[i]?.actions || [], draftBranches[i]?.actions || []);
+        if (Array.isArray(planStep.actions) && Array.isArray(draftStep.actions))
+            syncSteps(planStep.actions, draftStep.actions);
+    };
+    const syncSteps = (planSteps, draftSteps) => {
+        for (let i = 0; i < planSteps.length && i < draftSteps.length; i++)
+            syncNode(planSteps[i], draftSteps[i]);
+    };
+    syncSteps(plan.actions || [], draft.actions || []);
+}
+async function resolveHrmFieldAssignments(plan, client, errors) {
+    let schema = null;
+    const fetchSchema = async () => {
+        if (schema)
+            return schema;
+        const response = await hrmSource.getHrmOnboardingFields(client);
+        schema = response?.data;
+        if (!schema || !Array.isArray(schema.main))
+            throw new Error('hrm-onboarding-fields 未返回有效字段定义');
+        return schema;
+    };
+    const validateFields = (values, fields, path) => {
+        if (!values || typeof values !== 'object' || Array.isArray(values) || !Object.keys(values).length) {
+            errors.push(`${path} 至少配置一个字段。`);
+            return;
+        }
+        for (const key of Object.keys(values)) {
+            const hits = fields.filter((field) => String(field.id || '') === key || String(field.showName || field.name || '') === key);
+            if (!hits.length)
+                errors.push(`${path}: 字段 '${key}' 不在当前租户人员字段定义中。`);
+            else if (hits.length > 1)
+                errors.push(`${path}: 字段名 '${key}' 重名，请改传字段 ID。`);
+        }
+    };
+    const walk = async (steps, path) => {
+        for (let index = 0; index < (steps || []).length; index++) {
+            const step = steps[index];
+            if (!step || typeof step !== 'object')
+                continue;
+            const stepPath = `${path}[${index}]`;
+            if (['PersonnelOnboarding', 'HrmEmployeeUpdate'].includes(String(step.type))) {
+                const params = step.params || {};
+                if (!params.fieldAssignments) {
+                    errors.push(`${stepPath}.params.fieldAssignments 为必填项；请使用语义化字段赋值，不要传 setting DTO。`);
+                    continue;
+                }
+                try {
+                    const current = await fetchSchema();
+                    params._hrmFieldSchema = current;
+                    validateFields(params.fieldAssignments.main, current.main || [], `${stepPath}.params.fieldAssignments.main`);
+                    if (params.fieldAssignments.detail !== undefined) {
+                        if (!Array.isArray(params.fieldAssignments.detail))
+                            errors.push(`${stepPath}.params.fieldAssignments.detail 必须是数组。`);
+                        else
+                            for (const item of params.fieldAssignments.detail) {
+                                const tableKey = String(item?.tableId ?? item?.table ?? item?.tableName ?? '');
+                                const tables = (current.detail || []).filter((table) => String(table.detailTableId || '') === tableKey || String(table.tableName || '') === tableKey);
+                                if (tables.length !== 1)
+                                    errors.push(`${stepPath}.params.fieldAssignments.detail: 表 '${tableKey}' ${tables.length ? '重名，请传 tableId' : '不在当前租户字段定义中'}。`);
+                                else
+                                    validateFields(item?.fields ?? item?.assignments, tables[0].fields || [], `${stepPath}.params.fieldAssignments.detail[${tableKey}]`);
+                            }
+                    }
+                }
+                catch (error) {
+                    errors.push(`${stepPath}: 人员字段读取失败: ${String(error?.message || error)}`);
+                }
+            }
+            for (const branch of step.branches || [])
+                await walk(branch?.actions || [], `${stepPath}.branches`);
+            if (Array.isArray(step.actions))
+                await walk(step.actions, `${stepPath}.actions`);
+        }
+    };
+    await walk(plan.actions || [], 'actions');
+}
+/** 按拓扑顺序查询真实上下文，禁止未解析引用进入保存阶段。 */
+export async function preflightContext(plan, appId, client) {
+    const store = new ContextStore();
+    const provider = new PlatformContextProvider(client);
+    const errors = [];
+    const warnings = [];
+    const event = plan.event;
+    if (!event || typeof event !== 'object') {
+        return { valid: false, errors: ['event must be an object'], contextStore: {} };
+    }
+    await fillRequiredTriggerOperator(plan, client);
+    await resolveFixedPeople(plan, client);
+    await resolveEntrustFields(plan, client, errors);
+    await resolveHrmFieldAssignments(plan, client, errors);
+    // 回填 targetForm 缺失的 groupId/name
+    try {
+        const unresolvedForms = await resolveTargetForms(plan, client);
+        for (const fid of unresolvedForms) {
+            errors.push(`targetForm.id='${fid}' 未在平台表单中找到, 无法确定所属应用(groupId). 请用 form-applications + form-list 确认表单真实存在.`);
+        }
+    }
+    catch {
+        // 忽略
+    }
+    // 查并登记所有目标表单字段元数据（转换前必须有 fieldType/componentKey）
+    const hydrateFilterFields = async (steps) => {
+        for (const step of steps || []) {
+            if (!step || typeof step !== 'object')
+                continue;
+            if (['ActionEbAdd', 'ActionEbUpdate', 'ActionEbDelete', 'ActionEbRecover', 'ActionEbSaveVersion', 'EbGetDataById', 'EnquiryForm', 'TimeBatchTrigger', 'EventFormData', 'DateTrigger'].includes(step.type)) {
+                const tf = stepFormRef(step);
+                if (tf && tf.id)
+                    await getFormFieldsFull(String(tf.id), client, tf);
+            }
+            if (step.type === 'Condition') {
+                for (const branch of step.branches || []) {
+                    if (branch && typeof branch === 'object')
+                        await hydrateFilterFields(branch.actions || []);
+                }
+            }
+        }
+    };
+    await hydrateFilterFields([event]);
+    await hydrateFilterFields(plan.actions || []);
+    // 更新动作若无法拿到目标表字段，平台 saveDesign 会直接 500，这里硬拦截。
+    const validateUpdateFields = (steps, prefix = 'actions') => {
+        for (const [index, step] of (steps || []).entries()) {
+            if (!step || typeof step !== 'object')
+                continue;
+            const path = `${prefix}[${index}]`;
+            if (step.type === 'ActionEbUpdate') {
+                const target = stepFormRef(step) || {};
+                const formId = String(target.id || '');
+                const fields = formId ? (getTargetFormFields())[formId] || {} : {};
+                if (!Object.keys(fields).length) {
+                    errors.push(`${path}.targetForm: 未取得目标表单字段，拒绝保存更新动作；请确认 form-fields 能返回该表单的字段定义。`);
+                    continue;
+                }
+                const params = step.params || {};
+                for (const key of ['mapping', 'constants']) {
+                    const values = params[key] || {};
+                    const targets = key === 'mapping' && values && typeof values === 'object'
+                        ? Object.values(values)
+                        : key === 'constants' && values && typeof values === 'object'
+                            ? Object.keys(values)
+                            : [];
+                    for (const targetId of targets) {
+                        let normalized = String(targetId);
+                        if (['+', '-'].includes(normalized[0]))
+                            normalized = normalized.slice(1);
+                        if (targetId && typeof targetId === 'object') {
+                            normalized = String(targetId.target || targetId.fieldId || '');
+                            if (['+', '-'].includes(normalized[0]))
+                                normalized = normalized.slice(1);
+                        }
+                        if (normalized && !(normalized in fields)) {
+                            errors.push(`${path}.params.${key}: 目标字段 '${targetId}' 不属于表单 '${formId}'。`);
+                        }
+                    }
+                }
+            }
+            if (step.type === 'Condition') {
+                for (const [bi, branch] of (step.branches || []).entries()) {
+                    if (branch && typeof branch === 'object')
+                        validateUpdateFields(branch.actions || [], `${path}.branches[${bi}].actions`);
+                }
+            }
+        }
+    };
+    validateUpdateFields(plan.actions || []);
+    // 查 event 上下文
+    let eventContext = {};
+    try {
+        const eventResult = await queryNodeContext(event, appId, 'event_1', store, provider, 'event');
+        errors.push(...eventResult.errors);
+        eventContext = eventResult.context;
+    }
+    catch (e) {
+        errors.push(String(e?.message || e));
+    }
+    // 提取 event 上下文字段（event_source_fields 按显示名去重，event_context_fields 全量）
+    const eventFieldTypes = {};
+    const eventSourceFields = [];
+    const eventContextFields = [];
+    const seenPk = {};
+    for (const [, v] of Object.entries(eventContext)) {
+        if (v && typeof v === 'object' && v.type === 'context_group') {
+            for (const f of v.fields || []) {
+                if (!f || typeof f !== 'object')
+                    continue;
+                if (f.showName && f.componentKey)
+                    eventFieldTypes[String(f.showName)] = String(f.componentKey);
+                if (f.showName) {
+                    const pk = String(f.paramKey || '');
+                    eventContextFields.push({ ...f });
+                    const idx = seenPk[String(f.showName)];
+                    if (idx === undefined) {
+                        seenPk[String(f.showName)] = eventSourceFields.length;
+                        eventSourceFields.push({
+                            showName: String(f.showName || ''),
+                            componentKey: String(f.componentKey || ''),
+                            paramType: String(f.paramType || '').toLowerCase(),
+                            paramKey: pk,
+                            id: String(f.id || ''),
+                        });
+                    }
+                    else if (pk.endsWith('[]') && !String(eventSourceFields[idx].paramKey).endsWith('[]')) {
+                        eventSourceFields[idx].paramKey = pk;
+                    }
+                }
+            }
+        }
+    }
+    // 注册字段名→id 映射（component-context paramKey 权威源）
+    const WF_IDS = getWorkflowFieldIds();
+    const byWf = {};
+    for (const sf of eventSourceFields) {
+        const pk = String(sf.paramKey || '');
+        if (pk.includes('.') && sf.showName) {
+            const idx = pk.lastIndexOf('.');
+            const head = pk.slice(0, idx);
+            const tail = pk.slice(idx + 1);
+            (byWf[head] ??= {})[String(sf.showName)] = tail;
+        }
+    }
+    for (const [wfId, wfMap] of Object.entries(byWf)) {
+        if (wfId && wfMap)
+            Object.assign((WF_IDS[wfId] ??= {}), wfMap);
+    }
+    // 提取流程明细表子字段 → WORKFLOW_DETAIL_FIELDS
+    const evWfId = String(event.workflowId || event.params?.workflowPath?.id || '');
+    const WF_DETAIL = getWorkflowDetailFields();
+    for (const sf of eventSourceFields) {
+        const pk = String(sf.paramKey || '');
+        const nm = String(sf.showName || '');
+        if (!nm || (!pk.includes('[]. ') && !pk.includes('[].')))
+            continue;
+        const subform = pk.split('[]')[0].split('.').pop() || '';
+        if (subform) {
+            ((WF_DETAIL[evWfId] ??= {})[subform] ??= {})[nm] = pk;
+        }
+    }
+    // 登记流程明细表真实名称（只登记有子字段的明细表）
+    const WF_DETAIL_NAMES = getWorkflowDetailNames();
+    for (const sf of eventSourceFields) {
+        const pk = String(sf.paramKey || '');
+        const nm = String(sf.showName || '');
+        if (!nm || !pk.endsWith('[]') || pk.includes('[]. ') || pk.includes('[].'))
+            continue;
+        const idx = pk.lastIndexOf('.');
+        const head = pk.slice(0, idx);
+        const subf = pk.slice(idx + 1).replace(/\[\]$/, '');
+        if (head && subf && /^\d+$/.test(subf) && (WF_DETAIL[head] || {})[subf]) {
+            (WF_DETAIL_NAMES[head] ??= {})[subf] = nm;
+        }
+    }
+    // 触发器上下文注册 + workflow-fields 补注册
+    if (['ApproveTrigger', 'TimeBatchTrigger', 'EventFormData', 'DateTrigger'].includes(event.type)) {
+        let workflowId = String(event.workflowId || event.params?.workflowPath?.id || '');
+        if (!workflowId) {
+            const ds = event.params?.dataSource || event.params?.targetForm || {};
+            workflowId = String(ds.id || '');
+        }
+        if (workflowId) {
+            registerWorkflowContextFields(workflowId, eventContextFields);
+            let fid = FORM_ID_CACHE[workflowId] || '';
+            if (!fid) {
+                for (const s of plan.actions || []) {
+                    const tp = s?.params?.targetForm;
+                    if (tp && typeof tp === 'object' && tp.id) {
+                        fid = String(tp.id);
+                        break;
+                    }
+                }
+            }
+            if (fid) {
+                FORM_ID_CACHE[workflowId] = fid;
+                try {
+                    const wfFields = await workflowSource.getWorkflowFields(client, workflowId, fid);
+                    if (wfFields && typeof wfFields === 'object' && Array.isArray(wfFields.data)) {
+                        registerWorkflowFieldIds(workflowId, wfFields.data);
+                    }
+                }
+                catch {
+                    // 忽略
+                }
+            }
+        }
+    }
+    // 显式 mapping 补实时显示名
+    hydrateMappingLabels(plan, eventContextFields);
+    hydrateLoopCycleTimes(plan, eventContextFields);
+    if (errors.length) {
+        return { valid: false, errors, warnings, contextStore: store.asDict() };
+    }
+    // 逐节点查上下文 + ApproveCreate 目标字段
+    const walk = async (steps, branchStore, prefix) => {
+        for (const [index, step] of (steps || []).entries()) {
+            const path = `${prefix}[${index}]`;
+            let result;
+            try {
+                result = await queryNodeContext(step, appId, 'event_1', branchStore, provider, path);
+            }
+            catch (e) {
+                errors.push(String(e?.message || e));
+                return;
+            }
+            errors.push(...result.errors);
+            if (result.errors.length)
+                return;
+            if (step.type === 'Condition') {
+                for (const [bi, branch] of (step.branches || []).entries()) {
+                    if (branch && typeof branch === 'object') {
+                        await walk(branch.actions || [], new ContextStore(branchStore.asDict()), `${path}.branches[${bi}].actions`);
+                    }
+                }
+            }
+            else if (step.type === 'MultipleExecution') {
+                // 循环体可以引用该循环刚返回的 CycleParams（当次循环）；先查询循环节点，
+                // 再携带其上下文进入循环体，不能把循环体当作独立主链处理。
+                hydrateCurrentLoopReferences(step.actions || [], branchStore.asDict());
+                await walk(step.actions || [], new ContextStore(branchStore.asDict()), `${path}.actions`);
+            }
+            else if (step.type === 'ApproveCreate') {
+                await resolveBizCreateFields(step, plan, client, errors, path);
+            }
+        }
+    };
+    await walk(plan.actions || [], store, 'actions');
+    // 源字段硬性校验
+    checkSourceReferences(plan, eventContextFields, errors);
+    if (errors.length) {
+        return { valid: false, errors, warnings, contextStore: store.asDict() };
+    }
+    return {
+        valid: true,
+        errors,
+        warnings,
+        contextStore: store.asDict(),
+        autoMappings: plan._autoMappings || [],
+        autoResources: plan._autoResources || [],
+    };
+}
+//# sourceMappingURL=preflight_service.js.map