diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md index 301a8c8..921d56f 100644 --- a/docs/HANDOFF.md +++ b/docs/HANDOFF.md @@ -1,5 +1,13 @@ # 开发交接(2026-10-23) +## 当前:字段映射仅维护BPM流程和节点(2026-10-23) + +- 字段映射页面简化为自动采集开关、只读更新、搜索与流程/节点列表。目录使用原加密数据库中的独立记录持久化,仅由可信BPM列表及真实待办采集更新;初次升级从已保存的服务端证据初始化,不从规则、Excel或历史节点占位名反向生成。 +- 分类规则新增行仅使用目录中的流程及对应节点;已有未知值保留并标注,不污染其他行候选。内部详情适配器及证据保留,页面不再编辑客户、数量、型号等业务字段路径。自动采集暂停不改变已有活动规则。 +- Excel仅修改分类草稿;新增“下载规则导入模板”,每行一配对,同分类多行合并并要求业务配置一致,附填写说明和BPM可选项。兼容原xls及旧配置导出,支持模板ID、产品线。未知流程/节点逐行警告,可保存草稿,但应用、首次开启测试、恢复测试和正式发布均复核目录。模板无效及同分类配置冲突在预览时报错。 +- 实采名称保留原标点,包括全角括号及斜线/加号;导入优先完整匹配实采名称,再兼容旧表多值写法。原已发布规则、受限快照、邮件计划、账号和数据不因迁移改写。未观测名称不等于BPM一定不存在;已办通知补漏及真实PDF/归档能力验收仍未完成。 +- 本轮核心54项、采集专项10项、分类交互专项4项和新增流程专项1项通过;未运行旧千项全量。备份后更新原本机测试副本,初始化20个流程/32个配对,规则、订单、批次、内部适配器、真实采集样本、测试快照、设置及发信记录哈希不变。实机新页面已刷新验收。本轮未发送邮件或办理BPM;具体代码版本以code-revision.json为准,正式服务机未操作。 + ## 本轮:旧记录移除与隔离样例邮件验收(2026-10-23 16:18) - 按用户要求将唯一旧受阻订单软移出订单中心,原归档与规则快照哈希保持一致,防重数据保留;当前订单中心0条。未新增业务订单或业务批次。 diff --git a/docs/business-configuration.md b/docs/business-configuration.md index da4631c..8942e68 100644 --- a/docs/business-configuration.md +++ b/docs/business-configuration.md @@ -1,5 +1,15 @@ # 业务配置与 Excel 导入 +## 字段映射与规则导入(2026-10-23更新) + +“字段映射”页面现在只展示BPM实际采集到的流程、对应节点,以及自动采集开关。名称和配对保存在数据库;开启后监听完整待办列表或手动“从 BPM 更新”会新增去重项,关闭后保留目录和既有业务规则。初始化仅读取已保存的服务端真实采集证据,不使用分类种子、Excel或历史查看占位节点生成选项。采集不创建业务订单、不发信、不办理BPM。 + +规则编辑新增行的流程选项只来自此目录,选中流程后只显示对应节点。已有规则中的未知项仍显示原值并标记“未在BPM采集”,不会被自动删除或改写;这些值不会成为其他行的候选项。内部订单详情读取和PDF执行所需的已核验适配器仍保留,页面不再要求逐项配置客户、型号、数量。 + +在“分类规则 → 导入 Excel”下载“规则导入模板”。模板包含分类规则、填写说明、BPM可选项三个工作表;每行一个流程/节点,同分类可填多行,其余业务配置必须一致。模板以现有分类编号和当前配置作为起点,支持填写邮件模板ID和产品线;原始xls及“下载当前规则 Excel”仍兼容。导入仅维护已有分类的匹配与分发草稿,不新增字段映射项,也不自动启用规则。 + +预览会按Excel行提示未知流程、未知节点、无效邮件模板或同分类配置冲突。未知范围可以保存草稿,但不允许直接应用到测试、首次建立测试、恢复测试或正式发布;应检查Excel或补充BPM采集。未观测到不等于流程一定不存在。保存草稿、应用到测试和正式发布仍是独立操作;已有活动快照与冻结批次不因本次界面调整被修改。 + 模板 `{{日期}}` 使用订单原始 `event.receivedAt` 的北京时间日期;跨日按订单出现顺序去重,不能改用批次截止、纳入或创建日期。只有引用该变量的模板要求该时间完整;缺失阻断新冻结,不重写旧批次。 2026-10-23 当前业务权威:唯一来源文件是 `source/订单通知书邮件发送信息.xls`。系统只采用该文件原始 15 类的精确流程和精确节点;不使用“生效”别名,BOM 节点排除,海外 4 个流程只允许 `订单专员(订单通知书)`。产品线和模板 ID 由类别配置显式指定,Excel 不提供这些字段;测试产品线暂用 rule.name,并明确标为测试标签。固定 QQ、空 Cc、Desktop 目录是受控测试覆盖值,不是原 Excel 的正式目的地;正式原始目的地不提交 Git。 diff --git a/docs/field-mappings-guide.md b/docs/field-mappings-guide.md index a022edc..cf262a3 100644 --- a/docs/field-mappings-guide.md +++ b/docs/field-mappings-guide.md @@ -1,4 +1,8 @@ -# BPM 信息识别配置 +# 2026-10-23 当前页面职责 + +字段映射已简化为BPM流程与节点目录:自动采集开关、BPM连接选择、只读更新、搜索和流程/节点列表。目录持久化,提供分类规则新增匹配项的下拉候选。Excel导入只改分类草稿,不能修改此目录;未知流程或节点逐行警告且不能直接启用执行。内部详情适配器和历史证据保留。以下旧版字段来源编辑说明仅作为历史技术资料,当前页面不再提供这些控件。最新操作见 [业务配置与Excel导入](business-configuration.md)。 + +## 旧版字段来源编辑(历史资料) 入口:业务设置 → 字段映射。管理员低频维护,日常人员查看结果即可。分类规则消费本页已生效接口,负责流程节点、收件人和通知/归档策略;本页集中维护字段来源。 diff --git a/docs/superpowers/plans/2026-10-23-scope-mapping-import.md b/docs/superpowers/plans/2026-10-23-scope-mapping-import.md new file mode 100644 index 0000000..f4ed575 --- /dev/null +++ b/docs/superpowers/plans/2026-10-23-scope-mapping-import.md @@ -0,0 +1,12 @@ +# 字段映射与Excel规则导入职责拆分 + +用户已在对话确认设计并要求实施。沿用当前开发分支;本机服务使用独立发布副本,开发时不修改运行数据。 + +- [x] 先写失败测试:BPM流程/节点目录持久化、开关、去重;Excel只改规则,未知配对警告且不能直接应用。 +- [x] 目录接入可信BPM列表采集,字段映射页仅维护开关及流程/节点展示,规则新增选项只读目录。 +- [x] 提供每行一组配对的Excel导入模板,合并同分类多行,逐行检查业务配置及目录一致性。 +- [x] 运行相关后端与隔离UI验收,记录边界,提交推送并更新本机测试副本。禁止测试发送或BPM写操作。 + +内部详情适配数据不删除;已有发布快照不改写。目录不从分类规则或Excel反向生成。未观测名称表示需要检查Excel或补充采集,不能断言BPM不存在。 + +验收:核心54项、采集专项10项、分类交互专项4项和流程新增专项1项通过;独立复审三项问题已补失败测试并修复。本机备份后更新,20个流程/32个配对已从真实历史采集证据初始化;原规则、快照、订单、批次、适配器、采集证据、处理设置及发信记录哈希不变。正式服务机未操作。 diff --git a/package.json b/package.json index c202616..fdcff92 100644 --- a/package.json +++ b/package.json @@ -13,7 +13,7 @@ "service:stop": "node scripts/service.cjs stop", "service:restart": "node scripts/service.cjs restart", "test": "npm run test:business", - "test:business": "node --test --test-concurrency=1 tests/mail/sample-send.test.cjs tests/order-rules/excel-import-contract.test.cjs tests/order-rules/excel-execution-bridge.test.cjs tests/order-rules/excel-import-flow-ui.test.cjs tests/order-rules/query.test.cjs tests/order-rules/scheduled-mail-policy.test.cjs", + "test:business": "node --test --test-concurrency=1 tests/mail/sample-send.test.cjs tests/order-rules/scope-catalog.test.cjs tests/order-rules/field-mapping-ui.test.cjs tests/order-rules/excel-import-contract.test.cjs tests/order-rules/excel-execution-bridge.test.cjs tests/order-rules/excel-import-flow-ui.test.cjs tests/order-rules/query.test.cjs tests/order-rules/scheduled-mail-policy.test.cjs", "test:full": "node --test --test-concurrency=2 \"tests/**/*.test.cjs\"" }, "engines": { diff --git a/src/app/dashboard.cjs b/src/app/dashboard.cjs index e630909..bdfffeb 100644 --- a/src/app/dashboard.cjs +++ b/src/app/dashboard.cjs @@ -46,7 +46,7 @@ function createDashboard({store,outputDir,workspace,bpmSessions,bpmMonitor,mail, if(await notificationApi({notifications,workspace,user,route,method:request.method,body,reply}))return; if(await orderRuleQueryApi({orderRules,execution:orderExecution,workspace,user,url,route,method:request.method,reply,response}))return; if(await orderExecutionApi({execution:orderExecution,orderRules,dispatcher:orderDispatcher,workspace,user,sessionId:token,url,route,method:request.method,body,reply}))return; - if(await orderRuleApi({orderRules,mail,workspace,user,route,method:request.method,body,reply,response}))return; + if(await orderRuleApi({orderRules,mail,workspace,user,url,route,method:request.method,body,reply,response}))return; if(await assistantApi({assistant,workspace,user,sessionId:token,route,method:request.method,body,request,reply,trustedProxy}))return; if(await workspaceApi({workspace,store,user,route,method:request.method,body,reply,bpmSessions,bpmMonitor,bpmLifecycle,orderRules}))return; if(await dashboardApi({store,outputDir,workspace,mail,scanner,storage,orderRules,user,route,request,response,body,reply,fail}))return; diff --git a/src/modules/order-execution/api.cjs b/src/modules/order-execution/api.cjs index 2bdf2ba..de0515f 100644 --- a/src/modules/order-execution/api.cjs +++ b/src/modules/order-execution/api.cjs @@ -4,9 +4,12 @@ async function orderExecutionApi({execution,orderRules,dispatcher,workspace,user const task=/^\/api\/order-execution\/tasks\/([\w-]+)\/(retry|resolve)$/.exec(route),resend=/^\/api\/order-rules\/batches\/([\w-]+)\/resend$/.exec(route); const sample=/^\/api\/order-rules\/field-samples\/(list|capture)$/.exec(route),mapping=/^\/api\/order-rules\/field-mappings\/(draft|check|activate)$/.exec(route); const catalog=route==='/api/order-rules/field-samples/catalog',propose=route==='/api/order-rules/field-mappings/propose'; - if(!route.startsWith('/api/order-execution')&&!['/api/order-rules/fields','/api/order-rules/adapters'].includes(route)&&!resend&&!sample&&!mapping&&!catalog&&!propose)return false; + const scopeSettings=route==='/api/order-rules/field-mappings/catalog-settings'; + if(!route.startsWith('/api/order-execution')&&!['/api/order-rules/fields','/api/order-rules/adapters'].includes(route)&&!resend&&!sample&&!mapping&&!catalog&&!propose&&!scopeSettings)return false; if(!orderRules)fail('订单执行服务未启动。',503); if(!user)fail('请先登录。',401); + if(scopeSettings&&method==='POST'){reply(200,require('../order-rules/scope-catalog.cjs').configure(orderRules,body,user));return true;} + if(route==='/api/order-rules/fields'&&method==='GET'&&url?.searchParams.get('view')==='scopes'){reply(200,require('../order-rules/scope-catalog.cjs').directory(orderRules));return true;} if(catalog&&method==='GET'){reply(200,require('./field-sample-catalog.cjs').catalogFieldSamples({store:orderRules,workspace},url?.searchParams||{}, {user,sessionId}));return true;} if(propose&&method==='POST'){ if(!body||Array.isArray(body)||Object.keys(body).some(k=>!['sampleId','ruleId','ruleVersion','ruleDraft','sources'].includes(k))||typeof body.sampleId!=='string'||!body.sampleId||body.sampleId.length>200)fail('识别提案参数无效。'); diff --git a/src/modules/order-execution/coordinator.cjs b/src/modules/order-execution/coordinator.cjs index a9b7463..e79162d 100644 --- a/src/modules/order-execution/coordinator.cjs +++ b/src/modules/order-execution/coordinator.cjs @@ -118,6 +118,7 @@ class OrderExecutionCoordinator{ } this.store.transaction(()=>{ const id=hash([payload.connectionId,payload.runId]); + require('../order-rules/scope-catalog.cjs').observe(this.store,payload.rows); const existing=this.store.get('execution-discovery-runs',id); if(existing){ if(hash(existing.rows)!==hash(payload.rows)||existing.startedAt!==payload.startedAt||existing.finishedAt!==payload.finishedAt){ @@ -165,6 +166,7 @@ class OrderExecutionCoordinator{ this.query={id:'main',status:'scanning',connectionId:connection.id,startedAt:startedAt||this.now()};this.store.put('execution-query',this.query);this.store.put('execution-scans',{...this.query,id:connection.id}); try{ const rows=trustedRows===undefined?await this.provider.scan(connection,principal):clone(trustedRows);if(!Array.isArray(rows))throw Error('待办提供器返回格式无效。'); + this.store.transaction(()=>require('../order-rules/scope-catalog.cjs').observe(this.store,rows)); if(trustedRows===undefined&&eligibility.state(this.store))eligibility.recordCurrentScan(this.store,{connectionId:connection.id,rows,startedAt:this.query.startedAt,finishedAt:this.now()}); let considered=0;const observed=new Set(),discovered=[]; const window=this.store.snapshot().window; diff --git a/src/modules/order-execution/field-samples.cjs b/src/modules/order-execution/field-samples.cjs index 7c48e9c..9eeee66 100644 --- a/src/modules/order-execution/field-samples.cjs +++ b/src/modules/order-execution/field-samples.cjs @@ -79,6 +79,7 @@ function listFieldSamples(coordinator,input,principal){return coordinator.serial const rows=await scan(coordinator,connection,principal,input.scope); if(!Array.isArray(rows))fail('待办提供器返回格式无效。',502); ensureBinding(coordinator,request,principal); + coordinator.store.transaction(()=>require('../order-rules/scope-catalog.cjs').observe(coordinator.store,rows)); const window=currentWindow(coordinator,input.scope),rules=scopeRules(coordinator),id=crypto.randomUUID(),seen=new Set(),selected=[]; for(const row of rows){ if(!eligible(coordinator,row,window,rules))continue; diff --git a/src/modules/order-rules/api.cjs b/src/modules/order-rules/api.cjs index 555bce1..05658ca 100644 --- a/src/modules/order-rules/api.cjs +++ b/src/modules/order-rules/api.cjs @@ -1,13 +1,13 @@ 'use strict'; const {fail,validateRule}=require('./validation.cjs'); const {checkTemplates}=require('./template-validation.cjs'); -async function orderRuleApi({orderRules,mail,workspace,user,route,method,body,reply,response}){ +async function orderRuleApi({orderRules,mail,workspace,user,url,route,method,body,reply,response}){ if(route!=='/api/order-rules'&&!route.startsWith('/api/order-rules/'))return false; if(!orderRules)fail('分类通知规则服务未启动。',503); if(route==='/api/order-rules'&&method==='GET'){const snapshot=require('./access.cjs').publicSnapshot(orderRules,workspace,user);if(Array.isArray(snapshot.rules))snapshot.rules=snapshot.rules.map(rule=>({huizhouEnabled:false,huizhouTemplateId:'',...rule}));reply(200,snapshot);return true;} if(route==='/api/order-rules/import-template'&&method==='GET'){ if(user.role!=='admin')fail('仅管理员可导出规则配置。',403); - const bytes=await require('./import-template.cjs').template(orderRules);response.writeHead(200,{'Content-Type':'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet','Content-Disposition':"attachment; filename*=UTF-8''"+encodeURIComponent('分类规则.xlsx')});response.end(bytes);return true; + const importTemplate=url?.searchParams.get('type')==='template',bytes=await require('./import-template.cjs').template(orderRules,{importTemplate});response.writeHead(200,{'Content-Type':'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet','Content-Disposition':"attachment; filename*=UTF-8''"+encodeURIComponent(importTemplate?'规则导入模板.xlsx':'分类规则.xlsx')});response.end(bytes);return true; } if(method!=='POST')fail('没有找到此规则操作。',404); if(user.role==='viewer')fail('只读成员不能编辑规则或提交样本。',403); @@ -33,7 +33,7 @@ async function orderRuleApi({orderRules,mail,workspace,user,route,method,body,re if(body?.enabled){const channelId=orderRules.restrictedTest()?.channelId||body.channelId;if(!mail?.store.publicChannel(channelId)?.state.smtp)fail('请先验证测试发件邮箱SMTP。',409);for(const record of orderRules.all('rules'))if(!body.ruleIds||body.ruleIds.includes(record.id))checkTemplates(mail,orderRules.executionRule(record)||record.draft);} result=orderRules.saveRestrictedTest(body,user); } - else if(route==='/api/order-rules/import/preview')result=require('./import.cjs').previewImport(orderRules,body,actor); + else if(route==='/api/order-rules/import/preview')result=require('./import.cjs').previewImport(orderRules,body,actor,{mail}); else if(route==='/api/order-rules/import/commit')result=require('./import.cjs').commitImport(orderRules,body,actor,{mail,user}); else if(route==='/api/order-rules/restricted-test/apply'){ for(const item of Array.isArray(body?.rules)?body.rules:[]){const record=orderRules.get('rules',item?.id);if(record)checkTemplates(mail,record.draft);} diff --git a/src/modules/order-rules/import-template.cjs b/src/modules/order-rules/import-template.cjs index 0832675..7bade56 100644 --- a/src/modules/order-rules/import-template.cjs +++ b/src/modules/order-rules/import-template.cjs @@ -1,8 +1,18 @@ 'use strict'; -async function template(store){ +async function template(store,{importTemplate=false}={}){ // This endpoint only needs the in-memory workbook API. The vendor bundle // preserves formatting without hundreds of synchronous cold file loads. const Excel=require('exceljs/dist/exceljs.min.js'),book=new Excel.Workbook(),sheet=book.addWorksheet('分类规则'); + if(importTemplate){ + sheet.columns=['类别编号','分类名称','流程名称','触发节点','归档目录','邮件命名','邮件模板ID','产品线','收件人','抄送人','文件名日期'].map(header=>({header,width:['收件人','归档目录'].includes(header)?60:30})); + const dates={appDate:'申请日期',receivedAt:'接收日期',archiveDate:'归档日期'}; + for(const {draft:r}of store.all('rules'))for(const scope of require('./scopes.cjs').scopesFor(r))sheet.addRow([r.id,r.name,scope.processName,scope.nodeName,r.archiveDirectory,r.subjectPrefix,r.bodyTemplateId||'',r.productLine||'',r.to.join('\n'),r.cc.join('\n'),dates[r.filenameDate]||'']); + const help=book.addWorksheet('填写说明');help.getColumn(1).width=110; + for(const line of ['每行填写一个流程和触发节点,同一分类可重复多行,其余业务配置必须一致。','类别编号使用现有分类编号;模板已带入当前规则,可删去不需修改的分类行。','流程和节点请参考BPM可选项工作表;这是BPM实际采集目录,不由Excel维护。','未知流程或节点会逐行警告,可保存草稿,但不能应用到测试或正式发布。','邮件模板ID填写已有普通邮件模板ID;留空沿用分类原有模板。','收件人、抄送人可用换行或分号分隔;归档目录填写完整共享路径。','文件名日期填写申请日期、接收日期或归档日期。','导入只修改分类草稿,不自动启用、归档或发送邮件;PDF不作邮件附件。','本文件最多200行数据;采集未覆盖不代表BPM一定不存在,请检查Excel或补充采集。'])help.addRow([line]); + const choices=book.addWorksheet('BPM可选项');choices.columns=[{header:'流程名称',width:45},{header:'触发节点',width:45}];for(const row of require('./scope-catalog.cjs').directory(store).scopes)choices.addRow([row.processName,row.nodeName]); + for(const s of [sheet,choices]){s.views=[{state:'frozen',ySplit:1}];s.getRow(1).font={bold:true};s.eachRow(row=>row.alignment={vertical:'top',wrapText:true});}sheet.autoFilter='A1:K1';choices.autoFilter='A1:B1'; + return Buffer.from(await book.xlsx.writeBuffer()); + } sheet.columns=['类别编号','分类名称','订单评审流程','电子流状态','流程节点配对','服务器存档地址','邮件命名','收件人','抄送人','附带PDF','文件名日期'].map(header=>({header,width:['收件人','流程节点配对'].includes(header)?60:28})); const dates={appDate:'申请日期',receivedAt:'接收日期',archiveDate:'归档日期'}; for(const {draft:r}of store.all('rules'))sheet.addRow([r.id,r.name,r.processNames.join('/'),r.nodeNames.join('/'),require('./scopes.cjs').scopesFor(r).map(s=>s.processName+' → '+s.nodeName).join('\n'),r.archiveDirectory,r.subjectPrefix,r.to.join('\n'),r.cc.join('\n'),r.attachPdf?'是':'否',dates[r.filenameDate]||'']); diff --git a/src/modules/order-rules/import.cjs b/src/modules/order-rules/import.cjs index 3184748..2ef3593 100644 --- a/src/modules/order-rules/import.cjs +++ b/src/modules/order-rules/import.cjs @@ -4,18 +4,20 @@ const {validateRule,addresses,fail}=require('./validation.cjs'); const {checkTemplates}=require('./template-validation.cjs'); // Match the authoritative source-workbook reader's canonical text, without // treating different business node names as aliases. -const split=value=>String(value||'').normalize('NFKC').split(/[\n/+]/).map(v=>v.trim().replace(/^[“”"'「」]+|[“”"'「」]+$/g,'').trim()).filter(Boolean); +const split=(value,canonical,known)=>known.has(String(value||'').trim())?[String(value).trim()]:String(value||'').split(/[\n/+]/).map(v=>canonical(v.trim().replace(/^[“”"'「」]+|[“”"'「」]+$/g,'').trim())).filter(Boolean); function recipients(value){ const text=String(value||'').trim();if(!text)return [];if(!text.includes('@'))fail('收件人未识别到有效邮箱'); const parsed=require('nodemailer/lib/addressparser')(text.replace(/[,;\n]/g,',')),values=[]; const collect=items=>{for(const item of items){if(item.group)collect(item.group);else values.push(item.address);}};collect(parsed); if(!values.length)fail('收件人未识别到有效邮箱');return addresses(values); } -function previewImport(store,input,actor){ +function previewImport(store,input,actor,{mail}={}){ if(!input||Object.keys(input).some(k=>k!=='rows')||!Array.isArray(input.rows)||input.rows.length<2||input.rows.length>201||input.rows.some(r=>!Array.isArray(r)||r.length>20||r.some(c=>typeof c!=='string'&&typeof c!=='number'||String(c).length>20000)))fail('请导入不超过 200 行、20 列的分类表格。'); - const headers=input.rows[0].map(v=>String(v).trim());if(new Set(headers.filter(Boolean)).size!==headers.filter(Boolean).length)fail('Excel 列名重复,请检查表头。'); + const aliases={'流程名称':'订单评审流程','触发节点':'电子流状态','归档目录':'服务器存档地址'}; + const headers=input.rows[0].map(v=>aliases[String(v).trim()]||String(v).trim());if(new Set(headers.filter(Boolean)).size!==headers.filter(Boolean).length)fail('Excel 列名重复,请检查表头。'); for(const name of ['订单评审流程','电子流状态','邮件命名','收件人'])if(!headers.includes(name))fail('缺少 Excel 列:'+name); - const originals=store.all('rules'),rows=[],seen=new Set(); + const originals=store.all('rules'),rows=[],seen=new Map(); + const knownScopes=require('./scope-catalog.cjs').directory(store).scopes,knownProcesses=new Set(knownScopes.map(s=>s.processName)),knownNodes=new Set(knownScopes.map(s=>s.nodeName)),canonical=value=>knownProcesses.has(value)||knownNodes.has(value)?value:value.normalize('NFKC'); input.rows.slice(1).forEach((cells,index)=>{ const get=name=>String(cells[headers.indexOf(name)]??'').trim();if(!cells.some(c=>String(c).trim()))return; const row={sourceRow:index+2,name:get('分类名称'),issues:[],warnings:[],changes:[]};rows.push(row); @@ -24,12 +26,14 @@ function previewImport(store,input,actor){ const matches=explicit?originals.filter(r=>r.id===explicit):originals.filter(r=>r.draft.name===name||r.draft.subjectPrefix===subject.match(/^[【\[].+?[】\]]/)?.[0]); if(matches.length>1)fail('类别名称或主题对应多条规则,请用类别编号明确选择');const record=matches[0]; if(!record)fail('未找到对应类别,请使用模板中的类别编号或现有分类名称'); - if(seen.has(record.id))fail('此类别在 Excel 中重复');seen.add(record.id);row.id=record.id;row.name=record.draft.name; - const old=record.draft,processes=split(get('订单评审流程')),nodes=split(get('电子流状态'));if(!processes.length||!nodes.length)fail('流程名和节点名不能为空'); + row.id=record.id;row.name=record.draft.name; + const old=record.draft,processes=split(get('订单评审流程'),canonical,knownProcesses),nodes=split(get('电子流状态'),canonical,knownNodes);if(!processes.length||!nodes.length)fail('流程名和节点名不能为空'); const prefix=subject.match(/^[【\[].+?[】\]]/)?.[0]||subject; let scopes=processes.flatMap(processName=>nodes.map(nodeName=>({processName,nodeName}))); - if(get('流程节点配对'))scopes=get('流程节点配对').split('\n').filter(v=>v.trim()).map(v=>{const pair=v.split('→').map(s=>s.normalize('NFKC').trim());if(pair.length!==2||!pair.every(Boolean))fail('流程节点配对请按“流程名 → 节点名”每行一对填写');return {processName:pair[0],nodeName:pair[1]};}); + if(get('流程节点配对'))scopes=get('流程节点配对').split('\n').filter(v=>v.trim()).map(v=>{const pair=v.split('→').map(s=>canonical(s.trim()));if(pair.length!==2||!pair.every(Boolean))fail('流程节点配对请按“流程名 → 节点名”每行一对填写');return {processName:pair[0],nodeName:pair[1]};}); const candidate={...old,name:get('分类名称')||old.name,sourceRow:index+2,subjectPrefix:prefix,to:recipients(get('收件人')),scopes}; + if(headers.includes('邮件模板ID')&&get('邮件模板ID'))candidate.bodyTemplateId=get('邮件模板ID'); + if(headers.includes('产品线')&&get('产品线'))candidate.productLine=get('产品线'); if(headers.includes('抄送人'))candidate.cc=recipients(get('抄送人')); if(headers.includes('服务器存档地址'))candidate.archiveDirectory=get('服务器存档地址'); if(headers.includes('文件名日期')){const dates={'申请日期':'appDate','接收日期':'receivedAt','归档日期':'archiveDate','':'',appDate:'appDate',receivedAt:'receivedAt',archiveDate:'archiveDate'};if(!Object.hasOwn(dates,get('文件名日期')))fail('文件名日期只支持申请日期、接收日期或归档日期');candidate.filenameDate=dates[get('文件名日期')];} @@ -38,20 +42,30 @@ function previewImport(store,input,actor){ candidate.attachPdf=false; candidate.adapterIds=[...new Set([...old.adapterIds,...store.adapters().filter(a=>a.verified&&processes.includes(a.processName)).filter(a=>!store.adapters().some(b=>b.id!==a.id&&b.verified&&b.processName===a.processName&&b.processVersion===a.processVersion)).map(a=>a.id)])]; Object.assign(candidate,validateRule(candidate,old),{version:old.version});row.candidate=candidate;row.version=old.version;row.recipientCount=candidate.to.length; + if(mail)checkTemplates(mail,candidate); + row.scopeWarnings=require('./scope-catalog.cjs').warnings(store,candidate).map(message=>'第'+(index+2)+'行:'+message);row.warnings.push(...row.scopeWarnings); row.preview={scopes:structuredClone(candidate.scopes),subjectPrefix:candidate.subjectPrefix,archiveDirectory:candidate.archiveDirectory,to:[...candidate.to],cc:[...candidate.cc],attachPdf:false}; const labels={name:'分类名称',subjectPrefix:'邮件主题',to:'收件人',cc:'抄送人',archiveDirectory:'归档目录',attachPdf:'PDF附件',filenameDate:'文件名日期',scopes:'流程与节点',adapterIds:'BPM识别配置'}; for(const [key,label]of Object.entries(labels))if(JSON.stringify(old[key])!==JSON.stringify(candidate[key]))row.changes.push(label); if(!candidate.archiveDirectory.startsWith('\\\\'))row.warnings.push('表内仅有目录名称,请在第03步选择存储服务器和目录'); if(!get('流程节点配对')&&processes.length>1&&nodes.length>1)row.warnings.push('此行多个流程共用多个节点,按所有组合导入,请在第01步检查配对'); if(!candidate.filenameDate)row.warnings.push('文件名日期仍待选择'); + const previous=seen.get(record.id); + if(previous){ + const distribution=value=>JSON.stringify(Object.fromEntries(Object.entries(value).filter(([key])=>!['sourceRow','scopes','processNames','nodeNames','adapterIds'].includes(key)))); + if(distribution(previous.candidate)!==distribution(candidate))fail('同分类多行的模板、收件人或其他业务配置不一致,请统一填写。'); + previous.candidate.scopes=require('./scopes.cjs').normalizeScopes([...previous.candidate.scopes,...candidate.scopes]); + previous.candidate.processNames=[...new Set(previous.candidate.scopes.map(s=>s.processName))];previous.candidate.nodeNames=[...new Set(previous.candidate.scopes.map(s=>s.nodeName))];previous.candidate.adapterIds=[...new Set([...previous.candidate.adapterIds,...candidate.adapterIds])]; + previous.preview.scopes=structuredClone(previous.candidate.scopes);previous.warnings.push(...row.warnings);previous.scopeWarnings.push(...row.scopeWarnings);previous.sourceRows.push(index+2);previous.changes=[...new Set([...previous.changes,...row.changes])];rows.pop(); + }else {row.sourceRows=[index+2];seen.set(record.id,row);} }catch(error){row.issues.push(error.message);} }); if(!rows.length)fail('表格没有可导入的分类行'); const test=store.restrictedTest?.(); - const id=crypto.randomUUID(),canCommit=rows.every(r=>!r.issues.length),plan={id,actor,createdAt:store.now(),canCommit,rows,...test?.enabled?{testVersion:test.version}:{}}; + const id=crypto.randomUUID(),canCommit=rows.every(r=>!r.issues.length),plan={id,actor,createdAt:store.now(),canCommit,canApply:canCommit&&rows.every(r=>!r.scopeWarnings?.length),rows,...test?.enabled?{testVersion:test.version}:{}}; store.put('rule-imports',plan);return publicPlan(plan); } -function publicPlan(plan){return {id:plan.id,canCommit:plan.canCommit,...plan.testVersion!==undefined?{testVersion:plan.testVersion}:{},rows:plan.rows.map(({candidate,...row})=>row)};} +function publicPlan(plan){return {id:plan.id,canCommit:plan.canCommit,canApply:plan.canApply,...plan.testVersion!==undefined?{testVersion:plan.testVersion}:{},rows:plan.rows.map(({candidate,...row})=>row)};} function commitImport(store,input,actor,{mail,user}={}){return store.transaction(()=>{ if(!input||Object.keys(input).some(k=>!['id','applyToTest'].includes(k))||typeof input.id!=='string'||input.applyToTest!==undefined&&typeof input.applyToTest!=='boolean')fail('请选择已检查的导入预览'); const plan=store.get('rule-imports',input.id);if(!plan||plan.actor!==actor)fail('导入预览不存在,请重新选择文件',404); @@ -59,6 +73,7 @@ function commitImport(store,input,actor,{mail,user}={}){return store.transaction if(Date.parse(store.now())-Date.parse(plan.createdAt)>30*60000)fail('导入预览已过期,请重新选择文件',409); if(!plan.canCommit)fail('请修复 Excel 中的问题后重新导入',409); const prepared=plan.rows.map(row=>{const record=store.get('rules',row.id);return {record,rule:validateRule(row.candidate,record?.draft)};}); + if(input.applyToTest)for(const {rule}of prepared)require('./scope-catalog.cjs').assertKnown(store,rule); for(const {rule}of prepared)checkTemplates(mail,rule); for(const {record,rule}of prepared){store.put('rule-history',{id:record.id+':'+record.draft.version,rule:record.draft,at:store.now(),actor});record.draft=rule;record.trialVersion=null;record.trialDemo=null;record.trialSampleId=null;store.put('rules',record);} if(input.applyToTest){if(plan.testVersion===undefined)fail('此预览没有有效的测试版本,请重新预览。',409);store.applyRestrictedDrafts({version:plan.testVersion,rules:prepared.map(({record,rule})=>({id:record.id,version:rule.version}))},user);} diff --git a/src/modules/order-rules/registry.cjs b/src/modules/order-rules/registry.cjs index ed453e5..1e6a403 100644 --- a/src/modules/order-rules/registry.cjs +++ b/src/modules/order-rules/registry.cjs @@ -9,7 +9,7 @@ function fields(store){const samples=store.all('capture-samples').map(({snapshot function recordCapture(store,{sample,snapshot,taskId}){ if(sample?.demo||!snapshot||!Array.isArray(snapshot.fields)||snapshot.processVersion!==sample.processVersion)fail('捕获样本缺少一致的流程版本或实际字段证据。',409); const paths=new Set();for(const f of snapshot.fields){if(!f||typeof f.path!=='string'||!f.path||paths.has(f.path)||!Object.hasOwn(sample.fields||{},f.path)||JSON.stringify(sample.fields[f.path])!==JSON.stringify(f.value))fail('捕获字段冲突或与样本不一致。',409);paths.add(f.path);} - const id=hash([taskId,sample,snapshot]);const captured={id,taskId,processName:sample.processName,processVersion:sample.processVersion,sample:structuredClone(sample),snapshot:structuredClone(snapshot),capturedAt:store.now(),provenance:'server-provider',evidenceHash:hash({sample,snapshot})};store.put('capture-samples',captured);return captured; + const id=hash([taskId,sample,snapshot]);const captured={id,taskId,processName:sample.processName,processVersion:sample.processVersion,sample:structuredClone(sample),snapshot:structuredClone(snapshot),capturedAt:store.now(),provenance:'server-provider',evidenceHash:hash({sample,snapshot})};store.put('capture-samples',captured);require('./scope-catalog.cjs').observe(store,[sample]);return captured; } function saveAdapter(store,input,actor){return require('./field-mappings.cjs').saveLegacy(store,input,actor);} module.exports={registry,fields,recordCapture,saveAdapter}; diff --git a/src/modules/order-rules/restricted-test.cjs b/src/modules/order-rules/restricted-test.cjs index a27d1f2..4852294 100644 --- a/src/modules/order-rules/restricted-test.cjs +++ b/src/modules/order-rules/restricted-test.cjs @@ -49,6 +49,7 @@ function applyDrafts(store,input,actor){ const record=store.get('rules',item.id),index=next.rules.findIndex(r=>r.id===item.id); if(!record||record.draft.version!==item.version||index<0)fail('规则已变化或不在当前测试范围,请刷新。',409); const draft=record.draft,binding=next.rules[index]; + require('./scope-catalog.cjs').assertKnown(store,draft); if(run.rules[index].version!==draft.version){ const unfinished=order=>order?.ruleSnapshot?.testRunId===run.id&&['normal','huizhou'].some(mode=>{const value=require('./delivery.cjs').delivery(order,mode);return value&&!value.batchId&&!['sent','ignored','unknown','not_applicable','disabled','empty'].includes(value.status);}); const pending=store.all('orders').some(order=>order.categoryId===item.id&&unfinished(order)); @@ -83,7 +84,7 @@ function save(store,input,actor){ for(const key of ['recipient','archiveRoot','channelId'])if(input[key]!==undefined&&input[key]!==old[key])fail('受限测试目的地已固定,不能通过启停修改。',409); if(input.ruleIds&&hash([...input.ruleIds].sort())!==hash(old.rules.map(r=>r.id).sort()))fail('受限测试类别已固定。',409); const next={...old,enabled:input.enabled,version:old.version+1}; - if(next.enabled){assertPath(store,next.archiveRoot,next);if(next.rules.some(r=>!validRule(store,r,next)))fail('测试字段配置已变化,需要重新核验,不能直接恢复。',409);} + if(next.enabled){assertPath(store,next.archiveRoot,next);for(const rule of next.rules)require('./scope-catalog.cjs').assertKnown(store,rule);if(next.rules.some(r=>!validRule(store,r,next)))fail('测试字段配置已变化,需要重新核验,不能直接恢复。',409);} store.put('restricted-test',{id:'main',value:next});store.audit(actor.username,next.enabled?'恢复受限测试':'暂停受限测试',next.id);return summary(store); } if(!input.enabled)fail('尚未建立受限测试配置。',409); @@ -100,6 +101,7 @@ function save(store,input,actor){ run.uncovered.push(...draft.processNames.filter(p=>!covered.includes(p)).map(processName=>({categoryId:id,processName}))); const rule={...structuredClone(draft),processNames:covered,scopes:scopesFor(draft).filter(s=>covered.includes(s.processName)),adapterIds:adapters.map(a=>a.id),status:'enabled',testRunId:run.id,testSince:run.since,testArchiveRoot:run.archiveRoot}; if(!covered.length||!rule.scopes.length)fail('类别缺少已验证的真实字段证据:'+draft.name,409); + require('./scope-catalog.cjs').assertKnown(store,rule); assertRule(store,rule,run); const issues=publicationIssues(rule,adapters);if(issues.length)fail(issues.join(';'),409); if(run.rules.some(r=>require('./scopes.cjs').scopesOverlap(r,rule)))fail('测试类别存在流程节点冲突。',409); diff --git a/src/modules/order-rules/scope-catalog.cjs b/src/modules/order-rules/scope-catalog.cjs new file mode 100644 index 0000000..47a50b8 --- /dev/null +++ b/src/modules/order-rules/scope-catalog.cjs @@ -0,0 +1,38 @@ +'use strict'; +const crypto=require('node:crypto'); +const {fail}=require('./validation.cjs'); +const {scopesFor}=require('./scopes.cjs'); +const settings=store=>store.get('scope-catalog-settings','main')||{id:'main',version:1,enabled:true}; +const clean=value=>typeof value==='string'&&value.trim()&&value.length<=250&&!/[\x00-\x1f]/.test(value)?value.trim():''; +function observe(store,rows){ + if(!settings(store).enabled)return; + for(const row of rows){ + if(!['todo','inform'].includes(row?.source)||row.demo||row.configurationOnly&&row.source!=='todo')continue; + const processName=clean(row.processName),nodeName=clean(row.nodeName||row.activityName); + if(!processName||!nodeName||/历史查看|未提供办理节点/.test(nodeName))continue; + const id=crypto.createHash('sha256').update(JSON.stringify([processName,nodeName])).digest('hex'); + if(!store.get('scope-catalog',id))store.put('scope-catalog',{id,processName,nodeName,discoveredAt:store.now()}); + } +} +function initialize(store){ + if(store.get('scope-catalog-settings','main'))return; + store.put('scope-catalog-settings',settings(store)); + // Only server-collected evidence; never seed from classification rules or imports. + observe(store,store.all('capture-samples').filter(c=>c.provenance==='server-provider').map(c=>c.sample)); + for(const kind of ['execution-discovery-runs','field-sample-lists'])for(const record of store.all(kind))observe(store,(record.rows||[]).map(r=>r.row||r)); +} +function directory(store){ + const {id,...config}=settings(store),scopes=store.all('scope-catalog').map(({processName,nodeName})=>({processName,nodeName})).sort((a,b)=>a.processName.localeCompare(b.processName,'zh-CN')||a.nodeName.localeCompare(b.nodeName,'zh-CN')); + return {settings:config,scopes}; +} +function configure(store,input,actor){ + if(actor?.role!=='admin'||!actor.username)fail('仅管理员可以维护字段映射。',403); + return store.transaction(()=>{const old=settings(store);if(!input||Object.keys(input).some(k=>!['version','enabled'].includes(k))||typeof input.enabled!=='boolean')fail('字段映射开关无效。');if(input.version!==old.version)fail('字段映射设置已变化,请刷新重试。',409); + store.put('scope-catalog-settings',{id:'main',version:old.version+1,enabled:input.enabled});store.audit(actor.username,'字段映射自动采集',input.enabled?'启用':'停用');return directory(store);}); +} +function warnings(store,rule){ + const scopes=directory(store).scopes; + return scopesFor(rule).flatMap(row=>!scopes.some(s=>s.processName===row.processName)?['流程“'+row.processName+'”未在BPM字段映射中采集,请检查Excel或补充采集。']:!scopes.some(s=>s.processName===row.processName&&s.nodeName===row.nodeName)?['流程“'+row.processName+'”的节点“'+row.nodeName+'”未在BPM字段映射中采集,请检查Excel或补充采集。']:[]); +} +function assertKnown(store,rule){const issues=warnings(store,rule);if(issues.length)fail('字段映射与规则不一致:'+issues.join(';'),409);} +module.exports={initialize,observe,directory,configure,warnings,assertKnown}; diff --git a/src/modules/order-rules/store.cjs b/src/modules/order-rules/store.cjs index 54d9802..250b6e3 100644 --- a/src/modules/order-rules/store.cjs +++ b/src/modules/order-rules/store.cjs @@ -33,6 +33,7 @@ class RuleStore{ const draft=override?validateRule({...rule,...override},rule):rule; this.put('rules',{id:rule.id,draft:{...draft,status:'draft'},published:null,trialVersion:null,trialDemo:null}); } + require('./scope-catalog.cjs').initialize(this); for(const batch of this.all('batches')){ if(batch.manual&&batch.status==='prepared'){ batch.status='failed';batch.version=(batch.version||1)+1;batch.error='人工补发在发送前中断,可再次受控补发。';this.put('batches',batch);this.updateBatchOrders(batch,'pending',batch.error); @@ -102,6 +103,7 @@ class RuleStore{ if(this.restrictedTest()?.enabled)fail('受限测试运行期间不能发布正式分类规则;请先暂停测试并重新检查真实通知。',409); const record=this.get('rules',id);if(!record)fail('规则不存在。',404); if(input?.version!==record.draft.version)fail('规则已变化,请刷新。',409); + require('./scope-catalog.cjs').assertKnown(this,record.draft); const issues=publicationIssues(record.draft,this.adapters()); if(record.trialVersion!==record.draft.version)issues.push('请先用真实结构样本试运行当前草稿'); if(record.trialDemo!==false)issues.push('演示样本仅用于理解字段,发布前请校验真实业务样本'); @@ -123,6 +125,7 @@ class RuleStore{ if(input?.version!==record.draft.version||input.publishedVersion!==record.published.version||input.activationVersion!==(record.activationVersion||0))fail('规则或启停状态已变化,请刷新。',409); const sample=this.get('capture-samples',record.publicationSampleId||record.trialSampleId||''); const issues=publicationIssues(record.published,this.adapters()); + require('./scope-catalog.cjs').assertKnown(this,record.published); if(record.publicationAdaptersHash!==digest(record.published.adapterIds.map(id=>this.adapters().find(a=>a.id===id))))issues.push('BPM 信息识别配置已变化,请重新检查并发布'); if(!sample||sample.provenance!=='server-provider'||!previewMatch([record.published],this.adapters(),sample.sample).valid)issues.push('已发布版本需要重新检查真实订单识别结果'); const overlaps=this.all('rules').filter(r=>r.id!==id&&r.published?.status==='enabled'&&scopesOverlap(r.published,record.published)); diff --git a/tests/order-rules/excel-execution-bridge.test.cjs b/tests/order-rules/excel-execution-bridge.test.cjs index e119ab0..8b9236a 100644 --- a/tests/order-rules/excel-execution-bridge.test.cjs +++ b/tests/order-rules/excel-execution-bridge.test.cjs @@ -10,6 +10,7 @@ function fixture(t){ const evidence=activateReferenceMapping(store),old=store.get('rules','bs-change').draft;store.saveRule({...old,to:['2639266652@qq.com'],cc:[],bodyTemplateId:'',archiveDirectory:root+'\\orders',filenameDate:'receivedAt'},'admin'); store.saveRestrictedTest({version:0,enabled:true,recipient:'2639266652@qq.com',archiveRoot:root,channelId:'fixture-mail',ruleIds:['bs-change']},admin); const event=(taskId,nodeName='Excel通知节点')=>({...evidence.sample,instanceId:'fixture-instance-'+taskId,taskId,nodeName,receivedAt:'2026-10-23T01:00:01Z'}); + require('../../src/modules/order-rules/scope-catalog.cjs').observe(store,[event('observed')]); const input={rows:[['类别编号','分类名称','订单评审流程','电子流状态','服务器存档地址','邮件命名','收件人'],['bs-change','备损订单更改通知书','备损订单更改评审','Excel通知节点','Excel归档分类','【备损订单更改通知书】','formal@example.test']]}; return {get store(){return store;},root,event,input,reopen(){const clock=store.clock;store.close();store=new RuleStore(path.join(dir,'state'),{...options,clock});}}; } @@ -45,6 +46,7 @@ test('applying edits keeps old task snapshots valid and rejects stale or unautho test('unusable imports roll back atomically and uncovered flows remain explicitly blocked',t=>{ const f=fixture(t),before=f.store.all('rules'),run=f.store.get('restricted-test','main'); f.input.rows[1][2]='未配置字段的流程';const bad=previewImport(f.store,f.input,'admin');assert.throws(()=>commitImport(f.store,{id:bad.id,applyToTest:true},'admin',{user:admin}),{status:409});assert.deepEqual(f.store.all('rules'),before);assert.deepEqual(f.store.get('restricted-test','main'),run); + require('../../src/modules/order-rules/scope-catalog.cjs').observe(f.store,[{source:'todo',processName:'未配置字段的流程',nodeName:'Excel通知节点'}]); f.input.rows[1][2]='备损订单更改评审/未配置字段的流程';const partial=previewImport(f.store,f.input,'admin');commitImport(f.store,{id:partial.id,applyToTest:true},'admin',{user:admin}); assert(f.store.restrictedTest().uncovered.some(row=>row.processName==='未配置字段的流程')); const blocked=f.store.ingest({...f.event('uncovered'),processName:'未配置字段的流程'},'fixture');assert.equal(blocked.status,'blocked');assert.equal(blocked.archive,null); @@ -55,3 +57,7 @@ test('applying one category retains missing-flow warnings for other categories', f.store.put('restricted-test',{id:'main',value:null});const run=f.store.saveRestrictedTest({version:0,enabled:true,recipient:'2639266652@qq.com',archiveRoot:f.root,channelId:'fixture-mail',ruleIds:['bs-change','overseas-change']},admin);assert(run.uncovered.length>0); const rule=f.store.get('rules','bs-change').draft;f.store.applyRestrictedDrafts({version:run.version,rules:[{id:rule.id,version:rule.version}]},admin);assert.deepEqual(f.store.restrictedTest().uncovered,run.uncovered); }); +test('first restricted activation cannot bypass an unknown imported notification node',t=>{ + const f=fixture(t),draft=f.store.get('rules','bs-change').draft;f.store.saveRule({...draft,scopes:[{processName:'备损订单更改评审',nodeName:'Excel未知节点'}]},'admin');f.store.put('restricted-test',{id:'main',value:null}); + assert.throws(()=>f.store.saveRestrictedTest({version:0,enabled:true,recipient:'2639266652@qq.com',archiveRoot:f.root,channelId:'fixture-mail',ruleIds:['bs-change']},admin),e=>e.status===409&&/字段映射/.test(e.message));assert.equal(f.store.restrictedTest(),null); +}); diff --git a/tests/order-rules/excel-import-flow-ui.test.cjs b/tests/order-rules/excel-import-flow-ui.test.cjs index 561ab81..5dfcd5a 100644 --- a/tests/order-rules/excel-import-flow-ui.test.cjs +++ b/tests/order-rules/excel-import-flow-ui.test.cjs @@ -54,6 +54,7 @@ test('import and editor application update the actual execution rule through aut runtime.orderRules.saveRule({...draft,to:['2639266652@qq.com'],cc:[],bodyTemplateId:'',archiveDirectory:root+'\\orders',filenameDate:'receivedAt'},'admin'); const run=runtime.orderRules.saveRestrictedTest({version:0,enabled:true,recipient:'2639266652@qq.com',archiveRoot:root,channelId:'fixture-channel',ruleIds:['bs-change']},{username:'admin',role:'admin'}); const rows=[['类别编号','分类名称','订单评审流程','电子流状态','服务器存档地址','邮件命名','收件人'],['bs-change','备损订单更改通知书','备损订单更改评审','Excel通知节点','表内目录','【备损订单更改通知书】','formal@example.test']],book=XLSX.utils.book_new();XLSX.utils.book_append_sheet(book,XLSX.utils.aoa_to_sheet(rows),'分类规则'); + require('../../src/modules/order-rules/scope-catalog.cjs').observe(runtime.orderRules,[{source:'todo',processName:'备损订单更改评审',nodeName:'Excel通知节点'}]); await page.goto(base+'/#order-rules');await login(page);await page.getByRole('button',{name:'导入 Excel',exact:true}).click();await page.locator('#rule-import-file').setInputFiles({name:'执行规则.xlsx',mimeType:'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',buffer:XLSX.write(book,{type:'buffer',bookType:'xlsx'})}); await page.getByRole('button',{name:'确认导入并应用到测试',exact:true}).click();await page.getByText('Excel 规则已导入并应用到测试,旧订单和批次保持不变。',{exact:true}).waitFor(); const active=()=>runtime.orderRules.executionRule(runtime.orderRules.get('rules','bs-change'));assert.equal(active().nodeNames[0],'Excel通知节点');assert.deepEqual(active().to,['2639266652@qq.com']);assert.equal(runtime.orderRules.restrictedTest().since,run.since); diff --git a/tests/order-rules/field-mapping-ui.test.cjs b/tests/order-rules/field-mapping-ui.test.cjs index eb3ab17..e6215e1 100644 --- a/tests/order-rules/field-mapping-ui.test.cjs +++ b/tests/order-rules/field-mapping-ui.test.cjs @@ -1,50 +1,27 @@ 'use strict'; -const test=require('node:test'),assert=require('node:assert/strict'),fs=require('node:fs/promises'),path=require('node:path'); -const {loadPlaywright,browserOptions}=require('../../src/platform/browser.cjs'); -async function setup(t,role='admin',legacy=false,noSampleReference=false){ - const browser=await loadPlaywright().chromium.launch(browserOptions());t.after(()=>browser.close());const page=await browser.newPage({viewport:{width:1200,height:1000}});page.setDefaultTimeout(5000);await page.setContent('
'); - for(const file of ['navigation/lifecycle.js','field-mappings/sample-picker.js','field-mappings/recognition-panel.js','field-mappings/view.js'])await page.addScriptTag({content:await fs.readFile(path.resolve('web/modules',file),'utf8')}); - await page.addStyleTag({content:await fs.readFile(path.resolve('web/modules/field-mappings/view.css'),'utf8')}); - await page.evaluate(async({role,legacy,noSampleReference})=>{ - window.calls=[];window.active=true;window.failRefresh=false;window.deferSave=false;let sequence=0; - const sample={id:'s1',processName:'真实流程',processVersion:'2.0',sample:{title:'订单号:TITLE-1 客户简称:标题客户',taskId:'T1',serialNum:'SER1',nodeName:'通知节点',receivedAt:'2026-10-20T01:00:00Z'},snapshot:{fields:[{path:'form.order',label:'订单号',value:'FORM-1'},{path:'form.qty',label:'数量',value:0},{path:'form.amount',label:'金额',value:500},{path:'form.other',label:'备注',value:'特殊值'},{path:'form.second',label:'主订单号',value:'SECOND'}]}}; - const directory={samples:[sample],adapters:[],processes:[{processName:'真实流程',categories:[{id:'cat',name:'真实分类',filenameDate:'appDate'}],versions:[{processVersion:'2.0',sampleCount:1,sampleIds:['s1'],status:'待配置'},{processVersion:'3.0',sampleCount:0,sampleIds:[],status:'未采集'}]}]}; - if(role!=='admin')Object.assign(directory.processes[0].versions[0],{status:'已核验',active:{id:'active1',version:4,sampleId:'s1',sources:{orderNo:{type:'form',path:'form.order'},brief:{type:'title'},processName:{type:'metadata',key:'processName'}}}}); - if(legacy)Object.assign(directory.processes[0].versions[0],{status:'已核验',active:{id:'legacy1',version:9,sampleId:'s1',fields:{orderNo:'form.order',quantity:'form.qty',brief:'form.other'}}}); - if(noSampleReference){directory.samples=[];Object.assign(directory.processes[0].versions[0],{status:'未采集',sampleCount:0,sampleIds:[],reference:{id:'ref1',reference:true,fields:{orderNo:'form.order',quantity:'form.qty'}}});} - const api=async(url,body)=>{calls.push({url,body});if(url.startsWith('/order-rules/field-samples/catalog'))return {items:[],nextCursor:null};if(url.endsWith('/propose')){const item=directory.samples.find(s=>s.id===body.sampleId),version=directory.processes[0].versions.find(v=>v.processVersion===item.processVersion),chosen=version.draft||version.active,source=body.sources||chosen?.sources||(chosen?.fields?Object.fromEntries(Object.entries(chosen.fields).filter(([k])=>k!=='brief').map(([k,path])=>[k,{type:'form',path}])):{quantity:{type:'form',path:'form.qty'}});source.brief={type:'title'};return {sampleId:item.id,evidenceHash:'evidence-'+item.id,mapping:{basis:chosen?'draft':'recommended',sources:source},fields:[{key:'orderNo',label:'主订单号',state:source.orderNo?'recognized':'ambiguous',value:source.orderNo?'FORM-1':null,candidates:[{path:'form.order',label:'订单号',value:'FORM-1'},{path:'form.second',label:'主订单号',value:'SECOND'}]}],recognition:{event:{brief:'TITLE-1'},valid:false},blockedReasons:[],warnings:[]};} if(url==='/workspace')return {connections:[{id:'c1',name:'我的连接'}]};if(url.split('?')[0]==='/order-rules/fields'){if(window.deferRefresh)await new Promise(r=>window.releaseRefresh=r);if(failRefresh)throw Error('刷新断线');return structuredClone(directory);}if(url.endsWith('/draft')){const saved={...body,id:'mapping-1',version:++sequence,status:'draft',check:null};directory.processes[0].versions[0].draft=saved;if(deferSave)await new Promise(r=>window.releaseSave=r);return saved;}if(url.endsWith('/check'))return {id:'check-1',evidenceHash:'evidence-'+body.sampleId,valid:true,version:body.version,sampleId:body.sampleId,result:{event:{orderNo:'FORM-1',mainOrder:'FORM-1',brief:'订单号:TITLE-1',titleOrders:[{orderNo:'TITLE-1'}]},issues:[],checks:[{label:'订单号',ok:true,detail:'有效'}],filenames:[{categoryId:'cat',categoryName:'真实分类',filename:'FORM-1_20261020_SER1.pdf',issues:[]}],affectedCategories:[{id:'cat',name:'真实分类'}]}};if(url.endsWith('/activate'))return {...directory.processes[0].versions[0].draft,activeVersion:body.version,status:'active'};if(url.endsWith('/field-samples/list')&&window.failList)throw Object.assign(Error('列表读取失败'),{status:502});if(url.endsWith('/field-samples/list')&&window.uncertainList)throw Object.assign(Error('结果待核实'),{outcome:'uncertain'});if(url.endsWith('/field-samples/list'))return {id:'list-1',rows:[{id:'row-1',taskId:'T2',serialNum:'SER2',processName:'真实流程',processVersion:'3.0',nodeName:'通知节点',title:'订单号:NEW-2'}]};if(url.endsWith('/field-samples/capture')){if(window.failCapture)throw Object.assign(Error('采集断线'),{status:502});const captured={...structuredClone(sample),id:'s2',processVersion:'3.0',sample:{...sample.sample,title:'订单号:NEW-2',serialNum:'SER2'}};directory.samples.push(captured);Object.assign(directory.processes[0].versions[1],{sampleCount:1,sampleIds:['s2']});return captured;}throw Error('unexpected '+url);}; - PageLifecycle.attach(document.querySelector('#root'));window.controller=await FieldMappingViews.render(document.querySelector('#root'),{api,esc:v=>String(v??'').replaceAll('&','&').replaceAll('<','<').replaceAll('"','"'),formatDate:v=>v||'—',user:{role},isActive:()=>active,feedback:(m,type)=>document.querySelector('#notice').textContent=m});PageLifecycle.bind(); - },{role,legacy,noSampleReference});if(!noSampleReference)await page.waitForFunction(()=>document.querySelector('#fm-recognition')?.textContent.includes('当前订单识别结果'));await page.locator('#fm-manual').evaluate(e=>e.open=true);return page; -} -test('field mapping keeps no-sample versions visible, searches field values and never guesses quantity from amount',async t=>{ - const page=await setup(t);assert.match(await page.locator('#root').innerText(),/3.0/);assert.match(await page.locator('#root').innerText(),/真实分类/);await page.locator('#fm-orderNo').selectOption('form.order');assert.equal(await page.getByText('同名候选,尚未确认:FORM-1',{exact:true}).isVisible(),false);await page.locator('#fm-orderNo').selectOption('');await page.locator('#fm-search-orderNo').fill('特殊值');assert.equal(await page.locator('#fm-orderNo option[value="form.other"]').count(),1);assert.equal(await page.locator('#fm-orderNo option[value="form.order"]').count(),0);assert.equal(await page.locator('#fm-quantity').inputValue(),'form.qty');assert.equal(await page.locator('#fm-totalAmount').inputValue(),''); - await page.locator('[data-fm-version="1"]').click();assert.match(await page.locator('#fm-editor').innerText(),/尚无真实样本/);await page.setViewportSize({width:390,height:844});assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth<=innerWidth),true); +const test=require('node:test'),assert=require('node:assert/strict'); +const {orderDrivenUI}=require('../fixtures/order-driven-ui.cjs'); +test('field mapping page shows only persisted processes/nodes and toggles collection without editing rules',{timeout:60000},async t=>{ + const {page,runtime}=await orderDrivenUI(t);const before=runtime.orderRules.all('rules'); + await page.getByRole('switch',{name:'自动采集流程和节点',exact:true}).waitFor(); + assert.equal(await page.locator('#fm-orderNo,#fm-quantity,#fm-version-state').count(),0); + assert.equal(await page.getByRole('cell',{name:'备损订单更改评审',exact:true}).count(),1); + await page.getByRole('switch',{name:'自动采集流程和节点',exact:true}).uncheck();await page.getByText('字段映射采集已停用。',{exact:true}).waitFor(); + await page.reload();await page.getByRole('switch',{name:'自动采集流程和节点',exact:true}).waitFor();assert.equal(await page.getByRole('switch',{name:'自动采集流程和节点',exact:true}).isChecked(),false);assert.deepEqual(runtime.orderRules.all('rules'),before); + await page.setViewportSize({width:390,height:844});assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth<=innerWidth),true); }); - -test('reference paths without a real sample never count as configured fields',async t=>{ - const page=await setup(t,'admin',false,true);assert.match(await page.locator('#fm-editor').innerText(),/可选业务信息 · 0 项已对应/);assert.match(await page.locator('#fm-version-state').innerText(),/有参考配置,尚未核验/);assert.equal(await page.locator('#fm-save').isDisabled(),true); +test('rule picker offers BPM-observed pairs and never offers imported unknown scopes to a new row',{timeout:60000},async t=>{ + const {page,runtime,base}=await orderDrivenUI(t,'#order-rules');const s=runtime.orderRules,record=s.get('rules','trial-notice'); + record.draft.scopes=[{processName:'Excel独有流程',nodeName:'Excel独有节点'}];record.draft.processNames=['Excel独有流程'];record.draft.nodeNames=['Excel独有节点'];s.put('rules',record); + await page.getByRole('button',{name:'刷新规则与字段',exact:true}).click();await page.locator('[data-rule-id="bs-change"]').click();await page.getByRole('button',{name:'添加流程节点',exact:true}).click(); + const select=page.getByLabel('第2行适用流程',{exact:true});assert.doesNotMatch(await select.innerText(),/Excel独有流程/);assert.match(await select.innerText(),/备损订单更改评审/); + await select.selectOption('备损订单更改评审');assert.match(await page.getByLabel('第2行触发节点',{exact:true}).innerText(),/订单专员\(订单通知书\)/); + await page.getByRole('button',{name:'删除第2行',exact:true}).click();await page.getByRole('button',{name:'导入 Excel',exact:true}).click();const [download]=await Promise.all([page.waitForEvent('download'),page.getByRole('link',{name:'下载规则导入模板',exact:true}).click()]);assert.equal(download.suggestedFilename(),'规则导入模板.xlsx'); + const result=await page.request.post(base+'/api/order-rules/field-mappings/catalog-settings',{headers:{Origin:base},data:{version:1,enabled:'yes'}});assert.equal(result.status(),400); }); -test('save baseline stays clean after refresh failure and activation needs a fresh version check plus category confirmation',async t=>{ - const page=await setup(t);await page.locator('#fm-orderNo').selectOption('form.order');await page.getByText(/可选业务信息 ·/).evaluate(e=>e.parentElement.open=true);await page.locator('#fm-quantity').selectOption('form.qty');await page.evaluate(()=>failRefresh=true);await page.getByRole('button',{name:'保存草稿',exact:true}).click();await page.getByText(/刷新失败/).waitFor();assert.equal(await page.evaluate(()=>PageLifecycle.dirty()),false);assert.equal(await page.locator('#fm-orderNo').inputValue(),'form.order'); - const draft=await page.evaluate(()=>calls.find(c=>c.url.endsWith('/draft')).body);assert.deepEqual(draft.sources,{orderNo:{type:'form',path:'form.order'},brief:{type:'title'},quantity:{type:'form',path:'form.qty'}});assert.equal(draft.version,0);assert.equal(await page.locator('#fm-activate').isDisabled(),true); - await page.getByRole('button',{name:'检查识别结果',exact:true}).click();await page.getByText('FORM-1_20261020_SER1.pdf',{exact:true}).waitFor();assert.match(await page.locator('#fm-result').innerText(),/TITLE-1/);await page.getByRole('button',{name:'检查识别结果',exact:true}).click();const checkKeys=await page.evaluate(()=>calls.filter(c=>c.url.endsWith('/check')).map(c=>c.body.idempotencyKey));assert.notEqual(checkKeys[0],checkKeys[1]);assert.equal(await page.locator('#fm-activate').isDisabled(),true);await page.locator('#fm-confirm').check();await page.locator('#fm-activate').click();await page.getByText(/字段对应已确认生效/).waitFor();assert.equal(await page.evaluate(()=>calls.filter(c=>c.url.endsWith('/activate')).length),1); - await page.locator('#fm-quantity').selectOption('');assert.equal(await page.locator('#fm-activate').isDisabled(),true);assert.equal(await page.evaluate(()=>PageLifecycle.dirty()),true); +test('manual BPM discovery reads only list metadata and retains saved choices on a failed retry',{timeout:60000},async t=>{ + const {page,runtime,sample}=await orderDrivenUI(t);let scans=0;runtime.orderExecution.provider.scan=async()=>{scans++;if(scans>1)throw Error('隔离连接读取失败');return [{...sample,taskId:'new-task',processName:'新采集流程',nodeName:'新采集节点'}];}; + await page.getByRole('button',{name:'从 BPM 更新',exact:true}).click();await page.getByRole('cell',{name:'新采集流程',exact:true}).waitFor();const before=runtime.orderRules.all('scope-catalog'); + for(const kind of ['orders','batches','execution-tasks'])assert.deepEqual(runtime.orderRules.all(kind),[]); + await page.getByRole('button',{name:'从 BPM 更新',exact:true}).click();await page.getByText('隔离连接读取失败',{exact:true}).waitFor();assert.deepEqual(runtime.orderRules.all('scope-catalog'),before);assert.equal(await page.getByRole('cell',{name:'新采集流程',exact:true}).count(),1); }); -test('dirty switching is guarded and a pending save locks edits while a late response never refreshes a departed page',async t=>{ - const page=await setup(t);await page.locator('#fm-orderNo').selectOption('form.order');await page.locator('[data-fm-version="1"]').click();await page.getByRole('button',{name:'留在此页',exact:true}).click();assert.equal(await page.locator('#fm-orderNo').inputValue(),'form.order');await page.evaluate(()=>deferSave=true);await page.getByRole('button',{name:'保存草稿',exact:true}).click();await page.waitForFunction(()=>typeof releaseSave==='function');assert.equal(await page.locator('#fm-orderNo').isDisabled(),true);assert.equal(await page.locator('[data-fm-version="1"]').isDisabled(),true);await page.evaluate(()=>{active=false;releaseSave();});await page.waitForTimeout(50);assert.equal(await page.evaluate(()=>calls.filter(c=>c.url.startsWith('/order-rules/fields')).length),1);assert.equal(await page.locator('#notice').innerText(),''); -}); -for(const role of ['operator','viewer'])test(role+' sees readonly bindings and never reads connection permissions or posts sample actions',async t=>{ - const page=await setup(t,role);assert.equal(await page.locator('#fm-orderNo').isDisabled(),true);assert.equal(await page.locator('#fm-orderNo').inputValue(),'form.order');assert.match(await page.locator('#fm-version-state').innerText(),/生效 v4/);assert.equal(await page.getByRole('button',{name:'保存草稿',exact:true}).count(),0);assert.equal(await page.evaluate(()=>calls.some(c=>c.url==='/workspace'||c.body&&!c.url.endsWith('/propose'))),false); -}); -test('sample capture uses listed row identity, guards dirty input, and can fetch a new list after successful reads',async t=>{ - const page=await setup(t);await page.locator('#fm-orderNo').selectOption('form.order');await page.getByText('从 BPM 选择',{exact:true}).click();await page.locator('[data-picker=connection]').selectOption('c1');await page.getByRole('button',{name:'读取待办列表',exact:true}).click();await page.locator('[data-picker-capture]').waitFor();await page.getByRole('button',{name:'读取待办列表',exact:true}).click();await page.waitForFunction(()=>calls.filter(c=>c.url.endsWith('/field-samples/list')).length===2);const keys=await page.evaluate(()=>calls.filter(c=>c.url.endsWith('/field-samples/list')).map(c=>c.body.idempotencyKey));assert.notEqual(keys[0],keys[1]);await page.evaluate(()=>window.failCapture=true);await page.locator('[data-picker-capture]').click();await page.getByRole('button',{name:'放弃并继续',exact:true}).click();await page.getByText('采集断线',{exact:true}).waitFor();assert.equal(await page.locator('#fm-orderNo').inputValue(),'form.order');await page.evaluate(()=>window.failCapture=false);await page.locator('[data-picker-capture]').click();await page.getByRole('button',{name:'放弃并继续',exact:true}).click();await page.waitForFunction(()=>document.querySelector('#fm-sample')?.value==='s2');assert.equal(await page.locator('#fm-sample').inputValue(),'s2');const body=await page.evaluate(()=>calls.find(c=>c.url.endsWith('/field-samples/capture')).body);assert.equal(body.connectionId,'c1');assert.equal(body.listId,'list-1');assert.equal(body.rowId,'row-1');const captureKeys=await page.evaluate(()=>calls.filter(c=>c.url.endsWith('/field-samples/capture')).map(c=>c.body.idempotencyKey));assert.notEqual(captureKeys[0],captureKeys[1]);assert.equal(await page.evaluate(()=>calls.some(c=>/order-execution|adapters|pdf|mail/.test(c.url))),false); -}); - -test('a definite sample-list failure can be retried with a new key while an uncertain attempt retains its key',async t=>{ - const page=await setup(t);await page.getByText('从 BPM 选择',{exact:true}).click();await page.locator('[data-picker=connection]').selectOption('c1');await page.evaluate(()=>window.failList=true);await page.getByRole('button',{name:'读取待办列表',exact:true}).click();await page.getByText('列表读取失败',{exact:true}).waitFor();await page.evaluate(()=>{window.failList=false;window.uncertainList=true;});await page.getByRole('button',{name:'读取待办列表',exact:true}).click();await page.getByText('结果待核实',{exact:true}).waitFor();await page.evaluate(()=>window.uncertainList=false);await page.getByRole('button',{name:'读取待办列表',exact:true}).click();await page.locator('[data-picker-capture]').waitFor();const keys=await page.evaluate(()=>calls.filter(c=>c.url.endsWith('/field-samples/list')).map(c=>c.body.idempotencyKey));assert.notEqual(keys[0],keys[1]);assert.equal(keys[1],keys[2]); -}); -test('legacy active-only mappings load field paths and start an independent draft revision that survives refresh failures',async t=>{ - const page=await setup(t,'admin',true);assert.equal(await page.locator('#fm-orderNo').inputValue(),'form.order');assert.equal(await page.locator('#fm-quantity').inputValue(),'form.qty');assert.match(await page.locator('#fm-version-state').innerText(),/生效 v9/);assert.equal(await page.locator('#fm-check').isDisabled(),true);await page.evaluate(()=>window.failRefresh=true);await page.getByRole('button',{name:'保存草稿',exact:true}).click();await page.getByText(/刷新失败/).waitFor();assert.equal(await page.evaluate(()=>PageLifecycle.dirty()),false);await page.locator('[data-fm-version="1"]').click();await page.locator('[data-fm-version="0"]').click();await page.locator('#fm-manual').evaluate(e=>e.open=true);await page.locator('#fm-quantity').selectOption('');await page.getByRole('button',{name:'保存草稿',exact:true}).click();await page.waitForFunction(()=>calls.filter(c=>c.url.endsWith('/draft')).length===2&&!document.querySelector('#fm-save').disabled);const writes=await page.evaluate(()=>calls.filter(c=>c.url.endsWith('/draft')).map(c=>c.body));assert.deepEqual(writes.map(body=>body.version),[0,1]);assert.deepEqual(writes[0].sources,{brief:{type:'title'},orderNo:{type:'form',path:'form.order'},quantity:{type:'form',path:'form.qty'}});assert.equal(await page.evaluate(()=>PageLifecycle.dirty()),false);assert.match(await page.locator('#fm-version-state').innerText(),/草稿 v2/); -}); - -test('directory refresh locks edits until its response is applied',async t=>{const page=await setup(t,'admin',true);await page.evaluate(()=>window.deferRefresh=true);await page.getByRole('button',{name:'刷新目录',exact:true}).click();await page.waitForFunction(()=>typeof releaseRefresh==='function');assert.equal(await page.locator('#fm-orderNo').isDisabled(),true);assert.equal(await page.locator('[data-fm-version="1"]').isDisabled(),true);await page.evaluate(()=>releaseRefresh());await page.waitForFunction(()=>!document.querySelector('#fm-refresh').disabled);assert.equal(await page.locator('#fm-orderNo').isDisabled(),false);assert.equal(await page.locator('#fm-orderNo').inputValue(),'form.order');}); diff --git a/tests/order-rules/order-driven-rules-ui.test.cjs b/tests/order-rules/order-driven-rules-ui.test.cjs index 49fe699..2aeaafd 100644 --- a/tests/order-rules/order-driven-rules-ui.test.cjs +++ b/tests/order-rules/order-driven-rules-ui.test.cjs @@ -39,6 +39,6 @@ test('leaving distribution for mapping respects unsaved inputs and business sear await page.getByLabel('收件人',{exact:true}).fill('keep@example.test');await page.getByLabel('搜索流程或节点',{exact:true}).fill('备损');await page.getByLabel('搜索流程或节点',{exact:true}).press('Enter'); assert.equal(runtime.orderRules.get('rules','bs-change').draft.version,version); await page.getByRole('link',{name:'字段映射',exact:true}).first().click();await page.getByRole('button',{name:'留在此页',exact:true}).click();assert.equal(await page.getByLabel('收件人',{exact:true}).inputValue(),'keep@example.test'); - await page.getByRole('link',{name:'字段映射',exact:true}).first().click();await page.getByRole('button',{name:'放弃并继续',exact:true}).click();await page.locator('#fm-orderNo').waitFor({state:'attached'}); + await page.getByRole('link',{name:'字段映射',exact:true}).first().click();await page.getByRole('button',{name:'放弃并继续',exact:true}).click();await page.getByRole('switch',{name:'自动采集流程和节点',exact:true}).waitFor(); assert.deepEqual(runtime.orderRules.all('field-mapping-drafts'),[]); }); diff --git a/tests/order-rules/scope-catalog.test.cjs b/tests/order-rules/scope-catalog.test.cjs new file mode 100644 index 0000000..c563281 --- /dev/null +++ b/tests/order-rules/scope-catalog.test.cjs @@ -0,0 +1,45 @@ +'use strict'; +const test=require('node:test'),assert=require('node:assert/strict'),fs=require('node:fs'),os=require('node:os'),path=require('node:path'); +const {RuleStore}=require('../../src/modules/order-rules/store.cjs'); +const catalog=()=>require('../../src/modules/order-rules/scope-catalog.cjs'); +function fixture(t){const dir=fs.mkdtempSync(path.join(os.tmpdir(),'scope-catalog-'));let store=new RuleStore(dir);t.after(()=>{store.close();assert.equal(path.dirname(fs.realpathSync(dir)).toLowerCase(),fs.realpathSync(os.tmpdir()).toLowerCase());fs.rmSync(dir,{recursive:true,force:true});});return {get store(){return store;},reopen(){store.close();store=new RuleStore(dir);return store;}};} +test('BPM directory persists only observed process/node pairs and pauses discovery without deleting choices',t=>{ + const f=fixture(t),c=catalog(),s=f.store;assert.deepEqual(c.directory(s).scopes,[]); + c.observe(s,[{source:'todo',processName:'流程A',nodeName:'节点甲'},{source:'todo',processName:'流程A',nodeName:'节点甲'},{source:'todo',processName:'流程B',nodeName:'节点乙'},{source:'history',processName:'流程C',nodeName:'历史查看(未提供办理节点)'}]); + assert.deepEqual(c.directory(s).scopes,[{processName:'流程A',nodeName:'节点甲'},{processName:'流程B',nodeName:'节点乙'}]); + const before=c.directory(s);c.configure(s,{version:before.settings.version,enabled:false},{role:'admin',username:'admin'});c.observe(s,[{source:'todo',processName:'流程D',nodeName:'节点丁'}]); + assert.deepEqual(c.directory(f.reopen()).scopes,before.scopes);assert.equal(c.directory(f.store).settings.enabled,false); + assert.throws(()=>c.configure(f.store,{version:1,enabled:true},{role:'viewer',username:'v'}),e=>e.status===403); + assert.throws(()=>c.configure(f.store,{version:before.settings.version,enabled:true},{role:'admin',username:'admin'}),e=>e.status===409); +}); +test('Excel unknown pairs warn without changing the directory and cannot apply; known same-category rows combine',t=>{ + const s=fixture(t).store,c=catalog(),imp=require('../../src/modules/order-rules/import.cjs'); + c.observe(s,[{source:'todo',processName:'流程A',nodeName:'节点甲'},{source:'todo',processName:'流程B',nodeName:'节点乙'}]); + const before=c.directory(s),header=['类别编号','分类名称','流程名称','触发节点','归档目录','邮件命名','收件人']; + const row=(p,n)=>['bs-change','备损订单更改通知书',p,n,'测试目录','【备损订单更改通知书】','recipient@example.test']; + let plan=imp.previewImport(s,{rows:[header,row('Excel独有流程','节点甲')]},'admin');assert.equal(plan.canCommit,true);assert.equal(plan.canApply,false);assert.match(plan.rows[0].warnings.join(' '),/第2行.*流程.*未.*采集/); + imp.commitImport(s,{id:plan.id},'admin');assert.deepEqual(c.directory(s),before); + assert.throws(()=>imp.commitImport(s,{id:imp.previewImport(s,{rows:[header,row('流程A','节点乙')]},'admin').id,applyToTest:true},'admin'),/字段映射|BPM/); + plan=imp.previewImport(s,{rows:[header,row('流程A','节点甲'),row('流程B','节点乙')]},'admin');assert.equal(plan.canApply,true);assert.equal(plan.rows.length,1); + imp.commitImport(s,{id:plan.id},'admin');assert.deepEqual(s.get('rules','bs-change').draft.scopes,before.scopes);assert.deepEqual(c.directory(s),before); + const conflict=row('流程B','节点乙');conflict[6]='other@example.test';plan=imp.previewImport(s,{rows:[header,row('流程A','节点甲'),conflict]},'admin');assert.equal(plan.canCommit,false);assert.match(plan.rows.flatMap(r=>r.issues).join(' '),/不一致/); +}); +test('import template offers actual BPM choices and supports one row per scope without writing mappings',async t=>{ + const s=fixture(t).store,c=catalog(),XLSX=require('xlsx');c.observe(s,[{source:'todo',processName:'流程A',nodeName:'节点甲'}]); + const before=c.directory(s),bytes=await require('../../src/modules/order-rules/import-template.cjs').template(s,{importTemplate:true}),book=XLSX.read(bytes,{type:'buffer'}); + assert(book.SheetNames.includes('填写说明'));assert(book.SheetNames.includes('BPM可选项'));assert.deepEqual(XLSX.utils.sheet_to_json(book.Sheets['BPM可选项']),[{流程名称:'流程A',触发节点:'节点甲'}]); + const rows=XLSX.utils.sheet_to_json(book.Sheets['分类规则'],{header:1});assert(rows[0].includes('邮件模板ID'));assert(rows[0].includes('流程名称'));assert.deepEqual(c.directory(s),before); +}); +test('BPM names retain their exact punctuation through catalog selection and Excel import',t=>{ + const s=fixture(t).store,c=catalog(),scope={processName:'订单流程(国内)/变更+复核',nodeName:'订单专员(通知)/复核+归档'};c.observe(s,[{source:'todo',...scope}]);assert.deepEqual(c.directory(s).scopes,[scope]); + const imp=require('../../src/modules/order-rules/import.cjs'),plan=imp.previewImport(s,{rows:[['类别编号','分类名称','流程名称','触发节点','邮件命名','收件人'],['bs-change','备损订单更改通知书',scope.processName,scope.nodeName,'【通知】','recipient@example.test']]},'admin');assert.equal(plan.canApply,true);imp.commitImport(s,{id:plan.id},'admin');assert.deepEqual(s.get('rules','bs-change').draft.scopes,[scope]); +}); +test('Excel template references are checked per source row before any draft write',t=>{ + const s=fixture(t).store,imp=require('../../src/modules/order-rules/import.cjs'),before=s.all('rules'),mail={store:{template(){throw Object.assign(Error('邮件模板不存在'),{status:404});}}}; + const plan=imp.previewImport(s,{rows:[['类别编号','流程名称','触发节点','邮件命名','收件人','邮件模板ID'],['bs-change','流程A','节点甲','【通知】','recipient@example.test','missing-template']]},'admin',{mail});assert.equal(plan.canCommit,false);assert.equal(plan.rows[0].sourceRow,2);assert.match(plan.rows[0].issues.join(' '),/模板/);assert.deepEqual(s.all('rules'),before); +}); +test('scope APIs expose only choices to readers and reject non-admin writes',async t=>{ + const s=fixture(t).store,c=catalog(),{orderExecutionApi}=require('../../src/modules/order-execution/api.cjs');c.observe(s,[{source:'todo',processName:'流程A',nodeName:'节点甲',title:'私密订单内容'}]); + for(const role of ['viewer','operator']){let result;await orderExecutionApi({orderRules:s,user:{username:role,role},url:new URL('http://localhost/api/order-rules/fields?view=scopes'),route:'/api/order-rules/fields',method:'GET',reply:(status,value)=>{assert.equal(status,200);result=value;}});assert.deepEqual(result.scopes,[{processName:'流程A',nodeName:'节点甲'}]);assert(!JSON.stringify(result).includes('私密订单')); + await assert.rejects(orderExecutionApi({orderRules:s,user:{username:role,role},route:'/api/order-rules/field-mappings/catalog-settings',method:'POST',body:{version:1,enabled:false},reply(){}}),e=>e.status===403);} +}); diff --git a/tests/order-rules/workbench-ui.test.cjs b/tests/order-rules/workbench-ui.test.cjs index 96745ba..fbfb74f 100644 --- a/tests/order-rules/workbench-ui.test.cjs +++ b/tests/order-rules/workbench-ui.test.cjs @@ -7,6 +7,7 @@ async function setup(t){ const dir=await fs.mkdtemp(path.join(os.tmpdir(),'rule-workbench-ui-')),runtime=await startTestDashboard({stateDir:dir}),browser=await loadPlaywright().chromium.launch(browserOptions()); t.after(async()=>{await browser.close();await runtime.close();await fs.rm(dir,{recursive:true,force:true});}); const {captured}=activateReferenceMapping(runtime.orderRules); + require('../../src/modules/order-rules/scope-catalog.cjs').observe(runtime.orderRules,[{source:'todo',processName:'试产订单更改评审',nodeName:'订单专员(订单通知书)'}]); const initial=runtime.orderRules.get('rules','bs-change').draft;runtime.orderRules.saveRule({...initial,archiveDirectory:'\\\\fixture-server\\orders'},'admin'); const page=await browser.newPage({viewport:{width:1440,height:1000}});page.setDefaultTimeout(7000);await page.route('**/api/order-rules/fields',route=>route.fulfill({json:runtime.orderRules.fields()})); await page.goto('http://127.0.0.1:'+runtime.server.address().port+'/#order-rules');await login(page);await page.locator('[data-rule-id="bs-change"]').click();return{page,runtime,captured,browser}; diff --git a/web/app.js b/web/app.js index 28e3e73..31f0b6c 100644 --- a/web/app.js +++ b/web/app.js @@ -5,7 +5,7 @@ const formatDate=value=>{const date=new Date(value);return value&&!Number.isNaN( const roles={admin:'管理员',operator:'操作员',viewer:'只读成员'}; const statusMap={running:['处理中','blue'],success:['已完成','green'],error:['失败','red'],interrupted:['已中断','orange']}; let currentUser=null,settings=null,currentView='overview',overview=null,refreshTimer=null,viewGeneration=0,historyIndex=0,historyTransition=null,automationRevision=0,overviewRevision=0; -const views={tools:['工具','手工导出、文件查看与助手'],'records-pdf':['订单与导出记录','查询PDF导出结果、文件可用性与存储归档记录'],'order-notifications':['通知总览','查看当前发送时段、待发订单及接入阻塞'],'notification-execution':['订单执行','扫描真实待办,查看归档进度与受控恢复'],'notification-orders':['订单中心','查看订单分类、归档证据及所属邮件批次'],'notification-batches':['邮件批次','按发送时段检查分类汇总和冻结内容'],'notification-history':['发送记录','核对发送结果、冻结内容和人工恢复记录'],'notification-settings':['发送设置','维护发件邮箱、邮件限制与自动通知开关'],'rule-fields':['字段映射','从真实 BPM 样本选择字段,按表单版本保存对应关系'],'assistant-settings':['助手设置','配置 ZCode 运行包、模型与受控操作权限'],'business-settings':['业务设置','维护 Excel 分类规则、收件人和真实字段对应'],'system-settings':['系统设置','集中管理服务连接、运行维护和团队权限'],account:['个人账号','维护自己的登录密码与访问安全'],'order-rules':['分类通知规则','按 Excel 类别维护匹配、归档、收件人与通知正文'],health:['系统健康','查看服务守护、登录自启和各模块最近检查结果'],assistant:['ZCode 助手','对话查询运行状态、分析异常与执行受控恢复'],storage:['存储服务器','配置 SMB 共享目录、检查连接与管理 PDF 归档'],notifications:['兼容业务通知','原来源映射、产业接口人与通知队列'],overview:['业务首页','订单处理、邮件窗口、业务阻塞与待核验'],calendar:['业务日历','按公司实际安排设置工作日、休息日与暂停日期'],exceptions:['异常待办','认领、转交和跟进异常'],bpm:['BPM 连接','管理连接及负责人'],supervisor:['运行监管','配置负责人、通知方式与重试上限'],records:['订单与导出记录','查询已经采集的订单,下载已完成的 PDF'],rules:['分类通知规则','按 Excel 类别维护匹配、归档、收件人与通知正文'],schedule:['发送计划','设置每日两个发送时间及周末安排'],templates:['邮件模板','管理模板及 Excel 类别关联;收件名单在分类规则维护'],mail:['邮箱管理','维护托管邮箱、模板收信与连接状态'],connections:['服务接入','查看各个环节的接入情况'],users:['团队账号','为局域网内的同事分配访问权限'],audit:['操作记录','查看配置变更和导出任务的处理记录']}; +const views={tools:['工具','手工导出、文件查看与助手'],'records-pdf':['订单与导出记录','查询PDF导出结果、文件可用性与存储归档记录'],'order-notifications':['通知总览','查看当前发送时段、待发订单及接入阻塞'],'notification-execution':['订单执行','扫描真实待办,查看归档进度与受控恢复'],'notification-orders':['订单中心','查看订单分类、归档证据及所属邮件批次'],'notification-batches':['邮件批次','按发送时段检查分类汇总和冻结内容'],'notification-history':['发送记录','核对发送结果、冻结内容和人工恢复记录'],'notification-settings':['发送设置','维护发件邮箱、邮件限制与自动通知开关'],'rule-fields':['字段映射','采集BPM流程和节点,供分类规则选择匹配项'],'assistant-settings':['助手设置','配置 ZCode 运行包、模型与受控操作权限'],'business-settings':['业务设置','维护Excel分类规则、收件人和BPM流程节点目录'],'system-settings':['系统设置','集中管理服务连接、运行维护和团队权限'],account:['个人账号','维护自己的登录密码与访问安全'],'order-rules':['分类通知规则','按 Excel 类别维护匹配、归档、收件人与通知正文'],health:['系统健康','查看服务守护、登录自启和各模块最近检查结果'],assistant:['ZCode 助手','对话查询运行状态、分析异常与执行受控恢复'],storage:['存储服务器','配置 SMB 共享目录、检查连接与管理 PDF 归档'],notifications:['兼容业务通知','原来源映射、产业接口人与通知队列'],overview:['业务首页','订单处理、邮件窗口、业务阻塞与待核验'],calendar:['业务日历','按公司实际安排设置工作日、休息日与暂停日期'],exceptions:['异常待办','认领、转交和跟进异常'],bpm:['BPM 连接','管理连接及负责人'],supervisor:['运行监管','配置负责人、通知方式与重试上限'],records:['订单与导出记录','查询已经采集的订单,下载已完成的 PDF'],rules:['分类通知规则','按 Excel 类别维护匹配、归档、收件人与通知正文'],schedule:['发送计划','设置每日两个发送时间及周末安排'],templates:['邮件模板','管理模板及 Excel 类别关联;收件名单在分类规则维护'],mail:['邮箱管理','维护托管邮箱、模板收信与连接状态'],connections:['服务接入','查看各个环节的接入情况'],users:['团队账号','为局域网内的同事分配访问权限'],audit:['操作记录','查看配置变更和导出任务的处理记录']}; const pendingWrites=new Map(); async function api(route,body,{signal,ownerCheck,managedOutcome=false}={}) { const originGeneration=viewGeneration,originUser=currentUser,originRevision=window.PageLifecycle?.revision;const originActive=()=>viewGeneration===originGeneration&¤tUser===originUser&&window.PageLifecycle?.revision===originRevision;const submission=window.PageLifecycle?.submission,hasBody=body!==undefined,write=hasBody&&route!=='/order-rules/field-mappings/propose',key=originGeneration+':'+originRevision+':'+route+':'+JSON.stringify(body);const pending=pendingWrites.get(key);if(write&&pending?.user===originUser)return pending.work; diff --git a/web/modules/field-mappings/view.js b/web/modules/field-mappings/view.js index 0f1ce39..a5a4859 100644 --- a/web/modules/field-mappings/view.js +++ b/web/modules/field-mappings/view.js @@ -1,72 +1,26 @@ (() => { 'use strict'; - const labels={orderNo:'订单号',customer:'客户',quantity:'数量',appDate:'申请日期',productLine:'产品线',changeReason:'更改原因',changeContent:'更改内容',totalAmount:'总金额'}; - const optional=Object.keys(labels).filter(key=>key!=='orderNo'); - const text=value=>value==null?'':typeof value==='object'?JSON.stringify(value):String(value); - const states={noSample:'未采集',missing:'待配置',draft:'待检查',checked:'检查通过',active:'已核验',invalid:'检查未通过',reference:'参考配置',changed:'版本变化'}; - const stateOf=version=>({'未采集':'noSample','待配置':'missing','待检查':'draft','检查通过':'checked','检查未通过':'invalid','已核验':'active','版本变化':'changed',verified:'active'})[version.status]||version.status||(version.active?'active':version.draft?'draft':'missing'); - async function render(host,{api,esc,user,isActive=()=>true,feedback=()=>{},formatDate=value=>value||'—',initialSampleId=null,embedded=false,onActivated=async()=>{},onSourcesChanged=()=>{}}){ - const lifecycle=window.PageLifecycle,admin=user.role==='admin'; - let data=await api('/order-rules/fields?view=directory');if(!isActive())return; - let disposed=false,busy=false,revision=0,readRevision=0,selection=0,selectedFallback=null,sampleId='',sources={},record=null,draftVersion=0,check=null,baseline='',query='',stateFilter='all',connections=[],proposal=null,proposalRevision=0,pickerController=null,panelController=null,sourcesEdited=false,uncertain=false; - const live=()=>!disposed&&isActive(),keyCache=new Map(),allVersions=()=>groups().flatMap(process=>(process.versions||[]).map(version=>({process,version}))),selected=()=>selectedFallback||allVersions()[selection]; - function groups(){if(Array.isArray(data.processes))return data.processes;const result=[];for(const sample of data.samples||[]){let process=result.find(p=>p.processName===sample.processName);if(!process){process={processName:sample.processName,categories:[],versions:[]};result.push(process);}let version=process.versions.find(v=>v.processVersion===sample.processVersion);if(!version){version={processVersion:sample.processVersion,sampleIds:[],status:'missing'};process.versions.push(version);}version.sampleIds.push(sample.id);version.sampleCount=version.sampleIds.length;}data.processes=result;return result;} - const samples=()=>{const current=selected();return (data.samples||[]).filter(sample=>sample.processName===current?.process.processName&&sample.processVersion===current?.version.processVersion&&sample.sample?.demo!==true);}; - const sample=()=>samples().find(item=>item.id===sampleId),catalog=()=>sample()?.fields||sample()?.snapshot?.fields||[],snapshot=()=>JSON.stringify(sources); - const dirty=()=>admin&&!!baseline&&baseline!==snapshot(); - const requestKey=(route,body)=>{const signature=route+JSON.stringify(body);if(!keyCache.has(signature))keyCache.set(signature,lifecycle.requestKey());return keyCache.get(signature);}; - const post=(route,body)=>api(route,{...body,idempotencyKey:requestKey(route,body)},{managedOutcome:route.startsWith('/order-rules/field-mappings/')}); - - const guard=work=>{if(busy||!live())return false;return lifecycle.guard(work);}; - const badge=version=>{const state=stateOf(version);return `${esc(states[state]||state)}`;}; - host.innerHTML=`
字段对应

