daiso 1.0.4 → 1.0.5

package/dist/pages/openapiSpecComponentsLottecinema.js

@@ -0,0 +1,163 @@
+/**
+ * OpenAPI 롯데시네마 컴포넌트 스키마 정의
+ */
+export const OPENAPI_LOTTECINEMA_COMPONENT_SCHEMAS = {
+    LotteCinemaTheater: {
+        type: 'object',
+        properties: {
+            theaterId: { type: 'string', example: '1016' },
+            theaterName: { type: 'string', example: '월드타워' },
+            regionCode: { type: 'string', example: '1' },
+            regionDetailCode: { type: 'string', example: '0001' },
+            address: { type: 'string', example: '서울 송파구 올림픽로 300' },
+            latitude: { type: 'number', format: 'float', example: 37.5132941 },
+            longitude: { type: 'number', format: 'float', example: 127.104215 },
+            distanceKm: { type: 'number', format: 'float', example: 0.5 },
+        },
+    },
+    LotteCinemaResolvedLocation: {
+        type: 'object',
+        properties: {
+            keyword: { type: 'string', nullable: true, example: '안산 중앙역' },
+            latitude: { type: 'number', format: 'float', nullable: true, example: 37.3172 },
+            longitude: { type: 'number', format: 'float', nullable: true, example: 126.839 },
+            geocodeUsed: { type: 'boolean', example: true },
+            formattedAddress: { type: 'string', nullable: true, example: '대한민국 경기도 안산시 단원구 고잔동 535' },
+        },
+    },
+    LotteCinemaMovie: {
+        type: 'object',
+        properties: {
+            movieId: { type: 'string', example: '23816' },
+            movieName: { type: 'string', example: '왕과 사는 남자' },
+            rating: { type: 'string', example: '12세이상관람가' },
+            durationMinutes: { type: 'integer', example: 127 },
+            releaseDate: { type: 'string', example: '2026-03-10' },
+        },
+    },
+    LotteCinemaShowtime: {
+        type: 'object',
+        properties: {
+            scheduleId: { type: 'string', example: '20260310-1016-1201-1' },
+            theaterId: { type: 'string', example: '1016' },
+            theaterName: { type: 'string', example: '월드타워' },
+            movieId: { type: 'string', example: '23816' },
+            movieName: { type: 'string', example: '왕과 사는 남자' },
+            screenId: { type: 'string', example: '1201' },
+            screenName: { type: 'string', example: '1관 샤롯데' },
+            playDate: { type: 'string', example: '20260310' },
+            startTime: { type: 'string', example: '10:40' },
+            endTime: { type: 'string', example: '12:47' },
+            totalSeats: { type: 'integer', example: 32 },
+            bookedSeats: { type: 'integer', example: 28 },
+            remainingSeats: { type: 'integer', example: 4 },
+        },
+    },
+    LotteCinemaTheaterSearchResponse: {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean', example: true },
+            data: {
+                type: 'object',
+                properties: {
+                    keyword: { type: 'string', nullable: true },
+                    latitude: { type: 'number', format: 'float', nullable: true },
+                    longitude: { type: 'number', format: 'float', nullable: true },
+                    geocodeUsed: { type: 'boolean' },
+                    formattedAddress: { type: 'string', nullable: true },
+                    playDate: { type: 'string' },
+                    theaters: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/LotteCinemaTheater' },
+                    },
+                },
+            },
+            meta: {
+                type: 'object',
+                properties: {
+                    total: { type: 'integer' },
+                    pageSize: { type: 'integer' },
+                },
+            },
+        },
+    },
+    LotteCinemaMovieListResponse: {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean', example: true },
+            data: {
+                type: 'object',
+                properties: {
+                    playDate: { type: 'string' },
+                    filters: {
+                        type: 'object',
+                        properties: {
+                            theaterId: { type: 'string', nullable: true },
+                            movieId: { type: 'string', nullable: true },
+                            keyword: { type: 'string', nullable: true },
+                            latitude: { type: 'number', format: 'float', nullable: true },
+                            longitude: { type: 'number', format: 'float', nullable: true },
+                        },
+                    },
+                    resolvedTheater: {
+                        anyOf: [{ $ref: '#/components/schemas/LotteCinemaTheater' }, { type: 'null' }],
+                    },
+                    theaters: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/LotteCinemaTheater' },
+                    },
+                    movies: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/LotteCinemaMovie' },
+                    },
+                    showtimes: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/LotteCinemaShowtime' },
+                    },
+                },
+            },
+            meta: {
+                type: 'object',
+                properties: {
+                    total: { type: 'integer' },
+                },
+            },
+        },
+    },
+    LotteCinemaSeatListResponse: {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean', example: true },
+            data: {
+                type: 'object',
+                properties: {
+                    playDate: { type: 'string' },
+                    filters: {
+                        type: 'object',
+                        properties: {
+                            theaterId: { type: 'string', nullable: true },
+                            movieId: { type: 'string', nullable: true },
+                            keyword: { type: 'string', nullable: true },
+                            latitude: { type: 'number', format: 'float', nullable: true },
+                            longitude: { type: 'number', format: 'float', nullable: true },
+                        },
+                    },
+                    resolvedTheater: {
+                        anyOf: [{ $ref: '#/components/schemas/LotteCinemaTheater' }, { type: 'null' }],
+                    },
+                    seats: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/LotteCinemaShowtime' },
+                    },
+                },
+            },
+            meta: {
+                type: 'object',
+                properties: {
+                    total: { type: 'integer' },
+                    pageSize: { type: 'integer' },
+                },
+            },
+        },
+    },
+};

