File manager

File manager - Edit - /home/webapp69.cm.in.th/u69319090029/Project SME/README.md

Back
# 📖 CMTC Tech Solution Cloud — Project SME > Smart Multi-Tenant Dining & SME Management System ![CMTC Tech Solution](logo.png) --- ## 📌 ข้อมูลโครงการ (Project Overview) CMTC Tech Solution Cloud (Project SME) คือระบบบริหารจัดการร้านอาหารและร้านค้าแบบ Multi-Tenant (ระบบหลายร้านค้าบนแพลตฟอร์มเดียว) ออกแบบมาเพื่อสนับสนุนผู้ประกอบการ SME, ศูนย์อาหาร (Food Center), และร้านอาหารเดี่ยว/หลายสาขา ให้สามารถบริหารจัดการเมนู ออเดอร์ คิวอาหาร และการเรียกคิวลูกค้าได้อย่างครบวงจรผ่านระบบคลาวด์แบบ Real-time --- ## 🌟 คุณสมบัติเด่น (Key Features) ### 🛒 1. ระบบสั่งอาหารสำหรับลูกค้า (Customer Self-Ordering) * Mobile-First Experience: หน้าตาอินเทอร์เฟซรองรับสมาร์ทโฟน สะดวก รวดเร็ว * Table & QR Code Support: ระบุหมายเลขโต๊ะ (เช่น `A01`, `TB-05`) อัตโนมัติเมื่อสแกน QR Code * Live Order Tracking: ลูกค้าติดตามสถานะอาหารของตนเองได้สดๆ บนหน้าจอ (ส่งแล้ว ➔ กำลังปรุง ➔ พร้อมรับ) ### 👑 2. ระบบแอดมินส่วนกลาง (Super Admin Platform) * Shop Registration Review: ระบบรับใบสมัครเข้าร่วมโครงการจากหน้าแรก * Auto Shop Provisioning: กดยืนยันอนุมัติร้านค้าใหม่ ระบบจะสร้างรหัสร้านและบัญชีผู้ดูแลร้าน (`admin_[shop_id]`) ให้อัตโนมัติ * Platform Analytics: ตรวจสอบสถิติจำนวนร้านค้าและยอดรวมแพ็กเกจ ### 🏪 3. ระบบบริหารร้านค้าสำหรับเจ้าของร้าน (Shop Admin / Kitchen Command) * Menu Management (CRUD): เพิ่ม แก้ไข ลบรายการอาหาร ปรับราคา และเปลี่ยนสถานะ (พร้อมเสิร์ฟ / หมดชั่วคราว) * Kitchen Order Management: รับออเดอร์เข้าครัว เปลี่ยนสถานะออเดอร์ (`pending` ➔ `preparing` ➔ `served` / `cancelled`) * Shop Profile Customization: แก้ไขข้อมูลร้าน เบอร์โทรศัพท์ และพิกัดจุดบริการ ### 📺 4. จอทีวีประกาศเรียกคิวพร้อมเสียงสังเคราะห์ (Queue TV & Automated TTS) * Real-time Kitchen Sync: อัปเดตคิวอาหารที่ปรุงเสร็จแล้วทันทีเมื่อห้องครัวกดแจ้งเตือน * Automatic Thai TTS Voice Calling: พ่นเสียงประกาศเรียกคิวอัตโนมัติด้วยเทคโนโลยี Web Speech API (ตัวอย่าง: "โต๊ะหมายเลข A3 รับอาหารได้เลยค่ะ") --- ## 🔗 ตารางเส้นทางการเข้าใช้งานระบบ (URLs Matrix) \| กลุ่มผู้ใช้งาน \| ลิงก์เข้าใช้งาน (URL) \| วัตถุประสงค์ / คำอธิบาย \| \| :--- \| :--- \| :--- \| \| ลูกค้าทั่วไป \| [`menu.php`](menu.php) \| ค้นหารายชื่อร้านค้าทั้งหมดในศูนย์อาหาร/โครงการ \| \| ลูกค้าประจำโต๊ะ \| `menu.php?shop_id={id}` \| เลือกระบุร้านค้าเฉพาะจุด สั่งอาหาร และกรอกหมายเลขโต๊ะ \| \| ผู้ดูแลระบบส่วนกลาง \| [`platform-admin.php`](platform-admin.php) \| แผงอนุมัติร้านค้าใหม่ ตรวจสอบแพ็กเกจ และดูภาพรวมระบบ \| \| ผู้ดูแลร้านค้า \| [`demo-admin.php`](demo-admin.php) / [`store-admin.php`](store-admin.php) \| จัดการรายการอาหาร ปรับแต่งร้าน และจัดการออเดอร์ในครัว \| \| สถานะคิวลูกค้า \| `status.php?shop_id={id}` \| บอร์ดแสดงคิวกำลังปรุง / คิวพร้อมรับ สำหรับลูกค้า \| \| จอทีวีประกาศเรียกคิว \| `queue-tv.php?shop_id={id}` \| จอใหญ่สำหรับติดหน้าร้าน พร้อมระบบเสียงเรียกคิวอัตโนมัติ \| --- ## 🔑 บัญชีเข้าใช้งานตั้งต้น (Default System Credentials) ### Super Admin (ส่วนกลาง) * Username: `admin` * Password: `@smetech69` ### Shop Admin ตั้งต้น (เมื่อได้รับอนุมัติร้านค้า) * Username: `admin_{shop_id}` (เช่น `admin_1`, `admin_2`) * Password: `123456` --- ## 🛠️ เทคโนโลยีที่ใช้ (Tech Stack) * Backend: PHP 7.4+ / 8.x (PDO Driver, Prepared Statements, Session Management) * Database: MySQL / MariaDB (`InnoDB` Engine, UTF-8 Unicode Support) * Frontend: HTML5, Vanilla CSS3 (Custom Design Tokens), JavaScript ES6+ * Real-time & Audio: Fetch API / AJAX Polling, Web Speech API (`SpeechSynthesisUtterance`) * Environment Config: `.env` configuration support --- ## 📂 โครงสร้างฐานข้อมูล (Database Schema) ระบบใช้งานฐานข้อมูลชื่อ `sme_os` (หรือ `smart_dine_cloud_db`) ประกอบด้วย 5 ตารางหลัก: 1. `shops`: ข้อมูลร้านค้าที่ลงทะเบียน (ชื่อร้าน, เบอร์โทร, แพ็กเกจ, สถานะ) 2. `shop_admins`: บัญชีผู้ดูแลร้านค้าแต่ละร้าน (เชื่อมโยงกับ `shops.id`) 3. `products`: เมนูอาหาร/สินค้าในระบบ 4. `orders`: ใบสั่งซื้อ/ออเดอร์ (ระบุหมายเลขโต๊ะ และสถานะ `pending`, `preparing`, `served`, `completed`, `cancelled`) 5. `order_items`: ตารางรายละเอียดรายการอาหารใน แต่ละออเดอร์ --- ## 🚀 ขั้นตอนการติดตั้งและเปิดใช้งาน (Setup & Installation Guide) ### 1. ความต้องการของระบบ (Prerequisites) * Web Server (Apache / Nginx) เช่น XAMPP, WampServer หรือ Laragon * PHP Version 7.4 ขึ้นไป * MySQL / MariaDB Database Server ### 2. ขั้นตอนการติดตั้ง 1. คัดลอกโฟลเดอร์โครงการไปไว้ที่ Web Root: ```bash C:\xampp\htdocs\Project SME ``` 2. สร้างฐานข้อมูล MySQL และนำเข้าไฟล์ schema: * นำเข้าไฟล์ [`database.sql`](database.sql) ผ่าน phpMyAdmin หรือ MySQL Command Line: ```sql CREATE DATABASE IF NOT EXISTS `sme_os` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE `sme_os`; -- Import database.sql contents ``` 3. กำหนดค่าการเชื่อมต่อฐานข้อมูลในไฟล์ [`.env`](.env): ```ini DB_HOST=127.0.0.1 DB_PORT=3306 DB_USER=sme_os DB_PASS=@smetech69 DB_NAME=sme_os DB_DEBUG=true ``` 4. ทดสอบเข้าใช้งานผ่าน Web Browser: ``` http://localhost/Project%20SME/index.php ``` --- ## 📋 ขั้นตอนการทำงานของระบบ (Workflow Summary) ```mermaid flowchart TD A[ร้านค้าลงทะเบียนเข้าร่วมโครงการ] -->\|ส่งใบสมัคร\| B[index.php] B --> C[Super Admin ตรวจสอบคำขอ] C -->\|กดอนุมัติ\| D[platform-admin.php] D -->\|สร้างระบบอัตโนมัติ\| E[สร้างรหัสร้าน & บัญชี admin_shop] F[ลูกค้าสแกน QR / เข้าเว็บ] -->\|สั่งอาหาร\| G[menu.php?shop_id=X] G -->\|ส่งออเดอร์\| H[(Database: orders & order_items)] H -->\|แสดงคิวเข้าครัว\| I[demo-admin.php / store-admin.php] I -->\|กดเริ่มปรุง / ปรุงเสร็จ\| J{เปลี่ยนสถานะออเดอร์} J -->\| status = served \| K[status.php แสดงคิว ready] J -->\| status = served \| L[queue-tv.php ประกาศเรียกคิว + เสียงพูด] ``` --- ## 📄 ใบอนุญาตและการดูแล (License & Support) พัฒนาและดูแลโดยทีมงาน CMTC Tech Solution Cloud สงวนลิขสิทธิ์ © 2026 CMTC Tech Solution. All rights reserved.

| ver. 1.4 | Github | . | PHP 7.4.33 | Generation time: 0.23 | proxy | phpinfo | Settings