Merge pull request #271 from code-zero-to-one/feature/openapi-new

aken-you · web-flow · commit 3941948398d0 · 2025-12-27T15:08:00.000+09:00
feat: new OpenAPI (automated)
diff --git a/src/api/openapi/.openapi-generator/FILES b/src/api/openapi/.openapi-generator/FILES
@@ -133,6 +133,8 @@ docs/GroupStudyThreadCommentRequest.md
 docs/GroupStudyThreadRequest.md
 docs/GroupStudyUpdateRequestDto.md
 docs/GrowthMetricResponse.md
+docs/HasMemberNewNotificationResponse.md
+docs/HasMemberNewNotificationSchema.md
 docs/HomeworkEditRequest.md
 docs/HomeworkSubmissionRequest.md
 docs/HomeworkSubmissionResponse.md
@@ -343,6 +345,8 @@ models/group-study-thread-comment-request.ts
 models/group-study-thread-request.ts
 models/group-study-update-request-dto.ts
 models/growth-metric-response.ts
+models/has-member-new-notification-response.ts
+models/has-member-new-notification-schema.ts
 models/homework-edit-request.ts
 models/homework-submission-request.ts
 models/homework-submission-response.ts
diff --git a/src/api/openapi/api/notification-api.ts b/src/api/openapi/api/notification-api.ts
@@ -22,6 +22,8 @@ import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObj
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
 // @ts-ignore
+import type { HasMemberNewNotificationSchema } from '../models';
+// @ts-ignore
 import type { MemberNotificationSchema } from '../models';
 // @ts-ignore
 import type { NotificationCategoriesSchema } from '../models';
