taiwan-logistics-skill 1.2.2 → 1.3.0

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 (46) hide show
  1. package/README.md +132 -132
  2. package/assets/taiwan-logistics/CLAUDE.md +147 -137
  3. package/assets/taiwan-logistics/EXAMPLES.md +3258 -3258
  4. package/assets/taiwan-logistics/README.md +132 -132
  5. package/assets/taiwan-logistics/SKILL.md +845 -845
  6. package/assets/taiwan-logistics/data/field-mappings.csv +23 -27
  7. package/assets/taiwan-logistics/data/logistics-types.csv +29 -25
  8. package/assets/taiwan-logistics/data/operations.csv +32 -32
  9. package/assets/taiwan-logistics/data/providers.csv +20 -15
  10. package/assets/taiwan-logistics/data/status-codes.csv +89 -35
  11. package/assets/taiwan-logistics/examples/ecpay-logistics-cvs-example.py +175 -175
  12. package/assets/taiwan-logistics/examples/newebpay-logistics-cvs-example.py +524 -524
  13. package/assets/taiwan-logistics/examples/payuni-logistics-cvs-example.py +605 -605
  14. package/assets/taiwan-logistics/examples/store-map-integration-example.html +573 -573
  15. package/assets/taiwan-logistics/references/NEWEBPAY_LOGISTICS_REFERENCE.md +774 -774
  16. package/assets/taiwan-logistics/references/carrier-direct-access.md +134 -0
  17. package/assets/taiwan-logistics/references/ecpay-logistics-api.md +536 -536
  18. package/assets/taiwan-logistics/references/ezship-logistics-api.md +103 -0
  19. package/assets/taiwan-logistics/references/hct-logistics-api.md +1102 -1102
  20. package/assets/taiwan-logistics/references/lalamove-logistics-api.md +138 -0
  21. package/assets/taiwan-logistics/references/paynow-logistics-api.md +1670 -1670
  22. package/assets/taiwan-logistics/references/payuni-logistics-api.md +712 -712
  23. package/assets/taiwan-logistics/references/pchomepay-logistics-api.md +1154 -1154
  24. package/assets/taiwan-logistics/references/smilepay-logistics-api.md +1332 -1332
  25. package/assets/taiwan-logistics/scripts/core.py +276 -276
  26. package/assets/taiwan-logistics/scripts/generate-logistics-service.py +1248 -1248
  27. package/assets/taiwan-logistics/scripts/recommend.py +370 -364
  28. package/assets/taiwan-logistics/scripts/search.py +127 -127
  29. package/assets/taiwan-logistics/scripts/test_logistics.py +300 -300
  30. package/assets/templates/base/quick-reference.md +74 -74
  31. package/assets/templates/base/skill-content.md +845 -845
  32. package/assets/templates/platforms/agent.json +26 -26
  33. package/assets/templates/platforms/claude.json +26 -26
  34. package/assets/templates/platforms/codebuddy.json +25 -25
  35. package/assets/templates/platforms/codex.json +26 -26
  36. package/assets/templates/platforms/continue.json +25 -25
  37. package/assets/templates/platforms/copilot.json +25 -25
  38. package/assets/templates/platforms/cursor.json +26 -26
  39. package/assets/templates/platforms/gemini.json +25 -25
  40. package/assets/templates/platforms/kiro.json +25 -25
  41. package/assets/templates/platforms/opencode.json +25 -25
  42. package/assets/templates/platforms/qoder.json +25 -25
  43. package/assets/templates/platforms/roocode.json +25 -25
  44. package/assets/templates/platforms/trae.json +25 -25
  45. package/assets/templates/platforms/windsurf.json +25 -25
  46. package/package.json +65 -65
