@lemoncloud/clipbiz-goods-api 0.25.1028 → 0.25.1125

package/dist/modules/ai/model.d.ts

@@ -10,7 +10,6 @@
  */
 import { CoreModel } from 'lemon-model';
 import $LUT, { RecommendState, RecommendStereo, ReferencedContent, ReferencedUsage } from './types';
-import { GenModelType } from '../../lib/openai/openai-types';
 /**
  * type: `ModelType`
  */
@@ -52,7 +51,7 @@ export interface RecommendModel extends Model, RecommendHead {
     /** name of recommend */
     name?: string;
     /** type of llm model */
-    modelType?: GenModelType;
+    modelType?: string;
     /** system prompt to use */
     promptId?: string;
     /** state of recommend */

package/dist/modules/ai/views.d.ts

@@ -62,4 +62,9 @@ export interface RecommendPostItemsParam extends RecommendCommonParam {
      * - if true, return immediately after make notify()
      */
     async?: boolean | string;
+    /**
+     * (optional) id of connection-id
+     * - send the result of the change to a WebSocket
+     */
+    connId?: string;
 }

package/dist/modules/contracts/model.d.ts

@@ -0,0 +1,157 @@
+/**
+ * `model.ts`
+ * - model definitions per contract data
+ *
+ * @author      Steve <steve@lemoncloud.io>
+ * @date        2022-08-29 initial version.
+ * @author      Aiden <aiden@lemoncloud.io>
+ * @date        2025-11-30 implement a contract service.
+ *
+ * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { CoreModel } from 'lemon-model';
+import $LUT, { ContractStereo, ContractState, DeliveryStereo, DeliveryState, ContractAgreement } from './types';
+import { DealHead, DealModel } from '../deals/model';
+import { Cores } from 'lemon-core';
+/**
+ * type: `ModelType`
+ */
+export declare type ModelType = keyof typeof $LUT.ModelType;
+/**
+ * type: `Model`: common model interface
+ * - modifier 정보 저장을 위해 확장됨 @251124
+ *
+ * TODO [Steve] 아래의 `$` 부분은 추후 `lemon-model` 쪽으로 이전 검토 필요. @251124
+ */
+export interface Model extends CoreModel<ModelType> {
+    /**
+     * the modifier information
+     * - can't update manually.
+     */
+    readonly $?: Cores;
+}
+/**
+ * type: `ContractHead`
+ */
+export interface ContractHead {
+    /** id of model */
+    id?: string;
+    /** name of model */
+    name?: string;
+}
+/**
+ * type: `ContractModel`
+ * - 매칭(deal)에 대한 계약 정보를 관리함.
+ */
+export interface ContractModel extends ContractHead, Model {
+    /** name of model */
+    name?: string;
+    /** stereo of model */
+    stereo?: ContractStereo;
+    /** state of model */
+    state?: ContractState;
+    /** (linked) id of deal */
+    dealId?: string;
+    /** (linked) parital of deal */
+    deal$?: DealHead;
+    /** 총 주문수량 */
+    totalQuantity?: number;
+    /** 단가 */
+    unitPrice?: number;
+    /** 총 계약금액 */
+    totalAmount?: number;
+    /** 계약 시작 시각 */
+    startedAt?: number;
+    /** 계약 만료 시각 */
+    expiredAt?: number;
+    /** 특이사항 (for 기업) */
+    notes?: string;
+    /** 메모  (for 사업장) */
+    memo?: string;
+    /** 반려사유 (for 사업장) */
+    reasons?: string[];
+    /**
+     * no of revision
+     * - [parent] no-of-revision
+     * - [child] no-in-revision
+     */
+    revisionNo?: number;
+    /**
+     * no of delivery (원자적 증가)
+     * - 마지막 생성된 납기 번호
+     */
+    deliveryNo?: number;
+    /** (optional) id of parent */
+    parentId?: string;
+    /** (optional) partial of parent */
+    parent$?: ContractHead;
+    /**
+     * 약관 동의 기록
+     * - 기업, 표준사업장 동의 기록 관리
+     */
+    agreed$?: ContractAgreement;
+    /**
+     * (internal) detail info of deal
+     */
+    readonly $deal?: DealModel;
+}
+/**
+ * interface: `DeliveryHead`
+ * - common head of `DeliveryModel`
+ */
+export interface DeliveryHead {
+    /** id of model */
+    id?: string;
+    /** name of model */
+    name?: string;
+}
+/**
+ * interface: `DeliveryModel`
+ * - 계약(contract)애 대헌 회차/납기 정보를 관리함.
+ */
+export interface DeliveryModel extends DeliveryHead, Model {
+    /** name of model */
+    name?: string;
+    /** stereo of model */
+    stereo?: DeliveryStereo;
+    /** state of model */
+    state?: DeliveryState;
+    /** (linked) id of contract */
+    contractId?: string;
+    /** (linked) partial of contract */
+    contract$?: ContractHead;
+    /** (internal) 납기 번호 (:= Contract.deliveryNo) */
+    no?: number;
+    /** 납기 수량 */
+    quantity?: number;
+    /** 납기 단가 */
+    unitPrice?: number;
+    /** 납기 금액 */
+    amount?: number;
+    /** 예정 납기일 */
+    scheduledAt?: number;
+    /** 실제 납품일 */
+    deliveredAt?: number;
+    /** 메모 */
+    memo?: string;
+}
+export declare const filterFields: (fields: string[], base?: string[]) => string[];
+export declare const $HEAD: {
+    contract: string[];
+    delivery: string[];
+};
+export declare const $FIELD: {
+    contract: string[];
+    delivery: string[];
+};
+declare const _default: {
+    $HEAD: {
+        contract: string[];
+        delivery: string[];
+    };
+    $FIELD: {
+        contract: string[];
+        delivery: string[];
+    };
+};
+export default _default;

package/dist/modules/contracts/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * `types.ts`
+ * - view types used in API controllers and transformer
+ *
+ * @author      Steve <steve@lemoncloud.io>
+ * @date        2022-06-21 optimized w/ `abstract-services`
+ * @author      Aiden <aiden@lemoncloud.io>
+ * @date        2025-11-30 implement a contract service.
+ *
+ * @copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+declare const $LUT: {
+    ModelType: {
+        contract: string;
+        delivery: string;
+    };
+    /** ContractStereo **/
+    ContractStereo: {
+        '': string;
+        '#': string;
+        '#revision': string;
+    };
+    /** ContractState */
+    ContractState: {
+        '': string;
+        draft: string;
+        pending: string;
+        approved: string;
+        active: string;
+        completed: string;
+        expired: string;
+        rejected: string;
+        cancelled: string;
+    };
+    /** DeliveryStereo */
+    DeliveryStereo: {
+        '': string;
+    };
+    /** DeliveryState */
+    DeliveryState: {
+        '': string;
+    };
+};
+/**
+ * type: `ContractStereo`
+ */
+export declare type ContractStereo = keyof typeof $LUT.ContractStereo;
+/**
+ * type: `ContractState`
+ */
+export declare type ContractState = keyof typeof $LUT.ContractState;
+/**
+ * type: `DeliveryStereo`
+ */
+export declare type DeliveryStereo = keyof typeof $LUT.DeliveryStereo;
+/**
+ * type: `DeliveryState`
+ */
+export declare type DeliveryState = keyof typeof $LUT.DeliveryState;
+/**
+ * type: `Agreement`
+ */
+export interface Agreement {
+    /**
+     * 동적 약관 동의 기록
+     * - key: 약관 ID
+     * - value: 약관 정보
+     */
+    [key: string]: {
+        /** 약관(term) ID */
+        id: string;
+        /** 약관(term)명 */
+        name: string;
+        /** 동의 시각 */
+        ts?: number;
+    };
+}
+/**
+ * type: `ContractAgreement`
+ * - 계약서별 약관 동의 기록
+ */
+export interface ContractAgreement {
+    /** 구매업체(기업) 약관 기록 */
+    seller?: Agreement;
+    /** 판매업체(표준사업장) 약관 기록 */
+    buyer?: Agreement;
+}
+export default $LUT;

package/dist/modules/contracts/views.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `contracts/views.ts`
+ * - types used in `backed-proxy`
+ *
+ * @author      Steve <steve@lemoncloud.io>
+ * @date        2022-08-29 initial version.
+ * @author      Aiden <aiden@lemoncloud.io>
+ * @date        2025-11-30 implement a contract service.
+ *
+ * @copyright   (C) lemoncloud.io 2022 - All Rights Reserved.
+ */
+import { View, Body } from 'lemon-model';
+import { ContractModel, DeliveryModel } from './model';
+import $LUT from './types';
+import { DealView } from '../deals/views';
+export * from './types';
+export default $LUT;
+/**!SECTION */
+/**
+ * type: `ContractView`
+ * - usually same as post's body.
+ */
+export interface ContractView extends View, Omit<Partial<ContractModel>, 'deal$'> {
+    /**
+     * (readonly) 매칭 정보
+     */
+    readonly deal$?: DealView;
+}
+export interface ContractBody extends Body, Partial<ContractView> {
+}
+/**
+ * type: `DeliveryView`
+ * - usually same as post's body.
+ */
+export interface DeliveryView extends View, Omit<Partial<DeliveryModel>, 'contract$'> {
+    /**
+     * (readonly) 계약서 정보
+     */
+    readonly contract$?: ContractView;
+}
+/**
+ * type: `DeliveryBody`
+ */
+export interface DeliveryBody extends Body, Partial<DeliveryView> {
+}

package/dist/modules/deals/model.d.ts

@@ -7,7 +7,7 @@
  *
  * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
  */
-import { CoreModel } from 'lemon-model';
+import { CoreModel, Cores } from 'lemon-model';
 import $LUT, { DealStereo, DealStatus, DealStatusSet } from './types';
 import { ProdHead } from '../goods/model';
 import { ItemHead } from '../goods/model';
@@ -17,9 +17,18 @@ import { SiteHead } from '../sites/model';
  */
 export declare type ModelType = keyof typeof $LUT.ModelType;
 /**
- * type: `Model`: common model
+ * type: `Model`: common model interface
+ * - modifier 정보 저장을 위해 확장됨 @251124
+ *
+ * TODO [Steve] 아래의 `$` 부분은 추후 `lemon-model` 쪽으로 이전 검토 필요. @251124
  */
-export declare type Model = CoreModel<ModelType>;
+export interface Model extends CoreModel<ModelType> {
+    /**
+     * the modifier information
+     * - can't update manually.
+     */
+    readonly $?: Cores;
+}
 /**
  * interface: `DealHead`
  * - common head of deal-model
@@ -29,6 +38,23 @@ export interface DealHead {
     id?: string;
     /** name of deal */
     name?: string;
+    /** ==== 계약 시점의 스냅샷  ==== */
+    /** (linked) 상품(희망상품) ID */
+    prodId?: string;
+    /** (linked) 상품(희망상품) 정보 */
+    prod$?: ProdHead;
+    /** (linked) 품목 ID */
+    itemId?: string;
+    /** (linked) 품목 정보 */
+    item$?: ItemHead;
+    /** (linked) 신청 기업(업체) ID */
+    buyerSiteId?: string;
+    /** (linked) 신청 기업(업체) 정보 */
+    buyerSite$?: SiteHead;
+    /** (linked) 공급 기업(표준사업장) ID */
+    sellerSiteId?: string;
+    /** (linked) 공급 기업(표준사업장) 정보 */
+    sellerSite$?: SiteHead;
 }
 /**
  * interface: `DealModel`
@@ -63,6 +89,8 @@ export interface DealModel extends DealHead, Model {
     sellerSite$?: SiteHead;
     /** 전체 상태 */
     status?: DealStatus;
