daiso 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/README.md +218 -540
  2. package/dist/api/actionsProxy.js +82 -0
  3. package/dist/api/cgvHandlers.js +103 -16
  4. package/dist/api/daisoHandlers.js +127 -0
  5. package/dist/api/emart24Handlers.js +176 -0
  6. package/dist/api/gs25Handlers.js +256 -0
  7. package/dist/api/handlers.js +184 -108
  8. package/dist/api/healthChecks.js +332 -0
  9. package/dist/api/lottecinemaHandlers.js +155 -0
  10. package/dist/api/lottemartHandlers.js +128 -0
  11. package/dist/api/megaboxHandlers.js +81 -50
  12. package/dist/api/routes/cuRoutes.js +17 -0
  13. package/dist/api/routes/daisoRoutes.js +6 -1
  14. package/dist/api/routes/emart24Routes.js +22 -0
  15. package/dist/api/routes/gs25Routes.js +22 -0
  16. package/dist/api/routes/healthRoutes.js +44 -0
  17. package/dist/api/routes/lottecinemaRoutes.js +22 -0
  18. package/dist/api/routes/lottemartRoutes.js +18 -0
  19. package/dist/api/routes/oliveyoungRoutes.js +6 -1
  20. package/dist/api/routes/sevenelevenRoutes.js +32 -0
  21. package/dist/api/sevenelevenHandlers.js +200 -0
  22. package/dist/cli/args.js +54 -0
  23. package/dist/cli/commands/convenience.js +241 -0
  24. package/dist/cli/commands/daiso.js +96 -0
  25. package/dist/cli/constants.js +5 -0
  26. package/dist/cli/deps.js +48 -0
  27. package/dist/cli/http.js +98 -0
  28. package/dist/cli/interactiveFetch.js +31 -0
  29. package/dist/cli/interactiveItemSearch.js +259 -0
  30. package/dist/cli/interactivePrompt.js +49 -0
  31. package/dist/cli/interactiveTypes.js +4 -0
  32. package/dist/cli/types.js +4 -0
  33. package/dist/cli.js +66 -197
  34. package/dist/cliHelp.js +206 -1
  35. package/dist/cliInteractive.js +174 -0
  36. package/dist/cliPicker.js +56 -0
  37. package/dist/cliRenderer.js +4 -0
  38. package/dist/index.js +147 -8
  39. package/dist/pages/openapi.js +2 -1
  40. package/dist/pages/openapiFullSpec.js +58 -0
  41. package/dist/pages/openapiResponse.js +28 -0
  42. package/dist/pages/openapiSpec.js +2 -41
  43. package/dist/pages/openapiSpecActions.js +109 -0
  44. package/dist/pages/openapiSpecComponents.js +30 -391
  45. package/dist/pages/openapiSpecComponentsCgv.js +24 -0
  46. package/dist/pages/openapiSpecComponentsCu.js +112 -0
  47. package/dist/pages/openapiSpecComponentsDaisoOliveyoung.js +342 -0
  48. package/dist/pages/openapiSpecComponentsEmart24.js +141 -0
  49. package/dist/pages/openapiSpecComponentsGs25.js +109 -0
  50. package/dist/pages/openapiSpecComponentsLotteMart.js +85 -0
  51. package/dist/pages/openapiSpecComponentsLottecinema.js +163 -0
  52. package/dist/pages/openapiSpecComponentsMegabox.js +144 -0
  53. package/dist/pages/openapiSpecComponentsSeveneleven.js +82 -0
  54. package/dist/pages/openapiSpecPathsCgv.js +66 -3
  55. package/dist/pages/openapiSpecPathsCu.js +138 -0
  56. package/dist/pages/openapiSpecPathsDaiso.js +302 -0
  57. package/dist/pages/openapiSpecPathsDaisoOliveyoung.js +4 -376
  58. package/dist/pages/openapiSpecPathsEmart24.js +223 -0
  59. package/dist/pages/openapiSpecPathsGs25.js +166 -0
  60. package/dist/pages/openapiSpecPathsLotteMart.js +135 -0
  61. package/dist/pages/openapiSpecPathsLottecinema.js +212 -0
  62. package/dist/pages/openapiSpecPathsMegabox.js +52 -3
  63. package/dist/pages/openapiSpecPathsOliveyoung.js +231 -0
  64. package/dist/pages/openapiSpecPathsSeveneleven.js +234 -0
  65. package/dist/pages/prompt.js +8 -402
  66. package/dist/pages/promptCoreText.js +278 -0
  67. package/dist/pages/promptReferenceText.js +131 -0
  68. package/dist/pages/promptRetailCinemaText.js +273 -0
  69. package/dist/services/cgv/client.js +6 -1
  70. package/dist/services/cgv/index.js +3 -3
  71. package/dist/services/cgv/location.js +235 -0
  72. package/dist/services/cgv/tools/findTheaters.js +30 -5
  73. package/dist/services/cgv/tools/getTimetable.js +42 -14
  74. package/dist/services/cgv/tools/searchMovies.js +40 -12
  75. package/dist/services/cgv/transport.js +0 -3
  76. package/dist/services/cu/api.js +11 -0
  77. package/dist/services/cu/client.js +297 -0
  78. package/dist/services/cu/index.js +21 -0
  79. package/dist/services/cu/tools/checkInventory.js +123 -0
  80. package/dist/services/cu/tools/findNearbyStores.js +49 -0
  81. package/dist/services/cu/types.js +4 -0
  82. package/dist/services/daiso/api.js +22 -2
  83. package/dist/services/daiso/client.js +59 -0
  84. package/dist/services/daiso/index.js +2 -0
  85. package/dist/services/daiso/product.js +17 -0
  86. package/dist/services/daiso/tools/checkInventory.js +76 -41
  87. package/dist/services/daiso/tools/findStores.js +17 -7
  88. package/dist/services/daiso/tools/getDisplayLocation.js +75 -0
  89. package/dist/services/emart24/api.js +11 -0
  90. package/dist/services/emart24/client.js +173 -0
  91. package/dist/services/emart24/index.js +22 -0
  92. package/dist/services/emart24/inventoryLookup.js +134 -0
  93. package/dist/services/emart24/tools/checkInventory.js +54 -0
  94. package/dist/services/emart24/tools/findNearbyStores.js +72 -0
  95. package/dist/services/emart24/tools/searchProducts.js +63 -0
  96. package/dist/services/emart24/types.js +4 -0
  97. package/dist/services/gs25/api.js +9 -0
  98. package/dist/services/gs25/client.js +198 -0
  99. package/dist/services/gs25/index.js +22 -0
  100. package/dist/services/gs25/storeUtils.js +168 -0
  101. package/dist/services/gs25/tools/checkInventory.js +163 -0
  102. package/dist/services/gs25/tools/findNearbyStores.js +103 -0
  103. package/dist/services/gs25/tools/searchProducts.js +50 -0
  104. package/dist/services/gs25/types.js +4 -0
  105. package/dist/services/lottecinema/api.js +12 -0
  106. package/dist/services/lottecinema/client.js +161 -0
  107. package/dist/services/lottecinema/index.js +30 -0
  108. package/dist/services/lottecinema/location.js +191 -0
  109. package/dist/services/lottecinema/tools/findNearbyTheaters.js +47 -0
  110. package/dist/services/lottecinema/tools/getRemainingSeats.js +85 -0
  111. package/dist/services/lottecinema/tools/listNowShowing.js +79 -0
  112. package/dist/services/lottecinema/types.js +4 -0
  113. package/dist/services/lottemart/api.js +31 -0
  114. package/dist/services/lottemart/client.js +245 -0
  115. package/dist/services/lottemart/clientTypes.js +4 -0
  116. package/dist/services/lottemart/config.js +4 -0
  117. package/dist/services/lottemart/debug.js +92 -0
  118. package/dist/services/lottemart/geocode.js +49 -0
  119. package/dist/services/lottemart/index.js +30 -0
  120. package/dist/services/lottemart/keyword.js +29 -0
  121. package/dist/services/lottemart/parser.js +185 -0
  122. package/dist/services/lottemart/session.js +331 -0
  123. package/dist/services/lottemart/storeSearch.js +52 -0
  124. package/dist/services/lottemart/tools/findNearbyStores.js +67 -0
  125. package/dist/services/lottemart/tools/searchProducts.js +62 -0
  126. package/dist/services/lottemart/types.js +4 -0
  127. package/dist/services/lottemart/zetta.js +105 -0
  128. package/dist/services/megabox/location.js +219 -0
  129. package/dist/services/megabox/tools/findNearbyTheaters.js +13 -44
  130. package/dist/services/megabox/tools/getRemainingSeats.js +31 -3
  131. package/dist/services/megabox/tools/listNowShowing.js +31 -3
  132. package/dist/services/oliveyoung/api.js +2 -0
  133. package/dist/services/oliveyoung/client.js +150 -9
  134. package/dist/services/oliveyoung/index.js +3 -1
  135. package/dist/services/oliveyoung/tools/checkInventory.js +15 -4
  136. package/dist/services/oliveyoung/tools/searchProducts.js +57 -0
  137. package/dist/services/seveneleven/api.js +15 -0
  138. package/dist/services/seveneleven/client.js +279 -0
  139. package/dist/services/seveneleven/index.js +30 -0
  140. package/dist/services/seveneleven/inventory.js +302 -0
  141. package/dist/services/seveneleven/productKeyword.js +141 -0
  142. package/dist/services/seveneleven/tools/checkInventory.js +82 -0
  143. package/dist/services/seveneleven/tools/getCatalogSnapshot.js +55 -0
  144. package/dist/services/seveneleven/tools/getSearchPopwords.js +41 -0
  145. package/dist/services/seveneleven/tools/searchProducts.js +56 -0
  146. package/dist/services/seveneleven/tools/searchStores.js +45 -0
  147. package/dist/services/seveneleven/types.js +4 -0
  148. package/dist/utils/cliInteractiveHelpers.js +63 -0
  149. package/dist/utils/daisoKeyword.js +30 -0
  150. package/dist/utils/http.js +16 -2
  151. package/openapi.json +1977 -734
  152. package/openapi.yaml +1430 -543
  153. package/package.json +28 -15
  154. package/dist/tools/checkInventory.js +0 -98
  155. package/dist/tools/findStores.js +0 -125
  156. package/dist/tools/getPriceInfo.js +0 -77
  157. package/dist/tools/searchProducts.js +0 -61
  158. package/dist/types/index.js +0 -4