`; - const get=id=>host.querySelector('#'+id); - function drawDirectory(){let index=0,visible=0;get('fm-directory-list').innerHTML=groups().map(process=>{ - const versions=(process.versions||[]).map(version=>({version,index:index++}));const searchable=[process.processName,...(process.categories||[]).map(c=>c.name)].join(' ').toLowerCase();if(query&&!searchable.includes(query.toLowerCase()))return ''; - const rows=versions.filter(({version})=>stateFilter==='all'||stateOf(version)===stateFilter);if(!rows.length)return '';visible+=rows.length; - return `
${esc(process.processName)}
关联分类:${esc((process.categories||[]).map(c=>c.name).join('、')||'暂无关联分类')}
${rows.map(({version,index})=>``).join('')}
`; - }).join('')||'
暂无符合条件的流程版本
';get('fm-directory-list').querySelectorAll('[data-fm-version]').forEach(button=>button.onclick=()=>{const next=Number(button.dataset.fmVersion);if(next===selection)return;return guard(()=>{selection=next;selectedFallback=null;++revision;loadSelection();drawDirectory();drawEditor();pickerController?.setContext({processNames:[selected()?.process.processName].filter(Boolean)});requestProposal();});});return visible;} - function loadSelection(){const version=selected()?.version;record=version?.draft||version?.active||null;draftVersion=version?.draft?.version||0;check=version?.draft?.check||null;sampleId=samples().some(s=>s.id===record?.sampleId)?record.sampleId:samples()[0]?.id||'';sources={brief:{type:'title'}};const reference=record,saved=reference?.sources||Object.fromEntries(Object.entries(reference?.fields||{}).filter(([,path])=>typeof path==='string'&&path).map(([name,path])=>[name,{type:'form',path}]));for(const name of Object.keys(labels)){if(saved?.[name])sources[name]=structuredClone(saved[name]);}baseline=snapshot();sourcesEdited=false;proposal=null;++proposalRevision;} - function fieldOptions(name,search=''){const current=sources[name]?.path||'',fields=Array.isArray(catalog())?catalog():[];return ''+fields.filter(field=>field.path===current||[field.label,text(field.value)].join(' ').toLowerCase().includes(search.toLowerCase())).map(field=>``).join('');} - function binding(name){const path=sources[name]?.path,field=catalog().find(item=>item.path===path),suggestions=!path?catalog().filter(item=>item.label===labels[name]):[];return `
${esc(field?text(field.value):'尚未对应')}
${suggestions.length===1?'
同名候选,尚未确认:'+esc(text(suggestions[0].value))+'
':''}
字段路径详情${esc(path||'尚未选择字段')}
`;} - function drawEditor(){const manualOpen=!!get('fm-manual')?.open;const current=selected();if(!current){get('fm-heading').textContent='暂无流程';get('fm-editor').innerHTML='
暂无流程目录。请检查类别规则与采集状态。
';return;} - get('fm-heading').textContent=current.process.processName+' · '+(current.version.processVersion||'版本未提供');const item=sample(),meta=item?.sample||item||{},hasSample=!!item; - panelController?.dispose();get('fm-editor').innerHTML=`
01

选择真实样本

${esc(meta.serialNum||'')} · ${esc(meta.source==='history'?'历史 · 节点未提供':meta.nodeName||'')}
${hasSample?`${meta.source==='history'?'
历史只读样本,仅用于字段配置;未提供办理节点及通知接收时间,不能直接用于通知执行。
':''}
完整${meta.source==='history'?'历史':'待办'}标题
${esc(meta.title||'样本未包含待办标题,检查时会提示缺失')}
`:'
此版本尚无真实样本,请从 BPM 待办读取列表后采集。
'}

采样与真实订单选择统一使用上方真实订单选择器。

02

核对自动识别的信息

逐项维护字段(高级)

从实际字段标签与当前值选择。元数据固定来自待办;数量与总金额分别对应。

${binding('orderNo')}
摘要来源
完整待办标题 → 订单段落
保留所有标题订单;主订单单独取表单订单号。
sources[name])?'open':''}>可选业务信息 · ${optional.filter(name=>sources[name]).length} 项已对应
${optional.map(binding).join('')}
03