package/dist/pages/openapiSpecComponentsMegabox.js

@@ -0,0 +1,144 @@
+/**
+ * OpenAPI 컴포넌트 스키마 정의 (메가박스)
+ */
+export const OPENAPI_MEGABOX_COMPONENT_SCHEMAS = {
+    MegaboxTheater: {
+        type: 'object',
+        properties: {
+            theaterId: { type: 'string', example: '1372' },
+            theaterName: { type: 'string', example: '강남' },
+            address: { type: 'string', example: '서울특별시 강남구 강남대로 438' },
+            latitude: { type: 'number', format: 'float', example: 37.4982 },
+            longitude: { type: 'number', format: 'float', example: 127.0264 },
+            distanceKm: { type: 'number', format: 'float', example: 0.5 },
+        },
+    },
+    MegaboxShowtime: {
+        type: 'object',
+        properties: {
+            scheduleId: { type: 'string', example: '2603041372011' },
+            movieId: { type: 'string', example: '25104500' },
+            movieName: { type: 'string', example: '미키 17' },
+            theaterId: { type: 'string', example: '1372' },
+            theaterName: { type: 'string', example: '강남' },
+            playDate: { type: 'string', example: '20260304' },
+            startTime: { type: 'string', example: '09:30' },
+            endTime: { type: 'string', example: '11:20' },
+            totalSeats: { type: 'integer', example: 120 },
+            remainingSeats: { type: 'integer', example: 42 },
+        },
+    },
+    MegaboxTheaterSearchResponse: {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean', example: true },
+            data: {
+                type: 'object',
+                properties: {
+                    location: {
+                        type: 'object',
+                        properties: {
+                            latitude: { type: 'number', format: 'float' },
+                            longitude: { type: 'number', format: 'float' },
+                        },
+                    },
+                    playDate: { type: 'string' },
+                    areaCode: { type: 'string' },
+                    theaters: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/MegaboxTheater' },
+                    },
+                },
+            },
+            meta: {
+                type: 'object',
+                properties: {
+                    total: { type: 'integer' },
+                    pageSize: { type: 'integer' },
+                },
+            },
+        },
+    },
+    MegaboxMovieListResponse: {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean', example: true },
+            data: {
+                type: 'object',
+                properties: {
+                    playDate: { type: 'string' },
+                    filters: {
+                        type: 'object',
+                        properties: {
+                            theaterId: { type: 'string', nullable: true },
+                            movieId: { type: 'string', nullable: true },
+                            areaCode: { type: 'string' },
+                        },
+                    },
+                    theaters: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                theaterId: { type: 'string' },
+                                theaterName: { type: 'string' },
+                            },
+                        },
+                    },
+                    movies: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                movieId: { type: 'string' },
+                                movieName: { type: 'string' },
+                                movieStatus: { type: 'string' },
+                            },
+                        },
+                    },
+                    showtimes: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/MegaboxShowtime' },
+                    },
+                },
+            },
+            meta: {
+                type: 'object',
+                properties: {
+                    total: { type: 'integer' },
+                },
+            },
+        },
+    },
+    MegaboxSeatListResponse: {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean', example: true },
+            data: {
+                type: 'object',
+                properties: {
+                    playDate: { type: 'string' },
+                    filters: {
+                        type: 'object',
+                        properties: {
+                            theaterId: { type: 'string', nullable: true },
+                            movieId: { type: 'string', nullable: true },
+                            areaCode: { type: 'string' },
+                        },
+                    },
+                    seats: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/MegaboxShowtime' },
+                    },
+                },
+            },
+            meta: {
+                type: 'object',
+                properties: {
+                    total: { type: 'integer' },
+                    pageSize: { type: 'integer' },
+                },
+            },
+        },
+    },
+};

