feat(WEB): FCM 푸시 알림 공통 모듈 및 기안함 연동

- FCM 공통 모듈 생성 (src/lib/actions/fcm.ts)
  - sendFcmNotification: 기본 FCM 발송 함수
  - sendApprovalNotification: 결재 알림 프리셋
  - sendWorkOrderNotification: 작업지시 알림 프리셋
  - sendNoticeNotification: 공지사항 알림 프리셋
- 기안함 페이지에 '문서완료' 버튼 추가
  - Bell 아이콘 + FCM 발송 기능
  - 발송 결과 토스트 메시지 표시

src/lib/actions/fcm.ts

@@ -0,0 +1,148 @@
+/**
+ * FCM 푸시 알림 공통 서버 액션
+ *
+ * 사용 예시:
+ * import { sendFcmNotification, sendApprovalNotification } from '@/lib/actions/fcm';
+ *
+ * // 기본 알림 발송
+ * const result = await sendFcmNotification({ title: '알림', body: '내용' });
+ *
+ * // 결재 알림 발송 (프리셋)
+ * const result = await sendApprovalNotification();
+ */
+
+'use server';
+
+import { isNextRedirectError } from '@/lib/utils/redirect-error';
+import { serverFetch } from '@/lib/api/fetch-wrapper';
+
+// ============================================
+// 타입 정의
+// ============================================
+
+export interface FcmNotificationParams {
+  /** 알림 제목 (필수) */
+  title: string;
+  /** 알림 본문 (필수) */
+  body: string;
+  /** 특정 테넌트에게만 발송 */
+  tenant_id?: number;
+  /** 특정 사용자에게만 발송 */
+  user_id?: number;
+  /** 플랫폼 필터 (android, ios, web) */
+  platform?: 'android' | 'ios' | 'web';
+  /** 알림 채널 ID (Android) */
+  channel_id?: string;
+  /** 알림 타입 (앱에서 분기 처리용) */
+  type?: string;
+  /** 클릭 시 이동할 URL */
+  url?: string;
+  /** 알림 사운드 키 */
+  sound_key?: string;
+}
+
+export interface FcmResult {
+  success: boolean;
+  error?: string;
+  sentCount?: number;
+  __authError?: boolean;
+}
+
+// ============================================
+// 기본 FCM 발송 함수
+// ============================================
+
+/**
+ * FCM 푸시 알림 발송
+ */
+export async function sendFcmNotification(
+  params: FcmNotificationParams
+): Promise<FcmResult> {
+  try {
+    const { response, error } = await serverFetch(
+      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/admin/fcm/send`,
+      {
+        method: 'POST',
+        body: JSON.stringify(params),
+      }
+    );
+
+    if (error?.__authError) {
+      return { success: false, error: '인증이 필요합니다.', __authError: true };
+    }
+
+    if (!response) {
+      return { success: false, error: error?.message || 'FCM 발송에 실패했습니다.' };
+    }
+
+    const result = await response.json();
+
+    if (!response.ok || !result.success) {
+      return {
+        success: false,
+        error: result.message || 'FCM 발송에 실패했습니다.',
+      };
+    }
+
+    return {
+      success: true,
+      sentCount: result.data?.success || 0,
+    };
+  } catch (error) {
+    if (isNextRedirectError(error)) throw error;
+    console.error('[FCM] sendFcmNotification error:', error);
+    return {
+      success: false,
+      error: '서버 오류가 발생했습니다.',
+    };
+  }
+}
+
+// ============================================
+// 프리셋 함수들 (자주 사용하는 알림 타입)
+// ============================================
+
+/**
+ * 결재 알림 발송 (프리셋)
+ */
+export async function sendApprovalNotification(
+  customParams?: Partial<FcmNotificationParams>
+): Promise<FcmResult> {
+  return sendFcmNotification({
+    title: '결재 알림',
+    body: '결재 문서가 완료되었습니다.',
+    type: 'approval',
+    channel_id: 'approval',
+    ...customParams,
+  });
+}
+
+/**
+ * 작업지시 알림 발송 (프리셋)
+ */
+export async function sendWorkOrderNotification(
+  customParams?: Partial<FcmNotificationParams>
+): Promise<FcmResult> {
+  return sendFcmNotification({
+    title: '작업지시 알림',
+    body: '새로운 작업지시가 있습니다.',
+    type: 'work_order',
+    channel_id: 'work_order',
+    ...customParams,
+  });
+}
+
+/**
+ * 일반 공지 알림 발송 (프리셋)
+ */
+export async function sendNoticeNotification(
+  customParams?: Partial<FcmNotificationParams>
+): Promise<FcmResult> {
+  return sendFcmNotification({
+    title: '공지사항',
+    body: '새로운 공지사항이 있습니다.',
+    type: 'notice',
+    channel_id: 'notice',
+    ...customParams,
+  });
+}