feat: impl get national assembly schedule list (#14)

* feat: impl get national assembly schedule list

Signed-off-by: sunrabbit123 <[email protected]>

* docs: add getNationalAssemblySchedule comment for tag api origin

Signed-off-by: sunrabbit123 <[email protected]>

* ci: add test code

Signed-off-by: sunrabbit123 <[email protected]>

---------

Signed-off-by: sunrabbit123 <[email protected]>

Author: sunrabbit123

src/constant/index.ts

@@ -59,4 +59,13 @@ export const translatedVariableDictionary = {
   대표발의자코드: 'leadProposerCode',
   본회의심의결과: 'plenarySessionReviewResult',
   의결일: 'resolutionDate',
+  일정_종류: 'scheduleType',
+  일정_내용: 'scheduleContent',
+  일정_일자: 'scheduleDate',
+  일정_시간: 'scheduleTime',
+  회의_구분: 'conferenceDivision',
+  회의_회기: 'conferenceSession',
+  회의_차수: 'conferenceDegree',
+  행사_주체자: 'eventInstitution',
+  행사_장소: 'eventPlace',
 } as const;

src/lawmaker/getLawmakerList.ts

@@ -80,5 +80,5 @@ export const getLawmakerList = async ({ page, take, ...rest }: Argument) => {
     { NAAS_CD, NAAS_NM, PLPT_NM, BLNG_CMIT_NM }
   );
 
-  return res.ALLNAMEMBER[1].row.map(transform);
+  return res[command][1].row.map(transform);
 };

src/national-assembly/getNationalAssemblySchedule.spec.ts

@@ -0,0 +1,71 @@
+import { describe, it, expect, vi } from 'vitest';
+import { getNationalAssemblySchedule } from './getNationalAssemblySchedule';
+import { callOpenApi } from '../functional';
+import { translatedVariableDictionary } from '../constant';
+
+vi.mock('../functional', () => ({
+  callOpenApi: vi.fn(),
+}));
+
+describe('getNationalAssemblySchedule', () => {
+  it('should return a list of national assembly schedules', async () => {
+    const mockResponse = {
+      ALLSCHEDULE: [
+        null,
+        {
+          row: [
+            {
+              SCH_KIND: 'Meeting',
+              SCH_CN: 'Committee Meeting',
+              SCH_DT: '2023-05-01',
+              SCH_TM: '09:00',
+              CONF_DIV: 'Regular',
+              CMIT_NM: 'Committee A',
+              CONF_SESS: '1',
+              CONF_DGR: '1',
+              EV_INST_NM: 'National Assembly',
+              EV_PLC: 'Room 123',
+            },
+          ],
+        },
+      ],
+    };
+
+    (callOpenApi as any).mockResolvedValueOnce(mockResponse);
+
+    const schedules = await getNationalAssemblySchedule({ page: 1, take: 10 });
+
+    expect(schedules).toHaveLength(1);
+    expect(schedules[0]).toEqual({
+      [translatedVariableDictionary['일정_종류']]: 'Meeting',
+      [translatedVariableDictionary['일정_내용']]: 'Committee Meeting',
+      [translatedVariableDictionary['일정_일자']]: '2023-05-01',
+      [translatedVariableDictionary['일정_시간']]: '09:00',
+      [translatedVariableDictionary['회의_구분']]: 'Regular',
+      [translatedVariableDictionary['위원회명']]: 'Committee A',
+      [translatedVariableDictionary['회의_회기']]: '1',
+      [translatedVariableDictionary['회의_차수']]: '1',
+      [translatedVariableDictionary['행사_주체자']]: 'National Assembly',
+      [translatedVariableDictionary['행사_장소']]: 'Room 123',
+    });
+  });
+
+  it('should return an empty list when no schedules are found', async () => {
+    const mockResponse = {
+      ALLSCHEDULE: [null, { row: [] }],
+    };
+
+    (callOpenApi as any).mockResolvedValueOnce(mockResponse);
+
+    const schedules = await getNationalAssemblySchedule({ page: 1, take: 10 });
+
+    expect(schedules).toHaveLength(0);
+  });
+
+  it('should throw an error when callOpenApi fails', async () => {
+    const mockError = new Error('Failed to fetch schedules');
+    (callOpenApi as any).mockRejectedValueOnce(mockError);
+
+    await expect(getNationalAssemblySchedule({ page: 1, take: 10 })).rejects.toThrow('Failed to fetch schedules');
+  });
+});

src/national-assembly/getNationalAssemblySchedule.ts

@@ -0,0 +1,49 @@
+import { translatedVariableDictionary } from '../constant';
+import { callOpenApi } from '../functional';
+import { PaginationType } from '../types/callOpenApi';
+
+interface NationalAssemblySchedule {
+  SCH_KIND: string; // 일정종류
+  SCH_CN: string; // 일정내용
+  SCH_DT: string; // 일자
+  SCH_TM: string; // 시간
+  CONF_DIV: string; // 회의구분
+  CMIT_NM: string; // 위원회명
+  CONF_SESS: string; // 회의회기
+  CONF_DGR: string; // 회의차수
+  EV_INST_NM: string; // 행사주체자
+  EV_PLC: string; // 행사장소
+}
+
+type Row = {
+  [k in keyof NationalAssemblySchedule]: NationalAssemblySchedule[k] | null;
+};
+
+type Argument = {
+  scheduleKind?: string;
+  scheduleDate?: string;
+} & PaginationType;
+
+const command = 'ALLSCHEDULE';
+
+const transform = (v: Row) => ({
+  [translatedVariableDictionary['일정_종류']]: v.SCH_KIND,
+  [translatedVariableDictionary['일정_내용']]: v.SCH_CN,
+  [translatedVariableDictionary['일정_일자']]: v.SCH_DT,
+  [translatedVariableDictionary['일정_시간']]: v.SCH_TM,
+  [translatedVariableDictionary['회의_구분']]: v.CONF_DIV,
+  [translatedVariableDictionary['위원회명']]: v.CMIT_NM,
+  [translatedVariableDictionary['회의_회기']]: v.CONF_SESS,
+  [translatedVariableDictionary['회의_차수']]: v.CONF_DGR,
+  [translatedVariableDictionary['행사_주체자']]: v.EV_INST_NM,
+  [translatedVariableDictionary['행사_장소']]: v.EV_PLC,
+});
+/**
+ * @description call https://open.assembly.go.kr/portal/data/service/selectAPIServicePage.do/OOWY4R001216HX11437
+ */
+export const getNationalAssemblySchedule = async ({ page, take, ...rest }: Argument) => {
+  const { scheduleKind: SCH_KIND, scheduleDate: SCH_DT } = rest;
+  const res = await callOpenApi<typeof command, Row>(command, { page, take }, { SCH_KIND, SCH_DT });
+
+  return res[command][1].row.map(transform);
+};

src/national-assembly/index.ts

@@ -0,0 +1 @@
+export { getNationalAssemblySchedule } from './getNationalAssemblySchedule';

src/types/callOpenApi.ts

@@ -3,7 +3,7 @@ export type PaginationType = {
   take: number;
 };
 
-export type ApiCommand = ('ALLNAMEMBER' | 'TVBPMBILL11') & string;
+export type ApiCommand = ('ALLNAMEMBER' | 'ALLSCHEDULE' | 'TVBPMBILL11') & string;
 
 export const OpenApiResponseKind = {
   'INFO-000': '정상 처리되었습니다.',