[회비 생성] 회비 생성 기능 리팩토링 및 변경된 회비로 생성 가능하도록 수정

src/component/YearPagination/index.tsx

@@ -8,9 +8,10 @@ import * as S from './style';
 interface YearPaginationProps {
   duesYear: number;
   setDuesYear: React.Dispatch<React.SetStateAction<number>>;
+  routeParam: string;
 }
 
-export default function YearPagination({ duesYear, setDuesYear }: YearPaginationProps) {
+export default function YearPagination({ duesYear, setDuesYear, routeParam }: YearPaginationProps) {
   const navigate = useNavigate();
   const currentYear = new Date().getFullYear();
   const param = useQueryParam('page');
@@ -20,14 +21,14 @@ export default function YearPagination({ duesYear, setDuesYear }: YearPagination
     // 재학생 회비 내역이 2021년부터 시작하므로 2021년 이전으로 이동할 수 없음
     const prevYear = page ? page + 1 : 2;
     if (prevYear <= currentYear - 2020) {
-      navigate(`/dues?page=${prevYear}`);
+      navigate(`/${routeParam}?page=${prevYear}`);
       setDuesYear((prev) => prev - 1);
     }
   };
 
   const goToNextYear = () => {
     if (page && page > 1) {
-      navigate(`/dues?page=${page - 1}`);
+      navigate(`/${routeParam}?page=${page - 1}`);
       setDuesYear((prev) => prev + 1);
     }
   };

src/model/member.ts

@@ -42,6 +42,7 @@ export interface Member {
   updatedAt: string;
   isAuthed: boolean;
   isDeleted: boolean;
+  isFeeExempt: boolean;
   deleteReason: string;
   birthday: string;
 }

src/page/DuesManagement/index.tsx

@@ -94,7 +94,7 @@ function DefaultTable() {
       const updatedTrack = [...prevTrack];
       updatedTrack[trackIndex] = !updatedTrack[trackIndex];
       setFilteredValue(allDues.dues.filter((row) => updatedTrack[tracks.map((track) => track.name).indexOf(row.track.name)]
-      && members?.content.some((member) => member.memberType === 'REGULAR' && member.id === row.memberId)));
+        && members?.content.some((member) => member.memberType === 'REGULAR' && member.id === row.memberId)));
       return updatedTrack;
     });
   };