核对识别结果

04

保存与确认生效

关联分类:${esc((current.process.categories||[]).map(c=>c.name).join('、')||'无')}
${admin?`
`:'

当前账号只读,字段对应由管理员维护。

'}
`; - get('fm-sample').onchange=()=>{const next=get('fm-sample').value;get('fm-sample').value=sampleId;return guard(()=>{sampleId=next;++revision;check=null;sourcesEdited=false;baseline=snapshot();drawEditor();requestProposal();});}; - host.querySelectorAll('[data-fm-search]').forEach(input=>input.oninput=()=>{const name=input.dataset.fmSearch;get('fm-'+name).innerHTML=fieldOptions(name,input.value);}); - host.querySelectorAll('[data-fm-binding]').forEach(select=>select.onchange=()=>{const name=select.dataset.fmBinding;if(select.value)sources[name]={type:'form',path:select.value};else delete sources[name];sourcesEdited=true;onSourcesChanged(structuredClone(sources));++proposalRevision;proposal=null;check=null;get('fm-confirm')&&(get('fm-confirm').checked=false);const field=catalog().find(f=>f.path===select.value);get('fm-value-'+name).textContent=field?text(field.value):'尚未对应';get('fm-path-'+name).textContent=select.value||'尚未选择字段';const suggestion=get('fm-suggestion-'+name);if(suggestion)suggestion.hidden=!!select.value;drawResult();updateActions();requestProposal();}); - if(admin){get('fm-save').onclick=save;get('fm-check').onclick=runCheck;get('fm-activate').onclick=activate;get('fm-confirm').onchange=updateActions;} - if(manualOpen)get('fm-manual').open=true;get('fm-manual').ontoggle=async()=>{if(!get('fm-manual')?.open||catalog().length||!sampleId)return;const id=sampleId,owner=proposalRevision;try{const fresh=await api('/order-rules/fields');if(!live()||id!==sampleId||owner!==proposalRevision)return;const item=fresh.samples.find(s=>s.id===id);if(item){Object.assign(sample(),{fields:item.fields||item.snapshot?.fields||[]});if(catalog().length)drawEditor();}}catch(error){if(live()&&id===sampleId)feedback('字段读取失败:'+error.message,'warning');}};drawResult();updateActions();drawProposal(); + async function render(host,{api,esc,user,isActive=()=>true,feedback=()=>{}}){ + const admin=user.role==='admin';let data,busy=false,disposed=false,revision=0,query='',connections=[]; + const live=()=>!disposed&&isActive(),key=()=>window.PageLifecycle.requestKey(); + function lock(value){busy=value;host.setAttribute('aria-busy',String(value));host.querySelectorAll('button,input,select').forEach(e=>e.disabled=value||e.dataset.admin==='true'&&!admin);const discover=host.querySelector('#fm-discover');if(discover)discover.disabled=value||!data?.settings.enabled||!connections.length;} + async function load(){const request=++revision;const fresh=await api('/order-rules/fields?view=scopes');if(!live()||request!==revision)return;data=fresh;draw();} + function rows(){const scopes=data.scopes.filter(s=>(s.processName+' '+s.nodeName).toLocaleLowerCase().includes(query.toLocaleLowerCase())),groups=new Map();for(const s of scopes){if(!groups.has(s.processName))groups.set(s.processName,[]);groups.get(s.processName).push(s.nodeName);}host.querySelector('#fm-count').textContent=new Set(data.scopes.map(s=>s.processName)).size+' 个流程 · '+data.scopes.length+' 个流程节点配对';host.querySelector('#fm-rows').innerHTML=[...groups].map(([process,nodes])=>''+esc(process)+''+nodes.map(n=>'
'+esc(n)+'
').join('')+'').join('')||''+(query?'没有匹配的流程或节点。':'尚未采集到流程和节点,请选择BPM连接更新。')+'';} + async function act(work){if(busy||!live())return;lock(true);try{await work();}catch(e){if(live())feedback(e.message,'danger');}finally{if(live()){const toggle=host.querySelector('#fm-enabled');if(toggle)toggle.checked=data.settings.enabled;lock(false);}}} + function draw(){ + const selected=host.querySelector('#fm-connection')?.value; + host.innerHTML='

字段映射

从BPM采集流程与节点,保存后供规则匹配选择。Excel只导入分类规则,不修改此目录。

停用只停止发现新项,已保存目录和已有业务规则继续使用。新发现的配对不会自动启用通知。

'+ + (admin?'

只读获取当前待办中的流程和节点,不打开订单详情,不办理BPM,不创建订单或发送邮件。尚未发现的节点需后续采集。

':'')+ + '

流程名称触发节点
'; + if(selected&&connections.some(c=>c.id===selected))host.querySelector('#fm-connection').value=selected; + rows();host.querySelector('#fm-search').oninput=e=>{query=e.target.value;rows();};host.querySelector('#fm-refresh').onclick=()=>act(load); + if(admin){host.querySelector('#fm-enabled').onchange=e=>{const enabled=e.target.checked;act(async()=>{const fresh=await api('/order-rules/field-mappings/catalog-settings',{version:data.settings.version,enabled});if(!live())return;data=fresh;draw();feedback(enabled?'字段映射采集已启用。':'字段映射采集已停用。','success');});}; + host.querySelector('#fm-discover').onclick=()=>act(async()=>{const connectionId=host.querySelector('#fm-connection').value;if(!connectionId)throw Error('请先配置BPM连接。');await api('/order-rules/field-samples/list',{connectionId,scope:'configuration',idempotencyKey:key()});if(!live())return;await load();if(live())feedback('BPM流程和节点已更新,规则编辑可选择新发现的项。','success');});} + lock(busy); } - function compatibleCheck(){return check?.result&&record&&check.version===record.version&&check.sampleId===sampleId&&(!proposal||check.evidenceHash===proposal.evidenceHash)&&!dirty();} - function updateActions(){if(!live())return;get('fm-editor')?.setAttribute('aria-busy',String(busy));host.querySelectorAll('input,select,button').forEach(input=>{input.disabled=busy||(!admin&&(input.matches('[data-fm-binding],[data-fm-search]')));});const current=selected();if(get('fm-version-state'))get('fm-version-state').textContent=(dirty()?'有未保存修改 · ':'')+'草稿 '+(draftVersion?'v'+draftVersion:'尚未保存')+' · 生效 '+(record?.activeVersion||current?.version.active?.version?'v'+(record?.activeVersion||current.version.active.version):'无')+(current?.version.reference?' · 有参考配置,尚未核验':'');if(!admin||!get('fm-save'))return; - get('fm-save').disabled=busy||uncertain||!sample()||!sources.orderNo?.path||!current?.version.processVersion; - get('fm-check').disabled=busy||uncertain||dirty()||!draftVersion||!record||!sample(); - get('fm-confirm').disabled=busy||!compatibleCheck()||!check.valid; - get('fm-activate').disabled=busy||uncertain||!compatibleCheck()||!check.valid||!get('fm-confirm').checked; - const affected=compatibleCheck()?(check.result?.affectedCategories||[]):[];get('fm-activation-summary').textContent=affected.length?'确认后影响:'+affected.map(c=>c.name||c.id).join('、')+'。已发布分类将暂停,需重新检查并发布分类规则。':'请先保存草稿,并检查当前版本的识别结果。'; - } - function drawResult(){if(!get('fm-result'))return;if(!compatibleCheck()){get('fm-result').innerHTML='

保存草稿后检查真实样本。修改字段或样本后须重新检查。

';return;} - const result=check.result||{},event=result.event||{},titleOrders=result.titleOrders||event.titleOrders||[]; - const issues=(result.issues||[]).map(issue=>typeof issue==='string'?issue:issue.message||issue.detail||JSON.stringify(issue)); - get('fm-result').innerHTML=`
${check.valid?'当前草稿检查通过,请继续核对受影响分类。':'检查未通过,请修正后重新保存检查。'}
表单主订单
${esc(text(result.mainOrder||event.mainOrder||event.orderNo)||'未取得')}
摘要
${esc(event.brief||'未取得')}
${(result.warnings||[]).map(w=>'
'+esc(w)+'
').join('')}

标题全部订单

${titleOrders.length?titleOrders.map(order=>`
${esc(order.text||(order.orderNo?'订单号:'+order.orderNo:text(order)))}
`).join(''):'未识别到标题订单'}

各分类文件名

${(result.filenames||[]).map(file=>`
${esc(file.categoryName||file.categoryId)}
${esc(file.filename||'无法生成文件名')}
${(file.issues||[]).map(issue=>'
'+esc(text(issue))+'
').join('')}
`).join('')||'

无文件名结果

'}${issues.length?'