package/dist/pages/openapiSpecComponentsSeveneleven.js

@@ -0,0 +1,82 @@
+/**
+ * OpenAPI 컴포넌트 스키마 정의 (세븐일레븐)
+ */
+export const OPENAPI_SEVENELEVEN_COMPONENT_SCHEMAS = {
+    SevenElevenProduct: {
+        type: 'object',
+        properties: {
+            itemCode: { type: 'string', example: '8801056252243' },
+            itemName: { type: 'string', example: '칠성)핫식스더킹퍼플500ml' },
+            salePrice: { type: 'integer', nullable: true, example: 3000 },
+            imageUrl: { type: 'string', nullable: true, example: '' },
+        },
+    },
+    SevenElevenStockError: {
+        type: 'object',
+        nullable: true,
+        properties: {
+            cause: { type: 'string', example: 'api' },
+            httpStatus: { type: 'integer', nullable: true, example: 400 },
+            code: { type: 'integer', nullable: true, example: 501 },
+            message: { type: 'string', example: 'RSA 복호화 실패' },
+            raw: { type: 'string', nullable: true },
+        },
+    },
+    SevenElevenStoreInventory: {
+        type: 'object',
+        properties: {
+            storeCode: { type: 'string', example: '54928' },
+            storeName: { type: 'string', example: '안산중앙일번가점' },
+            address: { type: 'string', example: '경기 안산시 단원구 중앙대로 907 2동 2121호' },
+            latitude: { type: 'number', format: 'float', example: 37.317371500357 },
+            longitude: { type: 'number', format: 'float', example: 126.837004318586 },
+            stockQuantity: { type: 'integer', example: 14 },
+            isSoldOut: { type: 'boolean', example: false },
+            distanceM: { type: 'integer', nullable: true, example: 100 },
+        },
+    },
+    SevenElevenInventoryResponse: {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean', example: true },
+            data: {
+                type: 'object',
+                properties: {
+                    keyword: { type: 'string', example: '핫식스' },
+                    storeKeyword: { type: 'string', example: '안산 중앙역' },
+                    product: {
+                        anyOf: [
+                            { $ref: '#/components/schemas/SevenElevenProduct' },
+                            { type: 'null' },
+                        ],
+                    },
+                    stockAvailable: { type: 'boolean', example: true },
+                    stockError: { $ref: '#/components/schemas/SevenElevenStockError' },
+                    note: {
+                        type: 'string',
+                        example: '실시간 재고 데이터가 포함되어 있습니다.',
+                    },
+                    inventory: {
+                        type: 'object',
+                        properties: {
+                            totalStoreCount: { type: 'integer', example: 4 },
+                            inStockStoreCount: { type: 'integer', example: 3 },
+                            count: { type: 'integer', example: 4 },
+                            stores: {
+                                type: 'array',
+                                items: { $ref: '#/components/schemas/SevenElevenStoreInventory' },
+                            },
+                        },
+                    },
+                },
+            },
+            meta: {
+                type: 'object',
+                properties: {
+                    total: { type: 'integer', example: 4 },
+                    pageSize: { type: 'integer', example: 10 },
+                },
+            },
+        },
+    },
+};

package/dist/pages/openapiSpecPathsCgv.js