+    /** 상태 순서 (1-7) */
+    stateNo?: number;
     /** 상태 세트 (inner object) */
     status$?: DealStatusSet;
     /** 요청 정보 */

package/dist/modules/deals/types.d.ts

@@ -27,20 +27,87 @@ declare const $LUT: {
     DealStatus: {
         /** 상태없음 */
         '': string;
-        /** 승인 대기 */
+        /**
+         * 승인 대기
+         * @deprecated 기획 변경에 따른 타입 수정. 제거 필요함
+         */
         pending: string;
-        /** 준비 단계 */
+        /**
+         * 준비 단계
+         * @deprecated 기획 변경에 따른 타입 수정. 제거 필요함
+         */
         preparing: string;
-        /** 진행 단계 */
+        /**
+         * 진행 단계
+         * @deprecated 기획 변경에 따른 타입 수정. 제거 필요함
+         */
         inProgress: string;
-        /** 완료 */
+        /**
+         * 완료
+         * @deprecated 기획 변경에 따른 타입 수정. 제거 필요함
+         */
         completed: string;
-        /** 반려 (재신청 가능) */
+        /**
+         * 반려 (재신청 가능)
+         * @deprecated 기획 변경에 따른 타입 수정. 제거 필요함
+         */
         rejected: string;
-        /** 취소 (재신청 가능) */
+        /**
+         * 취소 (재신청 가능)
+         * @deprecated 기획 변경에 따른 타입 수정. 제거 필요함
+         */
         cancelled: string;
-        /** 취소요청 */
+        /**
+         * 취소요청
+         * @deprecated 기획 변경에 따른 타입 수정. 제거 필요함
+         */
         toCancel: string;
+        /** [step1] 우수사업장 선정 */
+        select: string;
+        /** [step2] 품목 매핑 */
+        mapping: string;
+        /** [step3] 사용부서 협의 */
+        agreement: string;
+        /** [step4] 업체평 (선택) */
+        review: string;
+        /** [step5] 샘플 테스트 */
+        sample: string;
+        /** [step6] 업체 등록 */
+        register: string;
+        /** [step7] 단가 계약 */
+        contract: string;
+    };
+    /**
+     * DealWorkflowState
+     */
+    DealWorkflowState: {
+        /** 상태없음 */
+        '': string;
+        /** 초기상태 */
+        init: string;
+        /** 처리중(진행중) */
+        busy: string;
+        /** 완료 */
+        completed: string;
+    };
+    /**
+     * DealStatusOrder
+     */
+    DealStatusOrder: {
+        /** [step1] 우수사업장 선정 */
+        select: number;
+        /** [step2] 품목 매핑 */
+        mapping: number;
+        /** [step3] 사용부서 협의 */
+        agreement: number;
+        /** [step4] 업체평 (선택) */
+        review: number;
+        /** [step5] 샘플 테스트 */
+        sample: number;
+        /** [step6] 업체 등록 */
+        register: number;
+        /** [step7] 단가 계약 */
+        contract: number;
     };
 };
 /**
@@ -51,32 +118,58 @@ export declare type DealStereo = keyof typeof $LUT.DealStereo;
  * type: `DealStatus`
  */
 export declare type DealStatus = keyof typeof $LUT.DealStatus;
