របៀបចូលប្រើ Swag Shop របស់ WhiskeyMate និងតាមដានការបញ្ជាទិញរបស់អ្នក

<h2>ទិដ្ឋភាពទូទៅ</h2><p>Swag Shop របស់ WhiskeyMate គឺជាហាងអនឡាញដែលអ្នកអាចបើកពីកម្មវិធីទូរស័ព្ទ។ នៅពេលអ្នកបើកហាងពីក្នុង WhiskeyMate កម្មវិធីនឹងបញ្ជូន Firebase sign-in token បច្ចុប្បន្នរបស់អ្នកទៅកាន់ហាង ដើម្បីឱ្យគេហទំព័រអាចចូលគណនីអ្នកដោយស្វ័យប្រវត្តិ។</p><h2>បើក Swag Shop</h2><ul> <li><strong>iOS</strong>: បើកម៉ឺនុយមេ (ពីតំបន់ collections/profile របស់អ្នក) ហើយចុច <strong>Swag Shop</strong>។ WhiskeyMate នឹងទាញយក Firebase ID token របស់អ្នក ហើយបើក <code>https://whiskeymate.net/store.html?idToken=...</code> នៅក្នុង browser របស់អ្នក។</li> <li><strong>Android</strong>: បើកម៉ឺនុយកម្មវិធី ពង្រីក <strong>Swag Shop</strong> រួចជ្រើសរើស <strong>Store</strong>។ កម្មវិធីនឹងបើក <code>https://whiskeymate.net/store.html?idToken=...</code> នៅក្នុង browser របស់អ្នក។</li></ul><h3>របៀបដែលការចូលគណនីដោយស្វ័យប្រវត្តិដំណើរការ (គេហទំព័រ)</h3><ul> <li>គេហទំព័រ Swag Shop អាន <code>idToken</code> query parameter ហៅ <code>/verify-id-token</code> ដើម្បីប្តូរវាទៅជា Firebase <em>custom token</em> រួចចូលគណនីដោយប្រើ custom token នោះ។</li> <li>បន្ទាប់ពីចូលគណនី គេហទំព័រនឹងលុប <code>idToken</code> ចេញពី URL (ដូច្នេះ token មិននៅជាប់ក្នុង address bar របស់អ្នកទេ)។</li></ul><h2>ការទូទាត់ &amp; ការបំពេញការបញ្ជាទិញ (ទិដ្ឋភាពទូទៅ)</h2><ul> <li><strong>ការទូទាត់</strong>: ការទូទាត់ត្រូវបានគ្រប់គ្រងតាមរយៈ Stripe នៅលើគេហទំព័រ Swag Shop។</li> <li><strong>ការបំពេញការបញ្ជាទិញ</strong>: ផលិតផលត្រូវបានទាញចេញពី Printful ហើយការបញ្ជាទិញត្រូវបានបញ្ជូនទៅ Printful សម្រាប់ការបំពេញ និងការដឹកជញ្ជូន។ ជម្រើសដឹកជញ្ជូនអាស្រ័យលើអាសយដ្ឋានគោលដៅរបស់អ្នក។</li></ul><h2>តាមដានការបញ្ជាទិញរបស់អ្នក (ក្នុងកម្មវិធី)</h2><ul> <li><strong>iOS</strong>: ចុច <strong>Order History</strong> ដើម្បីបើកអេក្រង់ <strong>Order Status</strong> នៅក្នុងកម្មវិធី។</li> <li><strong>Android</strong>: បើកម៉ឺនុយ → <strong>Swag Shop</strong> → <strong>Orders</strong> ដើម្បីបើក <strong>Order Status</strong>។</li></ul><h3>អ្វីដែលអ្នកនឹងឃើញនៅក្នុង Order Status</h3><ul> <li><strong>បញ្ជីការបញ្ជាទិញ</strong>: រាល់ការបញ្ជាទិញនីមួយៗបង្ហាញកាលបរិច្ឆេទ Payment/Intent ID និង status badge។</li> <li><strong>ព័ត៌មានលម្អិតដែលអាចពង្រីកបាន</strong>: មុខទំនិញ (ឈ្មោះ variant × ចំនួន) អាសយដ្ឋានដឹកជញ្ជូន និងអ៊ីមែលណាមួយដែលបានកត់ត្រាសម្រាប់ការបញ្ជាទិញនោះ។</li> <li><strong>កាលវិភាគការបញ្ជាទិញ</strong>: កាលវិភាគមួយជំហានម្តងៗ (Draft → Submitted → Pending → In Progress → Partial → Fulfilled → Shipped) ដោយផ្អែកលើស្ថានភាពការបញ្ជាទិញ។</li> <li><strong>មើលការបញ្ជាទិញពេញលេញ</strong>: បើក <code>https://whiskeymate.net/order-status.html?id=&lt;paymentIntentId&gt;</code> នៅក្នុង browser របស់អ្នក។</li></ul><h2>នៅពីក្រោយឆាក (API ប្រវត្តិការបញ្ជាទិញ)</h2><ul> <li>ទាំង iOS និង Android ទាញយកប្រវត្តិការបញ្ជាទិញរបស់អ្នកដោយបញ្ជូន Firebase ID token របស់អ្នកជា <code>Authorization: Bearer ...</code> header ទៅកាន់ <code>/order-history</code> endpoint របស់គេហទំព័រ WhiskeyMate។</li></ul><h2>ការដោះស្រាយបញ្ហា</h2><ul> <li><strong>ហាងមិនដំណើរការ ឬមិនស្គាល់អ្នក</strong>: ត្រូវប្រាកដថាអ្នកបានចូលគណនី WhiskeyMate រួចបើក Swag Shop ពីក្នុងកម្មវិធីម្តងទៀត ដើម្បីឱ្យវាអាចបញ្ជូន token ថ្មី។</li> <li><strong>មិនមានការបញ្ជាទិញបង្ហាញ</strong>: អេក្រង់ Order Status នឹងបង្ហាញសារ “No orders found” ហើយក៏ផ្តល់ការផ្សព្វផ្សាយទំនិញដើម្បីឱ្យអ្នកអាចរកមើលផលិតផលបាន។</li> <li><strong>ស្ថានភាពហាក់យឺតយ៉ាវ</strong>: ការអាប់ដេតការបំពេញ/ដឹកជញ្ជូនអាស្រ័យលើដំណើរការរបស់អ្នកផ្តល់សេវា ហើយអាចចំណាយពេលដើម្បីបង្ហាញនៅក្នុងកាលវិភាគ។</li></ul>