@@ -154,7 +154,7 @@ function DefaultTable() {
     <>
       <div css={S.searchAndPagination}>
         <div css={S.pagination}>
-          <YearPagination duesYear={duesYear} setDuesYear={setDuesYear} />
+          <YearPagination duesYear={duesYear} setDuesYear={setDuesYear} routeParam="dues" />
         </div>
         <div>
           <Input

src/page/DuesSetup/hooks/findMemberDuesInfo.ts

@@ -0,0 +1,50 @@
+import * as Excel from 'exceljs';
+import { DuesInfo } from 'model/dues/allDues';
+import { Pagination } from 'model/page';
+import { Member } from 'model/member';
+
+const NAME_ROW_NUMBER = 4;
+
+interface FindMemberDuesInfoProps {
+  worksheet: Excel.CellValue[][];
+  members: Pagination<Member>;
+  prevYearDues: DuesInfo;
+  currentYearDues: DuesInfo;
+}
+
+export type MemberDuesInfo = { id: number, name: string, notPaidMonthInfo: { year: number, month: number }[] };
+
+function findUnpaidMonths(duesInfo: DuesInfo | undefined, memberId: number, year: number) {
+  if (!duesInfo) return [];
+  const memberDues = duesInfo.dues.find((dues) => dues.memberId === memberId);
+  return memberDues && memberDues.unpaidCount > 0
+    ? memberDues.detail.filter((detail) => detail.status === 'NOT_PAID').map((detail) => ({ year, month: detail.month }))
+    : [];
+}
+
+export function findMemberDuesInfo({
+  worksheet, members, prevYearDues, currentYearDues,
+}: FindMemberDuesInfoProps) {
+  const result: MemberDuesInfo[] = [];
+  const currentYear = new Date().getFullYear();
+
+  worksheet.forEach((row) => {
+    const memberName = row[NAME_ROW_NUMBER] as string;
+    const memberInfo = members?.content.find((member) => member.name === memberName);
+
+    if (memberInfo) {
+      const unpaidMonthsPrevYear = findUnpaidMonths(prevYearDues, memberInfo.id, currentYear - 1);
+      const unpaidMonthsCurrentYear = findUnpaidMonths(currentYearDues, memberInfo.id, currentYear);
+
+      if (unpaidMonthsPrevYear.length > 0 || unpaidMonthsCurrentYear.length > 0) {
+        result.push({
+          id: memberInfo.id,
+          name: memberName,
+          notPaidMonthInfo: [...unpaidMonthsPrevYear, ...unpaidMonthsCurrentYear],
+        });
+      }
+    }
+  });
+
+  return result;
+}

src/page/DuesSetup/hooks/updateDues.ts

@@ -0,0 +1,130 @@
+import * as Excel from 'exceljs';
+import { DuesInfo } from 'model/dues/allDues';
+import { Pagination } from 'model/page';
+import { Member } from 'model/member';
+import { UseMutationResult } from '@tanstack/react-query';
+import { NewDuesData } from 'api/dues';
+import { MemberDuesInfo } from './findMemberDuesInfo';
+
+interface UpdateDuesProps {
+  worksheet: Excel.CellValue[][];
+  members: Pagination<Member>;
+  unpaidMemberDuesInfo: MemberDuesInfo[];
+  currentYearDues: DuesInfo;
+  putDuesMutation: UseMutationResult<any, Error, NewDuesData, unknown>;
+  postDuesMutation: UseMutationResult<any, Error, NewDuesData, unknown>;
+}
+
+type UpdateNotPaidDuesToPaidProps = Pick<UpdateDuesProps, 'unpaidMemberDuesInfo' | 'putDuesMutation'> & {
+  name: string;
+  depositDues: number;
+};
+
+type UpdateNullDuesToPaidProps = Pick<UpdateDuesProps, 'postDuesMutation'> & {
+  id: number;
+  name: string;
+  depositDues: number;
+};
+
+type UpdateWavierDuesProps = Pick<UpdateDuesProps, 'postDuesMutation' | 'members'>;
+type UpdateNullToNotPaidDuesProps = Pick<UpdateDuesProps, 'postDuesMutation' | 'currentYearDues'>;
+
+// depositDues만큼 unpaidMemberDuesInfo를 반영하여 mutate하기
+function updateNotPaidDuesToPaid({
+  name, depositDues, unpaidMemberDuesInfo, putDuesMutation,
+}: UpdateNotPaidDuesToPaidProps) {
+  let leftDepositDues = depositDues;
+  if (depositDues % 10000 === 0) {
+    Array.from({ length: depositDues }).forEach((_, index) => {
+      // TODO: 동명이인 처리
+      const memberDuesInfo = unpaidMemberDuesInfo.find((info) => info.name === name);
+      if (memberDuesInfo) {
+        const { id, notPaidMonthInfo } = memberDuesInfo;
+        const { year, month } = notPaidMonthInfo[index];
+        putDuesMutation.mutate({
+          memberId: id,
+          year,
+          month,
+          status: 'PAID',
+        });
+        leftDepositDues -= 10000;
+      }
+    });
+  }
+  return leftDepositDues;
+}
+
+function updateNullDuesToPaid({ id, depositDues, postDuesMutation }: UpdateNullDuesToPaidProps) {
+  // 회비를 매 달 1일에 정리하기 때문에 저번 달을 기준으로 처리한다.
+  const currentYear = new Date().getFullYear();
+  const prevMonth = new Date().getMonth();
+  Array.from({ length: depositDues }).forEach((_, index) => {
+    const year = prevMonth + index > 12 ? currentYear + 1 : currentYear;
+    const month = ((prevMonth + index) % 12) + 1;
+    postDuesMutation.mutate({
+      memberId: id,
+      year,
+      month,
+      status: 'PAID',
+    });
+  });
+}
+
+function updateWavierDues({ postDuesMutation, members }: UpdateWavierDuesProps) {
+  members.content.forEach((member) => {
+    if (member.isFeeExempted) {
+      postDuesMutation.mutate({
+        memberId: member.id,
+        year: new Date().getFullYear(),
+        month: new Date().getMonth() + 1,
+        status: 'SKIP',
+      });
+    }
+  });
+}
+
+function updateNullToNotPaidDues({ currentYearDues, postDuesMutation }: UpdateNullToNotPaidDuesProps) {
+  currentYearDues.dues.forEach((dues) => {
+    const prevMonth = new Date().getMonth();
+    if (dues.detail[prevMonth].status === null) {
+      postDuesMutation.mutate({
+        memberId: dues.memberId,
+        year: new Date().getFullYear(),
+        month: prevMonth + 1,
+        status: 'NOT_PAID',
+      });
+    }
+  });
+}
+
+export function updateDues({
+  worksheet, members, unpaidMemberDuesInfo, currentYearDues, putDuesMutation, postDuesMutation,
+}: UpdateDuesProps) {
+  worksheet.forEach((row) => {
+    const [, , depositValue, , content, , note] = row;
+    const depositDues = Number(depositValue);
+    const name = String(content);
+    const id = members.content.find((member) => member.name === name)?.id;
+    let leftDepositDues;
+
+    if (name && depositDues && id) {
+      // type note = 'X' | '-' | `id=${id}`;
+      if (note !== 'X') {
+        /**
+         * 1. 미납된 회비를 납부한 경우, 미납된 회비를 납부 처리한다.
+         * 2. 미납된 회비가 없는 경우, 납부한 달의 회비를 납부 처리한다.
+         * 3. 면제 인원의 경우 면제 처리한다.
+         * 4. 납부한 회비가 없는 경우 미납 처리한다. (1~3번 까지 처리가 끝난 후 아무값도 없는 경우 NOT_PAID 처리)
+         */
+        leftDepositDues = updateNotPaidDuesToPaid({
+          name, depositDues, unpaidMemberDuesInfo, putDuesMutation,
+        });
+        updateNullDuesToPaid({
+          id, name, depositDues: leftDepositDues, postDuesMutation,
+        });
+        updateWavierDues({ members, postDuesMutation });
+        updateNullToNotPaidDues({ postDuesMutation, currentYearDues });
+      }
+    }
+  });
+}

src/page/DuesSetup/hooks/updateWorksheetwithDuesInfo.ts

@@ -0,0 +1,29 @@
+import * as Excel from 'exceljs';
+import { MemberDuesInfo } from './findMemberDuesInfo';
+
+const NAME_ROW_NUMBER = 4;
+const UNPAID_INFO_ROW_NUMBER = 7;
+
+export function updateWorksheetWithDuesInfo(
+  worksheet: Excel.CellValue[][],
+  memberDuesInfo: MemberDuesInfo[],
+) {
+  const updatedWorksheet = worksheet.filter((_, index) => index > 0);
+  return updatedWorksheet.map((row) => {
+    const memberName = row[NAME_ROW_NUMBER] as string;
+    const memberInfo = memberDuesInfo.find((info) => info.name === memberName);
+    const updatedRow = [...row];
+
+    if (memberInfo) {
+      const unpaidMonths = memberInfo.notPaidMonthInfo
+        .map(({ year, month }) => `${year}년 ${month}월`)
+        .join(', ');
+
+      updatedRow[UNPAID_INFO_ROW_NUMBER] = unpaidMonths;
+    } else {
+      updatedRow[UNPAID_INFO_ROW_NUMBER] = '';
+    }
+
+    return updatedRow;
+  });
+}

src/page/DuesSetup/hooks/useReadExcelFile.ts

@@ -0,0 +1,43 @@
+import * as Excel from 'exceljs';
+
+function makeWorksheetToArray(worksheet: Excel.Worksheet): Excel.CellValue[][] {
+  const result: Excel.CellValue[][] = [];
+  worksheet.eachRow((row, rowNumber) => {
+    result.push([]);
+    row.eachCell((cell) => {
+      if (cell.value !== null && cell.value !== undefined) {
+        result[rowNumber - 1].push(cell.value);
+      }
+    });
+  });
+  return result;
+}
+
+export function useReadExcelFile(excelFileRef: React.RefObject<HTMLInputElement>): () => Promise<Excel.CellValue[][] | null> {
+  const readFile: () => Promise<Excel.CellValue[][] | null> = async () => {
+    const workbook = new Excel.Workbook();
+    const file = excelFileRef.current?.files?.[0];
+    if (!file) return null;
+
+    const reader = new FileReader();
+    return new Promise((resolve, reject) => {
+      reader.onload = async (e) => {
+        try {
+          const data = new Uint8Array(e.target?.result as ArrayBuffer);
+          await workbook.xlsx.load(data);
+          const worksheet = workbook.getWorksheet(1);
+          if (!worksheet) {
+            reject(new Error('worksheet is not found'));
+          }
+          resolve(worksheet ? makeWorksheetToArray(worksheet) : null);
+        } catch (error) {
+          reject(error);
+        }
+      };
+      reader.onerror = (error) => reject(error);
+      reader.readAsArrayBuffer(file);
+    });
+  };
+
+  return readFile;
+}