แพลตฟอร์ม Open Source สำหรับ ร้านค้าชุมชนในหมู่บ้าน — ทดแทนการซื้อขายผ่าน LINE OpenChat ที่ Order ตกหล่น ไม่รู้ว่าร้านเปิดหรือปิด และไม่รู้ว่าหมู่บ้านมีร้านอะไรบ้าง
UX ได้แรงบันดาลใจจาก Delivery Platform (Grab / LINE MAN) ที่ทั้งลูกค้าและเจ้าของร้านใช้จนคุ้นมือ แต่ปรับให้เหมาะกับ "ร้านในหมู่บ้าน": ไม่มี Rider และไม่มีค่าส่ง (ร้านไปส่งเองหรือลูกค้ามารับ), เฉพาะคนในหมู่บ้านที่ Admin อนุมัติแล้วเท่านั้น, มีบริการ (นวด, ซักรีด), มี Pre-order แบบเป็นรอบ และจ่ายเงินแบบโอนตรง / เงินสด
| ปัญหาเดิม (OpenChat) | SmartShop |
|---|---|
| ไม่รู้ว่าร้านเปิด/ปิดอยู่ไหม | สถานะร้าน Real-time (ตามตารางเวลา + เปิด/ปิดเองได้ + ปิดชั่วคราวเป็นช่วง) |
| ไม่รู้ว่าหมู่บ้านมีร้านอะไรบ้าง | หน้า Home ของหมู่บ้าน, หมวดหมู่, ค้นหา |
| Order อยู่ในแชท แล้วตกหล่น | Order มีสถานะชัดเจน + Timeline + แจ้งเตือนสมาชิกร้านทุกคน ทุกอุปกรณ์ (LINE / Web Push / FCM / In-app) พร้อมเสียงเตือนจนกว่าจะมีคนรับ |
| ไม่รู้ว่าโอนแล้วหรือยัง | QR พร้อมเพย์พร้อมยอด, แนบสลิป, ตรวจสลิปซ้ำ, ร้านกดยืนยัน (หรือต่อระบบตรวจสลิปอัตโนมัติ) |
| ของหมดแต่ยังมีคนสั่ง | จัดการ Stock / จองสต็อกตอนสั่ง / Sold-out อัตโนมัติ |
ทำครบทุก Phase ตาม Roadmap แล้ว ได้แก่ Web App (PWA + LINE LIFF), Mobile App (MAUI), Backend 13 Module, รีวิว, โปรโมชั่น/คูปอง, Audit log, Public API + Webhook, Row-Level Security, Helm chart
- ลูกค้า: ดูร้านที่เปิดอยู่, สั่งของ/จองบริการ/Pre-order, จ่ายเงินสดหรือโอน, ติดตาม Order แบบ Real-time, แชทกับร้าน, รีวิว
- ร้านค้า: รับ Order พร้อมเสียงเตือน, จัดการเมนูและสต็อก, ตั้งเวลาเปิดปิด, สมาชิกร้านหลายคน, ยอดขาย/CSV, โปรโมชั่น, เชื่อม POS/เครื่องพิมพ์ผ่าน API
- Admin หมู่บ้าน: อนุมัติสมาชิกและร้าน, ประกาศ, ดูแลรีวิว/รายงานปัญหา, Audit log
ต้องมี .NET 10 SDK และ Docker
docker compose -f deploy/docker-compose.dev.yml up -d # Postgres, Valkey, RabbitMQ, SeaweedFS
dotnet run --project src/Hosts/SmartShop.Api --launch-profile http # :5080 (migrate อัตโนมัติ)
dotnet run --project src/Hosts/SmartShop.Worker --launch-profile http # :5090
dotnet run --project src/Clients/SmartShop.Web --launch-profile http # :5100 เปิดอันนี้ในเบราว์เซอร์ใน Development ใช้ปุ่ม Dev login ได้โดยไม่ต้องตั้งค่า LINE · คู่มือติดตั้งฉบับเต็ม (สิ่งที่ต้องเตรียม, ตั้งค่า LINE, ขึ้น Server จริง): docs/07-installation.md
- VPS เครื่องเดียว:
deploy/docker-compose.yml+ Caddy (HTTPS อัตโนมัติ) ดูdeploy/.env.example - Kubernetes: Helm chart ที่
deploy/helm/smartshop - Observability (ไม่บังคับ):
deploy/docker-compose.observability.yml(Grafana + OpenTelemetry) - Mobile:
src/Clients/SmartShop.Mobile(Android; Build ด้วยSmartShop.Mobile.slnxและต้องติดตั้ง MAUI workload ก่อน)
- Features & Roles: บทบาทผู้ใช้และ Feature ทั้งหมด แยกตาม Phase
- UX / UI Flows: หน้าจอและ Flow ที่อิงจาก Grab / LINE MAN
- Architecture: สถาปัตยกรรม .NET แบบ Event-Driven, Cache, Security, Deploy, License
- Domain Model & Events: ERD, State Machine, Stock Logic, Event Catalog
- Roadmap: สถานะแต่ละ Phase และ Decisions Log
- Public API & Webhooks: เชื่อมต่อ POS / เครื่องพิมพ์ / ระบบอื่น
- Installation: สิ่งที่ต้องเตรียม และวิธีติดตั้งแต่ละแบบ
- Deploy หลัง Cloudflare: Cloud (เช่น Hetzner) + Cloudflare + Nginx ที่มีอยู่แล้ว
- แยกเป็น 2 เครื่อง: ย้ายแอปไปอีกเครื่องผ่าน Hetzner Private Network เมื่อ RAM เครื่องเดิมไม่พอ
- Backend: .NET 10, ASP.NET Core Minimal APIs, EF Core + PostgreSQL, Wolverine (Messaging + Outbox + Scheduling), HybridCache + Valkey, SignalR
- Frontend: Blazor WebAssembly PWA (+ LINE LIFF) และ .NET MAUI Blazor Hybrid ใช้ Razor Component ชุดเดียวกัน (MudBlazor)
- Infra: PostgreSQL, Valkey, RabbitMQ, SeaweedFS (S3), Caddy
- Auth: LINE Login → ระบบออก JWT เอง (+ Refresh token rotation)
- Dev/Deploy: Docker Compose / Aspire (Local), Docker Compose หรือ Helm (Production), GitHub Actions → GHCR
MIT (Dependency ที่เป็น AGPL ใช้ได้เฉพาะแบบรันแยก Container ดู License Policy)