# สรุปความต้องการระบบ Stok24 (จาก PRD)

> อ้างอิง: `docs/PRODUCT_REQUIREMENTS_AND_PRICING.md` · ใช้สำหรับทีมขายและออกแบบ landing page

---

## 1. ตำแหน่งผลิตภัณฑ์

**Stok24** = ระบบปฏิบัติการร้านค้าแบบรวมศูนย์ (POS + สต็อก + ซ่อม + เอกสาร + หลายสาขา)

- **เทคโนโลยี:** PHP, MySQL, Alpine.js, Tailwind — self-hosted หรือ managed SaaS
- **ไม่ใช่:** GL เต็มรูปแบบ, e-Tax กรมสรรพากรโดยตรง (มี VAT snapshot / ใบกำกับตามมาตรฐานร้าน)

---

## 2. กลุ่มลูกค้า

| กลุ่ม | Pain | โมดูลสำคัญ |
|-------|------|-------------|
| ร้านปลีก / มือถือ | POS + สต็อก + บิล | POS, สินค้า, คลัง, รายงาน |
| ศูนย์ซ่อม | งาน + อะไหล่ + เก็บเงิน | งานซ่อม, สต็อก, POS |
| หลายสาขา | แยกสต็อก/ยอด | สาขา, โอนสต็อก |
| ขายเชื่อ | ลูกหนี้ | AR, ลูกค้า |
| Subscription / บัญชีดิจิทัล | ทะเบียนบริการ | Service Accounts |
| Franchise / IT | สิทธิ์ + backup | RBAC, Ops, Telegram |

---

## 3. ความต้องการแพลตฟอร์ม

- Login/logout, remember-me, audit auth → Telegram
- Multi-branch context
- RBAC 100+ permission keys
- Feature toggles (global / สาขา / บทบาท)
- Audit log + Telegram (optional)
- ตั้งค่า: บริษัท, เอกสาร, POS, backup
- แจ้งเตือน in-app + Telegram
- Backup full/DB, restore, ops jobs
- Job queue async, retry, metrics
- UI ไทย, responsive, dark mode
- Export CSV/Excel

---

## 4. โมดูลหลัก (ฟีเจอร์ขาย)

### แดชบอร์ด
ยอดขาย, กำไร, สินค้าใกล้หมด, quick links, แจ้งเตือน, ops health

### POS
ค้นหา/SKU/barcode, สแกน QR, สร้างสินค้าเร็ว, ตะกร้า, ส่วนลด, แก้ราคา, VAT, เงินสด/โอน/QR, พักบิล, ลูกค้าในบิล, ใบเสร็จ, void/refund, **AR ลูกหนี้**

### สินค้าและคลัง
CRUD, หมวด/หน่วย, รูปหลายรูป, export, รับเข้า/ปรับ/โอนสาขา, สแกนรับเข้า, สต็อกติดลบ (toggle), พนักงาน + เบิกสินค้า

### จัดซื้อและบัญชี
Service Accounts, PO, AP หนี้ซื้อ

### ลูกค้า
ที่อยู่, เลขภาษี, ธนาคาร/QR, แนบไฟล์, ประวัติธุรกรรม

### งานซ่อม
Workflow, อะไหล่, รับชำระ, พิมพ์

### เอกสาร
QUO, BN, INV, REC, CS, CN, DN — issue, void, create-from, VAT snapshot, ล็อกหลังออก

### รายงาน
รายวัน/เดือน/ปี, แยกสาขา/พนักงาน/ช่องทาง, export

### ระบบ
Users, Roles, Branches, Settings, Telegram, Backup, Ops, Toggles, Audit logs

### ยังไม่ขายเต็มที่
- **Tasks/Kanban** — มี DB/RBAC แต่ยังไม่มี route → ระบุเป็น Roadmap บนเว็บ
- SpinHub — แอปแยก ไม่ใช่ core

---

## 5. Feature toggles (แพ็ก)

`pos.discount`, `pos.price_override`, `pos.hold_bill`, `pos.void`, `pos.refund`, `inventory.negative_stock`, `inventory.transfer`, `product.quick_create`, `reports.export`, `audit.logs`, `settings.manage`, `accounts_receivable.manage`, `backup.restore`

---

## 6. แพ็กและราคา (Marketing)

| แพ็ก | เหมาะกับ | รายเดือน (อ้างอิง) | รายปี (≈10 เดือน) |
|------|----------|-------------------|-------------------|
| **Starter** | ร้านเดียว 1–3 เครื่อง | ฿1,490 | ฿14,900 |
| **Pro** | ซ่อม / ขายเชื่อ | ฿3,490 | ฿34,900 |
| **Business** | 2–5 สาขา | ฿6,990 | ฿69,900 |
| **Enterprise** | Franchise | ติดต่อ | ติดต่อ |

**Add-ons:** สาขา +฿990/เดือน · ผู้ใช้ +฿249/คน · Managed hosting ฿2,490+ · อบรม on-site ฿5,000/วัน

**Funnel ขาย:**
1. ทดลอง **14 วัน** — Starter ครบ, จำกัด **500 บิล**
2. **Setup fee** ครั้งเดียว — นำเข้าสินค้า + อบรม 2 ชม. (฿4,900)
3. **Upsell หลัง 30 วัน** — AR หรือเอกสารเมื่อเริ่มขายเชื่อ
4. **Renewal** — ลดเมื่อจ่ายปี; เกินโควต้าสาขา/ผู้ใช้คิดเพิ่ม

---

## 7. Checklist ก่อนขายจริง

- [x] หน้า pricing + ตารางเทียบแพ็ก (landing page)
- [ ] จำกัดสาขา/ผู้ใช้ในโค้ด (license/settings)
- [ ] คู่มือติดตั้ง + migration มาตรฐาน
- [ ] Tasks/Kanban — ตัดจาก marketing จนกว่าพร้อม (ทำแล้ว: Roadmap)
- [ ] แพ็ก e-Tax / ฟอร์มกำกับมาตรฐานร้าน VAT (ถ้าขายร้าน VAT)

---

## 8. บทบาทมาตรฐาน

| บทบาท | Starter | Pro | Business |
|--------|:-------:|:---:|:--------:|
| Admin | ✓ | ✓ | ✓ |
| Cashier | ✓ | ✓ | ✓ |
| Stock | — | ✓ | ✓ |
| Manager | — | — | ✓ |
| Account | — | — | ✓ |