@gct-paas/word 0.1.74-beta.20 → 0.1.74-beta.21

package/dist/runtime/canvas/table/render/material-consume/scan-validator.d.ts

@@ -0,0 +1,192 @@
+import { IBomEntry, IMaterialConsumeData } from '../../../../../domain/table/business/material/types';
+/**
+ * 扫码校验与填充
+ * 对应 scan-validation-logic.md
+ * 独立于 bom-validator.ts，只依赖 types 中的 IBomEntry / IMaterialConsumeData
+ */
+/** 横线下方三种扫码场景 */
+export declare enum ScanBizScenario {
+    /** 有 BOM，按顺序上料，同时只有一组可编辑 */
+    HAS_BOM_SEQUENTIAL = "has_bom_sequential",
+    /** 有 BOM，不按顺序上料，所有行可编辑 */
+    HAS_BOM_FREE = "has_bom_free",
+    /** 没有 BOM，所有行可编辑 */
+    NO_BOM = "no_bom"
+}
+/** 填充动作：新增行 / 回填空物料 / 回填空批次 */
+export type ScanFillAction = 'append' | 'fillEmptyProduct' | 'fillEmptyLot';
+export interface ScanValidatorOptions {
+    /** 是否按顺序上料 */
+    enableSequenceLoading: boolean;
+    /** BOM 明细列表，场景三可传空数组 */
+    bomEntries?: IBomEntry[];
+    /** 场景三：无 BOM 时是否按批次上料。有 BOM 时以明细 type_ 为准 */
+    byLotEnabled?: boolean;
+}
+/** 填充成功后的表数据与动作 */
+export interface ScanFillResult {
+    table: IMaterialConsumeData[];
+    groupSwitched: boolean;
+    fillAction: ScanFillAction;
+}
+/** 对齐 materialCheck 返回项 */
+export interface ScanCheckItem {
+    materialId: string;
+    materialNo?: string;
+    productionIdentificationName: string;
+}
+export type ResolveScanCandidatesResult = {
+    status: 'single';
+    row: IMaterialConsumeData;
+} | {
+    status: 'needSelect';
+    candidates: IMaterialConsumeData[];
+};
+/** handleScan 返回：多条待选，或已填充 */
+export type HandleScanResult = {
+    status: 'needSelect';
+    candidates: IMaterialConsumeData[];
+} | ({
+    status: 'filled';
+} & ScanFillResult);
+/**
+ * 把扫码接口一条结果转成表行。
+ * extra 可带数量、有效期等；物料/批次默认取接口字段，extra 可覆盖。
+ */
+export declare function toScanRow(item: ScanCheckItem, extra?: Partial<IMaterialConsumeData>): IMaterialConsumeData;
+/**
+ * 取一组允许出现的物料 id：主料，以及开启替代料时的替代料。
+ * 用于判断某物料是否属于该 BOM 明细组。
+ */
+export declare function getGroupProductIds(entry: IBomEntry): string[];
+/**
+ * 按物料 id 找到所属 BOM 明细（主料或替代料命中即返回）。
+ * 找不到说明物料不在当前 BOM 中。
+ */
+export declare function findEntryByProductId(entries: IBomEntry[], productId: string): IBomEntry | undefined;
+/**
+ * 三个场景共用的第一步：把接口返回列表收成单条 scanRow。
+ * - 0 条：抛错
+ * - 1 条：直接作为 scanRow
+ * - 多条：返回 needSelect，由调用方弹窗；本函数不改表、不跑后续校验
+ */
+export declare function resolveScanCandidates(rows: IMaterialConsumeData[]): ResolveScanCandidatesResult;
+/**
+ * 按「有无 BOM 明细 + 是否按顺序上料」判定场景。
+ * 不使用人为指定 / BOM 模式 / 记录模式。
+ */
+export declare function resolveScanScenario(options: {
+    enableSequenceLoading: boolean;
+    bomEntries?: IBomEntry[];
+}): ScanBizScenario;
+/**
+ * 通用校验 1：扫码物料是否出现在 BOM 明细（主料或替代料）中。
+ * 场景三无 BOM，不调用本函数。找不到则抛错。
+ */
+export declare function validateInBom(row: IMaterialConsumeData, entries: IBomEntry[]): void;
+/** 判断物料 id 是否属于该 BOM 组（主料或已启用的替代料） */
+export declare function isMemberOfGroup(productId: string | undefined, entry: IBomEntry): boolean;
+/**
+ * 通用校验 2：物料是否允许写入目标组。
+ * 查看 / 未开替代料：必须是主料。
+ * 整批替代：组内已有物料时必须与之一致。
+ * 混用替代：必须是主料或替代料。
+ */
+export declare function assertMaterialInGroup(productId: string | undefined, entry: IBomEntry, groupRows?: IMaterialConsumeData[]): void;
+/**
+ * 通用校验 3：按批次上料且开启混批时，同一组同一物料的不同批次数不能超过 lot_mixing_times_。
+ * includeIncomingLot 为 true 时，把即将写入的批次也算进去，避免先插入再超限。
+ */
+export declare function validateLotMixingForProduct(row: IMaterialConsumeData, groupRows: IMaterialConsumeData[], entry: IBomEntry, includeIncomingLot?: boolean): void;
+/**
+ * 通用校验 4：有效期为空则跳过；有效期当天结束仍早于现在则视为过期并抛错。
+ */
+export declare function checkExpiration(row: IMaterialConsumeData): void;
+/**
+ * 通用校验 5：开启数量校验时，同一组所有物料的上料之和 vs 组需求量。
+ * diff = 上料之和 - 需求量。eq：diff === 0；gte：diff >= 0；lte：diff <= 0；
+ * bounds：min <= diff <= max。
+ * 不按顺序上料且规则为 eq 时，允许 diff < 0（少上料），diff > 0 仍抛错。
+ */
+export declare function validateQtyForGroup(groupRows: IMaterialConsumeData[], entry: IBomEntry, sequential?: boolean): Promise<void>;
+/**
+ * 整组校验：切组前先对每一行走必填 + 通用 2、3、4，再整组跑一次通用 5。
+ * 任一项失败则中断，不切组、不填充。
+ */
+export declare function validateGroupRows(groupRows: IMaterialConsumeData[], entry: IBomEntry, sequential?: boolean): Promise<void>;
+/**
+ * 物料消耗表扫码校验与填充。
+ * 对应 scan-validation-logic.md；不依赖 bom-validator.ts。
+ */
+export declare class BomEntriesValidator {
+    private options;
+    constructor(options: ScanValidatorOptions);
+    /** 当前配置对应的扫码场景 */
+    get scenario(): ScanBizScenario;
+    /** BOM 明细，无 BOM 时为空数组 */
+    get entries(): IBomEntry[];
+    /** 按 sort_num_ 排序后的 BOM 明细，用于顺序上料定位当前组 / 下一组 */
+    get sortedEntries(): IBomEntry[];
+    /**
+     * 扫码总入口。
+     * 入参可为单条或接口返回的多条；不修改入参 table。
+     * 多条时返回 needSelect（调用方弹窗后再以选中的一条调用）；
+     * 单条则按场景走校验和填充，返回 filled。
+     * TODO: 待处理 — 尚未接入 Controller / 选择弹窗
+     */
+    handleScan(scanInput: IMaterialConsumeData | IMaterialConsumeData[], table: IMaterialConsumeData[]): Promise<HandleScanResult>;
+    /**
+     * 场景一：有 BOM 且按顺序上料。仅当前编辑组可写。
+     * 属于当前组：通用 2（含整批）→ 通用 3 → 填充。
+     * 不属于：前面组报错，否则切下一组。
+     */
+    private runScenario1;
+    /** 扫码物料属于前面组：已在表中 → 请勿重复上料；非必须且不在表中 → 请按顺序上料 */
+    private assertNotPreviousGroup;
+    /**
+     * 顺序上料切组：非必须且表中没有时，物料属于该组则收下，否则继续往后。
+     * 目标组不在表中：在当前组下方插入空行再填充。
+     */
+    private switchToNextGroup;
+    /** 在当前组最后一行下方插入目标组空占位行 */
+    private insertEmptyGroupBelow;
+    /**
+     * 场景二：有 BOM 但不按顺序。所有行可编辑，不切组。
+     * 表中没有该组：通用 2、3 后表末追加。有则通用 2、3 后走填充。
+     */
+    private runScenario2;
+    /**
+     * 场景三：没有 BOM。只校验有效期，不跑通用 1/2/3。
+     * 优先填空物料行，其次按批次填「有物料无批次」行，否则表末新增。
+     */
+    private runScenario3;
+    /**
+     * 顺序上料时定位「当前编辑组」在排序后 BOM 中的下标。
+     * 1. 编辑行有物料或 bom_entry_id_：按现逻辑匹配
+     * 2. 未初始化：取表中最后一组已出现（已确认）明细的序号，当前组 = BOM 下一条
+     * 3. 表里还没有任何组：第一组
+     */
+    private resolveCurrentGroupIndex;
+    /**
+     * 从表尾往前找最后一组已出现的 BOM 明细（已确认且有物料或 bom_entry_id_）。
+     * 找不到返回 -1。
+     */
+    private findLastAppearedGroupIndex;
+    /** 表中是否已有该 BOM 组（有物料行或带 bom_entry_id_ 的空行） */
+    private groupExistsInTable;
+    /**
+     * 收集空物料行下标。extra 可再限制范围（如仅当前编辑组、或匹配 bom_entry_id_）。
+     */
+    private collectEmptyProductIndexes;
+    /**
+     * 收集某 BOM 组在表中的范围：组成员行、空物料行、空批次行，以及默认插入位置。
+     * editingGroup 为 true 时，未确认的空物料行也算进该组。
+     */
+    private collectGroupScope;
+    /**
+     * 切组时改编辑态：当前组行确认（禁用），目标组行取消确认（可编辑）。
+     */
+    private applyGroupEditState;
+}
+/** 创建扫码校验器实例 */
+export declare function createBomValidator(options: ScanValidatorOptions): BomEntriesValidator;

