(최겸) 구매 PQ수정, 정규업체 결재 개발(진행중)

1 files changed, 99 insertions, 0 deletions

diff --git a/lib/vendor-regular-registrations/approval-actions.ts b/lib/vendor-regular-registrations/approval-actions.ts
new file mode 100644
index 00000000..02c7e412
--- /dev/null
+++ b/lib/vendor-regular-registrations/approval-actions.ts
@@ -0,0 +1,99 @@
+/**
+ * 정규업체 등록 관련 결재 서버 액션
+ * 
+ * 사용자가 UI에서 호출하는 함수들
+ * withApproval()을 사용하여 결재 프로세스를 시작
+ */
+
+'use server';
+
+import { withApproval } from '@/lib/approval/approval-workflow';
+import { mapRegistrationToTemplateVariables } from './handlers';
+import { debugLog, debugError, debugSuccess } from '@/lib/debug-utils';
+import type { RegistrationRequestData } from '@/components/vendor-regular-registrations/registration-request-dialog';
+
+/**
+ * 결재를 거쳐 정규업체 등록을 처리하는 서버 액션
+ * 
+ * 사용법 (클라이언트 컴포넌트에서):
+ * ```typescript
+ * const result = await registerVendorWithApproval({
+ *   registrationId: 123,
+ *   requestData: registrationData,
+ *   currentUser: { id: 1, epId: 'EP001', email: 'user@example.com' },
+ *   approvers: ['EP002', 'EP003']
+ * });
+ * 
+ * if (result.status === 'pending_approval') {
+ *   console.log('결재 ID:', result.approvalId);
+ * }
+ * ```
+ */
+export async function registerVendorWithApproval(data: {
+  registrationId: number;
+  requestData: RegistrationRequestData;
+  vendorId?: number; // vendors 테이블에서 정보를 가져오기 위한 vendorId
+  currentUser: { id: number; epId: string | null; email?: string };
+  approvers?: string[]; // Knox EP ID 배열 (결재선)
+}) {
+  debugLog('[VendorRegistrationApproval] 정규업체 등록 결재 서버 액션 시작', {
+    registrationId: data.registrationId,
+    companyName: data.requestData.companyNameKor,
+    businessNumber: data.requestData.businessNumber,
+    userId: data.currentUser.id,
+    hasEpId: !!data.currentUser.epId,
+  });
+
+  // 입력 검증
+  if (!data.currentUser.epId) {
+    debugError('[VendorRegistrationApproval] Knox EP ID 없음');
+    throw new Error('Knox EP ID가 필요합니다');
+  }
+
+  if (!data.registrationId) {
+    debugError('[VendorRegistrationApproval] 등록 ID 없음');
+    throw new Error('등록 ID가 필요합니다');
+  }
+
+  // 1. 템플릿 변수 매핑
+  debugLog('[VendorRegistrationApproval] 템플릿 변수 매핑 시작');
+  const requestedAt = new Date();
+  const variables = await mapRegistrationToTemplateVariables({
+    requestData: data.requestData,
+    requestedAt,
+    vendorId: data.vendorId,
+  });
+  debugLog('[VendorRegistrationApproval] 템플릿 변수 매핑 완료', {
+    variableKeys: Object.keys(variables),
+  });
+
+  // 2. 결재 워크플로우 시작 (템플릿 기반)
+  debugLog('[VendorRegistrationApproval] withApproval 호출');
+  const result = await withApproval(
+    // actionType: 핸들러를 찾을 때 사용할 키
+    'vendor_regular_registration',
+    
+    // actionPayload: 결재 승인 후 핸들러에 전달될 데이터
+    {
+      registrationId: data.registrationId,
+      requestData: data.requestData,
+    },
+    
+    // approvalConfig: 결재 상신 정보 (템플릿 포함)
+    {
+      title: `정규업체 등록 - ${data.requestData.companyNameKor}`,
+      description: `${data.requestData.companyNameKor} 정규업체 등록 요청`,
+      templateName: '정규업체 등록', // 한국어 템플릿명
+      variables, // 치환할 변수들
+      approvers: data.approvers,
+      currentUser: data.currentUser,
+    }
+  );
+
+  debugSuccess('[VendorRegistrationApproval] 결재 워크플로우 완료', {
+    approvalId: result.approvalId,
+    status: result.status,
+  });
+
+  return result;
+}