# កម្មវិធី ហាងលក់ទំនិញ មួយរៀល POS (Muyreal Store POS) - Pro Edition
កម្មវិធីគ្រប់គ្រងការលក់ និងគិតលុយ (Point of Sale - POS) បែបទំនើបសម្រាប់ **ហាងលក់ទំនិញ មួយរៀល (MUYREAL STORE)** បង្កើតឡើងដោយប្រើប្រាស់ **Python & PyQt6** ជាមួយមុខងារទំនើបៗតាមស្តង់ដារវិជ្ជាជីវៈ៖
---
## 🌟 មុខងារសំខាន់ៗដែលត្រូវបានអាប់ដេតថ្មី (Key Upgrades)
### 1. 🎨 មានពណ៌ច្រើនសម្រាប់ជ្រើសរើស (Multi-Color Themes & Background Colors)
- **បណ្តុំពណ៌ Theme ស្រស់ស្អាត (Theme Palettes)**៖
- 🌿 **Fresh Emerald**: បៃតងស្រស់ថ្លា បែបម៉ាតទំនើប (លំនាំដើម)
- 🌊 **Ocean Blue**: ខៀវមហាសមុទ្រ បែបបច្ចេកវិទ្យា
- 🌅 **Sunset Amber**: ទឹកក្រូចរស់រវើក បែបហាងលក់រាយ
- 🔮 **Royal Purple**: ស្វាយប្រណីត បែប Boutique
- 🌸 **Rose Berry**: ផ្កាឈូកទាន់សម័យ
- 🌌 **Obsidian Midnight**: ខ្មៅរលោង Premium
- ☕ **Warm Coffee & Wood**: កាហ្វេ និងឈើប្រណីត
- ☀️ **Pure Snow White**: សស្អាត Minimalist
- 👑 **Luxury Gold VIP**: មាសប្រណីត VIP
- 🍃 **Deep Forest Sage**: បៃតងព្រៃឈើ
- **🖼️ ជម្រើសពណ៌ផ្ទៃខាងក្រោយ (Selectable Background Colors)**៖
- ⚪ **សសុទ្ធ (Pure White - `#ffffff`)**
- 🌿 **បៃតងខ្ចីស្រទន់ (Soft Mint - `#f0fdf4`)**
- 🌊 **ខៀវខ្ចីស្រទន់ (Soft Sky - `#f0f9ff`)**
- 🌅 **ទឹកដោះគោស្រាល (Warm Cream - `#fffbeb`)**
- ☕ **ឡាតេកក់ក្តៅ (Warm Latte - `#fbf8f5`)**
- 🌸 **ផ្កាឈូកស្រាល (Soft Rose - `#fff1f2`)**
- 🔮 **ស្វាយខ្ចី (Soft Lavender - `#faf5ff`)**
- 🍃 **បៃតងស្លឹកឈើ (Sage Green - `#f2f7f4`)**
- ☁️ **ប្រផេះស្រាល Minimalist (Cool Slate - `#f1f5f9`)**
- 🌌 **ខ្មៅរលោង (Obsidian Dark - `#070b12`)**
- 🌑 **ធ្យូងខ្មៅ (Charcoal Dark - `#111827`)**
- 🎨 **ជ្រើសរើសពណ៌ផ្ទាល់ខ្លួនតាមចិត្ត (Custom Color Picker via QColorDialog)**
- គាំទ្រទាំង **☀️ Light Mode** និង **🌙 Dark Mode**
- **🖥️ បង្អួចអេក្រង់ធម្មតាពេលបើក (Normal Screen Resolution Startup)**៖
- ពេលបើកកម្មវិធី វានឹងបើកជា **បង្អួចអេក្រង់ធម្មតា (Normal Resolution ~1240x700)** នៅកណ្តាលអេក្រង់ ងាយស្រួលប្រើប្រាស់ មិនបាំង Taskbar ឬធ្លាក់ប៊ូតុងចុះក្រោម
- អាចចុច **⛶ ពេញអេក្រង់** ឬគ្រាប់ចុចកាត់ **F11** ដើម្បីប្តូរទៅ Kiosk Fullscreen និងប្តូរត្រឡប់មកវិញបានគ្រប់ពេល!
### 2. 📊 របាយការណ៍ទំនិញក្នុងស្តុក & ការលក់ (Sales & Inventory Analytics)
- **ផ្ទាំងរបាយការណ៍លក់ (Sales History)**:
- ស្ថិតិចំណូលសរុប, ចំណូលថ្ងៃនេះ, ចំនួនវិក្កយបត្រសរុប
- ត្រងទិន្នន័យតាម: ថ្ងៃនេះ, សប្តាហ៍នេះ, ខែនេះ, ទាំងអស់
- មើលវិក្កយបត្រឡើងវិញ និង Export ជារបាយការណ៍ **CSV / Excel**
- **ផ្ទាំងរបាយការណ៍ស្តុកទំនិញ (Inventory Stock Report)**:
- បង្ហាញចំនួនទំនិញក្នុងស្តុកសរុប (Total Units)
- ជូនដំណឹងទំនិញជិតអស់ (Low Stock ≤ 5) និងអស់ពីស្តុក (Out of Stock = 0)
- គណនាថ្លៃដើមទុនសរុប ($ Cost), តម្លៃលក់សរុប ($ Retail) និងប្រាក់ចំណេញរំពឹងទុក ($ Profit)
- ផ្លាកសញ្ញាស្ថានភាពស្តុក: 🟢 ស្តុកគ្រប់គ្រាន់ | 🟡 ជិតអស់ | 🔴 អស់ពីស្តុក
- ប៊ូតុង **➕ ថែមស្តុក (Quick Restock)** បញ្ចូលចំនួនស្តុកបានភ្លាមៗក្នុងតារាង
- Export បញ្ជីស្តុកទំនិញជាឯកសារ **CSV**
### 3. 🧾 វិក្កយបត្រអាចផ្លាស់ប្តូរស្តាយបាន ៤ បែប (4 Customizable Receipt Styles)
- អាចជ្រើសរើស និងមើលគំរូទម្រង់វិក្កយបត្របានភ្លាមៗ៖
1. 🌟 **ទម្រង់ទំនើប 80mm (Modern Clean)**: ស្រឡះភ្នែក រចនាបថទាន់សម័យ
2. 📜 **ទម្រង់បែបប្រពៃណី 80mm (Classic Retail)**: បែបបន្ទាត់ដាច់ៗ ម៉ាស៊ីនកម្ដៅបុរាណ
3. 🎫 **ទម្រង់បង្រួមតូច 58mm (Compact Minimalist)**: សម្រាប់ម៉ាស៊ីនព្រីនទំហំតូច 58mm សន្សំក្រដាស
4. 💎 **ទម្រង់ប្រណីត (Elegant Boutique)**: បែបហាងទំនិញប្រណីត មានរបារពណ៌ស្អាត
- ប៊ូតុង **⭐ ដាក់ជាលំនាំដើម** ដើម្បីកំណត់ស្តាយដែលចូលចិត្តសម្រាប់ចេញលើកក្រោយៗ
- គាំទ្រការបោះពុម្ពទៅកាន់ Printer ឬ Save ជាឯកសារ **PDF**
### 4. 📦 កំណត់មុខទំនិញបានច្រើនបែប ឬតែមួយទៅតាមម្ចាស់ហាង (Multi-Variants)
- គាំទ្រទាំង **ទំនិញទោល (Single Item)** និង **ទំនិញមានជម្រើសច្រើន (Multi-variant)**
- អាចកំណត់ Option ដូចជា៖ ទំហំ (Size S, M, L), ពណ៌, កម្រិតជាតិស្ករ, ក្តៅ/ត្រជាក់...
- កំណត់តម្លៃបន្ថែមលើ Option នីមួយៗ (+Extra USD), បាកូដ និងស្តុកដាច់ដោយឡែក
- ផ្ទាំង **Variant Selection Dialog** នឹងលោតឡើងស្វ័យប្រវត្តពេលចុច ឬស្កេន ដើម្បីជ្រើសរើសរហ័ស
### 5. 🎯 ភ្ជាប់ទៅជាមួយម៉ាស៊ីនស្កេនបាកូដ (Barcode Scanner Integration)
- ស្កេនបាកូដទំនិញចូលកន្ត្រកភ្លាមៗ ដោយមិនបាច់ប៉ះ Mouse
- ស្គាល់ទាំងបាកូដទំនិញទោល និងបាកូដជម្រើស (Variant Barcodes)
- មានសំឡេង **Beep Audio Feedback** ពេលស្កេនចូលជោគជ័យ
- ជម្រះអក្សរស្វ័យប្រវត្តក្នុងប្រអប់ Search ដើម្បីត្រៀមស្កេនមុខបន្ទាប់
### 6. 📱 Dynamic KHQR Code Total លើវិក្កយបត្រ (Dynamic QR to Invoice)
- បង្កើតកូដ **EMVCo Dynamic KHQR** ស្វ័យប្រវត្តិតាមចំនួនទឹកប្រាក់សរុបជាក់ស្តែងនៃវិក្កយបត្រ
- បង្ហាញលើផ្ទាំង Checkout និងបោះពុម្ពនៅលើវិក្កយបត្រ
- អតិថិជនគ្រាន់តែបើក App ធនាគារ (Bakong, ABA, ACLEDA, Wing...) ស្កេន ទឹកប្រាក់នឹងឡើងស្វ័យប្រវត្តិ ១០០%
### 7. 🔔 ផ្ញើសារប្រាប់ដំណឹងមកម្ចាស់ហាង (Telegram Instant Alerts)
- រាល់ពេលលក់ដាច់ ប្រព័ន្ធដំណើរការ Background Worker ផ្ញើសារជូនដំណឹងភ្លាមៗចូល Telegram របស់ម្ចាស់ហាង
- ក្នុងសារមាន៖ លេខវិក្កយបត្រ, ម៉ោង, ចំនួនទឹកប្រាក់ ($ / ៛), វិធីទូទាត់, និងបញ្ជីមុខទំនិញដែលបានលក់
- ផ្ទាំង Settings មានកន្លែងបញ្ចូល Telegram Bot Token, Chat ID និងប៊ូតុង **🧪 តេស្តផ្ញើសារ**
### 8. 🆘 ផ្ទាំងជំនួយ & ទំនាក់ទំនងពេលជួបបញ្ហា (Contact Me If You Have A Problem)
- ប៊ូតុងពិសេស **🆘 ជំនួយ && ទំនាក់ទំនង** លើ Header Navigation Bar និង Shortcut **F1** បើកផ្ទាំងជំនួយភ្លាមៗគ្រប់ពេលវេលា
- **🏢 ទីតាំងហាងជាក់ស្តែង**: ផ្សារសំណង់១២ (រាជធានីភ្នំពេញ) + ប៊ូតុងបើក Google Maps និងចម្លងទីតាំង
- **📞 លេខទូរស័ព្ទទំនាក់ទំនងរហ័ស (Click-to-Call & One-Click Copy)**:
- 🟢 **010 662269** (Smart Axiata)
- 🔴 **060 662269** (Metfone)
- 🟠 **061 662269** (Cellcard)
- **💬 Telegram ផ្ទាល់ & Telegram Bot**:
- 💬 Telegram ទំនាក់ទំនងផ្ទាល់: [@Muyreal](https://t.me/Muyreal) (ឆាតពិភាក្សាតម្លៃ និងជំនួយផ្ទាល់ជាមួយ Admin)
- 🤖 Telegram Bot: [@muyrealstore_bot](https://t.me/muyrealstore_bot) (ឆែកមើលទំនិញ និងទទួលដំណឹង)
- **🛠️ ប្រព័ន្ធរាយការណ៍បញ្ហាជួបប្រទះ (Report A Problem / Support Ticket)**:
- ជ្រើសរើសប្រភេទបញ្ហា៖ 🖨️ ម៉ាស៊ីនព្រីន, 🎯 ស្កេនបាកូដ, 💳 KHQR ធនាគារ, 📦 ស្តុកទំនិញ, ⚠️ កំហុសកម្មវិធី
- ប៊ូតុង **💬 ផ្ញើបញ្ហានេះទៅ Telegram @Muyreal ផ្ទាល់** (បើក Telegram ដោយស្វ័យប្រវត្តិជាមួយសាររៀបចំរួចជាស្រេច)
- ប៊ូតុង **🚀 ផ្ញើរាយការណ៍តាម Bot Alert** (ផ្ញើដំណឹងបញ្ហាទៅម្ចាស់ហាងតាម Telegram Bot ក្នុង Background)
- **🌟 បង្ហាញសេវាកម្មចម្បងរបស់ Muyreal Store**: ទូរស័ព្ទ (Smartphones), ម៉ូតូ (Motorcycles), រថយន្ត (Cars), សេវាជួល (Rentals), កុំព្យូទ័រ & Laptops, ព្រមទាំងប៊ូតុងបើកមើល **Poster ផ្សព្វផ្សាយពេញលេញ**
---
## 📖 សៀវភៅណែនាំរបៀបប្រើប្រាស់លម្អិត (Comprehensive How-To-Use Guide)
### 1. ⛶ របៀបប្រើប្រាស់ Full Screen (ពេញអេក្រង់) & ផ្លាស់ប្តូរទំហំ
- **ពេញអេក្រង់ដោយស្វ័យប្រវត្តិ (Auto-Maximized on Launch)**៖ រាល់ពេលបើកកម្មវិធី (`MuyrealPOS.exe` ឬ `main.py`) កម្មវិធីនឹងបើកទំហំពេញអេក្រង់ធំទូលាយស្វ័យប្រវត្តិ ផ្តល់ភាពងាយស្រួលដល់អ្នកគិតលុយលើអេក្រង់កុំព្យូទ័រ ឬម៉ាស៊ីន Touchscreen POS។
- **គ្រាប់ចុចកាត់ F11 (Toggle Fullscreen)**៖
- ចុចគ្រាប់ចុច **F11** លើ Keyboard ឬចុចប៊ូតុង **⛶ ពេញអេក្រង់** លើ Header Navigation Bar ដើម្បីប្តូរទៅជាទម្រង់ **Kiosk Fullscreen** (បិទរបារ Taskbar របស់ Windows)។
- ចុច **F11** ម្តងទៀតដើម្បីបង្រួមត្រឡប់មកធម្មតាវិញ។
---
### 2. 🎨 របៀបផ្លាស់ប្តូរពណ៌ Theme និងពណ៌ផ្ទៃខាងក្រោយ (Background & Palette Colors)
កម្មវិធីមានបណ្តុំពណ៌ Theme និងពណ៌ផ្ទៃខាងក្រោយ (Background Tint) ចំនួន **១០ ជម្រើសពិសេស** ទាំង Light Mode និង Dark Mode៖
1. 🌿 **Fresh Emerald (បៃតងស្រស់)**: ផ្ទៃខាងក្រោយពណ៌ជីរខ្ចីស្រស់ថ្លា (`#f0fdf4`) / Dark (`#06281e`)
2. 🌊 **Ocean Blue (ខៀវមហាសមុទ្រ)**: ផ្ទៃខាងក្រោយពណ៌ផ្ទៃមេឃត្រជាក់ភ្នែក (`#f0f9ff`) / Dark (`#081d33`)
3. 🌅 **Sunset Amber (ទឹកក្រូចរស់រវើក)**: ផ្ទៃខាងក្រោយពណ៌កក់ក្តៅ (`#fffbeb`) / Dark (`#241407`)
4. 🔮 **Royal Purple (ស្វាយប្រណីត)**: ផ្ទៃខាងក្រោយផ្កាត្រកួនទន់ភ្លន់ (`#faf5ff`) / Dark (`#170b2c`)
5. 🌸 **Rose Berry (ផ្កាឈូកទាន់សម័យ)**: ផ្ទៃខាងក្រោយផ្កាកុលាបស្រាល (`#fff1f2`) / Dark (`#260b17`)
6. 🌌 **Obsidian Midnight (ខ្មៅរលោង)**: ផ្ទៃខ្មៅរលោងកម្រិតខ្ពស់ (`#f1f5f9`) / Dark (`#070b12`)
7. ☕ **Warm Coffee & Wood (កាហ្វេ និង ឈើ)**: ផ្ទៃខាងក្រោយពណ៌កាហ្វេដោះគោ & ឈើកក់ក្តៅ (`#fbf8f5`) / Dark (`#1a130f`)
8. ☀️ **Pure Snow White (សស្អាត Minimalist)**: ផ្ទៃខាងក្រោយពណ៌សសុទ្ធ ១០០% (`#ffffff`) / Dark (`#111827`)
9. 👑 **Luxury Gold VIP (មាសប្រណីត VIP)**: ផ្ទៃខាងក្រោយពណ៌ភ្លុកដំរី និងមាសប្រណីត (`#fffdf5`) / Dark (`#14120c`)
10. 🍃 **Deep Forest Sage (បៃតងព្រៃឈើ)**: ផ្ទៃខាងក្រោយបៃតងស្លឹកឈើធម្មជាតិ (`#f2f7f4`) / Dark (`#0c1f15`)
**របៀបប្តូរពណ៌**:
- **ប្តូររហ័ស**: ចុចលើ Dropdown រូប **🎨** លើ Header Navigation Bar ដើម្បីជ្រើសរើសពណ៌ដែលចង់បាន ពណ៌ផ្ទៃក្រោយនឹងផ្លាស់ប្តូរភ្លាមៗ!
- **ប្តូររវាង Light / Dark**: ចុចលើប៊ូតុង **🌙 ងងឹត** ឬ **☀️ ស្រស់ថ្លា** លើ Header។
---
### 3. 📦 របៀបគ្រប់គ្រងមុខទំនិញ & ស្តុក (Product & Inventory Management)
1. ចុចប៊ូតុង **📦 គ្រប់គ្រងមុខទំនិញ** លើ Header Bar។
2. **បញ្ចូលទំនិញថ្មី (Add Product)**៖
- វាយឈ្មោះទំនិញ (ភាសាខ្មែរ និង English)
- ជ្រើសរើសប្រភេទ (Category)
- បញ្ចូលតម្លៃលក់ ($ Retail) និងថ្លៃដើម ($ Cost)
- វាយលេខបាកូដ (Barcode) ឬស្កេនបាកូដពីផលិតផលផ្ទាល់
- ជ្រើសរើសរូបភាពផលិតផល
3. **ការកំណត់ជម្រើសច្រើន (Multi-Variants)**៖
- ធីកលើប្រអប់ **«ទំនិញមានជម្រើសច្រើន (Has Variants)»**
- ចុច **➕ បន្ថែមជម្រើស** (ឧ. Size S, Size M, Size L ឬ ក្តៅ/ត្រជាក់)
- កំណត់តម្លៃបន្ថែមលើជម្រើសនីមួយៗ (+Extra USD), លេខបាកូដជម្រើស និងចំនួនស្តុកដាច់ដោយឡែកពីគ្នា។
4. **ការបន្ថែមស្តុកទំនិញរហ័ស (Quick Restock)**៖
- ចូលទៅកាន់ **📊 របាយការណ៍ & ស្តុក** -> ជ្រើសរើស Tab **📦 របាយការណ៍ស្តុកទំនិញ**
- ក្នុងតារាងចុចប៊ូតុង **➕ ថែមស្តុក** លើមុខទំនិញណាមួយ រួចវាយចំនួនដែលចង់ថែម ចំនួនស្តុកនឹងកើនឡើងភ្លាមៗ។
---
### 4. 🎯 របៀបស្កេនបាកូដ & លក់ទំនិញ (Barcode Scanning & Sales)
1. **ស្កេនបាកូដដោយស្វ័យប្រវត្តិ (Hands-free Barcode Scanning)**៖
- មិនបាច់ចុច Mouse ឡើយ! គ្រាន់តែយកម៉ាស៊ីនស្កេនបាកូដបាញ់ទៅលើផលិតផល កម្មវិធីនឹងបញ្ចេញសំឡេង **Beep** ហើយបញ្ចូលទំនិញទៅក្នុងកន្ត្រកភ្លាមៗ។
- ប្រសិនបើស្កេនលើទំនិញដែលមាន Variants ផ្ទាំងជ្រើសរើសនឹងលោតឡើងស្វ័យប្រវត្ត ដើម្បីឱ្យអ្នកគិតលុយចុចជ្រើសរើសទំហំ ឬពណ៌យ៉ាងរហ័ស។
2. **ស្វែងរកដោយវាយអក្សរ**:
- វាយឈ្មោះទំនិញក្នុងប្រអប់ **🔍 ស្កេនបាកូដ ឬវាយឈ្មោះទំនិញ...**
- ឬចុចលើ **Category Pills** (ភេសជ្ជៈ, នំចំណី, សម្ភារៈ...) ដើម្បីត្រងតាមផ្នែក។
3. **កែប្រែចំនួន និងបញ្ចុះតម្លៃ**:
- ក្នុងកន្ត្រកទំនិញ ចុចប៊ូតុង **+** ឬ **-** ឬវាយចំនួនលេខផ្ទាល់
- កំណត់ភាគរយបញ្ចុះតម្លៃក្នុងប្រអប់ **បញ្ចុះតម្លៃ (%):** (ឧ. 5%, 10%)
- កំណត់ពន្ធ VAT ក្នុងប្រអប់ **ពន្ធ VAT (%):**
---
### 5. 💵 របៀបគិតលុយ & បង្កើត Dynamic KHQR (Checkout & Payments)
1. **ទូទាត់ដោយសាច់ប្រាក់ (Cash)**៖
- ចុចប៊ូតុង **💵 សាច់ប្រាក់ (Cash)** ឬ Shortcut Enter
- ជ្រើសរើស ឬវាយចំនួនប្រាក់ដែលអតិថិជនបានឱ្យ (ជា USD ឬជាប្រាក់រៀល KHR)
- ប្រព័ន្ធនឹងគណនាប្រាក់អាប់ជូនដោយស្វ័យប្រវត្តទាំងជា **ដុល្លារ ($)** និង **ប្រាក់រៀល (៛)**
- ចុច **✅ បញ្ចប់ការគិតលុយ** ដើម្បីចេញវិក្កយបត្រ។
2. **ទូទាត់រហ័សតាម Dynamic KHQR Code**៖
- ចុចប៊ូតុង **⚡ Dynamic KHQR**
- ប្រព័ន្ធនឹងទាញយកទិន្នន័យគណនីធនាគារ (Bakong, ABA, Wing...) រួចបង្កើតកូដ **EMVCo Dynamic KHQR តាមចំនួនទឹកប្រាក់ជាក់ស្តែងនៃវិក្កយបត្រ**
- អតិថិជនគ្រាន់តែបើក App ធនាគារស្កេន ទឹកប្រាក់នឹងឡើងស្វ័យប្រវត្តិ ១០០% ដោយមិនបាច់វាយបញ្ចូលចំនួនលុយដោយដៃឡើយ។
---
### 6. 🧾 របៀបចេញវិក្កយបត្រ & បោះពុម្ព (Receipt Printing)
1. ផ្ទាំងវិក្កយបត្រនឹងបង្ហាញរូបរាងវិក្កយបត្រពេញលេញភ្លាមៗបន្ទាប់ពីគិតលុយរួច។
2. **ជ្រើសរើសស្តាយវិក្កយបត្រទាំង ៤ បែប**៖
- 🌟 **Modern Clean (80mm)**: ទំនើប ស្រឡះភ្នែក
- 📜 **Classic Retail (80mm)**: បែបបន្ទាត់ដាច់ៗ ម៉ាស៊ីនកម្ដៅបុរាណ
- 🎫 **Compact Minimalist (58mm)**: សម្រាប់ម៉ាស៊ីនកម្ដៅខ្នាតតូច 58mm សន្សំក្រដាស
- 💎 **Elegant Boutique**: បែបហាងប្រណីត មានរបារពណ៌ស្អាត
3. ចុចប៊ូតុង **🖨️ បោះពុម្ពវិក្កយបត្រ (Print)** ដើម្បីបញ្ជូនទៅកាន់ Thermal Printer ឬចុច **💾 រក្សាទុកជា PDF**។
---
### 7. 📊 របៀបមើលរបាយការណ៍ & ទាញយកឯកសារ (Sales & Inventory Reports)
1. ចុចប៊ូតុង **📊 របាយការណ៍ && ស្តុក** លើ Header Bar។
2. **ផ្ទាំងប្រវត្តិលក់ (Sales History)**៖
- មើលស្ថិតិចំណូលសរុប, ចំណូលថ្ងៃនេះ, និងចំនួនវិក្កយបត្រ
- ត្រងតាម៖ ថ្ងៃនេះ, សប្តាហ៍នេះ, ខែនេះ, ទាំងអស់
- ចុចលើវិក្កយបត្រណាមួយដើម្បី **មើលឡើងវិញ** ឬ **ព្រីនឡើងវិញ (Reprint)**
- ចុចប៊ូតុង **📥 ទាញយកជារបាយការណ៍ (Export CSV)** ដើម្បីបើកក្នុង Excel
3. **ផ្ទាំងស្តុកទំនិញ (Inventory Report)**៖
- មើលចំនួនទំនិញក្នុងស្តុកសរុប, ថ្លៃដើមទុន ($ Cost), តម្លៃលក់សរុប ($ Retail) និងប្រាក់ចំណេញរំពឹងទុក ($ Profit)
- តាមដានផ្លាកសញ្ញាពណ៌៖ 🟢 ស្តុកគ្រប់គ្រាន់ | 🟡 ជិតអស់ (≤ 5) | 🔴 អស់ពីស្តុក (= 0)
- ចុចប៊ូតុង **📥 Export CSV ស្តុកទំនិញ**។
---
### 8. 🔔 របៀបភ្ជាប់ Telegram Bot ផ្ញើដំណឹងលក់ទៅទូរស័ព្ទ (Telegram Alerts)
1. ចូលទៅកាន់ **⚙️ ការកំណត់ (Settings)** -> រមូរចុះក្រោមទៅកាន់ផ្នែក **ប្រព័ន្ធ Telegram ផ្ញើដំណឹងលក់**
2. ធីកលើ **«បើកដំណើរការផ្ញើសារប្រាប់ដំណឹងលក់ទៅកាន់ Telegram»**
3. បញ្ចូល **Telegram Bot Token** និង **Telegram Chat ID** របស់អ្នក
4. ចុចប៊ូតុង **🧪 តេស្តផ្ញើសារ (Test Connection)** ដើម្បីផ្ទៀងផ្ទាត់
5. ចុច **💾 រក្សាទុកការកំណត់** — រាល់ពេលគិតលុយដាច់ ប្រព័ន្ធនឹងផ្ញើវិក្កយបត្រចូល Telegram របស់អ្នកភ្លាមៗ!
---
### 9. 🆘 របៀបប្រើប្រាស់ផ្ទាំងជំនួយពេលជួបបញ្ហា (Contact Me If You Have A Problem)
- **របៀបបើក**:
- ចុចប៊ូតុងពណ៌មាស **`🆘 ជំនួយ && ទំនាក់ទំនង`** លើ Header
- ឬចុចគ្រាប់ចុចកាត់ **F1** លើ Keyboard
- **ការប្រើប្រាស់**:
- ចុច **[📞 ខល]** ឬ **[📋 ចម្លង]** លើលេខ Smart (010 662269), Metfone (060 662269), ឬ Cellcard (061 662269)
- ចុច **[✈️ ឆាត @Muyreal]** ដើម្បីឆាតផ្ទាល់ជាមួយ Admin
- ចុច **[🤖 បើក Bot]** ដើម្បីប្រើប្រាស់ Telegram Bot
- ចុច **[🗺️ បើក Google Maps]** ដើម្បីមើលទីតាំងហាងជាក់ស្តែងនៅផ្សារសំណង់១២
- ប្រសិនបើមានបញ្ហាប្រព័ន្ធ វាយបញ្ចូលព័ត៌មាន រួចចុច **«💬 ផ្ញើបញ្ហានេះទៅ Telegram @Muyreal ផ្ទាល់»** ដើម្បីទទួលបានការជួយដោះស្រាយជាបន្ទាន់!
---
## 🚀 របៀបដំណើរការកម្មវិធី (How to Run)
### ដំណើរការតាម Command Line / Terminal:
```bash
python main.py
```
### ដំណើរការតាម Launcher:
- Double-click លើ file `run_app.bat`
### បង្កើតឯកសារ Standalone EXE:
```bash
python build_exe.py
```
ឯកសារ EXE នឹងត្រូវបានបង្កើតក្នុង Folder `EXE/MuyrealPOS.exe` រួចជាស្រេច អាចចម្លងទៅប្រើលើកុំព្យូទ័រណាក៏បានដោយមិនបាច់ដំឡើង Python!
 - Pro Edition){kind=link}
0 Comments