daiso 1.0.4 → 1.0.6

package/dist/pages/openapiSpecPathsGs25.js

@@ -0,0 +1,166 @@
+/**
+ * OpenAPI 경로 정의 (GS25)
+ */
+export const OPENAPI_PATHS_GS25 = {
+    '/api/gs25/stores': {
+        get: {
+            operationId: 'gs25FindStores',
+            summary: 'GS25 매장 검색',
+            description: '키워드/좌표 기준으로 GS25 매장을 조회합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '매장명 또는 주소 키워드 (예: 강남)',
+                    schema: { type: 'string' },
+                },
+                {
+                    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: 200 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '검색 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/Gs25StoreSearchResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    '/api/gs25/products': {
+        get: {
+            operationId: 'gs25SearchProducts',
+            summary: 'GS25 상품 키워드 검색',
+            description: '키워드로 GS25 상품 후보를 조회합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: true,
+                    description: '상품 검색어',
+                    schema: { type: 'string' },
+                    example: '오감자',
+                },
+                {
+                    name: 'limit',
+                    in: 'query',
+                    required: false,
+                    description: '최대 결과 수',
+                    schema: { type: 'integer', default: 20, minimum: 1, maximum: 200 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '검색 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/Gs25ProductSearchResponse' },
+                        },
+                    },
+                },
+                '400': {
+                    description: '잘못된 요청 (검색어 누락)',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    '/api/gs25/inventory': {
+        get: {
+            operationId: 'gs25CheckInventory',
+            summary: 'GS25 재고 조회',
+            description: '상품 키워드 또는 itemCode 기준으로 GS25 매장별 재고를 조회합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '상품 검색어 (itemCode가 없을 때 사용)',
+                    schema: { type: 'string' },
+                    example: '오감자',
+                },
+                {
+                    name: 'itemCode',
+                    in: 'query',
+                    required: false,
+                    description: '상품 코드 (상품 검색 결과에서 전달)',
+                    schema: { type: 'string' },
+                    example: '8801056038861',
+                },
+                {
+                    name: 'storeKeyword',
+                    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: 'storeLimit',
+                    in: 'query',
+                    required: false,
+                    description: '반환할 최대 매장 수',
+                    schema: { type: 'integer', default: 20, minimum: 1, maximum: 200 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '조회 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/Gs25InventoryResponse' },
+                        },
+                    },
+                },
+                '400': {
+                    description: '잘못된 요청 (필수 파라미터 누락)',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};

package/dist/pages/openapiSpecPathsLotteMart.js

@@ -0,0 +1,149 @@
+/**
+ * OpenAPI 경로 정의 (롯데마트)
+ */
+export const OPENAPI_PATHS_LOTTEMART = {
+    '/api/lottemart/stores': {
+        get: {
+            operationId: 'lottemartFindStores',
+            summary: '롯데마트 매장 검색',
+            description: '지역/키워드 조건으로 롯데마트 계열 매장을 조회합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '매장명 또는 주소 키워드',
+                    schema: { type: 'string' },
+                },
+                {
+                    name: 'area',
+                    in: 'query',
+                    required: false,
+                    description: '지역 (예: 서울, 경기, 제주)',
+                    schema: { type: 'string' },
+                },
+                {
+                    name: 'brandVariant',
+                    in: 'query',
+                    required: false,
+                    description: '브랜드 변형 필터',
+                    schema: {
+                        type: 'string',
+                        enum: ['lottemart', 'toysrus', 'max', 'bottlebunker', 'mealguru', 'grandgrocery', 'other'],
+                    },
+                },
+                {
+                    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/LotteMartStoreSearchResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    '/api/lottemart/products': {
+        get: {
+            operationId: 'lottemartSearchProducts',
+            summary: '롯데마트 상품 검색',
+            description: '특정 롯데마트 매장을 기준으로 상품 가격과 재고를 조회합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: true,
+                    description: '상품 검색어',
+                    schema: { type: 'string' },
+                    example: '콜라',
+                },
+                {
+                    name: 'storeCode',
+                    in: 'query',
+                    required: false,
+                    description: '매장 코드',
+                    schema: { type: 'string' },
+                    example: '2301',
+                },
+                {
+                    name: 'storeName',
+                    in: 'query',
+                    required: false,
+                    description: '매장명',
+                    schema: { type: 'string' },
+                    example: '강변점',
+                },
+                {
+                    name: 'area',
+                    in: 'query',
+                    required: false,
+                    description: '지역 (storeName 해석 보조용)',
+                    schema: { type: 'string' },
+                    example: '서울',
+                },
+                {
+                    name: 'pageLimit',
+                    in: 'query',
+                    required: false,
+                    description: '추가 조회할 최대 페이지 수',
+                    schema: { type: 'integer', default: 3, minimum: 1, maximum: 20 },
+                },
+                {
+                    name: 'source',
+                    in: 'query',
+                    required: false,
+                    description: '상품 검색 경로',
+                    schema: { type: 'string', enum: ['auto', 'legacy', 'zetta'], default: 'auto' },
+                },
+                {
+                    name: 'timeoutMs',
+                    in: 'query',
+                    required: false,
+                    description: '요청 제한 시간(ms)',
+                    schema: { type: 'integer', default: 45000, minimum: 1 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '검색 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/LotteMartProductSearchResponse' },
+                        },
+                    },
+                },
+                '400': {
+                    description: '잘못된 요청',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};

package/dist/pages/openapiSpecPathsLottecinema.js

@@ -0,0 +1,212 @@
+/**
+ * OpenAPI 경로 정의 (롯데시네마)
+ */
+export const OPENAPI_PATHS_LOTTECINEMA = {
+    '/api/lottecinema/theaters': {
+        get: {
+            operationId: 'lottecinemaFindNearbyTheaters',
+            summary: '롯데시네마 주변 지점 조회',
+            description: '위치 키워드 또는 좌표 기준으로 롯데시네마 지점을 거리순으로 조회합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (예: 안산 중앙역, 잠실역)',
+                    schema: { type: 'string', example: '안산 중앙역' },
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도 (keyword가 없을 때 기본값: 서울 시청 37.5665)',
+                    schema: { type: 'number', format: 'float', default: 37.5665 },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도 (keyword가 없을 때 기본값: 서울 시청 126.978)',
+                    schema: { type: 'number', format: 'float', default: 126.978 },
+                },
+                {
+                    name: 'playDate',
+                    in: 'query',
+                    required: false,
+                    description: '조회 날짜 (YYYYMMDD)',
+                    schema: { type: 'string', example: '20260310' },
+                },
+                {
+                    name: 'limit',
+                    in: 'query',
+                    required: false,
+                    description: '최대 결과 수',
+                    schema: { type: 'integer', default: 10, minimum: 1, maximum: 100 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '조회 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/LotteCinemaTheaterSearchResponse' },
+                        },
+                    },
+                },
+                '500': {
+                    description: '롯데시네마 API 호출 실패',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    '/api/lottecinema/movies': {
+        get: {
+            operationId: 'lottecinemaListNowShowing',
+            summary: '롯데시네마 영화/회차 목록 조회',
+            description: '날짜, 지점, 영화 조건으로 롯데시네마 영화 및 상영 회차를 조회합니다. theaterId가 없으면 위치 키워드 기준 최근접 지점을 선택할 수 있습니다.',
+            parameters: [
+                {
+                    name: 'playDate',
+                    in: 'query',
+                    required: false,
+                    description: '조회 날짜 (YYYYMMDD)',
+                    schema: { type: 'string', example: '20260310' },
+                },
+                {
+                    name: 'theaterId',
+                    in: 'query',
+                    required: false,
+                    description: '지점 ID (예: 1016)',
+                    schema: { type: 'string', example: '1016' },
+                },
+                {
+                    name: 'movieId',
+                    in: 'query',
+                    required: false,
+                    description: '대표 영화 코드 (예: 23816)',
+                    schema: { type: 'string', example: '23816' },
+                },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (theaterId가 없을 때 사용, 예: 안산 중앙역)',
+                    schema: { type: 'string', example: '안산 중앙역' },
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도 (theaterId가 없을 때 사용)',
+                    schema: { type: 'number', format: 'float', example: 37.3172 },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도 (theaterId가 없을 때 사용)',
+                    schema: { type: 'number', format: 'float', example: 126.839 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '조회 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/LotteCinemaMovieListResponse' },
+                        },
+                    },
+                },
+                '500': {
+                    description: '롯데시네마 API 호출 실패',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    '/api/lottecinema/seats': {
+        get: {
+            operationId: 'lottecinemaGetRemainingSeats',
+            summary: '롯데시네마 잔여 좌석 조회',
+            description: '영화/지점/날짜 조건으로 회차별 잔여 좌석 수를 조회합니다. theaterId가 없으면 위치 키워드 기준 최근접 지점을 선택할 수 있습니다.',
+            parameters: [
+                {
+                    name: 'playDate',
+                    in: 'query',
+                    required: false,
+                    description: '조회 날짜 (YYYYMMDD)',
+                    schema: { type: 'string', example: '20260310' },
+                },
+                {
+                    name: 'theaterId',
+                    in: 'query',
+                    required: false,
+                    description: '지점 ID',
+                    schema: { type: 'string', example: '1016' },
+                },
+                {
+                    name: 'movieId',
+                    in: 'query',
+                    required: false,
+                    description: '대표 영화 코드',
+                    schema: { type: 'string', example: '23816' },
+                },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (theaterId가 없을 때 사용, 예: 안산 중앙역)',
+                    schema: { type: 'string', example: '안산 중앙역' },
+                },
+                {
+                    name: 'lat',
+                    in: 'query',
+                    required: false,
+                    description: '위도 (theaterId가 없을 때 사용)',
+                    schema: { type: 'number', format: 'float', example: 37.3172 },
+                },
+                {
+                    name: 'lng',
+                    in: 'query',
+                    required: false,
+                    description: '경도 (theaterId가 없을 때 사용)',
+                    schema: { type: 'number', format: 'float', example: 126.839 },
+                },
+                {
+                    name: 'limit',
+                    in: 'query',
+                    required: false,
+                    description: '최대 결과 수',
+                    schema: { type: 'integer', default: 50, minimum: 1, maximum: 200 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '조회 성공',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/LotteCinemaSeatListResponse' },
+                        },
+                    },
+                },
+                '500': {
+                    description: '롯데시네마 API 호출 실패',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};

package/dist/pages/openapiSpecPathsMegabox.js

@@ -6,8 +6,15 @@ export const OPENAPI_PATHS_MEGABOX = {
         get: {
             operationId: 'megaboxFindNearbyTheaters',
             summary: '메가박스 주변 지점 조회',
-            description: '좌표 기준으로 메가박스 지점을 거리순으로 조회합니다.',
+            description: '좌표 또는 위치 키워드 기준으로 메가박스 지점을 거리순으로 조회합니다. lat/lng가 없으면 keyword를 구글 지오코드로 보강할 수 있습니다.',
             parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (예: 안산 중앙역, 강남역)',
+                    schema: { type: 'string' },
+                },
                 {
                     name: 'lat',
                     in: 'query',
@@ -68,7 +75,7 @@ export const OPENAPI_PATHS_MEGABOX = {
         get: {
             operationId: 'megaboxListNowShowing',
             summary: '메가박스 영화/회차 목록 조회',
-            description: '날짜, 지점, 영화 조건으로 메가박스 영화 및 상영 회차를 조회합니다.',
+            description: '날짜, 지점, 영화 조건으로 메가박스 영화 및 상영 회차를 조회합니다. theaterId가 없고 keyword 또는 좌표가 있으면 가장 가까운 지점을 먼저 선택합니다.',
             parameters: [
                 {
                     name: 'playDate',
@@ -91,6 +98,27 @@ export const OPENAPI_PATHS_MEGABOX = {
                     description: '영화 ID (예: 25104500)',
                     schema: { type: 'string', example: '25104500' },
                 },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (예: 안산 중앙역, 강남역)',
+                    schema: { type: 'string' },
+                },
+                {
+                    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: 'areaCode',
                     in: 'query',
@@ -123,7 +151,7 @@ export const OPENAPI_PATHS_MEGABOX = {
         get: {
             operationId: 'megaboxGetRemainingSeats',
             summary: '메가박스 잔여 좌석 조회',
-            description: '영화/지점/날짜 조건으로 회차별 잔여 좌석 수를 조회합니다.',
+            description: '영화/지점/날짜 조건으로 회차별 잔여 좌석 수를 조회합니다. theaterId가 없고 keyword 또는 좌표가 있으면 가장 가까운 지점을 먼저 선택합니다.',
             parameters: [
                 {
                     name: 'playDate',
@@ -146,6 +174,27 @@ export const OPENAPI_PATHS_MEGABOX = {
                     description: '영화 ID',
                     schema: { type: 'string' },
                 },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '위치 키워드 (예: 안산 중앙역, 강남역)',
+                    schema: { type: 'string' },
+                },
+                {
+                    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: 'areaCode',
                     in: 'query',