@gct-paas/word 0.1.74 → 0.2.1

package/dist/domain/field/form-value.d.ts

@@ -8,6 +8,11 @@ export declare function setValue(value: any, valuePath: string, payload?: {
     [valuePath]: any;
 };
 export declare function toBoolean(value: any): boolean | null;
+/** 布尔选项默认别名 */
+export declare const BOOLEAN_TRUE_LABEL = "\u771F";
+export declare const BOOLEAN_FALSE_LABEL = "\u5047";
+/** 别名为空时回退到默认「真 / 假」 */
+export declare function resolveBooleanOptionLabel(label: unknown, value: unknown): string;
 export declare function toFormatValue(fieldType: FIELD_TYPE, value: any): any;
 export declare function toDictValue(field: string, value: any, row: any): any;
 export declare function getSelectOptions(payload: any): {

package/dist/domain/field/lot-display-label.d.ts

@@ -0,0 +1,2 @@
+/** 根据 批次/SN 记录决定界面展示名称；关联批子批次对外展示父批次名。 */
+export declare function resolveLotDisplayLabel(record: Record<string, any> | undefined): string | undefined;

package/dist/domain/object/date-object/index.d.ts

@@ -0,0 +1,4 @@
+export { profile as dateObjectProfile, OBJECT_TYPE } from './profile';
+export { DateObjectRuntime } from './runtime/date-object-runtime';
+export { DateObjectContext } from './runtime/date-object-context';
+export type { DateObjectProfile } from './types';

package/dist/domain/object/date-object/profile/field-keys.d.ts

@@ -0,0 +1,19 @@
+/** 批次 / 物料下拉 option 上的字段 */
+export declare const OptionF: {
+    /** 物料 */
+    readonly productId: "product_id_";
+    /** 生产日期 */
+    readonly productionDate: "production_date_";
+    /** 有效期 */
+    readonly validity: "validate_";
+    /** 下一次复检日期 */
+    readonly reInspectionDate: "re_inspection_date_";
+    /** 复检周期 */
+    readonly reInspectionInterval: "re_inspection_interval_";
+    /** 复检周期单位 */
+    readonly reInspectionIntervalUnit: "re_inspection_interval_unit_";
+};
+/** paramsConfig.txnConfig.businessType：复检场景 */
+export declare const RE_INSPECTION_BUSINESS_TYPE = "reInspection";
+/** 真正要按周期计算、但物料未配周期时的提示 */
+export declare const MISSING_RE_INSPECTION_INTERVAL_MSG = "\u5F53\u524D\u7269\u6599\u672A\u914D\u7F6E\u590D\u68C0\u5468\u671F\uFF0C\u65E0\u6CD5\u8BA1\u7B97\u4E0B\u4E00\u6B21\u590D\u68C0\u65E5\u671F";

package/dist/domain/object/date-object/profile/fields.d.ts

@@ -0,0 +1,2 @@
+import { DateObjectFieldProfile } from '../types';
+export declare const fields: DateObjectFieldProfile[];

package/dist/domain/object/date-object/profile/index.d.ts

@@ -0,0 +1,3 @@
+import { DateObjectProfile } from '../types';
+export declare const OBJECT_TYPE: "date_object";
+export declare const profile: DateObjectProfile;

package/dist/domain/object/date-object/runtime/date-object-context.d.ts

@@ -0,0 +1,41 @@
+import { Doc } from '../../../../core';
+import { FIELD_TYPE } from '../../../field/field-type';
+import { DateObjectFieldProfile, DateObjectProfile } from '../types';
+/** 日期对象子字段身份：控件 fieldLink 末段即主表 field key */
+interface DateObjectChildField {
+    key: string;
+}
+/** 同一日期对象下的子字段，按 bizType 索引 */
+interface DateObjectFieldSet {
+    belongingObject: string;
+    byBizType: Partial<Record<FIELD_TYPE, DateObjectChildField>>;
+}
+/** 单个物料日期对象实例：Profile + 同组字段 */
+export declare class DateObjectContext {
+    readonly doc: Doc;
+    readonly profile: DateObjectProfile;
+    readonly belongingObject: string;
+    readonly fieldSet: DateObjectFieldSet;
+    /**
+     * @param doc 当前文档
+     * @param profile 日期对象 Profile
+     * @param belongingObject 对象字段 key，同组子字段都挂在它下面
+     * @param fieldSet 已按 bizType 收好的同组字段
+     */
+    constructor(doc: Doc, profile: DateObjectProfile, belongingObject: string, fieldSet: DateObjectFieldSet);
+    /** 按 bizType 取同组字段 key */
+    fieldByBizType(bizType: FIELD_TYPE): DateObjectChildField | undefined;
+    /** 主表路径 `$.{fieldKey}` */
+    path(bizType: FIELD_TYPE): string | undefined;
+    /** 读取同组字段当前值 */
+    getValue(bizType: FIELD_TYPE): unknown;
+    /** 按 bizType 查找字段 Profile */
+    findFieldProfile(bizType: FIELD_TYPE): DateObjectFieldProfile | undefined;
+    /** 按主表 field key 反查同组 bizType */
+    bizTypeByFieldKey(fieldKey: string | undefined): FIELD_TYPE | undefined;
+    /** 一次模型遍历，收集文档内全部物料日期对象 */
+    static collectAll(doc: Doc): DateObjectContext[];
+    /** 按对象 key 查找上下文；不是日期对象则返回 undefined */
+    static find(doc: Doc, belongingObject: string | undefined): DateObjectContext | undefined;
+}
+export {};

package/dist/domain/object/date-object/runtime/date-object-runtime.d.ts

@@ -0,0 +1,41 @@
+import { Doc } from '../../../../core';
+import { FieldChangeMap } from '../../../../core/data';
+export declare class DateObjectRuntime {
+    private readonly doc;
+    /** 绑定当前文档；每次 overlay / afterFlush 可 new 一份 */
+    constructor(doc: Doc);
+    /** 文档初始化：按当前物料写入批次下拉过滤参数 */
+    onInit(): void;
+    /**
+     * 选中 / 清空下拉：按 profile.fillFromOption、clearOnEmpty 回填。
+     * 只反填物料 / 生产日期 / 有效期；下一次复检日期由 afterFlush 现查接口计算。
+     */
+    buildFillFromOption(options: {
+        belongingObject?: string;
+        bizType?: string;
+        selectedOption?: Record<string, unknown> | null;
+    }): Record<string, unknown>;
+    /**
+     * 用户改上游字段时，按 select.clearOnLinkChange 清空下游。
+     * 只看「本次点选的字段」，避免批次反填物料时把批次自己清掉。
+     */
+    buildDownstreamClears(options: {
+        belongingObject?: string;
+        bizType?: string;
+        pending?: Record<string, unknown>;
+    }): Record<string, unknown>;
+    /**
+     * 用户变更主表字段后：刷新级联 query，并按 profile.rowHandlers 现查接口重算。
+     */
+    onFieldChanges(changedMap: FieldChangeMap, options?: {
+        batchSource?: string;
+    }): Promise<void>;
+    /** 主表路径 `$.fieldKey` → 对象内 bizType */
+    private resolveChangedBizType;
+    /** 批次反填物料时物料值未变，不应触发 clearOnLinkChange */
+    private isUnchangedProduct;
+    /** 按 select.buildLinkQuery 写入批次下拉过滤参数 */
+    private applyLinkage;
+    /** 按 bizType 把同组字段写成 null；批次额外清 _id_ */
+    private buildClearUpdates;
+}

package/dist/domain/object/date-object/runtime/fetch-records.d.ts

@@ -0,0 +1,16 @@
+/** 物料信息：按版本 id 拉一条（value 可能是 baseId:versionId） */
+export declare function fetchProductRecord(productValue: unknown): Promise<Record<string, unknown> | null>;
+/** 批次信息：优先 companion id，否则按批次号 name_；每次现查，不用缓存 */
+export declare function fetchLotRecord(options: {
+    lotId?: unknown;
+    lotName?: unknown;
+}): Promise<Record<string, unknown> | null>;
+/** 并行拉物料 + 批次；缺 ident 的一侧不请求 */
+export declare function fetchDateObjectRecords(options: {
+    productValue?: unknown;
+    lotId?: unknown;
+    lotName?: unknown;
+}): Promise<{
+    product: Record<string, unknown> | null;
+    lot: Record<string, unknown> | null;
+}>;

package/dist/domain/object/date-object/runtime/object-handlers.d.ts

@@ -0,0 +1,6 @@
+import { Doc } from '../../../../core';
+export type DateObjectHandler = (doc: Doc, belongingObject: string) => void | Promise<void>;
+/** 注册对象级运行时钩子；profile 只需写短名 */
+export declare function registerDateObjectHandler(name: string, handler: DateObjectHandler): void;
+/** 执行指定短名的对象处理器；未注册则静默跳过 */
+export declare function runDateObjectHandler(name: string | undefined, doc: Doc, belongingObject: string): Promise<void>;

package/dist/domain/object/date-object/runtime/re-inspection-date.d.ts

@@ -0,0 +1,49 @@
+import { MISSING_RE_INSPECTION_INTERVAL_MSG } from '../profile/field-keys';
+export { MISSING_RE_INSPECTION_INTERVAL_MSG };
+export type ReInspectionIntervalUnit = 'day' | 'month';
+export interface ReInspectionInterval {
+    /** 复检周期 */
+    amount: number;
+    /** 复检周期单位 */
+    unit: ReInspectionIntervalUnit;
+}
+export interface ResolveNextReInspectionDateInput {
+    /** paramsConfig.txnConfig.businessType === reInspection */
+    isReInspection: boolean;
+    /** 批次接口上的下一次复检日期 */
+    lotReInspectionDate?: unknown;
+    /** 当前生产日期（批次带出或手选） */
+    productionDate?: unknown;
+    /** 复检周期信息 */
+    interval?: ReInspectionInterval;
+}
+export interface ResolveNextReInspectionDateResult {
+    value: string | null;
+    /** 是否走「生产日期 / 接口日期 + 周期」计算 */
+    needCalculate: boolean;
+    missingInterval: boolean;
+}
+/** 是否为可解析的日历日期（写入前会归一成 YYYY-MM-DD） */
+export declare function hasDateValue(value: unknown): boolean;
+/**
+ * 复检周期单位：接口只返回 day / month。
+ */
+export declare function normalizeReInspectionUnit(unit: unknown): ReInspectionIntervalUnit | undefined;
+/** 复检周期数量：必须是有限正数 */
+export declare function parseReInspectionIntervalAmount(value: unknown): number | undefined;
+/** 从物料或批次 option 读取复检周期；缺数量或单位则视为未配置 */
+export declare function pickReInspectionInterval(source?: Record<string, unknown> | null): ReInspectionInterval | undefined;
+/**
+ * 按日历加周期：先 toDateOnly 成 YYYY-MM-DD，再 dayjs.add。
+ * 项目里没有现成的日期加减工具，日期归一复用 toDateOnly。
+ * 自然月：1月31日 + 1月 → 2月28日；无效基准日期返回 null。
+ */
+export declare function addReInspectionInterval(base: unknown, interval: ReInspectionInterval): string | null;
+/**
+ * 下一次复检日期：
+ * - 未配复检且批次已有日期 → 直接用接口值
+ * - 否则用「接口日期（复检场景）或生产日期」+ 周期
+ */
+export declare function resolveNextReInspectionDate(input: ResolveNextReInspectionDateInput): ResolveNextReInspectionDateResult;
+/** paramsConfig.txnConfig.businessType === reInspection */
+export declare function isReInspectionTxnConfig(txnConfig: unknown): boolean;

package/dist/domain/object/date-object/runtime/register-handlers.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain/object/date-object/runtime/row-change-handlers.d.ts

@@ -0,0 +1,6 @@
+import { Doc } from '../../../../core';
+/**
+ * 用当前表单上的物料 / 批次去拉接口，写入下一次复检日期。
+ * 物料、批次都空时不请求、不提示（还没选 ident）。
+ */
+export declare function syncReInspectionDate(doc: Doc, belongingObject: string): Promise<void>;

package/dist/domain/object/date-object/types.d.ts

@@ -0,0 +1,48 @@
+import { FIELD_TYPE } from '../../field/field-type';
+/** 单条 option → 对象子字段 的映射 */
+export interface DateObjectOptionFillDef {
+    /** option record 里的源字段 key */
+    optionField: string;
+    /** 目标子字段，运行时按 bizType 解析为实际 field key */
+    toBizType: FIELD_TYPE;
+    /** 写入前对 option 值做转换（如日期时间 → 日期） */
+    transform?: (value: unknown) => unknown;
+}
+/** 下拉级联：上游按 bizType 解析，不写死 field key */
+export interface DateObjectSelectDef {
+    /** 上游字段 bizType（与本字段同属一个 belongingObject） */
+    linkBizType: FIELD_TYPE;
+    /** 构建下拉查询参数；上游为空时返回 {}，批次可独立下拉 */
+    buildLinkQuery?: (ctx: {
+        linkValue: unknown;
+    }) => Record<string, unknown>;
+    /** 用户改上游时清空的下游（bizType） */
+    clearOnLinkChange?: FIELD_TYPE[];
+}
+/** 日期对象子字段 Profile：按 bizType 匹配，声明联动 / 反填 */
+export interface DateObjectFieldProfile {
+    match: {
+        bizType: FIELD_TYPE;
+    };
+    /** 下拉级联 */
+    select?: DateObjectSelectDef;
+    /** 选中下拉项后，从 option 同步填充同组字段 */
+    fillFromOption?: DateObjectOptionFillDef[];
+    /** 本字段清空时要清的 sibling bizType（不含反填物料） */
+    clearOnEmpty?: FIELD_TYPE[];
+}
+/** 对象级处理器声明：按时机调用注册于 object-handlers 的具名处理器 */
+export interface DateObjectRowHandlerDef {
+    when: 'onFieldChange';
+    /** 仅这些 bizType 变更时执行 */
+    watch: FIELD_TYPE[];
+    /** 注册于 object-handlers 的处理器短名 */
+    handler: string;
+}
+/** 物料日期对象 Profile */
+export interface DateObjectProfile {
+    type: 'date_object';
+    fields: DateObjectFieldProfile[];
+    /** 无法声明的副作用（如按物料/批次接口计算复检日期） */
+    rowHandlers?: DateObjectRowHandlerDef[];
+}

package/dist/domain/table/business/check/check-table/actions/fetch-check-items.d.ts

@@ -2,6 +2,7 @@ import { CheckTableItemInfosPayload, CheckTableRegionRef } from '../types';
 import { ICheckTableConfig } from '../front-config';
 /**
  * 按已扫描的检验表 region 并行解析检验项（有快照用快照，否则请求）。
+ * @param instanceId 真实填报实例 id；设计态 / 模拟填报应传空字符串（默认数据源将跳过请求）
  * @returns infosMap / countMap（count 至少为 1，用于占位行）/ 待落库 byTable 快照
  */
 export declare function fetchCheckItemsForRegions(instanceId: string, regions: CheckTableRegionRef[], checkTableConfig?: ICheckTableConfig): Promise<{

package/dist/domain/table/business/material/material-requisition/index.d.ts

@@ -0,0 +1,2 @@
+export { profile as materialRequisitionProfile, TABLE_TYPE } from './profile';
+export * from './profile';

package/dist/domain/table/business/material/material-requisition/profile/field-keys.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 生产收料表（MATERIAL_REQUISITION）字段 key
+ */
+export declare const F: {
+    /** 物料 */
+    readonly product: "product_id_";
+    /** 物料名称 */
+    readonly productName: "product_id_name_";
+    /** 物料编码 */
+    readonly productCode: "product_id_code_";
+    /** 物料规格 */
+    readonly productSpec: "product_id_spec_";
+    /** 物料批号 */
+    readonly materialNo: "material_no_";
+    /** 物料批号 ID */
+    readonly materialNoId: "material_no__id_";
+    /** 工单 */
+    readonly mfgOrder: "mfg_order_id_";
+    /** 批次/SN */
+    readonly lotSn: "lot_sn_id_";
+    /** 唯一码 */
+    readonly uniqueCode: "unique_code_";
+    /** 收料数量 */
+    readonly qtyRequisition: "qty_requisition_";
+    /** 数量单位 */
+    readonly qtyUom: "qty_uom_id_";
+    /** 有效期 */
+    readonly validity: "validity_";
+};
+export type MaterialRequisitionFieldKey = (typeof F)[keyof typeof F];
+/** 设计态固定禁用、运行态只读的信息字段 */
+export declare const DISABLED_INPUT_FIELDS: readonly ["product_id_name_", "product_id_code_", "product_id_spec_"];
+/** 物料清空时需一并清空的字段 */
+export declare const CLEAR_ON_PRODUCT_EMPTY: readonly ["product_id_name_", "product_id_code_", "product_id_spec_"];

package/dist/domain/table/business/material/material-requisition/profile/fields.d.ts

@@ -0,0 +1,2 @@
+import { BusinessFieldProfile } from '../../../../types';
+export declare const fields: BusinessFieldProfile[];

package/dist/domain/table/business/material/material-requisition/profile/index.d.ts

@@ -0,0 +1,4 @@
+import { BusinessSubTableProfile } from '../../../../types';
+export declare const TABLE_TYPE: "material-requisition";
+export declare const profile: BusinessSubTableProfile;
+export { profile as materialRequisitionProfile };

package/dist/domain/table/business/material/material-requisition/runtime/register-handlers.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain/table/business/material/material-requisition/runtime/row-change-handlers.d.ts

@@ -0,0 +1,5 @@
+import { Doc } from '../../../../../../core';
+/**
+ * 物料清空时，同步清空名称 / 编码 / 规格
+ */
+export declare function handleProductIdChange(doc: Doc, subFieldKey: string, rowIndex: number): void;

package/dist/domain/table/business/material/types.d.ts

@@ -55,6 +55,21 @@ export interface IBomEntry {
     operation_sort_num_?: number;
     /** 是否必须上料 */
     force_loading_enabled_?: boolean;
+    /** 是否指定物料批次 */
+    specified_material_no_enabled_?: boolean;
+    /** 指定的物料批次集合 */
+    specified_material_entries_?: Array<{
+        name_?: string;
+        production_identification_id_?: string;
+    }>;
+    /** 是否禁用条码解析 */
+    disable_barcode_parsing_?: boolean;
+    /** 条码参数类型 */
+    scan_param_type_?: ScanParamType;
+    /** 需求数量计算规则 */
+    required_qty_calc_rule_?: RequiredQtyCalcRule;
+    /** 需求数量按生产数量计算时绑定的生产数量字段 */
+    product_qty_field_?: string;
 }
 /** 物料消耗表业务配置 */
 export interface IFormTmplBom {
@@ -68,6 +83,8 @@ export interface IFormTmplBom {
     material_loading_model_enabled_: boolean;
     /** 条码解析规则(旧数据是id,新数据是json对象str) */
     barcode_parsing_rules_id_?: string;
+    /** 条码参数配置，不开启条码解析时，用这个配置 */
+    barcodeParamType?: string;
     /** 从BOM初始化 */
     bom_init_enabled_?: boolean;
     /** 人为指定物料 */
@@ -80,6 +97,16 @@ export interface IFormTmplBom {
     deleted_?: boolean;
     /** 物料消耗模式, record：记录模式,bom： BOM模式 */
     material_consumption_pattern_?: MaterialConsumptionPatternEnum;
+    /** 是否禁用条码解析 */
+    disable_barcode_parsing_?: boolean;
+    /** 条码参数类型 */
+    scan_param_type_?: ScanParamType;
+    /** 需求数量计算规则 */
+    required_qty_calc_rule_?: RequiredQtyCalcRule;
+    /** 需求数量按生产数量计算时绑定的生产数量字段 */
+    product_qty_field_?: string;
+    /** 物料消耗对象 key */
+    object_key_?: string;
 }
 /**
  * 物料消耗表子模型的数据结构
@@ -99,6 +126,8 @@ export interface IMaterialConsumeData {
     qty_required_?: number;
     /** 需求数量单位 */
     qty_required_uom_id_?: string;
+    /** 序号 */
+    sort_num_?: number;
     /** 数量单位 */
     qty_uom_id_?: string;
     /** 转换后数量 */
@@ -127,6 +156,8 @@ export interface IMaterialConsumeData {
     product_id__lb_?: string;
     /** 扫码未回填 product_id_ 的兜底行标记（记录模式内部瞬态，行生命周期内持久，不向后端提交） */
     _scanFallback?: boolean;
+    /** 本次上料汇总数量 */
+    qty_consumed_total_?: number;
 }
 /**
  * 条码解析规则配置参数
@@ -151,3 +182,13 @@ export declare enum MaterialConsumptionPatternEnum {
     /** bom模式 */
     BOM = "bom"
 }
+/** 扫码参数类型 */
+export declare enum ScanParamType {
+    Lot = "lot",
+    UniqueCode = "uniqueCode"
+}
+/** 需求数量计算规则 */
+export declare enum RequiredQtyCalcRule {
+    LotQty = "lotQty",
+    ProductQty = "productQty"
+}

package/dist/domain/table/business/preprocess/pretreatment-list/actions/index.d.ts

@@ -1,2 +1 @@
 export * from './scan';
-export * from './change-parse-rule';

package/dist/domain/table/business/preprocess/pretreatment-list/actions/scan.d.ts

@@ -1,7 +1,6 @@
-import { Doc, SubRenderer } from '../../../../../../core';
-/** 打开扫码弹窗 */
-export declare function openPretreatmentListScan(options: {
-    doc: Doc;
-    subRenderer: SubRenderer;
-    subFieldKey: string;
-}): Promise<void>;
+import { BusinessScanHandler } from '../../../shared/scan-action';
+/**
+ * 预处理表：扫码后入行
+ * 接口同入库：em_production_identification / biz_production_identification_scan
+ */
+export declare const handlePretreatmentListScan: BusinessScanHandler;

package/dist/domain/table/business/preprocess/pretreatment-list/profile/field-keys.d.ts

@@ -13,7 +13,7 @@ export declare const F: {
     readonly productSpec: "product_id_spec_";
     /** 物料批次号 */
     readonly materialContainer: "material_container_no_";
-    /** 生产批次号 */
+    /** 生产LOT/SN */
     readonly productionContainer: "production_container_id_";
     /** 数量 */
     readonly qty: "qty_";
@@ -24,16 +24,16 @@ export declare const F: {
     /** 生产日期 */
     readonly productionDate: "production_date_";
 };
-/** remoteSync 成功回写的基础字段 */
-export declare const INVENTORY_INFO_APPLY_FIELDS: readonly ["product_id_", "product_id_name_", "product_id_code_", "product_id_spec_", "mfg_order_code_"];
-/** 行变更 handler：生产批次号清空时的字段集 */
+/** 设计态输入属性固定禁用、运行态只读：物料名称 / 编码 / 规格 */
+export declare const DISABLED_INPUT_FIELDS: readonly ["product_id_name_", "product_id_code_", "product_id_spec_"];
+/** 行变更 handler：生产LOT/SN清空时的字段集 */
 export declare const CLEAR_ON_PROD_CONTAINER_EMPTY: readonly ("product_id_" | "product_id_name_" | "product_id_code_" | "product_id_spec_" | "mfg_order_code_" | "qty_" | "production_date_")[];
-/** 行变更 handler：生产批次号切换时的字段集 */
+/** 行变更 handler：生产LOT/SN切换时的字段集 */
 export declare const CLEAR_ON_PROD_CONTAINER_SWITCH: ("material_container_no_" | "mfg_order_id_")[];
 /** 行变更 handler：工单清空时的字段集 */
 export declare const CLEAR_ON_MFG_ORDER_EMPTY: ("product_id_" | "product_id_name_" | "product_id_code_" | "product_id_spec_" | "mfg_order_code_" | "qty_" | "production_date_")[];
 /** 行变更 handler：工单切换时的字段集 */
-export declare const CLEAR_ON_MFG_ORDER_SWITCH: ("material_container_no_" | "production_container_id_")[];
+export declare const CLEAR_ON_MFG_ORDER_SWITCH: ("production_container_id_" | "material_container_no_")[];
 /** 行变更 handler：物料批次号清空时的字段集 */
 export declare const CLEAR_ON_MATERIAL_CONTAINER_NO_EMPTY: ("product_id_" | "product_id_name_" | "product_id_code_" | "product_id_spec_" | "mfg_order_code_" | "qty_" | "production_date_")[];
 /** 行变更 handler：物料批次号切换时的字段集 */

package/dist/domain/table/business/preprocess/pretreatment-list/runtime/row-change-handlers.d.ts

@@ -1,20 +1,20 @@
 import { Doc } from '../../../../../../core';
 /**
- * 生产批次号 切换 / 清空
- * 切换【生产批次号】 → 清工单 + 物料批次号
- * 清空【生产批次号】 → 清物料 + 物料名称 + 物料编码 + 物料规格 + 数量 + 工单号 + 生产日期
+ * 生产LOT/SN 切换 / 清空
+ * 切换【生产LOT/SN】 → 清工单 + 物料批次号
+ * 清空【生产LOT/SN】 → 清物料 + 物料名称 + 物料编码 + 物料规格 + 数量 + 工单号 + 生产日期
  */
 export declare function handleProductionContainerChange(doc: Doc, subFieldKey: string, rowIndex: number): void;
 /**
  * 工单 切换 / 清空
- * 切换【工单】 -> 清生产批次号 + 物料批次号
+ * 切换【工单】 -> 清生产LOT/SN + 物料批次号
  * 清空【工单】 -> 清物料 + 物料名称 + 物料编码 + 物料规格 + 数量 + 工单号 + 生产日期
  */
 export declare function handleMfgOrderChange(doc: Doc, subFieldKey: string, rowIndex: number): void;
 /**
  * 物料批次号 切换 / 清空
- * 下拉选中（有 companion id）→ 清生产批次号 + 工单
- * 手动输入（无 companion id）→ 清物料信息 + 数量 + 工单号 + 生产日期 + 生产批次号 + 工单
+ * 下拉选中（有 companion id）→ 清生产LOT/SN + 工单
+ * 手动输入（无 companion id）→ 清物料信息 + 数量 + 工单号 + 生产日期 + 生产LOT/SN + 工单
  * 清空【物料批次号】 → 清物料 + 物料名称 + 物料编码 + 物料规格 + 数量 + 工单号 + 生产日期
  */
 export declare function handleMaterialContainerNoChange(doc: Doc, subFieldKey: string, rowIndex: number): void;

package/dist/domain/table/business/shared/production-container-hyperlink-enricher.d.ts

@@ -2,6 +2,6 @@ import { Doc } from '../../../../core';
 import { DataEnricherRegistration } from '../../../../core/data';
 import { BusinessSubTableType } from '../../types';
 /**
- * 按业务表类型，仅为该表内的「生产批次号」补全 _href_
+ * 按业务表类型，仅为该表内的「生产LOT/SN」补全 _href_
  */
 export declare function createProductionContainerHyperlinkEnricher(doc: Doc, tableType: BusinessSubTableType): DataEnricherRegistration;

package/dist/domain/table/business/shared/production-identification-scan-api.d.ts

@@ -0,0 +1,17 @@
+import { IRuleParseData } from '../../../../runtime/canvas/table/render/label-parse-rule/type';
+import { BizServiceApiDef } from '../../types';
+export declare const PRODUCTION_IDENTIFICATION_SCAN_NOT_FOUND_MSG = "\u626B\u63CF\u7684\u7269\u6599\u4E0D\u5B58\u5728";
+export declare const PRODUCTION_IDENTIFICATION_SCAN_LOT_OR_UNIQUE_REQUIRED_MSG = "\u6761\u7801\u4E2D\u672A\u89E3\u6790\u5230\u7269\u6599\u6279\u53F7\u6216\u552F\u4E00\u7801";
+export declare const PRODUCTION_IDENTIFICATION_SCAN_API: BizServiceApiDef;
+/** 物料批号、唯一码至少有一个非空 */
+export declare function hasProductionIdentificationScanKey(parsed: IRuleParseData): boolean;
+/** 条码解析结果 → 扫码接口入参（字段名与后端约定一致，含 vaildate_ 拼写） */
+export declare function buildProductionIdentificationScanBody(parsed: IRuleParseData): Record<string, unknown>;
+/**
+ * 调用生产标识扫码匹配接口
+ * - 接口失败（宿主拦截器已提示）：返回 null，调用方直接中止
+ * - 成功：返回 0/1/N 条候选
+ */
+export declare function matchProductionIdentificationScanRecords(parsed: IRuleParseData): Promise<Record<string, unknown>[] | null>;
+/** 多条候选 → 公共多选弹框 */
+export declare function pickProductionIdentificationScanRecord(records: Record<string, unknown>[]): Promise<Record<string, unknown> | undefined>;

package/dist/domain/table/business/shared/scan-action.d.ts

@@ -1,25 +1,43 @@
+import { Doc, SubRenderer } from '../../../../core';
 import { ParseRuleProps } from '../material/types';
-import { TriggerName } from '../../../../utils/adapters/TriggerUtil';
+/** 扫码数量调整方向（盘点加减实盘等可复用） */
+export type ScanAdjustType = 'add' | 'minus';
+/** CommonScanModal 回传（可另带 barcode/type） */
+export type ScanModalInput = {
+    str?: string;
+    parsedValue?: unknown;
+    transformedData?: unknown;
+    barcode?: string;
+    type?: ScanAdjustType | string;
+    [key: string]: unknown;
+};
+export type BusinessScanContext = {
+    doc: Doc;
+    subRenderer: SubRenderer;
+    subFieldKey: string;
+    subModelKey?: string;
+};
+export type BusinessScanHandler = (ctx: BusinessScanContext, input: ScanModalInput) => void | Promise<void>;
+/** 取 CommonScanModal.parsedValue（条码解析结果） */
+export declare function resolveScanParsedValue<T extends Record<string, unknown> = Record<string, unknown>>(input: ScanModalInput): T | undefined;
+/** 取 CommonScanModal.transformedData（字段映射结果） */
+export declare function resolveScanFillData(input: ScanModalInput): Record<string, unknown>;
+/** 取扫码数量调整方向，默认 add */
+export declare function resolveScanAdjustType(input: ScanModalInput): ScanAdjustType;
+/** 出入库空行：物料、批次都没值 */
+export declare function isProductBatchEmptyRow(row: Record<string, unknown>): boolean;
+/**
+ * 扫码入行：优先回填首个空壳占位行，否则在活跃区末尾新增。
+ * 避免版面默认空行时 insertAt 导致「第一行空、第二行有数据」。
+ * 回填时空壳行按字段合并，保留 front_row_key_ / group_ 等元数据。
+ */
+export declare function appendOrFillScanRow(doc: Doc, subFieldKey: string, row: Record<string, unknown>, isEmptyRow?: (item: Record<string, unknown>) => boolean): number;
 /** 将 widget 上的条码解析规则 id 字符串转为配置对象 */
 export declare function toParseRuleConfig(value?: string): ParseRuleProps | undefined;
-export interface ScanRuleInfo {
-    rules_?: string;
-    [key: string]: unknown;
-}
-export interface OpenScanWithParseRuleOptions {
-    regionId: string;
-    barcodeParsingRulesId?: string;
-    modalEvent: TriggerName;
-    title?: string;
-    onScan: (input: {
-        str: string;
-    }, ctx: {
-        parseRuleProps: ParseRuleProps;
-        scanRuleInfo: ScanRuleInfo;
-    }) => void | Promise<void>;
-}
 /**
- * 扫码入口脚手架：防重入、校验解析规则、打开 modal、finally 清理
- * 业务侧只实现 onScan
+ * 业务子表统一扫码入口：同一个 CommonScanModal，差异只在 onScan 业务处理
  */
-export declare function openScanWithParseRule(options: OpenScanWithParseRuleOptions): Promise<void>;
+export declare function openBusinessTableScan(ctx: BusinessScanContext, onScan: BusinessScanHandler, formFieldOptions?: {
+    label: string;
+    value: string;
+}[]): Promise<void>;

package/dist/domain/table/business/sterilize/entrust-steril-batch-list/actions/index.d.ts

@@ -1,2 +1 @@
 export * from './scan';
-export * from './change-parse-rule';

package/dist/domain/table/business/sterilize/entrust-steril-batch-list/actions/scan.d.ts

@@ -1,7 +1,6 @@
-import { Doc, SubRenderer } from '../../../../../../core';
-/** 打开扫码弹窗 */
-export declare function openEntrustSterilBatchListScan(options: {
-    doc: Doc;
-    subRenderer: SubRenderer;
-    subFieldKey: string;
-}): Promise<void>;
+import { BusinessScanHandler } from '../../../shared/scan-action';
+/**
+ * 委托灭菌生产批次表：扫码后入行
+ * 接口同入库：em_production_identification / biz_production_identification_scan
+ */
+export declare const handleEntrustSterilBatchListScan: BusinessScanHandler;

package/dist/domain/table/business/sterilize/entrust-steril-batch-list/profile/field-keys.d.ts

@@ -11,7 +11,7 @@ export declare const F: {
     readonly productCode: "product_id_code_";
     /** 产品规格 */
     readonly productSpec: "product_id_spec_";
-    /** 生产批次号 */
+    /** 生产LOT/SN */
     readonly productionContainer: "production_container_id_";
     /** 数量 */
     readonly qty: "qty_";
@@ -22,7 +22,5 @@ export declare const F: {
     /** 生产日期 */
     readonly productionDate: "production_date_";
 };
-/** remoteSync 成功回写的基础字段 */
-export declare const INVENTORY_INFO_APPLY_FIELDS: readonly ["product_id_", "product_id_name_", "product_id_code_", "product_id_spec_", "mfg_order_code_", "mfg_order_id_"];
-/** 行变更 handler：生产批次号清空时的字段集 */
+/** 行变更 handler：生产LOT/SN清空时的字段集 */
 export declare const CLEAR_ON_PROD_CONTAINER_EMPTY: readonly ["product_id_", "product_id_name_", "product_id_code_", "product_id_spec_", "qty_", "mfg_order_code_", "mfg_order_id_", "production_date_"];