feat-fe: 메세지 제출 폼 및 사이드 모달 컴포넌트 구현

frontend/package.json

@@ -14,6 +14,7 @@
     "@sentry/react": "^8.20.0",
     "@sentry/webpack-plugin": "^2.21.1",
     "@tanstack/react-query": "^5.51.1",
+    "@tanstack/react-query-devtools": "^5.58.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-error-boundary": "^4.0.13",

frontend/public/mockServiceWorker.js

@@ -8,7 +8,7 @@
  * - Please do NOT serve this file on production.
  */
 
-const PACKAGE_VERSION = '2.3.2'
+const PACKAGE_VERSION = '2.4.9'
 const INTEGRITY_CHECKSUM = '26357c79639bfa20d64c0efca2a87423'
 const IS_MOCKED_RESPONSE = Symbol('isMockedResponse')
 const activeClientIds = new Set()

frontend/src/api/APIClient.ts

@@ -34,7 +34,7 @@ export default class APIClient implements APIClientType {
     return this.request<T>({ method: 'GET', ...params });
   }
 
-  async post<T>(params: APIClientParamsWithBody): Promise<T> {
+  async post<T>(params: APIClientParamsWithBody & { isFormData?: boolean }): Promise<T> {
     return this.request<T>({ method: 'POST', ...params });
   }
 
@@ -54,10 +54,12 @@ export default class APIClient implements APIClientType {
     method,
     body,
     hasCookies = true,
+    isFormData = false,
   }: {
     method: Method;
     body?: BodyHashMap;
     hasCookies?: boolean;
+    isFormData?: boolean;
   }) {
     const headers: HeadersInit = {
       Accept: 'application/json',
@@ -69,14 +71,21 @@ export default class APIClient implements APIClientType {
       headers,
     };
 
-    if (['POST', 'PUT', 'PATCH'].includes(method)) {
+    if (['POST', 'PUT', 'PATCH'].includes(method) && !isFormData) {
       headers['Content-Type'] = 'application/json';
     }
 
-    if (body) {
+    if (body && !isFormData) {
       requestInit.body = JSON.stringify(body);
     }
 
+    if (body && isFormData) {
+      const formData = new FormData();
+      const bodyKeys = Object.keys(body);
+      bodyKeys.forEach((key) => formData.append(key, body[key]));
+      requestInit.body = formData;
+    }
+
     return requestInit;
   }
 
@@ -85,14 +94,16 @@ export default class APIClient implements APIClientType {
     method,
     body,
     hasCookies,
+    isFormData,
   }: {
     path: string;
     method: Method;
     body?: BodyHashMap;
     hasCookies?: boolean;
+    isFormData?: boolean;
   }): Promise<T> {
     const url = this.baseURL + path;
-    const response = await fetch(url, this.getRequestInit({ method, body, hasCookies }));
+    const response = await fetch(url, this.getRequestInit({ method, body, hasCookies, isFormData }));
 
     if (!response.ok) {
       const json = await response.json();

frontend/src/api/domain/email.ts

@@ -0,0 +1,25 @@
+import { EMAILS } from '../endPoint';
+import APIClient from '../APIClient';
+
+const apiClient = new APIClient(EMAILS);
+
+const emailApis = {
+  send: async ({
+    clubId,
+    applicantId,
+    subject,
+    content,
+  }: {
+    clubId: string;
+    applicantId: number;
+    subject: string;
+    content: string;
+  }) =>
+    apiClient.post({
+      path: '/send',
+      body: { clubId, applicantIds: applicantId, subject, content },
+      isFormData: true,
+    }),
+};
+
+export default emailApis;

frontend/src/api/endPoint.ts

@@ -15,3 +15,5 @@ export const AUTH = `${BASE_URL}/auth`;
 export const MEMBERS = `${BASE_URL}/members`;
 
 export const QUESTIONS = `${BASE_URL}/questions`;
+
+export const EMAILS = `${BASE_URL}/emails`;

frontend/src/components/ApplicantModal/ApplicantBaseInfo/index.tsx

@@ -7,6 +7,8 @@
 import specificApplicant from '@hooks/useSpecificApplicant';
 import formatDate from '@utils/formatDate';
 import { useModal } from '@contexts/ModalContext';
+
+import { DropdownListItem } from '@customTypes/common';
 import S from './style';
 
 interface ApplicantBaseInfoProps {
@@ -35,17 +37,39 @@
 
   const items = processList
     .filter(({ processName }) => processName !== process.name)
-    .map(({ processId, processName }) => ({
-      id: processId,
-      name: processName,
-      onClick: ({ targetProcessId }: { targetProcessId: number }) => {
-        moveApplicantProcess({ processId: targetProcessId, applicants: [applicantId] });
-      },
-    }));
+    .map(
+      ({ processId, processName }) =>
+        ({
+          id: processId,
+          name: processName,
+          onClick: ({ targetProcessId }: { targetProcessId: number | string }) => {
+            moveApplicantProcess({ processId: Number(targetProcessId), applicants: [applicantId] });
+          },
+        }) as DropdownListItem,
+    );
+  items.push({
+    id: 'emailButton',
+    name: '이메일 보내기',
+    hasSeparate: true,
+    onClick: () => {
+      // TODO: 이메일 보내는 로직 추가
+      alert('오픈해야함');
+    },
+  });
 
+  items.push({
+    id: 'rejectButton',
+    name: '불합격 처리',
+    isHighlight: true,
+    hasSeparate: true,
+    onClick: () => {
+      // TODO: 불합격 로직 추가
+      alert('오픈해야함');
+    },
+  });
   const rejectAppHandler = () => {
     const confirmAction = (message: string, action: () => void) => {
       const isConfirmed = window.confirm(message);
       if (isConfirmed) {
         action();
         close();

frontend/src/components/_common/atoms/DropdownItem/index.tsx

@@ -5,9 +5,16 @@ export interface DropdownItemProps {
   size: 'sm' | 'md';
   onClick: () => void;
   isHighlight?: boolean;
+  hasSeparate?: boolean;
 }
 
-export default function DropdownItem({ item, size, onClick, isHighlight = false }: DropdownItemProps) {
+export default function DropdownItem({
+  item,
+  size,
+  onClick,
+  isHighlight = false,
+  hasSeparate = false,
+}: DropdownItemProps) {
   const clickHandler = (e: React.MouseEvent<HTMLButtonElement>) => {
     e.stopPropagation();
     onClick();
@@ -18,6 +25,7 @@ export default function DropdownItem({ item, size, onClick, isHighlight = false
       size={size}
       onClick={clickHandler}
       isHighlight={isHighlight}
+      hasSeparate={hasSeparate}
     >
       {item}
     </S.Item>

frontend/src/components/_common/atoms/DropdownItem/style.ts

@@ -1,14 +1,16 @@
 import styled from '@emotion/styled';
 
-const Item = styled.button<{ isHighlight: boolean; size: 'sm' | 'md' }>`
+const Item = styled.button<{ isHighlight: boolean; size: 'sm' | 'md'; hasSeparate: boolean }>`
   display: block;
   text-align: left;
   width: 100%;
 
   padding: ${({ size }) => (size === 'md' ? '6px 8px' : '6px 4px')};
   ${({ theme, size }) => (size === 'md' ? theme.typography.common.default : theme.typography.common.small)};
+
   color: ${({ isHighlight, theme }) => (isHighlight ? theme.baseColors.redscale[500] : 'none')};
-  border-radius: 4px;
+  border-top: ${({ theme, hasSeparate }) =>
+    hasSeparate ? `0.15rem solid ${theme.baseColors.grayscale[400]}` : 'none'};
 
   cursor: pointer;
   transition: all 0.2s ease-in-out;

frontend/src/components/_common/molecules/Dropdown/Dropdown.stories.tsx

@@ -42,3 +42,12 @@ export const InitValueTest: StoryObj<DropdownProps> = {
     initValue: '아무 글자',
   },
 };
+
+export const SeparateTest: StoryObj<DropdownProps> = {
+  ...Template,
+  args: {
+    size: 'sm',
+    items: [...testItemList, { ...testItem, name: 'SeparateTest', id: testItemList.length, hasSeparate: true }],
+    initValue: '아무 글자',
+  },
+};

frontend/src/components/_common/molecules/Dropdown/index.tsx

@@ -76,7 +76,7 @@ export default function Dropdown({
           size={size}
           isShadow={isShadow}
         >
-          {items.map(({ name, isHighlight, id, onClick }) => (
+          {items.map(({ name, isHighlight, id, hasSeparate, onClick }) => (
             <DropdownItem
               onClick={() => {
                 onClick({ targetProcessId: id });
@@ -86,6 +86,7 @@ export default function Dropdown({
               item={name}
               isHighlight={isHighlight}
               size={size}
+              hasSeparate={hasSeparate}
             />
           ))}
         </S.List>

frontend/src/components/_common/molecules/PopOverMenu/PopOverMenu.stories.tsx

@@ -16,7 +16,7 @@ const Template: StoryObj<PopOverMenuProps> = {
 const testItem: PopOverMenuItem = {
   id: 123,
   name: 'Menu Label',
-  onClick: () => console.log('clicked'),
+  onClick: () => alert('clicked'),
 };
 const testItemList: PopOverMenuItem[] = Array.from({ length: 3 }, (_, index) => ({
   ...testItem,
@@ -39,3 +39,11 @@ export const SmallSize: StoryObj<PopOverMenuProps> = {
     items: testItemList,
   },
 };
+
+export const SeparateTest: StoryObj<PopOverMenuProps> = {
+  ...Template,
+  args: {
+    size: 'sm',
+    items: [...testItemList, { ...testItem, name: 'SeparateTest', id: testItemList.length, hasSeparate: true }],
+  },
+};

frontend/src/components/_common/molecules/PopOverMenu/index.tsx

@@ -20,7 +20,7 @@ export default function PopOverMenu({ isOpen, setClose, size = 'sm', popOverPosi
       {isOpen && (
         <S.ListWrapper>
           <S.List size={size}>
-            {items.map(({ name, isHighlight, id, onClick }) => (
+            {items.map(({ name, isHighlight, id, hasSeparate, onClick }) => (
               <DropdownItem
                 size={size}
                 onClick={() => {
@@ -30,6 +30,7 @@ export default function PopOverMenu({ isOpen, setClose, size = 'sm', popOverPosi
                 key={id}
                 item={name}
                 isHighlight={isHighlight}
+                hasSeparate={hasSeparate}
               />
             ))}
           </S.List>

frontend/src/components/dashboard/ProcessBoard/index.tsx

@@ -1,6 +1,7 @@
 import { Process } from '@customTypes/process';
 import ApplicantModal from '@components/ApplicantModal';
 import ProcessColumn from '../ProcessColumn';
+import SideFloatingMessageForm from '../SideFloatingMessageForm';
 import S from './style';
 
 interface KanbanBoardProps {
@@ -20,6 +21,8 @@ export default function ProcessBoard({ processes, showRejectedApplicant = false
       ))}
 
       <ApplicantModal />
+
+      <SideFloatingMessageForm />
     </S.Wrapper>
   );
 }

frontend/src/components/dashboard/ProcessColumn/index.tsx

@@ -6,10 +6,13 @@ import { Process } from '@customTypes/process';
 import useProcess from '@hooks/useProcess';
 import useApplicant from '@hooks/useApplicant';
 import { useModal } from '@contexts/ModalContext';
+import { PopOverMenuItem } from '@customTypes/common';
 
-import S from './style';
+import specificApplicant from '@hooks/useSpecificApplicant';
+import { useFloatingEmailForm } from '@contexts/FloatingEmailFormContext';
 import ApplicantCard from '../ApplicantCard';
-import ProcessDescription from './ProcessDescription/index';
+import ProcessDescription from './ProcessDescription';
+import S from './style';
 
 interface ProcessColumnProps {
   process: Process;
@@ -20,19 +23,47 @@ export default function ProcessColumn({ process, showRejectedApplicant }: Proces
   const { dashboardId, applyFormId } = useParams() as { dashboardId: string; applyFormId: string };
   const { processList } = useProcess({ dashboardId, applyFormId });
   const { mutate: moveApplicantProcess } = useApplicant({});
+  const { mutate: rejectMutate } = specificApplicant.useRejectApplicant({ dashboardId, applyFormId });
 
   const { setApplicantId } = useSpecificApplicantId();
   const { setProcessId } = useSpecificProcessId();
   const { open } = useModal();
+  const { open: sideEmailFormOpen } = useFloatingEmailForm();
 
-  const menuItemsList = ({ applicantId }: { applicantId: number }) =>
-    processList.map(({ processName, processId }) => ({
-      id: processId,
-      name: processName,
-      onClick: ({ targetProcessId }: { targetProcessId: number }) => {
-        moveApplicantProcess({ processId: targetProcessId, applicants: [applicantId] });
+  const menuItemsList = ({ applicantId }: { applicantId: number }) => {
+    const menuItems = processList.map(
+      ({ processName, processId }) =>
+        ({
+          id: processId,
+          name: processName,
+          onClick: ({ targetProcessId }: { targetProcessId: number }) => {
+            moveApplicantProcess({ processId: targetProcessId, applicants: [applicantId] });
+          },
+        }) as PopOverMenuItem,
+    );
+
+    menuItems.push({
+      id: 'emailButton',
+      name: '이메일 보내기',
+      hasSeparate: true,
+      onClick: () => {
+        setApplicantId(applicantId);
+        sideEmailFormOpen();
       },
-    }));
+    });
+
+    menuItems.push({
+      id: 'rejectButton',
+      name: '불합격 처리',
+      isHighlight: true,
+      hasSeparate: true,
+      onClick: () => {
+        rejectMutate({ applicantId });
+      },
+    });
+
+    return menuItems;
+  };
 
   const cardClickHandler = (id: number) => {
     setApplicantId(id);

frontend/src/components/dashboard/SideFloatingMessageForm/MessageForm/MessageFrom.stories.tsx

@@ -0,0 +1,28 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { FloatingEmailFormProvider } from '@contexts/FloatingEmailFormContext';
+import MessageForm from '.';
+
+const meta: Meta<typeof MessageForm> = {
+  title: 'Organisms/Dashboard/SideFloatingMessageForm/MessageForm',
+  component: MessageForm,
+  tags: ['autodocs'],
+  args: {
+    recipient: '러기',
+    onSubmit: (data) => {
+      alert(`Subject: ${data.subject}, Content: ${data.content}`);
+    },
+    onClose: () => alert('close button clied'),
+  },
+  decorators: [
+    (Story) => (
+      <FloatingEmailFormProvider>
+        <Story />
+      </FloatingEmailFormProvider>
+    ),
+  ],
+};
+
+export default meta;
+type Story = StoryObj<typeof MessageForm>;
+
+export const Default: Story = {};