@@ -6,7 +6,7 @@ export const OPENAPI_PATHS_CGV = {
         get: {
             operationId: 'cgvFindTheaters',
             summary: 'CGV 극장 목록 조회',
-            description: '날짜/지역 코드 조건으로 CGV 극장 목록을 조회합니다.',
+            description: '날짜/지역 코드 또는 위치 키워드 조건으로 CGV 극장 목록을 조회합니다.',
             parameters: [
                 {
                     name: 'playDate',
@@ -22,6 +22,27 @@ export const OPENAPI_PATHS_CGV = {
                     description: '지역 코드 (예: 01 서울)',
                     schema: { type: 'string', example: '01' },
                 },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (예: 안산 중앙역, 강남역)',
+                    schema: { type: 'string', example: '안산 중앙역' },
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도',
+                    schema: { type: 'number', format: 'float', example: 37.3171 },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도',
+                    schema: { type: 'number', format: 'float', example: 126.8389 },
+                },
                 {
                     name: 'limit',
                     in: 'query',
@@ -54,7 +75,7 @@ export const OPENAPI_PATHS_CGV = {
         get: {
             operationId: 'cgvSearchMovies',
             summary: 'CGV 영화 목록 조회',
-            description: '날짜/극장 조건으로 CGV 영화 목록을 조회합니다.',
+            description: '날짜/극장 조건으로 CGV 영화 목록을 조회합니다. theaterCode가 없으면 keyword 또는 좌표 기준으로 최근접 극장을 선택할 수 있습니다.',
             parameters: [
                 {
                     name: 'playDate',
@@ -70,6 +91,27 @@ export const OPENAPI_PATHS_CGV = {
                     description: '극장 코드 (예: 0056)',
                     schema: { type: 'string', example: '0056' },
                 },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (예: 안산 중앙역, 강남역)',
+                    schema: { type: 'string', example: '안산 중앙역' },
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도',
+                    schema: { type: 'number', format: 'float', example: 37.3171 },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도',
+                    schema: { type: 'number', format: 'float', example: 126.8389 },
+                },
             ],
             responses: {
                 '200': {
@@ -95,7 +137,7 @@ export const OPENAPI_PATHS_CGV = {
         get: {
             operationId: 'cgvGetTimetable',
             summary: 'CGV 시간표 조회',
-            description: '날짜/극장/영화 조건으로 CGV 상영 시간표를 조회합니다.',
+            description: '날짜/극장/영화 조건으로 CGV 상영 시간표를 조회합니다. theaterCode가 없으면 keyword 또는 좌표 기준으로 최근접 극장을 선택할 수 있습니다.',
             parameters: [
                 {
                     name: 'playDate',
@@ -118,6 +160,27 @@ export const OPENAPI_PATHS_CGV = {
                     description: '영화 코드',
                     schema: { type: 'string' },
                 },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (예: 안산 중앙역, 강남역)',
+                    schema: { type: 'string', example: '안산 중앙역' },
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도',
+                    schema: { type: 'number', format: 'float', example: 37.3171 },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도',
+                    schema: { type: 'number', format: 'float', example: 126.8389 },
+                },
                 {
                     name: 'limit',
                     in: 'query',

package/dist/pages/openapiSpecPathsCu.js

@@ -0,0 +1,138 @@
+/**
+ * OpenAPI 경로 정의 (CU)
+ */
+export const OPENAPI_PATHS_CU = {
+    '/api/cu/stores': {
+        get: {
+            operationId: 'cuFindStores',
+            summary: 'CU 매장 검색',
+            description: '위치(위도/경도)와 키워드로 CU 매장을 검색합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '매장명 또는 지역 키워드 (예: 강남, 안산)',
+                    schema: { type: 'string' },
+                    example: '강남',
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도 (선택)',
+                    schema: { type: 'number', format: 'float' },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도 (선택)',
+                    schema: { type: 'number', format: 'float' },
+                },
+                {
+                    name: 'limit',
+                    in: 'query',
+                    required: false,
+                    description: '최대 결과 수',
+                    schema: { type: 'integer', default: 20, minimum: 1, maximum: 100 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '검색 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/CuStoreSearchResponse' },
+                        },
+                    },
+                },
+                '500': {
+                    description: 'CU API 호출 실패',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    '/api/cu/inventory': {
+        get: {
+            operationId: 'cuCheckInventory',
+            summary: 'CU 재고 확인',
+            description: '상품 키워드로 CU 재고를 조회하고 주변 매장 정보를 함께 반환합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: true,
+                    description: '재고를 확인할 상품 키워드',
+                    schema: { type: 'string' },
+                    example: '과자',
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도 (선택)',
+                    schema: { type: 'number', format: 'float' },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도 (선택)',
+                    schema: { type: 'number', format: 'float' },
+                },
+                {
+                    name: 'storeKeyword',
+                    in: 'query',
+                    required: false,
+                    description: '주변 매장 필터 키워드',
+                    schema: { type: 'string' },
+                },
+                {
+                    name: 'size',
+                    in: 'query',
+                    required: false,
+                    description: '재고 검색 결과 수',
+                    schema: { type: 'integer', default: 20, minimum: 1, maximum: 100 },
+                },
+                {
+                    name: 'offset',
+                    in: 'query',
+                    required: false,
+                    description: '재고 검색 시작 오프셋',
+                    schema: { type: 'integer', default: 0, minimum: 0 },
+                },
+                {
+                    name: 'searchSort',
+                    in: 'query',
+                    required: false,
+                    description: '재고 정렬 방식',
+                    schema: { type: 'string', default: 'recom' },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '조회 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/CuInventoryResponse' },
+                        },
+                    },
+                },
+                '400': {
+                    description: '잘못된 요청 (검색어 누락)',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};