@@ -0,0 +1,342 @@
1
+ /**
2
+ * OpenAPI 컴포넌트 스키마 정의 (다이소/올리브영)
3
+ */
4
+ export const OPENAPI_DAISO_OLIVEYOUNG_COMPONENT_SCHEMAS = {
5
+ Product: {
6
+ type: 'object',
7
+ description: '제품 정보',
8
+ properties: {
9
+ id: { type: 'string', description: '제품 ID', example: '1234567890' },
10
+ name: { type: 'string', description: '제품명', example: 'PP 수납박스 대형' },
11
+ price: { type: 'integer', description: '가격 (원)', example: 5000 },
12
+ imageUrl: {
13
+ type: 'string',
14
+ description: '제품 이미지 URL',
15
+ example: 'https://cdn.daisomall.co.kr/...',
16
+ },
17
+ soldOut: { type: 'boolean', description: '품절 여부', example: false },
18
+ isNew: { type: 'boolean', description: '신상품 여부', example: false },
19
+ pickupAvailable: { type: 'boolean', description: '매장 픽업 가능 여부', example: true },
20
+ },
21
+ },
22
+ ProductDetail: {
23
+ type: 'object',
24
+ description: '제품 상세 정보',
25
+ properties: {
26
+ id: { type: 'string', description: '제품 ID' },
27
+ name: { type: 'string', description: '제품명' },
28
+ price: { type: 'integer', description: '가격 (원)' },
29
+ currency: { type: 'string', description: '통화', example: 'KRW' },
30
+ imageUrl: { type: 'string', description: '제품 이미지 URL' },
31
+ brand: { type: 'string', description: '브랜드명' },
32
+ soldOut: { type: 'boolean', description: '품절 여부' },
33
+ isNew: { type: 'boolean', description: '신상품 여부' },
34
+ },
35
+ },
36
+ InventoryProduct: {
37
+ type: 'object',
38
+ description: '재고 응답에 포함되는 상품 요약 정보',
39
+ properties: {
40
+ id: { type: 'string', description: '제품 ID' },
41
+ name: { type: 'string', description: '제품명' },
42
+ imageUrl: { type: 'string', description: '제품 이미지 URL' },
43
+ brand: { type: 'string', description: '브랜드명' },
44
+ soldOut: { type: 'boolean', description: '품절 여부' },
45
+ isNew: { type: 'boolean', description: '신상품 여부' },
46
+ },
47
+ },
48
+ Store: {
49
+ type: 'object',
50
+ description: '매장 정보',
51
+ properties: {
52
+ name: { type: 'string', description: '매장명', example: '다이소 강남역점' },
53
+ phone: { type: 'string', description: '전화번호', example: '02-1234-5678' },
54
+ address: {
55
+ type: 'string',
56
+ description: '주소',
57
+ example: '서울특별시 강남구 강남대로 123',
58
+ },
59
+ lat: { type: 'number', format: 'float', description: '위도', example: 37.4979 },
60
+ lng: { type: 'number', format: 'float', description: '경도', example: 127.0276 },
61
+ openTime: { type: 'string', description: '영업 시작 시간', example: '10:00' },
62
+ closeTime: { type: 'string', description: '영업 종료 시간', example: '22:00' },
63
+ options: {
64
+ type: 'object',
65
+ description: '매장 옵션',
66
+ properties: {
67
+ parking: { type: 'boolean', description: '주차 가능 여부' },
68
+ pickup: { type: 'boolean', description: '픽업 가능 여부' },
69
+ taxFree: { type: 'boolean', description: '면세 가능 여부' },
70
+ },
71
+ },
72
+ },
73
+ },
74
+ StoreInventory: {
75
+ type: 'object',
76
+ description: '매장 재고 정보',
77
+ properties: {
78
+ storeCode: { type: 'string', description: '매장 코드', example: 'ST001' },
79
+ storeName: { type: 'string', description: '매장명', example: '다이소 강남역점' },
80
+ address: { type: 'string', description: '주소' },
81
+ distance: { type: 'string', description: '거리', example: '0.5km' },
82
+ quantity: { type: 'integer', description: '재고 수량', example: 12 },
83
+ options: {
84
+ type: 'object',
85
+ properties: {
86
+ parking: { type: 'boolean' },
87
+ pickup: { type: 'boolean' },
88
+ },
89
+ },
90
+ },
91
+ },
92
+ ProductSearchResponse: {
93
+ type: 'object',
94
+ properties: {
95
+ success: { type: 'boolean', example: true },
96
+ data: {
97
+ type: 'object',
98
+ properties: {
99
+ products: { type: 'array', items: { $ref: '#/components/schemas/Product' } },
100
+ },
101
+ },
102
+ meta: {
103
+ type: 'object',
104
+ properties: {
105
+ total: { type: 'integer', description: '전체 결과 수' },
106
+ page: { type: 'integer', description: '현재 페이지' },
107
+ pageSize: { type: 'integer', description: '페이지당 결과 수' },
108
+ },
109
+ },
110
+ },
111
+ },
112
+ ProductDetailResponse: {
113
+ type: 'object',
114
+ properties: {
115
+ success: { type: 'boolean', example: true },
116
+ data: { $ref: '#/components/schemas/ProductDetail' },
117
+ },
118
+ },
119
+ StoreSearchResponse: {
120
+ type: 'object',
121
+ properties: {
122
+ success: { type: 'boolean', example: true },
123
+ data: {
124
+ type: 'object',
125
+ properties: {
126
+ stores: { type: 'array', items: { $ref: '#/components/schemas/Store' } },
127
+ },
128
+ },
129
+ meta: {
130
+ type: 'object',
131
+ properties: { total: { type: 'integer', description: '전체 결과 수' } },
132
+ },
133
+ },
134
+ },
135
+ InventoryResponse: {
136
+ type: 'object',
137
+ properties: {
138
+ success: { type: 'boolean', example: true },
139
+ data: {
140
+ type: 'object',
141
+ properties: {
142
+ productId: { type: 'string', description: '제품 ID' },
143
+ product: { $ref: '#/components/schemas/InventoryProduct' },
144
+ location: {
145
+ type: 'object',
146
+ properties: {
147
+ latitude: { type: 'number', format: 'float' },
148
+ longitude: { type: 'number', format: 'float' },
149
+ },
150
+ },
151
+ onlineStock: { type: 'integer', description: '온라인 재고 수량', example: 150 },
152
+ storeInventory: {
153
+ type: 'object',
154
+ properties: {
155
+ totalStores: { type: 'integer', description: '전체 매장 수' },
156
+ inStockCount: { type: 'integer', description: '재고 있는 매장 수' },
157
+ stores: {
158
+ type: 'array',
159
+ items: { $ref: '#/components/schemas/StoreInventory' },
160
+ },
161
+ },
162
+ },
163
+ },
164
+ },
165
+ meta: {
166
+ type: 'object',
167
+ properties: {
168
+ total: { type: 'integer' },
169
+ page: { type: 'integer' },
170
+ pageSize: { type: 'integer' },
171
+ },
172
+ },
173
+ },
174
+ },
175
+ OliveyoungStore: {
176
+ type: 'object',
177
+ description: '올리브영 매장 정보',
178
+ properties: {
179
+ storeCode: { type: 'string', example: 'D176' },
180
+ storeName: { type: 'string', example: '올리브영 명동 타운' },
181
+ address: { type: 'string', example: '서울특별시 중구 명동길 53' },
182
+ latitude: { type: 'number', format: 'float', example: 37.56409158 },
183
+ longitude: { type: 'number', format: 'float', example: 126.9851771 },
184
+ pickupYn: { type: 'boolean', example: false },
185
+ o2oRemainQuantity: { type: 'integer', example: 0 },
186
+ },
187
+ },
188
+ OliveyoungProduct: {
189
+ type: 'object',
190
+ description: '올리브영 상품 재고 정보',
191
+ properties: {
192
+ goodsNumber: { type: 'string', example: 'A000000200614' },
193
+ goodsName: { type: 'string', example: '달바 퍼플 톤업 선크림 듀오 기획' },
194
+ imageUrl: {
195
+ type: 'string',
196
+ example: 'https://image.oliveyoung.co.kr/uploads/images/goods/10/0000/0020/A00000020061401ko.jpg',
197
+ },
198
+ priceToPay: { type: 'integer', example: 32130 },
199
+ originalPrice: { type: 'integer', example: 51000 },
200
+ discountRate: { type: 'integer', example: 37 },
201
+ o2oStockFlag: { type: 'boolean', description: '올리브영 원본 재고 가능 플래그', example: true },
202
+ o2oRemainQuantity: { type: 'integer', description: '올리브영 원본 잔여 수량 필드. 0이어도 재고가 있을 수 있음', example: 0 },
203
+ inStock: { type: 'boolean', description: '현재 조회한 주변 매장 기준 재고 여부. storeInventory가 있으면 그 결과를 우선 반영', example: true },
204
+ stockStatus: { type: 'string', enum: ['in_stock', 'out_of_stock'], example: 'in_stock' },
205
+ stockSource: { type: 'string', enum: ['global_search', 'nearby_store'], example: 'nearby_store' },
206
+ storeInventory: { $ref: '#/components/schemas/OliveyoungProductStoreInventory' },
207
+ },
208
+ },
209
+ OliveyoungStockStore: {
210
+ type: 'object',
211
+ description: '올리브영 상품별 매장 재고 상태',
212
+ properties: {
213
+ storeCode: { type: 'string', example: 'B040' },
214
+ storeName: { type: 'string', example: '안산중앙역점' },
215
+ address: { type: 'string', example: '경기도 안산시 단원구 고잔2길 65 1층' },
216
+ latitude: { type: 'number', format: 'float', example: 37.3177184 },
217
+ longitude: { type: 'number', format: 'float', example: 126.8385857 },
218
+ distance: { type: 'number', format: 'float', example: 0.07 },
219
+ pickupYn: { type: 'boolean', example: true },
220
+ salesStoreYn: { type: 'boolean', example: true },
221
+ remainQuantity: { type: 'integer', example: 3 },
222
+ o2oRemainQuantity: { type: 'integer', example: 2 },
223
+ stockStatus: { type: 'string', enum: ['in_stock', 'out_of_stock', 'not_sold'], example: 'in_stock' },
224
+ stockLabel: { type: 'string', example: '재고 3개' },
225
+ openYn: { type: 'boolean', example: true },
226
+ },
227
+ },
228
+ OliveyoungProductStoreInventory: {
229
+ type: 'object',
230
+ properties: {
231
+ totalCount: { type: 'integer', example: 1 },
232
+ inStockCount: { type: 'integer', example: 1 },
233
+ outOfStockCount: { type: 'integer', example: 0 },
234
+ notSoldCount: { type: 'integer', example: 0 },
235
+ stores: {
236
+ type: 'array',
237
+ items: { $ref: '#/components/schemas/OliveyoungStockStore' },
238
+ },
239
+ },
240
+ },
241
+ OliveyoungStoreSearchResponse: {
242
+ type: 'object',
243
+ properties: {
244
+ success: { type: 'boolean', example: true },
245
+ data: {
246
+ type: 'object',
247
+ properties: {
248
+ stores: {
249
+ type: 'array',
250
+ items: { $ref: '#/components/schemas/OliveyoungStore' },
251
+ },
252
+ },
253
+ },
254
+ meta: {
255
+ type: 'object',
256
+ properties: {
257
+ total: { type: 'integer' },
258
+ page: { type: 'integer' },
259
+ pageSize: { type: 'integer' },
260
+ },
261
+ },
262
+ },
263
+ },
264
+ OliveyoungProductSearchResponse: {
265
+ type: 'object',
266
+ properties: {
267
+ success: { type: 'boolean', example: true },
268
+ data: {
269
+ type: 'object',
270
+ properties: {
271
+ keyword: { type: 'string', example: '마스크팩' },
272
+ count: { type: 'integer', example: 2 },
273
+ products: {
274
+ type: 'array',
275
+ items: { $ref: '#/components/schemas/OliveyoungProduct' },
276
+ },
277
+ },
278
+ },
279
+ meta: {
280
+ type: 'object',
281
+ properties: {
282
+ total: { type: 'integer' },
283
+ page: { type: 'integer' },
284
+ pageSize: { type: 'integer' },
285
+ nextPage: { type: 'boolean' },
286
+ },
287
+ },
288
+ },
289
+ },
290
+ OliveyoungInventoryResponse: {
291
+ type: 'object',
292
+ properties: {
293
+ success: { type: 'boolean', example: true },
294
+ data: {
295
+ type: 'object',
296
+ properties: {
297
+ keyword: { type: 'string', example: '선크림' },
298
+ location: {
299
+ type: 'object',
300
+ properties: {
301
+ latitude: { type: 'number', format: 'float' },
302
+ longitude: { type: 'number', format: 'float' },
303
+ },
304
+ },
305
+ nearbyStores: {
306
+ type: 'object',
307
+ properties: {
308
+ totalCount: { type: 'integer' },
309
+ stores: {
310
+ type: 'array',
311
+ items: { $ref: '#/components/schemas/OliveyoungStore' },
312
+ },
313
+ },
314
+ },
315
+ inventory: {
316
+ type: 'object',
317
+ properties: {
318
+ totalCount: { type: 'integer' },
319
+ nextPage: { type: 'boolean' },
320
+ stockCheckedCount: { type: 'integer' },
321
+ stockUncheckedCount: { type: 'integer' },
322
+ inStockCount: { type: 'integer' },
323
+ outOfStockCount: { type: 'integer' },
324
+ products: {
325
+ type: 'array',
326
+ items: { $ref: '#/components/schemas/OliveyoungProduct' },
327
+ },
328
+ },
329
+ },
330
+ },
331
+ },
332
+ meta: {
333
+ type: 'object',
334
+ properties: {
335
+ total: { type: 'integer' },
336
+ page: { type: 'integer' },
337
+ pageSize: { type: 'integer' },
338
+ },
339
+ },
340
+ },
341
+ },
342
+ };
@@ -0,0 +1,141 @@
1
+ /**
2
+ * OpenAPI 컴포넌트 스키마 정의 (이마트24)
3
+ */
4
+ export const OPENAPI_EMART24_COMPONENT_SCHEMAS = {
5
+ Emart24Store: {
6
+ type: 'object',
7
+ properties: {
8
+ storeCode: { type: 'string', example: '28339' },
9
+ storeName: { type: 'string', example: '강남스퀘어점' },
10
+ address: { type: 'string', example: '서울특별시 강남구 강남대로 396' },
11
+ phone: { type: 'string', example: '02-000-0000' },
12
+ latitude: { type: 'number', format: 'float', example: 37.4982 },
13
+ longitude: { type: 'number', format: 'float', example: 127.0276 },
14
+ service24h: { type: 'boolean', example: true },
15
+ distanceM: { type: 'number', nullable: true, example: 120 },
16
+ },
17
+ },
18
+ Emart24Product: {
19
+ type: 'object',
20
+ properties: {
21
+ pluCd: { type: 'string', example: '8800244010504' },
22
+ goodsName: { type: 'string', example: '두바이초콜릿' },
23
+ originPrice: { type: 'integer', example: 3500 },
24
+ viewPrice: { type: 'integer', example: 3000 },
25
+ category: { type: 'string', example: '간식' },
26
+ kind: { type: 'string', example: '초콜릿' },
27
+ },
28
+ },
29
+ Emart24StoreSearchResponse: {
30
+ type: 'object',
31
+ properties: {
32
+ success: { type: 'boolean', example: true },
33
+ data: {
34
+ type: 'object',
35
+ properties: {
36
+ stores: {
37
+ type: 'array',
38
+ items: { $ref: '#/components/schemas/Emart24Store' },
39
+ },
40
+ },
41
+ },
42
+ meta: {
43
+ type: 'object',
44
+ properties: {
45
+ total: { type: 'integer' },
46
+ page: { type: 'integer' },
47
+ pageSize: { type: 'integer' },
48
+ },
49
+ },
50
+ },
51
+ },
52
+ Emart24ProductSearchResponse: {
53
+ type: 'object',
54
+ properties: {
55
+ success: { type: 'boolean', example: true },
56
+ data: {
57
+ type: 'object',
58
+ properties: {
59
+ products: {
60
+ type: 'array',
61
+ items: { $ref: '#/components/schemas/Emart24Product' },
62
+ },
63
+ },
64
+ },
65
+ meta: {
66
+ type: 'object',
67
+ properties: {
68
+ total: { type: 'integer' },
69
+ page: { type: 'integer' },
70
+ pageSize: { type: 'integer' },
71
+ },
72
+ },
73
+ },
74
+ },
75
+ Emart24InventoryResponse: {
76
+ type: 'object',
77
+ properties: {
78
+ success: { type: 'boolean', example: true },
79
+ data: {
80
+ type: 'object',
81
+ properties: {
82
+ keyword: { type: 'string', example: '고양이 츄르' },
83
+ pluCd: { type: 'string', example: '8800244010504' },
84
+ productCandidates: {
85
+ type: 'array',
86
+ items: { $ref: '#/components/schemas/Emart24Product' },
87
+ },
88
+ location: {
89
+ type: 'object',
90
+ nullable: true,
91
+ properties: {
92
+ latitude: { type: 'number', format: 'float' },
93
+ longitude: { type: 'number', format: 'float' },
94
+ },
95
+ },
96
+ storeFilters: {
97
+ type: 'object',
98
+ properties: {
99
+ storeKeyword: { type: 'string', example: '안산 중앙역' },
100
+ appliedStoreKeyword: { type: 'string', example: '안산중앙역' },
101
+ area1: { type: 'string', example: '경기도' },
102
+ area2: { type: 'string', example: '안산시' },
103
+ service24h: { type: 'boolean', example: false },
104
+ storeLimit: { type: 'integer', example: 10 },
105
+ directBizNos: {
106
+ type: 'array',
107
+ items: { type: 'string', example: '28339' },
108
+ },
109
+ },
110
+ },
111
+ nearbyStores: {
112
+ type: 'object',
113
+ properties: {
114
+ totalCount: { type: 'integer', example: 3 },
115
+ stores: {
116
+ type: 'array',
117
+ items: { $ref: '#/components/schemas/Emart24Store' },
118
+ },
119
+ },
120
+ },
121
+ goodsInfo: { type: 'object', nullable: true },
122
+ count: { type: 'integer', example: 1 },
123
+ stores: {
124
+ type: 'array',
125
+ items: {
126
+ type: 'object',
127
+ properties: {
128
+ bizNo: { type: 'string', example: '28339' },
129
+ bizQty: { type: 'integer', example: 3 },
130
+ storeName: { type: 'string', example: '강남스퀘어점' },
131
+ address: { type: 'string' },
132
+ phone: { type: 'string' },
133
+ distanceM: { type: 'number', nullable: true, example: 120 },
134
+ },
135
+ },
136
+ },
137
+ },
138
+ },
139
+ },
140
+ },
141
+ };
@@ -0,0 +1,109 @@
1
+ /**
2
+ * OpenAPI 컴포넌트 스키마 정의 (GS25)
3
+ */
4
+ export const OPENAPI_GS25_COMPONENT_SCHEMAS = {
5
+ Gs25Store: {
6
+ type: 'object',
7
+ properties: {
8
+ storeCode: { type: 'string', example: 'VE463' },
9
+ storeName: { type: 'string', example: '강남역점' },
10
+ address: { type: 'string', example: '서울특별시 강남구 강남대로 396' },
11
+ phone: { type: 'string', example: '02-1234-5678' },
12
+ latitude: { type: 'number', format: 'float', example: 37.4982 },
13
+ longitude: { type: 'number', format: 'float', example: 127.0276 },
14
+ realStockQuantity: { type: 'integer', example: 3 },
15
+ distanceM: { type: 'number', nullable: true, example: 120 },
16
+ propertyNames: {
17
+ type: 'array',
18
+ items: { type: 'string' },
19
+ example: ['반값택배픽업', '와인25플러스'],
20
+ },
21
+ },
22
+ },
23
+ Gs25ProductCandidate: {
24
+ type: 'object',
25
+ properties: {
26
+ name: { type: 'string', example: '오리온)오감자50G' },
27
+ sellPrice: { type: 'integer', nullable: true, example: 1700 },
28
+ matchedStoreCount: { type: 'integer', example: 120 },
29
+ inStockStoreCount: { type: 'integer', example: 42 },
30
+ totalStockQuantity: { type: 'integer', example: 110 },
31
+ },
32
+ },
33
+ Gs25StoreSearchResponse: {
34
+ type: 'object',
35
+ properties: {
36
+ success: { type: 'boolean', example: true },
37
+ data: {
38
+ type: 'object',
39
+ properties: {
40
+ stores: {
41
+ type: 'array',
42
+ items: { $ref: '#/components/schemas/Gs25Store' },
43
+ },
44
+ },
45
+ },
46
+ meta: {
47
+ type: 'object',
48
+ properties: {
49
+ total: { type: 'integer' },
50
+ pageSize: { type: 'integer' },
51
+ },
52
+ },
53
+ },
54
+ },
55
+ Gs25ProductSearchResponse: {
56
+ type: 'object',
57
+ properties: {
58
+ success: { type: 'boolean', example: true },
59
+ data: {
60
+ type: 'object',
61
+ properties: {
62
+ products: {
63
+ type: 'array',
64
+ items: { $ref: '#/components/schemas/Gs25ProductCandidate' },
65
+ },
66
+ },
67
+ },
68
+ meta: {
69
+ type: 'object',
70
+ properties: {
71
+ total: { type: 'integer' },
72
+ pageSize: { type: 'integer' },
73
+ },
74
+ },
75
+ },
76
+ },
77
+ Gs25InventoryResponse: {
78
+ type: 'object',
79
+ properties: {
80
+ success: { type: 'boolean', example: true },
81
+ data: {
82
+ type: 'object',
83
+ properties: {
84
+ keyword: { type: 'string', example: '오감자' },
85
+ product: {
86
+ type: 'object',
87
+ properties: {
88
+ name: { type: 'string', nullable: true, example: '오리온)오감자50G' },
89
+ sellPrice: { type: 'integer', nullable: true, example: 1700 },
90
+ },
91
+ },
92
+ inventory: {
93
+ type: 'object',
94
+ properties: {
95
+ totalStoreCount: { type: 'integer', example: 17684 },
96
+ matchedStoreCount: { type: 'integer', example: 100 },
97
+ inStockStoreCount: { type: 'integer', example: 35 },
98
+ totalStockQuantity: { type: 'integer', example: 90 },
99
+ stores: {
100
+ type: 'array',
101
+ items: { $ref: '#/components/schemas/Gs25Store' },
102
+ },
103
+ },
104
+ },
105
+ },
106
+ },
107
+ },
108
+ },
109
+ };
@@ -0,0 +1,85 @@
1
+ /**
2
+ * OpenAPI 컴포넌트 스키마 정의 (롯데마트)
3
+ */
4
+ export const OPENAPI_LOTTEMART_COMPONENT_SCHEMAS = {
5
+ LotteMartStore: {
6
+ type: 'object',
7
+ properties: {
8
+ area: { type: 'string', example: '서울' },
9
+ storeCode: { type: 'string', example: '2301' },
10
+ storeName: { type: 'string', example: '강변점' },
11
+ brandVariant: { type: 'string', example: 'lottemart' },
12
+ address: { type: 'string', example: '서울 광진구 광나루로 56길 85 테크노마트 B2' },
13
+ phone: { type: 'string', example: '02-3424-2502' },
14
+ openTime: { type: 'string', example: '10:00~23:00' },
15
+ closedDays: { type: 'string', example: '03/08(일), 03/22(일)' },
16
+ parkingType: { type: 'string', example: '유료' },
17
+ parkingDetails: { type: 'string', example: '최초 무료주차 : 1시간' },
18
+ detailUrl: { type: 'string', example: '/mobiledowa/market/detail_shop.asp?werks=2301' },
19
+ latitude: { type: 'number', format: 'float', example: 37.5354 },
20
+ longitude: { type: 'number', format: 'float', example: 127.0958 },
21
+ distanceM: { type: 'number', nullable: true, example: 530 },
22
+ },
23
+ },
24
+ LotteMartProduct: {
25
+ type: 'object',
26
+ properties: {
27
+ area: { type: 'string', example: '서울' },
28
+ storeCode: { type: 'string', example: '2301' },
29
+ storeName: { type: 'string', example: '강변점' },
30
+ keyword: { type: 'string', example: '콜라' },
31
+ productName: { type: 'string', example: '코카콜라' },
32
+ barcode: { type: 'string', example: '8801094011307' },
33
+ spec: { type: 'string', example: '1.2L' },
34
+ manufacturer: { type: 'string', example: '코카콜라음료 주식회사' },
35
+ price: { type: 'integer', example: 2980 },
36
+ stockQuantity: { type: 'integer', example: 20 },
37
+ },
38
+ },
39
+ LotteMartStoreSearchResponse: {
40
+ type: 'object',
41
+ properties: {
42
+ success: { type: 'boolean', example: true },
43
+ data: {
44
+ type: 'object',
45
+ properties: {
46
+ stores: {
47
+ type: 'array',
48
+ items: { $ref: '#/components/schemas/LotteMartStore' },
49
+ },
50
+ },
51
+ },
52
+ meta: {
53
+ type: 'object',
54
+ properties: {
55
+ total: { type: 'integer' },
56
+ page: { type: 'integer' },
57
+ pageSize: { type: 'integer' },
58
+ },
59
+ },
60
+ },
61
+ },
62
+ LotteMartProductSearchResponse: {
63
+ type: 'object',
64
+ properties: {
65
+ success: { type: 'boolean', example: true },
66
+ data: {
67
+ type: 'object',
68
+ properties: {
69
+ products: {
70
+ type: 'array',
71
+ items: { $ref: '#/components/schemas/LotteMartProduct' },
72
+ },
73
+ },
74
+ },
75
+ meta: {
76
+ type: 'object',
77
+ properties: {
78
+ total: { type: 'integer' },
79
+ page: { type: 'integer' },
80
+ pageSize: { type: 'integer' },
81
+ },
82
+ },
83
+ },
84
+ },
85
+ };