@@ -158,7 +160,7 @@ export const NotificationApiAxiosParamCreator = function (configuration?: Config
             };
         },
         /**
-         * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | boolean | 알림 읽음 여부 | true / false | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" | 
+         * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | object | 응답 본문 | { ... } | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" |  ---  ### Response > content  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | isRead | boolean | 신규 알림 여부 | true / false | 
          * @summary 회원 신규 알림 여부 조회
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -281,12 +283,12 @@ export const NotificationApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | boolean | 알림 읽음 여부 | true / false | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" | 
+         * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | object | 응답 본문 | { ... } | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" |  ---  ### Response > content  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | isRead | boolean | 신규 알림 여부 | true / false | 
          * @summary 회원 신규 알림 여부 조회
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async hasMemberNewNotification(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+        async hasMemberNewNotification(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<HasMemberNewNotificationSchema>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.hasMemberNewNotification(options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['NotificationApi.hasMemberNewNotification']?.[localVarOperationServerIndex]?.url;
@@ -299,7 +301,7 @@ export const NotificationApiFp = function(configuration?: Configuration) {
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async readMemberNotifications(ids?: Array<any>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+        async readMemberNotifications(ids?: Array<any>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<HasMemberNewNotificationSchema>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.readMemberNotifications(ids, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['NotificationApi.readMemberNotifications']?.[localVarOperationServerIndex]?.url;
@@ -347,12 +349,12 @@ export const NotificationApiFactory = function (configuration?: Configuration, b
             return localVarFp.getMemberNotifications(page, size, hasRead, topicType, options).then((request) => request(axios, basePath));
         },
         /**
-         * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | boolean | 알림 읽음 여부 | true / false | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" | 
+         * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | object | 응답 본문 | { ... } | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" |  ---  ### Response > content  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | isRead | boolean | 신규 알림 여부 | true / false | 
          * @summary 회원 신규 알림 여부 조회
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        hasMemberNewNotification(options?: RawAxiosRequestConfig): AxiosPromise<void> {
+        hasMemberNewNotification(options?: RawAxiosRequestConfig): AxiosPromise<HasMemberNewNotificationSchema> {
             return localVarFp.hasMemberNewNotification(options).then((request) => request(axios, basePath));
         },
         /**
@@ -362,7 +364,7 @@ export const NotificationApiFactory = function (configuration?: Configuration, b
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        readMemberNotifications(ids?: Array<any>, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+        readMemberNotifications(ids?: Array<any>, options?: RawAxiosRequestConfig): AxiosPromise<HasMemberNewNotificationSchema> {
             return localVarFp.readMemberNotifications(ids, options).then((request) => request(axios, basePath));
         },
     };
@@ -408,7 +410,7 @@ export class NotificationApi extends BaseAPI {
     }
 
     /**
-     * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | boolean | 알림 읽음 여부 | true / false | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" | 
+     * 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | object | 응답 본문 | { ... } | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" |  ---  ### Response > content  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | isRead | boolean | 신규 알림 여부 | true / false | 
      * @summary 회원 신규 알림 여부 조회
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
diff --git a/src/api/openapi/docs/HasMemberNewNotificationResponse.md b/src/api/openapi/docs/HasMemberNewNotificationResponse.md
@@ -0,0 +1,20 @@
+# HasMemberNewNotificationResponse
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**isRead** | **boolean** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { HasMemberNewNotificationResponse } from './api';
+
+const instance: HasMemberNewNotificationResponse = {
+    isRead,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
diff --git a/src/api/openapi/docs/HasMemberNewNotificationSchema.md b/src/api/openapi/docs/HasMemberNewNotificationSchema.md
@@ -0,0 +1,26 @@
+# HasMemberNewNotificationSchema
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**statusCode** | **number** |  | [optional] [default to undefined]
+**timestamp** | **string** |  | [optional] [default to undefined]
+**content** | [**HasMemberNewNotificationResponse**](HasMemberNewNotificationResponse.md) |  | [optional] [default to undefined]
+**message** | **string** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { HasMemberNewNotificationSchema } from './api';
+
+const instance: HasMemberNewNotificationSchema = {
+    statusCode,
+    timestamp,
+    content,
+    message,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
diff --git a/src/api/openapi/docs/NotificationApi.md b/src/api/openapi/docs/NotificationApi.md
@@ -95,15 +95,13 @@ This endpoint does not have any parameters.
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json, */*
+ - **Accept**: application/json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 회원 알림 카테고리 필터 목록 조회 성공 |  -  |
-|**401** | Bearer Token is invalid or no bearer token |  -  |
-|**403** | You are authenticated but not allowed authorization |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
@@ -168,9 +166,9 @@ const { status, data } = await apiInstance.getMemberNotifications(
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **hasMemberNewNotification**
-> hasMemberNewNotification()
+> HasMemberNewNotificationSchema hasMemberNewNotification()
 
-작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | boolean | 알림 읽음 여부 | true / false | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" | 
+작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원의 신규 알림 존재 여부를 조회합니다.  - 읽지 않은 알림이 하나 이상 존재하는 경우 false를 반환합니다.  ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 201: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | object | 응답 본문 | { ... } | | message | string | 처리 결과 | \"회원 신규 알림 여부 조회 성공\" |  ---  ### Response > content  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | isRead | boolean | 신규 알림 여부 | true / false | 
 
 ### Example
 
@@ -192,7 +190,7 @@ This endpoint does not have any parameters.
 
 ### Return type
 
-void (empty response body)
+**HasMemberNewNotificationSchema**
 
 ### Authorization
 
@@ -201,20 +199,18 @@ void (empty response body)
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json, */*
+ - **Accept**: application/json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 회원 신규 알림 여부 조회 성공 |  -  |
-|**401** | Bearer Token is invalid or no bearer token |  -  |
-|**403** | You are authenticated but not allowed authorization |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **readMemberNotifications**
-> readMemberNotifications()
+> HasMemberNewNotificationSchema readMemberNotifications()
 
 작성일자: 2025-11-29  작성자: 성효빈  ---  ## Description  - 회원 알림을 읽음 처리합니다.  - 알림 ID 목록을 전송하지 않는 경우, 전체 알림을 읽음 처리합니다. ---  ## Request  | **키** | **타입** | **설명** | **필수 여부** | **예시** | | --- | --- | --- | --- | --- | | ids | array | 알림 ID 목록(전송하지 않는 경우 전체 알림 읽음 처리) | N | [1, 2, 3] |  ---  ## Response  | **키** | **타입** | **설명** | **예시** | | --- | --- | --- | --- | | statusCode | number | 상태 코드 | 200: 성공 / 400: 클라이언트 요청 오류 / 401: 인증 실패 / 403: 인가 실패 / 404: 리소스 조회 실패 / 409: 충돌 / 500: 그 외 | | timestamp | string(datetime) | 응답 일시 | \"2025-11-29T10:11:12.123456\" | | content | object | 응답 본문 | null | | message | string | 처리 결과 | \"회원 알림 읽음 처리 성공\" | 
 
@@ -245,7 +241,7 @@ const { status, data } = await apiInstance.readMemberNotifications(
 
 ### Return type
 
-void (empty response body)
+**HasMemberNewNotificationSchema**
 
 ### Authorization
 
diff --git a/src/api/openapi/models/has-member-new-notification-response.ts b/src/api/openapi/models/has-member-new-notification-response.ts
@@ -0,0 +1,20 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Zeroone API v1
+ * v1
+ *
+ * The version of the OpenAPI document: v1
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface HasMemberNewNotificationResponse {
+    'isRead'?: boolean;
+}
+
diff --git a/src/api/openapi/models/has-member-new-notification-schema.ts b/src/api/openapi/models/has-member-new-notification-schema.ts
@@ -0,0 +1,26 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Zeroone API v1
+ * v1
+ *
+ * The version of the OpenAPI document: v1
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+// May contain unused imports in some cases
+// @ts-ignore
+import type { HasMemberNewNotificationResponse } from './has-member-new-notification-response';
+
+export interface HasMemberNewNotificationSchema {
+    'statusCode'?: number;
+    'timestamp'?: string;
+    'content'?: HasMemberNewNotificationResponse;
+    'message'?: string;
+}
+
diff --git a/src/api/openapi/models/index.ts b/src/api/openapi/models/index.ts