@@ -1,573 +1,573 @@
1
- <!DOCTYPE html>
2
- <html lang="zh-TW">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>超商門市地圖整合範例 - Taiwan Logistics Skill</title>
7
- <style>
8
- * {
9
- margin: 0;
10
- padding: 0;
11
- box-sizing: border-box;
12
- }
13
-
14
- body {
15
- font-family: 'Microsoft JhengHei', 'PingFang TC', 'Noto Sans TC', sans-serif;
16
- background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
17
- min-height: 100vh;
18
- padding: 20px;
19
- }
20
-
21
- .container {
22
- max-width: 800px;
23
- margin: 0 auto;
24
- background: white;
25
- border-radius: 16px;
26
- box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
27
- overflow: hidden;
28
- }
29
-
30
- .header {
31
- background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
32
- color: white;
33
- padding: 30px;
34
- text-align: center;
35
- }
36
-
37
- .header h1 {
38
- font-size: 28px;
39
- margin-bottom: 8px;
40
- }
41
-
42
- .header p {
43
- font-size: 14px;
44
- opacity: 0.9;
45
- }
46
-
47
- .content {
48
- padding: 30px;
49
- }
50
-
51
- .section {
52
- margin-bottom: 30px;
53
- }
54
-
55
- .section-title {
56
- font-size: 18px;
57
- font-weight: bold;
58
- margin-bottom: 15px;
59
- color: #333;
60
- display: flex;
61
- align-items: center;
62
- }
63
-
64
- .section-title::before {
65
- content: '';
66
- width: 4px;
67
- height: 20px;
68
- background: #667eea;
69
- margin-right: 10px;
70
- border-radius: 2px;
71
- }
72
-
73
- .form-group {
74
- margin-bottom: 20px;
75
- }
76
-
77
- label {
78
- display: block;
79
- font-size: 14px;
80
- font-weight: 500;
81
- color: #555;
82
- margin-bottom: 8px;
83
- }
84
-
85
- input[type="text"],
86
- select {
87
- width: 100%;
88
- padding: 12px 16px;
89
- border: 2px solid #e0e0e0;
90
- border-radius: 8px;
91
- font-size: 14px;
92
- transition: all 0.3s;
93
- }
94
-
95
- input[type="text"]:focus,
96
- select:focus {
97
- outline: none;
98
- border-color: #667eea;
99
- box-shadow: 0 0 0 3px rgba(102, 126, 234, 0.1);
100
- }
101
-
102
- .button-group {
103
- display: flex;
104
- gap: 10px;
105
- flex-wrap: wrap;
106
- }
107
-
108
- button {
109
- flex: 1;
110
- min-width: 150px;
111
- padding: 14px 24px;
112
- border: none;
113
- border-radius: 8px;
114
- font-size: 14px;
115
- font-weight: 600;
116
- cursor: pointer;
117
- transition: all 0.3s;
118
- }
119
-
120
- .btn-primary {
121
- background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
122
- color: white;
123
- }
124
-
125
- .btn-primary:hover {
126
- transform: translateY(-2px);
127
- box-shadow: 0 10px 20px rgba(102, 126, 234, 0.3);
128
- }
129
-
130
- .btn-secondary {
131
- background: #f0f0f0;
132
- color: #333;
133
- }
134
-
135
- .btn-secondary:hover {
136
- background: #e0e0e0;
137
- }
138
-
139
- .store-info {
140
- background: #f8f9fa;
141
- border-radius: 8px;
142
- padding: 20px;
143
- margin-top: 20px;
144
- display: none;
145
- }
146
-
147
- .store-info.active {
148
- display: block;
149
- animation: slideDown 0.3s ease;
150
- }
151
-
152
- @keyframes slideDown {
153
- from {
154
- opacity: 0;
155
- transform: translateY(-10px);
156
- }
157
- to {
158
- opacity: 1;
159
- transform: translateY(0);
160
- }
161
- }
162
-
163
- .info-row {
164
- display: flex;
165
- padding: 10px 0;
166
- border-bottom: 1px solid #e0e0e0;
167
- }
168
-
169
- .info-row:last-child {
170
- border-bottom: none;
171
- }
172
-
173
- .info-label {
174
- font-weight: 600;
175
- color: #667eea;
176
- min-width: 100px;
177
- }
178
-
179
- .info-value {
180
- color: #333;
181
- }
182
-
183
- .alert {
184
- padding: 15px 20px;
185
- border-radius: 8px;
186
- margin-bottom: 20px;
187
- font-size: 14px;
188
- }
189
-
190
- .alert-info {
191
- background: #e3f2fd;
192
- color: #1976d2;
193
- border-left: 4px solid #1976d2;
194
- }
195
-
196
- .alert-success {
197
- background: #e8f5e9;
198
- color: #388e3c;
199
- border-left: 4px solid #388e3c;
200
- }
201
-
202
- .code-block {
203
- background: #f5f5f5;
204
- border: 1px solid #e0e0e0;
205
- border-radius: 8px;
206
- padding: 15px;
207
- font-family: 'Courier New', monospace;
208
- font-size: 12px;
209
- overflow-x: auto;
210
- margin-top: 15px;
211
- }
212
-
213
- .badge {
214
- display: inline-block;
215
- padding: 4px 12px;
216
- border-radius: 12px;
217
- font-size: 12px;
218
- font-weight: 600;
219
- margin-left: 8px;
220
- }
221
-
222
- .badge-ecpay {
223
- background: #ff9800;
224
- color: white;
225
- }
226
-
227
- .badge-newebpay {
228
- background: #2196f3;
229
- color: white;
230
- }
231
-
232
- .badge-payuni {
233
- background: #4caf50;
234
- color: white;
235
- }
236
-
237
- @media (max-width: 600px) {
238
- .container {
239
- margin: 0;
240
- border-radius: 0;
241
- }
242
-
243
- .content {
244
- padding: 20px;
245
- }
246
-
247
- .button-group {
248
- flex-direction: column;
249
- }
250
-
251
- button {
252
- width: 100%;
253
- }
254
- }
255
- </style>
256
- </head>
257
- <body>
258
- <div class="container">
259
- <div class="header">
260
- <h1>🏪 超商門市地圖整合範例</h1>
261
- <p>Taiwan Logistics Skill - Store Map Integration</p>
262
- </div>
263
-
264
- <div class="content">
265
- <div class="alert alert-info">
266
- <strong>💡 說明:</strong> 此範例展示如何整合超商門市地圖,讓使用者選擇取貨門市。支援 ECPay、NewebPay、PAYUNi 三家物流服務商。
267
- </div>
268
-
269
- <div class="section">
270
- <div class="section-title">1. 選擇物流服務商</div>
271
- <div class="form-group">
272
- <label for="provider">物流服務商</label>
273
- <select id="provider">
274
- <option value="ecpay">ECPay 綠界物流 <span class="badge badge-ecpay">MD5</span></option>
275
- <option value="newebpay">NewebPay 藍新物流 <span class="badge badge-newebpay">AES-256</span></option>
276
- <option value="payuni">PAYUNi 統一物流 <span class="badge badge-payuni">AES-GCM</span></option>
277
- </select>
278
- </div>
279
-
280
- <div class="form-group">
281
- <label for="logisticsType">物流類型</label>
282
- <select id="logisticsType">
283
- <option value="CVS">超商取貨</option>
284
- <option value="Home">宅配到府</option>
285
- </select>
286
- </div>
287
-
288
- <div class="form-group">
289
- <label for="storeType">超商類型</label>
290
- <select id="storeType">
291
- <option value="UNIMART">7-ELEVEN (統一超商)</option>
292
- <option value="FAMI">FamilyMart (全家便利商店)</option>
293
- <option value="HILIFE">Hi-Life (萊爾富)</option>
294
- <option value="OKMART">OK Mart (OK 便利商店)</option>
295
- </select>
296
- </div>
297
- </div>
298
-
299
- <div class="section">
300
- <div class="section-title">2. 訂單資訊</div>
301
- <div class="form-group">
302
- <label for="orderNo">訂單編號</label>
303
- <input type="text" id="orderNo" placeholder="例: ORD20240130001" readonly>
304
- </div>
305
-
306
- <div class="form-group">
307
- <label for="amount">訂單金額 (元)</label>
308
- <input type="text" id="amount" placeholder="例: 1200" value="1200">
309
- </div>
310
- </div>
311
-
312
- <div class="section">
313
- <div class="section-title">3. 開啟門市地圖</div>
314
- <div class="button-group">
315
- <button class="btn-primary" onclick="openStoreMap()">🗺️ 選擇門市</button>
316
- <button class="btn-secondary" onclick="resetForm()">🔄 重置</button>
317
- </div>
318
- </div>
319
-
320
- <div id="storeInfo" class="store-info">
321
- <div class="alert alert-success">
322
- <strong>✓ 門市選擇成功!</strong>
323
- </div>
324
- <div class="info-row">
325
- <div class="info-label">門市代號:</div>
326
- <div class="info-value" id="storeId">-</div>
327
- </div>
328
- <div class="info-row">
329
- <div class="info-label">門市名稱:</div>
330
- <div class="info-value" id="storeName">-</div>
331
- </div>
332
- <div class="info-row">
333
- <div class="info-label">門市地址:</div>
334
- <div class="info-value" id="storeAddress">-</div>
335
- </div>
336
- <div class="info-row">
337
- <div class="info-label">門市電話:</div>
338
- <div class="info-value" id="storePhone">-</div>
339
- </div>
340
- </div>
341
-
342
- <div class="section">
343
- <div class="section-title">4. 後端整合範例</div>
344
- <div class="code-block" id="codeExample"></div>
345
- </div>
346
- </div>
347
- </div>
348
-
349
- <script>
350
- // 生成唯一訂單編號
351
- function generateOrderNo() {
352
- const timestamp = Date.now();
353
- const random = Math.floor(Math.random() * 1000).toString().padStart(3, '0');
354
- return `ORD${timestamp}${random}`;
355
- }
356
-
357
- // 初始化訂單編號
358
- document.getElementById('orderNo').value = generateOrderNo();
359
-
360
- // 開啟門市地圖
361
- function openStoreMap() {
362
- const provider = document.getElementById('provider').value;
363
- const storeType = document.getElementById('storeType').value;
364
- const orderNo = document.getElementById('orderNo').value;
365
-
366
- if (!orderNo) {
367
- alert('請輸入訂單編號');
368
- return;
369
- }
370
-
371
- // 在實際應用中,這裡會呼叫後端 API 取得門市地圖表單
372
- // 然後開啟新視窗顯示門市地圖
373
-
374
- // 模擬門市選擇
375
- simulateStoreSelection();
376
-
377
- // 更新程式碼範例
378
- updateCodeExample(provider, storeType, orderNo);
379
- }
380
-
381
- // 模擬門市選擇 (實際上會從回呼取得)
382
- function simulateStoreSelection() {
383
- setTimeout(() => {
384
- const storeType = document.getElementById('storeType').value;
385
- const mockStores = {
386
- 'UNIMART': {
387
- id: '991182',
388
- name: '統一超商 信義門市',
389
- address: '台北市信義區信義路五段7號',
390
- phone: '02-2723-4567'
391
- },
392
- 'FAMI': {
393
- id: '001779',
394
- name: '全家便利商店 台北信義店',
395
- address: '台北市信義區松仁路100號',
396
- phone: '02-2723-8901'
397
- },
398
- 'HILIFE': {
399
- id: '001234',
400
- name: '萊爾富 信義門市',
401
- address: '台北市信義區基隆路一段200號',
402
- phone: '02-2723-5678'
403
- },
404
- 'OKMART': {
405
- id: '100456',
406
- name: 'OK 便利商店 信義店',
407
- address: '台北市信義區松壽路18號',
408
- phone: '02-2723-6789'
409
- }
410
- };
411
-
412
- const selectedStore = mockStores[storeType];
413
-
414
- document.getElementById('storeId').textContent = selectedStore.id;
415
- document.getElementById('storeName').textContent = selectedStore.name;
416
- document.getElementById('storeAddress').textContent = selectedStore.address;
417
- document.getElementById('storePhone').textContent = selectedStore.phone;
418
-
419
- document.getElementById('storeInfo').classList.add('active');
420
- }, 1000);
421
- }
422
-
423
- // 更新程式碼範例
424
- function updateCodeExample(provider, storeType, orderNo) {
425
- const examples = {
426
- ecpay: `# ECPay 綠界物流 - 門市地圖整合
427
-
428
- from ecpay_logistics import ECPayLogisticsService
429
-
430
- # 1. 初始化服務
431
- service = ECPayLogisticsService(
432
- merchant_id='YOUR_MERCHANT_ID',
433
- hash_key='YOUR_HASH_KEY',
434
- hash_iv='YOUR_HASH_IV',
435
- is_test=True
436
- )
437
-
438
- # 2. 取得門市地圖 HTML
439
- map_html = service.get_cvs_map(StoreMapData(
440
- merchant_trade_no='${orderNo}',
441
- logistics_sub_type='${storeType}',
442
- is_collection='Y',
443
- server_reply_url='https://your-domain.com/api/logistics/map-callback'
444
- ))
445
-
446
- # 3. 回傳 HTML 給前端 (開啟新視窗)
447
- return {'html': map_html}
448
-
449
- # 4. 處理門市選擇回呼
450
- @app.post('/api/logistics/map-callback')
451
- def handle_map_callback(request):
452
- store_id = request.form.get('CVSStoreID')
453
- store_name = request.form.get('CVSStoreName')
454
- store_address = request.form.get('CVSAddress')
455
- store_phone = request.form.get('CVSTelephone')
456
-
457
- # 儲存門市資訊到訂單
458
- update_order_store_info(
459
- order_no='${orderNo}',
460
- store_id=store_id,
461
- store_name=store_name
462
- )
463
-
464
- return '1|OK' # 回應成功`,
465
-
466
- newebpay: `# NewebPay 藍新物流 - 門市地圖整合
467
-
468
- from newebpay_logistics import NewebPayLogisticsService
469
-
470
- # 1. 初始化服務
471
- service = NewebPayLogisticsService(
472
- merchant_id='YOUR_MERCHANT_ID',
473
- hash_key='YOUR_HASH_KEY',
474
- hash_iv='YOUR_HASH_IV',
475
- is_test=True
476
- )
477
-
478
- # 2. 取得門市地圖 HTML
479
- map_html = service.get_store_map(StoreMapData(
480
- merchant_order_no='${orderNo}',
481
- logistics_type='C2C',
482
- store_type='${storeType === 'UNIMART' ? '1' : storeType === 'FAMI' ? '2' : storeType === 'HILIFE' ? '3' : '4'}',
483
- return_url='https://your-domain.com/api/logistics/map-callback'
484
- ))
485
-
486
- # 3. 回傳 HTML 給前端
487
- return {'html': map_html}
488
-
489
- # 4. 處理門市選擇回呼
490
- @app.post('/api/logistics/map-callback')
491
- def handle_map_callback(request):
492
- # NewebPay 回傳加密資料,需先解密
493
- encrypt_data = request.form.get('EncryptData_')
494
- hash_data = request.form.get('HashData_')
495
-
496
- # 驗證並解密
497
- if service.verify_callback(encrypt_data, hash_data):
498
- data = service.decrypt(encrypt_data)
499
- store_id = data.get('StoreID')
500
- store_name = data.get('StoreName')
501
-
502
- # 儲存門市資訊
503
- update_order_store_info('${orderNo}', store_id, store_name)
504
-
505
- return '1|OK'`,
506
-
507
- payuni: `# PAYUNi 統一物流 - 門市地圖整合
508
-
509
- from payuni_logistics import PAYUNiLogisticsService
510
-
511
- # 1. 初始化服務
512
- service = PAYUNiLogisticsService(
513
- merchant_id='YOUR_MERCHANT_ID',
514
- hash_key='YOUR_HASH_KEY',
515
- hash_iv='YOUR_HASH_IV',
516
- is_test=True
517
- )
518
-
519
- # 2. 取得門市地圖 URL (PAYUNi 使用 RESTful API)
520
- map_url = service.get_store_map_url(
521
- merchant_trade_no='${orderNo}',
522
- logistics_type='PAYUNi_Logistic_711',
523
- callback_url='https://your-domain.com/api/logistics/map-callback'
524
- )
525
-
526
- # 3. 回傳 URL 給前端 (重定向到門市地圖)
527
- return {'url': map_url}
528
-
529
- # 4. 處理門市選擇回呼
530
- @app.post('/api/logistics/map-callback')
531
- def handle_map_callback(request):
532
- # PAYUNi 回傳 JSON
533
- data = request.json
534
-
535
- store_id = data.get('ReceiverStoreID')
536
- store_name = data.get('ReceiverStoreName')
537
- store_address = data.get('ReceiverStoreAddress')
538
-
539
- # 儲存門市資訊
540
- update_order_store_info(
541
- order_no='${orderNo}',
542
- store_id=store_id,
543
- store_name=store_name,
544
- store_address=store_address
545
- )
546
-
547
- return {'status': 'SUCCESS'}`
548
- };
549
-
550
- document.getElementById('codeExample').textContent = examples[provider];
551
- }
552
-
553
- // 重置表單
554
- function resetForm() {
555
- document.getElementById('orderNo').value = generateOrderNo();
556
- document.getElementById('amount').value = '1200';
557
- document.getElementById('storeInfo').classList.remove('active');
558
- document.getElementById('codeExample').textContent = '';
559
- }
560
-
561
- // 初始化程式碼範例
562
- updateCodeExample('ecpay', 'UNIMART', document.getElementById('orderNo').value);
563
-
564
- // 監聽服務商變更
565
- document.getElementById('provider').addEventListener('change', function() {
566
- const provider = this.value;
567
- const storeType = document.getElementById('storeType').value;
568
- const orderNo = document.getElementById('orderNo').value;
569
- updateCodeExample(provider, storeType, orderNo);
570
- });
571
- </script>
572
- </body>
573
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="zh-TW">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>超商門市地圖整合範例 - Taiwan Logistics Skill</title>
7
+ <style>
8
+ * {
9
+ margin: 0;
10
+ padding: 0;
11
+ box-sizing: border-box;
12
+ }
13
+
14
+ body {
15
+ font-family: 'Microsoft JhengHei', 'PingFang TC', 'Noto Sans TC', sans-serif;
16
+ background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
17
+ min-height: 100vh;
18
+ padding: 20px;
19
+ }
20
+
21
+ .container {
22
+ max-width: 800px;
23
+ margin: 0 auto;
24
+ background: white;
25
+ border-radius: 16px;
26
+ box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
27
+ overflow: hidden;
28
+ }
29
+
30
+ .header {
31
+ background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
32
+ color: white;
33
+ padding: 30px;
34
+ text-align: center;
35
+ }
36
+
37
+ .header h1 {
38
+ font-size: 28px;
39
+ margin-bottom: 8px;
40
+ }
41
+
42
+ .header p {
43
+ font-size: 14px;
44
+ opacity: 0.9;
45
+ }
46
+
47
+ .content {
48
+ padding: 30px;
49
+ }
50
+
51
+ .section {
52
+ margin-bottom: 30px;
53
+ }
54
+
55
+ .section-title {
56
+ font-size: 18px;
57
+ font-weight: bold;
58
+ margin-bottom: 15px;
59
+ color: #333;
60
+ display: flex;
61
+ align-items: center;
62
+ }
63
+
64
+ .section-title::before {
65
+ content: '';
66
+ width: 4px;
67
+ height: 20px;
68
+ background: #667eea;
69
+ margin-right: 10px;
70
+ border-radius: 2px;
71
+ }
72
+
73
+ .form-group {
74
+ margin-bottom: 20px;
75
+ }
76
+
77
+ label {
78
+ display: block;
79
+ font-size: 14px;
80
+ font-weight: 500;
81
+ color: #555;
82
+ margin-bottom: 8px;
83
+ }
84
+
85
+ input[type="text"],
86
+ select {
87
+ width: 100%;
88
+ padding: 12px 16px;
89
+ border: 2px solid #e0e0e0;
90
+ border-radius: 8px;
91
+ font-size: 14px;
92
+ transition: all 0.3s;
93
+ }
94
+
95
+ input[type="text"]:focus,
96
+ select:focus {
97
+ outline: none;
98
+ border-color: #667eea;
99
+ box-shadow: 0 0 0 3px rgba(102, 126, 234, 0.1);
100
+ }
101
+
102
+ .button-group {
103
+ display: flex;
104
+ gap: 10px;
105
+ flex-wrap: wrap;
106
+ }
107
+
108
+ button {
109
+ flex: 1;
110
+ min-width: 150px;
111
+ padding: 14px 24px;
112
+ border: none;
113
+ border-radius: 8px;
114
+ font-size: 14px;
115
+ font-weight: 600;
116
+ cursor: pointer;
117
+ transition: all 0.3s;
118
+ }
119
+
120
+ .btn-primary {
121
+ background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
122
+ color: white;
123
+ }
124
+
125
+ .btn-primary:hover {
126
+ transform: translateY(-2px);
127
+ box-shadow: 0 10px 20px rgba(102, 126, 234, 0.3);
128
+ }
129
+
130
+ .btn-secondary {
131
+ background: #f0f0f0;
132
+ color: #333;
133
+ }
134
+
135
+ .btn-secondary:hover {
136
+ background: #e0e0e0;
137
+ }
138
+
139
+ .store-info {
140
+ background: #f8f9fa;
141
+ border-radius: 8px;
142
+ padding: 20px;
143
+ margin-top: 20px;
144
+ display: none;
145
+ }
146
+
147
+ .store-info.active {
148
+ display: block;
149
+ animation: slideDown 0.3s ease;
150
+ }
151
+
152
+ @keyframes slideDown {
153
+ from {
154
+ opacity: 0;
155
+ transform: translateY(-10px);
156
+ }
157
+ to {
158
+ opacity: 1;
159
+ transform: translateY(0);
160
+ }
161
+ }
162
+
163
+ .info-row {
164
+ display: flex;
165
+ padding: 10px 0;
166
+ border-bottom: 1px solid #e0e0e0;
167
+ }
168
+
169
+ .info-row:last-child {
170
+ border-bottom: none;
171
+ }
172
+
173
+ .info-label {
174
+ font-weight: 600;
175
+ color: #667eea;
176
+ min-width: 100px;
177
+ }
178
+
179
+ .info-value {
180
+ color: #333;
181
+ }
182
+
183
+ .alert {
184
+ padding: 15px 20px;
185
+ border-radius: 8px;
186
+ margin-bottom: 20px;
187
+ font-size: 14px;
188
+ }
189
+
190
+ .alert-info {
191
+ background: #e3f2fd;
192
+ color: #1976d2;
193
+ border-left: 4px solid #1976d2;
194
+ }
195
+
196
+ .alert-success {
197
+ background: #e8f5e9;
198
+ color: #388e3c;
199
+ border-left: 4px solid #388e3c;
200
+ }
201
+
202
+ .code-block {
203
+ background: #f5f5f5;
204
+ border: 1px solid #e0e0e0;
205
+ border-radius: 8px;
206
+ padding: 15px;
207
+ font-family: 'Courier New', monospace;
208
+ font-size: 12px;
209
+ overflow-x: auto;
210
+ margin-top: 15px;
211
+ }
212
+
213
+ .badge {
214
+ display: inline-block;
215
+ padding: 4px 12px;
216
+ border-radius: 12px;
217
+ font-size: 12px;
218
+ font-weight: 600;
219
+ margin-left: 8px;
220
+ }
221
+
222
+ .badge-ecpay {
223
+ background: #ff9800;
224
+ color: white;
225
+ }
226
+
227
+ .badge-newebpay {
228
+ background: #2196f3;
229
+ color: white;
230
+ }
231
+
232
+ .badge-payuni {
233
+ background: #4caf50;
234
+ color: white;
235
+ }
236
+
237
+ @media (max-width: 600px) {
238
+ .container {
239
+ margin: 0;
240
+ border-radius: 0;
241
+ }
242
+
243
+ .content {
244
+ padding: 20px;
245
+ }
246
+
247
+ .button-group {
248
+ flex-direction: column;
249
+ }
250
+
251
+ button {
252
+ width: 100%;
253
+ }
254
+ }
255
+ </style>
256
+ </head>
257
+ <body>
258
+ <div class="container">
259
+ <div class="header">
260
+ <h1>🏪 超商門市地圖整合範例</h1>
261
+ <p>Taiwan Logistics Skill - Store Map Integration</p>
262
+ </div>
263
+
264
+ <div class="content">
265
+ <div class="alert alert-info">
266
+ <strong>💡 說明:</strong> 此範例展示如何整合超商門市地圖,讓使用者選擇取貨門市。支援 ECPay、NewebPay、PAYUNi 三家物流服務商。
267
+ </div>
268
+
269
+ <div class="section">
270
+ <div class="section-title">1. 選擇物流服務商</div>
271
+ <div class="form-group">
272
+ <label for="provider">物流服務商</label>
273
+ <select id="provider">
274
+ <option value="ecpay">ECPay 綠界物流 <span class="badge badge-ecpay">MD5</span></option>
275
+ <option value="newebpay">NewebPay 藍新物流 <span class="badge badge-newebpay">AES-256</span></option>
276
+ <option value="payuni">PAYUNi 統一物流 <span class="badge badge-payuni">AES-GCM</span></option>
277
+ </select>
278
+ </div>
279
+
280
+ <div class="form-group">
281
+ <label for="logisticsType">物流類型</label>
282
+ <select id="logisticsType">
283
+ <option value="CVS">超商取貨</option>
284
+ <option value="Home">宅配到府</option>
285
+ </select>
286
+ </div>
287
+
288
+ <div class="form-group">
289
+ <label for="storeType">超商類型</label>
290
+ <select id="storeType">
291
+ <option value="UNIMART">7-ELEVEN (統一超商)</option>
292
+ <option value="FAMI">FamilyMart (全家便利商店)</option>
293
+ <option value="HILIFE">Hi-Life (萊爾富)</option>
294
+ <option value="OKMART">OK Mart (OK 便利商店)</option>
295
+ </select>
296
+ </div>
297
+ </div>
298
+
299
+ <div class="section">
300
+ <div class="section-title">2. 訂單資訊</div>
301
+ <div class="form-group">
302
+ <label for="orderNo">訂單編號</label>
303
+ <input type="text" id="orderNo" placeholder="例: ORD20240130001" readonly>
304
+ </div>
305
+
306
+ <div class="form-group">
307
+ <label for="amount">訂單金額 (元)</label>
308
+ <input type="text" id="amount" placeholder="例: 1200" value="1200">
309
+ </div>
310
+ </div>
311
+
312
+ <div class="section">
313
+ <div class="section-title">3. 開啟門市地圖</div>
314
+ <div class="button-group">
315
+ <button class="btn-primary" onclick="openStoreMap()">🗺️ 選擇門市</button>
316
+ <button class="btn-secondary" onclick="resetForm()">🔄 重置</button>
317
+ </div>
318
+ </div>
319
+
320
+ <div id="storeInfo" class="store-info">
321
+ <div class="alert alert-success">
322
+ <strong>✓ 門市選擇成功!</strong>
323
+ </div>
324
+ <div class="info-row">
325
+ <div class="info-label">門市代號:</div>
326
+ <div class="info-value" id="storeId">-</div>
327
+ </div>
328
+ <div class="info-row">
329
+ <div class="info-label">門市名稱:</div>
330
+ <div class="info-value" id="storeName">-</div>
331
+ </div>
332
+ <div class="info-row">
333
+ <div class="info-label">門市地址:</div>
334
+ <div class="info-value" id="storeAddress">-</div>
335
+ </div>
336
+ <div class="info-row">
337
+ <div class="info-label">門市電話:</div>
338
+ <div class="info-value" id="storePhone">-</div>
339
+ </div>
340
+ </div>
341
+
342
+ <div class="section">
343
+ <div class="section-title">4. 後端整合範例</div>
344
+ <div class="code-block" id="codeExample"></div>
345
+ </div>
346
+ </div>
347
+ </div>
348
+
349
+ <script>
350
+ // 生成唯一訂單編號
351
+ function generateOrderNo() {
352
+ const timestamp = Date.now();
353
+ const random = Math.floor(Math.random() * 1000).toString().padStart(3, '0');
354
+ return `ORD${timestamp}${random}`;
355
+ }
356
+
357
+ // 初始化訂單編號
358
+ document.getElementById('orderNo').value = generateOrderNo();
359
+
360
+ // 開啟門市地圖
361
+ function openStoreMap() {
362
+ const provider = document.getElementById('provider').value;
363
+ const storeType = document.getElementById('storeType').value;
364
+ const orderNo = document.getElementById('orderNo').value;
365
+
366
+ if (!orderNo) {
367
+ alert('請輸入訂單編號');
368
+ return;
369
+ }
370
+
371
+ // 在實際應用中,這裡會呼叫後端 API 取得門市地圖表單
372
+ // 然後開啟新視窗顯示門市地圖
373
+
374
+ // 模擬門市選擇
375
+ simulateStoreSelection();
376
+
377
+ // 更新程式碼範例
378
+ updateCodeExample(provider, storeType, orderNo);
379
+ }
380
+
381
+ // 模擬門市選擇 (實際上會從回呼取得)
382
+ function simulateStoreSelection() {
383
+ setTimeout(() => {
384
+ const storeType = document.getElementById('storeType').value;
385
+ const mockStores = {
386
+ 'UNIMART': {
387
+ id: '991182',
388
+ name: '統一超商 信義門市',
389
+ address: '台北市信義區信義路五段7號',
390
+ phone: '02-2723-4567'
391
+ },
392
+ 'FAMI': {
393
+ id: '001779',
394
+ name: '全家便利商店 台北信義店',
395
+ address: '台北市信義區松仁路100號',
396
+ phone: '02-2723-8901'
397
+ },
398
+ 'HILIFE': {
399
+ id: '001234',
400
+ name: '萊爾富 信義門市',
401
+ address: '台北市信義區基隆路一段200號',
402
+ phone: '02-2723-5678'
403
+ },
404
+ 'OKMART': {
405
+ id: '100456',
406
+ name: 'OK 便利商店 信義店',
407
+ address: '台北市信義區松壽路18號',
408
+ phone: '02-2723-6789'
409
+ }
410
+ };
411
+
412
+ const selectedStore = mockStores[storeType];
413
+
414
+ document.getElementById('storeId').textContent = selectedStore.id;
415
+ document.getElementById('storeName').textContent = selectedStore.name;
416
+ document.getElementById('storeAddress').textContent = selectedStore.address;
417
+ document.getElementById('storePhone').textContent = selectedStore.phone;
418
+
419
+ document.getElementById('storeInfo').classList.add('active');
420
+ }, 1000);
421
+ }
422
+
423
+ // 更新程式碼範例
424
+ function updateCodeExample(provider, storeType, orderNo) {
425
+ const examples = {
426
+ ecpay: `# ECPay 綠界物流 - 門市地圖整合
427
+
428
+ from ecpay_logistics import ECPayLogisticsService
429
+
430
+ # 1. 初始化服務
431
+ service = ECPayLogisticsService(
432
+ merchant_id='YOUR_MERCHANT_ID',
433
+ hash_key='YOUR_HASH_KEY',
434
+ hash_iv='YOUR_HASH_IV',
435
+ is_test=True
436
+ )
437
+
438
+ # 2. 取得門市地圖 HTML
439
+ map_html = service.get_cvs_map(StoreMapData(
440
+ merchant_trade_no='${orderNo}',
441
+ logistics_sub_type='${storeType}',
442
+ is_collection='Y',
443
+ server_reply_url='https://your-domain.com/api/logistics/map-callback'
444
+ ))
445
+
446
+ # 3. 回傳 HTML 給前端 (開啟新視窗)
447
+ return {'html': map_html}
448
+
449
+ # 4. 處理門市選擇回呼
450
+ @app.post('/api/logistics/map-callback')
451
+ def handle_map_callback(request):
452
+ store_id = request.form.get('CVSStoreID')
453
+ store_name = request.form.get('CVSStoreName')
454
+ store_address = request.form.get('CVSAddress')
455
+ store_phone = request.form.get('CVSTelephone')
456
+
457
+ # 儲存門市資訊到訂單
458
+ update_order_store_info(
459
+ order_no='${orderNo}',
460
+ store_id=store_id,
461
+ store_name=store_name
462
+ )
463
+
464
+ return '1|OK' # 回應成功`,
465
+
466
+ newebpay: `# NewebPay 藍新物流 - 門市地圖整合
467
+
468
+ from newebpay_logistics import NewebPayLogisticsService
469
+
470
+ # 1. 初始化服務
471
+ service = NewebPayLogisticsService(
472
+ merchant_id='YOUR_MERCHANT_ID',
473
+ hash_key='YOUR_HASH_KEY',
474
+ hash_iv='YOUR_HASH_IV',
475
+ is_test=True
476
+ )
477
+
478
+ # 2. 取得門市地圖 HTML
479
+ map_html = service.get_store_map(StoreMapData(
480
+ merchant_order_no='${orderNo}',
481
+ logistics_type='C2C',
482
+ store_type='${storeType === 'UNIMART' ? '1' : storeType === 'FAMI' ? '2' : storeType === 'HILIFE' ? '3' : '4'}',
483
+ return_url='https://your-domain.com/api/logistics/map-callback'
484
+ ))
485
+
486
+ # 3. 回傳 HTML 給前端
487
+ return {'html': map_html}
488
+
489
+ # 4. 處理門市選擇回呼
490
+ @app.post('/api/logistics/map-callback')
491
+ def handle_map_callback(request):
492
+ # NewebPay 回傳加密資料,需先解密
493
+ encrypt_data = request.form.get('EncryptData_')
494
+ hash_data = request.form.get('HashData_')
495
+
496
+ # 驗證並解密
497
+ if service.verify_callback(encrypt_data, hash_data):
498
+ data = service.decrypt(encrypt_data)
499
+ store_id = data.get('StoreID')
500
+ store_name = data.get('StoreName')
501
+
502
+ # 儲存門市資訊
503
+ update_order_store_info('${orderNo}', store_id, store_name)
504
+
505
+ return '1|OK'`,
506
+
507
+ payuni: `# PAYUNi 統一物流 - 門市地圖整合
508
+
509
+ from payuni_logistics import PAYUNiLogisticsService
510
+
511
+ # 1. 初始化服務
512
+ service = PAYUNiLogisticsService(
513
+ merchant_id='YOUR_MERCHANT_ID',
514
+ hash_key='YOUR_HASH_KEY',
515
+ hash_iv='YOUR_HASH_IV',
516
+ is_test=True
517
+ )
518
+
519
+ # 2. 取得門市地圖 URL (PAYUNi 使用 RESTful API)
520
+ map_url = service.get_store_map_url(
521
+ merchant_trade_no='${orderNo}',
522
+ logistics_type='PAYUNi_Logistic_711',
523
+ callback_url='https://your-domain.com/api/logistics/map-callback'
524
+ )
525
+
526
+ # 3. 回傳 URL 給前端 (重定向到門市地圖)
527
+ return {'url': map_url}
528
+
529
+ # 4. 處理門市選擇回呼
530
+ @app.post('/api/logistics/map-callback')
531
+ def handle_map_callback(request):
532
+ # PAYUNi 回傳 JSON
533
+ data = request.json
534
+
535
+ store_id = data.get('ReceiverStoreID')
536
+ store_name = data.get('ReceiverStoreName')
537
+ store_address = data.get('ReceiverStoreAddress')
538
+
539
+ # 儲存門市資訊
540
+ update_order_store_info(
541
+ order_no='${orderNo}',
542
+ store_id=store_id,
543
+ store_name=store_name,
544
+ store_address=store_address
545
+ )
546
+
547
+ return {'status': 'SUCCESS'}`
548
+ };
549
+
550
+ document.getElementById('codeExample').textContent = examples[provider];
551
+ }
552
+
553
+ // 重置表單
554
+ function resetForm() {
555
+ document.getElementById('orderNo').value = generateOrderNo();
556
+ document.getElementById('amount').value = '1200';
557
+ document.getElementById('storeInfo').classList.remove('active');
558
+ document.getElementById('codeExample').textContent = '';
559
+ }
560
+
561
+ // 初始化程式碼範例
562
+ updateCodeExample('ecpay', 'UNIMART', document.getElementById('orderNo').value);
563
+
564
+ // 監聽服務商變更
565
+ document.getElementById('provider').addEventListener('change', function() {
566
+ const provider = this.value;
567
+ const storeType = document.getElementById('storeType').value;
568
+ const orderNo = document.getElementById('orderNo').value;
569
+ updateCodeExample(provider, storeType, orderNo);
570
+ });
571
+ </script>
572
+ </body>
573
+ </html>