package/dist/runtime/canvas/table/render/material-consume/service.d.ts

@@ -18,6 +18,10 @@ export declare function materialCheck(params: {
     bom_entries_: any;
     /** 工序id */
     operation_id_: string;
+    /** 唯一码 */
+    unique_code_: any;
+    /** 是否启用条码解析 */
+    bar_code_enabled_: boolean;
 }): Promise<{
     /** 物料id */
     materialId: string;
@@ -62,3 +66,5 @@ export declare function judgeUnique(opts: {
 }): Promise<boolean>;
 /** 是否有BOM授权 */
 export declare function queryIsBomGranted(): Promise<any>;
+/** 查批次锁定记录（最新一条） */
+export declare function getLotLockedReason(production_identification_id_: string): Promise<string>;

package/dist/runtime/canvas/table/render/material-consume/transform.d.ts

@@ -0,0 +1,12 @@
+/** 将源数据转换为子表数据 */
+declare function transformSourceData2SubTable(data: any, dict?: {}, 
+/** 默认值 */
+defaultData?: any): {
+    _DICT: object;
+    _OPCT: object;
+    [key: string]: any;
+}[];
+export declare const transformUtils: {
+    transformSourceData2SubTable: typeof transformSourceData2SubTable;
+};
+export {};

package/dist/runtime/renderer/dialogs/field-hyperlink/open-field-hyperlink.d.ts

@@ -1,24 +1,2 @@
 import { Doc, WidgetMeta } from '../../../../core';
-import { BusinessSubTableType } from '../../../../domain/table/types';
-/** 填报只读超链接字段点击 → 宿主打开追溯弹框 */
-interface OpenFieldHyperlinkModalOptions {
-    /** 展示值（批次号等） */
-    materialNo?: string;
-    /** 字段 manifest 类型（如 material_no）；同类型可能对应不同业务弹框，需配合 fieldKey/tableType */
-    fieldType?: string;
-    /** enrich 写入的 _href_（可能为空，如 newHrefSuffix 静态链） */
-    href?: string | null;
-    /** 业务字段 key，如 production_container_id_ / material_container_no_ */
-    fieldKey?: string;
-    /** 业务表类型，如 pretreatment-list；主表字段为空 */
-    tableType?: BusinessSubTableType;
-    /** 子表字段 key（子模型挂载点） */
-    subFieldKey?: string;
-    /** 子表行号 */
-    rowIndex?: number;
-    /** 运行时 valuePath */
-    valuePath?: string;
-}
-export declare function resolveOpenFieldHyperlinkModalOptions(doc: Doc, widgetMeta: WidgetMeta, runtimeValuePath: string): OpenFieldHyperlinkModalOptions;
 export declare function openFieldHyperlinkModal(doc: Doc, widgetMeta: WidgetMeta, runtimeValuePath: string): Promise<void>;
-export {};

package/dist/runtime/renderer/dropdowns/components/tables/columns/business/biz.d.ts

@@ -20,3 +20,14 @@ export declare const bizMfgOrderColumns: ({
     field: string;
     minWidth: number;
 })[];
+export declare const materialContainerColumns: ({
+    field: string;
+    type: string;
+    minWidth: number;
+    width: number;
+    showOverflow: boolean;
+} | {
+    title: string;
+    field: string;
+    minWidth: number;
+})[];

package/dist/runtime/renderer/dropdowns/components/tables/columns/columns.d.ts

@@ -10,6 +10,8 @@ export declare function getColumns(key: string, displayFields: IDisplayField[],
  * 根据列配置和行数据返回格式化后的值
  */
 export declare function renderWithFormatter(column?: any, row?: any): any;
+/** LOT/SN 下拉项的展示名称；related_child 对外展示父批次名称。 */
+export declare function getLotDisplayLabel(item: any): string;
 /**
  * 树形数据转换
  * 用于 RDO 场景，将平层数据转换为树形结构
@@ -35,7 +37,7 @@ export declare function transformTreeData(options?: any[], currentValue?: string
  * 用于批次/表格数据场景，将原始数据转换为表格行数据
  *
  * @param options - 原始选项数据
- * @param currentValue - 当前选中的值（批次号 name）
+ * @param currentValue - 当前选中的值（普通批次为 name，生产批次为 id）
  * @param currentId - companion `_id_`；有值时优先按 id 高亮，老数据无 id 时回退 name
  * @returns 转换后的数据和高亮索引
  *
@@ -44,7 +46,7 @@ export declare function transformTreeData(options?: any[], currentValue?: string
  * const { data, highlightIdx } = transformLotData(options, 'lot-123', 'id-xxx');
  * ```
  */
-export declare function transformLotData(options?: Option[], currentValue?: string | string[], currentId?: string): {
+export declare function transformLotData(options?: Option[], currentValue?: string | string[], currentId?: string, displayRelatedParent?: boolean): {
     data: any[];
     highlightIdx: {
         index: number[];

package/dist/runtime/renderer/dropdowns/components/tables/strategy/selectStrategy.d.ts

@@ -36,6 +36,8 @@ export interface SelectStrategy {
     allowManualInput?: boolean;
     /** 下拉选中时同步写入 companion `_id_`（批次字段） */
     persistOptionId?: boolean;
+    /** 是否将 related_child 的展示名称切换为父批次名称 */
+    displayRelatedParent?: boolean;
     /**
      * 将 option `id_` 写入行内指定字段（如 `inventory_id_`），用于多库存行唯一回显
      * @see SelectSourceDef.optionIdField
@@ -44,7 +46,7 @@ export interface SelectStrategy {
     /** biz 请求体与 pageNo/pageSize 平铺，不走 query/exp（由 searchStyle === 'param' 推导） */
     flatRequestBody?: boolean;
     buildQuery?: (ctx: SelectQueryContext) => SelectQueryResult;
-    transform: (options: any[], value?: string, currentId?: string) => any;
+    transform: (options: any[], value?: string, currentId?: string, displayRelatedParent?: boolean) => any;
     /** 如下拉 value/label 与 fetcher 默认不同 */
     optionMapping?: {
         value?: string;

package/dist/suites/edhr/component/resolve-field-render-colors.d.ts

@@ -1,6 +1,8 @@
 export type FieldRenderColors = {
     color: string;
     background: string;
+    /** 超链接下划线颜色（文字颜色可能被校验色覆盖） */
+    underlineColor?: string;
 };
 /**
  * 统一字段画布配色：校验异常红 + 打印 / 禁用 / 只读 / 可编辑
@@ -15,4 +17,6 @@ export declare function resolveFieldRenderColors(input: {
     /** 有值文本在打印/只读时使用的字色 */
     textColor?: string;
     variant: 'text' | 'placeholder';
+    /** 是否按超链接展示。超链接文字无校验时使用链接蓝色。 */
+    hyperlink?: boolean;
 }): FieldRenderColors;

package/dist/suites/edhr/panel-schema/data-init/material-consume-object/bom-validator.d.ts

@@ -0,0 +1,52 @@
+import { FormInstBomResponse } from '@gct-paas/api/apaas';
+/** 物料消耗对象字段信息 */
+export interface IMaterialConsumeObjectInfo {
+    /** 对象字段key */
+    objectField: string;
+    /** 对象字段名称（仅用于展示） */
+    objectFieldName?: string;
+    /** 子表字段key */
+    subFields?: Record<string, {
+        used: boolean;
+        key: string;
+        [key: string]: any;
+    }>;
+}
+/** 物料消耗对象中参与提交数量校验的上料数量字段。 */
+export declare function getObjectBomQtyFieldKeys(objectFieldList?: IMaterialConsumeObjectInfo[]): string[];
+/**
+ * 物料消耗对象扫码：按对象 BOM 配置校验扫码物料是否允许
+ * - 无 belongingObject / 无配置：跳过
+ * - personal_bom_enabled_：人为指定物料，直接通过
+ * - 否则用实例 bomEntries 校验（仅主料；开启替代料时才含替代料）
+ */
+export declare function validateObjectBomForScan(opts: {
+    formInstBom?: FormInstBomResponse | null;
+    belongingObject?: string;
+    productId?: string;
+}): void;
+/**
+ * 物料消耗对象物料批下拉：未开人为指定时，限制为 BOM 主料 + 已开替代料的替代料
+ * - 无需过滤时返回 null（无 belongingObject / 无配置 / 人为指定）
+ * - 无候选时用占位 id，避免空数组被后端当成不筛选
+ */
+export declare function getObjectBomMaterialLotQuery(opts: {
+    formInstBom?: FormInstBomResponse | null;
+    belongingObject?: string;
+}): {
+    'product_id_.versionIn': string[];
+} | null;
+/**
+ * 表单提交：校验所有物料消耗对象的数量 vs 需求数量
+ * - 开了数量校验且需求数量有值才校验
+ * - 人为指定：用 objectBom.entries_[0]；否则用 bomEntries 中与对象物料匹配的明细
+ * - 失败返回与物料消耗表 submitValidate 同类的 field/message 结构
+ */
+export declare function validateObjectBomQtyOnSubmit(opts: {
+    formState: Record<string, any>;
+    objectFieldList?: IMaterialConsumeObjectInfo[];
+    formInstBom?: FormInstBomResponse | null;
+}): Promise<{
+    field: string;
+    message: string;
+} | null>;

package/dist/suites/edhr/panel-schema/data-init/material-consume-object/index.d.ts

@@ -0,0 +1,2 @@
+export * from './use-tmpl-bom';
+export * from './bom-validator';

package/dist/suites/edhr/panel-schema/data-init/material-consume-object/use-tmpl-bom.d.ts

@@ -0,0 +1,13 @@
+import { ComputedRef, MaybeRef } from 'vue';
+import { FormTmplBomController } from '../../../../../runtime/canvas/table/render/material-consume';
+import { FormInstBomResponse } from '@gct-paas/api/apaas';
+/**
+ * 当前页 FormTmplBomController 的 provide / inject
+ * - document-paper 中 provide 当前页控制器
+ * - 主模型字段等通过 injectController / injectFormInstBom 读取
+ */
+export declare function useTmplBom(): {
+    provideController: (c: MaybeRef<FormTmplBomController | undefined>) => MaybeRef<FormTmplBomController | undefined>;
+    injectController: () => ComputedRef<FormTmplBomController | undefined>;
+    injectFormInstBom: () => ComputedRef<FormInstBomResponse | null | undefined>;
+};

package/dist/suites/edhr/panel-schema/data-init/object-init/object-init.vue.d.ts

@@ -1,9 +1,11 @@
 type __VLS_Props = {
-    list: any[];
-    onChange: (list: any[]) => void;
+    objects: any[];
 };
-declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    onChange: (list: any[]) => void;
-    list: any[];
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:objects": (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:objects"?: ((...args: any[]) => any) | undefined;
+}>, {
+    objects: any[];
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/utils/adapters/TriggerUtil.d.ts

@@ -1,4 +1,4 @@
-export type TriggerName = 'OPEN_COMMON_CONFIRM_MODAL' | 'OPEN_DOC_SIGNATURE_RULE_CONFIG_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_FORM_MODEL_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_INPUT_PARAMS_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_OUTPUT_PARAMS_MODAL' | 'OPEN_DATA_INIT_OBJ_INIT_EDIT_MODEL' | 'OPEN_FIELD_HYPERLINK_MODAL' | 'OPEN_FIELD_ONLINE_FORM_TMPL_MODAL' | 'OPEN_DISPLAY_FIELDS_TRANSFER_MODAL' | 'OPEN_QUICK_FILL_MODAL' | 'OPEN_CHECK_TABLE_DS_MODAL' | 'OPEN_MATERIAL_CONSUME_TABLE_PARSE_RULE_MODAL' | 'OPEN_MATERIAL_CONSUME_TABLE_ADD_MATERIAL_MODAL' | 'OPEN_MATERIAL_CONSUME_TABLE_SCAN_MODAL' | 'OPEN_MATERIAL_CONSUME_TABLE_BOM_MODAL' | 'OPEN_COMMON_BUSINESS_TABLE_SCAN_MODAL' | 'OPEN_COMMON_BUSINESS_TABLE_MULTI_ROWS_MODAL' | 'OPEN_E_SOP_VIEW_MODAL' | 'OPEN_FORMULA_EDITOR_MODAL';
+export type TriggerName = 'OPEN_COMMON_CONFIRM_MODAL' | 'OPEN_DOC_SIGNATURE_RULE_CONFIG_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_FORM_MODEL_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_INPUT_PARAMS_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_OUTPUT_PARAMS_MODAL' | 'OPEN_FIELD_HYPERLINK_MODAL' | 'OPEN_FIELD_ONLINE_FORM_TMPL_MODAL' | 'OPEN_DISPLAY_FIELDS_TRANSFER_MODAL' | 'OPEN_QUICK_FILL_MODAL' | 'OPEN_CHECK_TABLE_DS_MODAL' | 'OPEN_COMMON_BUSINESS_TABLE_SCAN_MODAL' | 'OPEN_COMMON_BUSINESS_TABLE_MULTI_ROWS_MODAL' | 'OPEN_E_SOP_VIEW_MODAL' | 'OPEN_FORMULA_EDITOR_MODAL';
 export type TriggerHandler = (name: TriggerName, options?: any) => Promise<any>;
 interface TriggerUtilHandlers {
     handle?: TriggerHandler;