+/**
+ * type: `DealWorkflowState`
+ */
+export declare type DealWorkflowState = keyof typeof $LUT.DealWorkflowState;
+/**
+ * type: `DealStatusOrder`
+ */
+export declare type DealStatusOrder = keyof typeof $LUT.DealStatusOrder;
 /**
  * interface: `DealStatusSet`
  * - 상태 세트
  */
-export interface DealStatusSet {
-    /** 신청 정보 */
+export interface DealStatusSet extends DealWorkflowSet {
+    /**
+     * 신청 정보
+     * @deprecated don't use it anymore.
+     */
     requestedAt?: number;
     requestedBy?: string;
     requestMemo?: string;
-    /** 승인 정보 */
+    /**
+     * 승인 정보
+     * @deprecated don't use it anymore.
+     */
     approvedAt?: number;
     approvedBy?: string;
     approvalMemo?: string;
-    /** 진행 정보 */
+    /**
+     * 진행 정보
+     * @deprecated don't use it anymore.
+     */
     progressedAt?: number;
     progressedBy?: string;
     progressedMemo?: string;
-    /** 완료 시각 */
+    /**
+     * 완료 정보
+     * @deprecated don't use it anymore.
+     */
     completedAt?: number;
     completedBy?: string;
     completedMemo?: string;
-    /** 반려 정보 */
+    /**
+     * 반려 정보
+     * @deprecated don't use it anymore.
+     */
     rejectedAt?: number;
     rejectedBy?: string;
     rejectionReason?: string;
-    /** 취소 정보 */
+    /**
+     * 취소 정보
+     * @deprecated don't use it anymore.
+     */
     cancelledAt?: number;
     cancelledBy?: string;
     cancelReason?: string;
@@ -85,5 +178,25 @@ export interface DealStatusSet {
     /** (internal) last udpated time */
     updatedAt?: number;
 }
+/**
+ * type: `DealWorkflowSet`
+ * - 매칭상품의 진행 상태를 관리함
+ */
+export interface DealWorkflowSet {
+    /** [step1] 우수사업장 선정 */
+    select?: DealWorkflowState;
+    /** [step2] 품목 매핑 */
+    mapping?: DealWorkflowState;
+    /** [step3] 사용부서 협의 */
+    agreement?: DealWorkflowState;
+    /** [step4] 업체평 (선택) */
+    review?: DealWorkflowState;
+    /** [step5] 샘플 테스트 */
+    sample?: DealWorkflowState;
+    /** [step6] 업체 등록 */
+    register?: DealWorkflowState;
+    /** [step7] 단가 계약 */
+    contract?: DealWorkflowState;
+}
 /** must export $LUT as default */
 export default $LUT;

package/dist/modules/goods/model.d.ts

@@ -9,7 +9,7 @@
  *
  * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
  */
-import { CoreModel } from 'lemon-model';
+import { CoreModel, Cores } from 'lemon-model';
 import $LUT, { ItemStereo, ItemUnitType, ProdStereo } from './types';
 /**
  * type: boolean style number.
@@ -22,9 +22,18 @@ import { SiteHead } from '../sites/model';
  */
 export declare type ModelType = keyof typeof $LUT.ModelType;
 /**
- * type: `Model`: common model
+ * type: `Model`: common model interface
+ * - modifier 정보 저장을 위해 확장됨 @251124
+ *
+ * TODO [Steve] 아래의 `$` 부분은 추후 `lemon-model` 쪽으로 이전 검토 필요. @251124
  */
-export declare type Model = CoreModel<ModelType>;
+export interface Model extends CoreModel<ModelType> {
+    /**
+     * the modifier information
+     * - can't update manually.
+     */
+    readonly $?: Cores;
+}
 /**
  * interface: `ItemHead`
  * - common head of item-model.

package/dist/service/backend-types.d.ts

@@ -24,12 +24,17 @@ declare const $LUT: {
         callback: string;
         category: string;
         site: string;
+        /**
+         * Lookup Table
+         *
+         * WARN! DO NOT EXPORT AS `$LUT`. use default export instead.
+         */
         user: string;
         exam: string;
+        contract: string;
+        delivery: string;
         deal: string;
-        item: string; /**
-         * Possible type of model.
-         */
+        item: string;
         prod: string;
         recommend: string;
     };