ระบบความรู้ครบวงจรสำหรับโปรเจกต์ Sangwijit ERP Web Portal — ระบบ Frontend Portal เชื่อมต่อกับ Dynamics 365 Business Central ครอบคลุม: สถาปัตยกรรมระบบ, 8+ Core Modules, Shared Components SC1-SC9, UI Design Pattern, BC365 API Integration, RBAC, Thailand Compliance ใช้ Skill นี้ทุกครั้งที่: - ถามหรือออกแบบ Module ใด ๆ ใน Sangwijit Portal (Sales, WH, Purchase, Finance, Service, Promotion, Master, Claims) - ออกแบบหน้าจอใหม่หรือ Flow ใหม่ตาม ERP Transaction Form Standard - เขียน Spec, Data Diction...
Scanned 9/12/2026
Install to Claude Code
Skills Directorynpx -y skills add aibot88/sec_skill_store --skill sangwijit-portal-skill --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Sangwijit Portal Skill?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/aibot88-sangwijit-portal-skill)More formats (shields.io, HTML) on the badges page.
---
name: sangwijit-portal
description: |
ระบบความรู้ครบวงจรสำหรับโปรเจกต์ Sangwijit ERP Web Portal — ระบบ Frontend Portal เชื่อมต่อกับ Dynamics 365 Business Central
ครอบคลุม: สถาปัตยกรรมระบบ, 8+ Core Modules, Shared Components SC1-SC9, UI Design Pattern, BC365 API Integration, RBAC, Thailand Compliance
ใช้ Skill นี้ทุกครั้งที่:
- ถามหรือออกแบบ Module ใด ๆ ใน Sangwijit Portal (Sales, WH, Purchase, Finance, Service, Promotion, Master, Claims)
- ออกแบบหน้าจอใหม่หรือ Flow ใหม่ตาม ERP Transaction Form Standard
- เขียน Spec, Data Dictionary, หรือ Workflow สำหรับ Developer
- ถามเรื่อง BC365 API Endpoint, RBAC Role, หรือ Status Flow
- วางแผน Phase การพัฒนาหรือประเมิน Task ใหม่
- ถามเรื่อง Shared Component SC1-SC9 — ใช้ที่ไหน, Props คืออะไร
- ออกแบบ Module ใหม่: e-Tax, Marketplace, Mobile App, HRM Hook
- ตรวจสอบ Open Questions ก่อน Implement
---
# Sangwijit ERP Web Portal Skill — Knowledge Base (v2.1)
**Last Updated:** เมษายน 2026
**เจ้าของโปรเจกต์:** Peerapat (พีรพัฒน์) — GM, กลุ่มแสงวิจิตร
**ธุรกิจ:** จำหน่ายเครื่องใช้ไฟฟ้า (ยอดขาย 450M+/ปี) — ค้าปลีก, ค้าส่ง, ส่งออก, ศูนย์บริการ
**Reference Folder:** `/Design Ai/` ใน Workspace
---
## ⚙️ กฎการทำงาน (RULES — บังคับทุกครั้ง)
### Rule 1: อ่าน Flowchart ก่อนออกแบบทุก Module
ก่อนออกแบบหน้าจอ หรือเขียน Spec ใด ๆ ต้องอ่าน Flowchart ที่เกี่ยวข้องจาก folder ก่อนเสมอ
**Flow Design Folder:** `/Design Ai/Flow Design/`
| Module | Subfolder | ประเภทไฟล์ |
|---|---|---|
| Sales | `Sales/Flow/` | Flow PDF (00–09) |
| Sales Documents | `Sales/Document/` | Document Template PDF |
| Purchase | `Purchase/Flow/` | Flow PDF (00–06) |
| Purchase Documents | `Purchase/Document/` | Document Template PDF |
| Warehouse | `Warehouse Inventory/Flow/` | Flow PDF (00–02) |
| Warehouse Documents | `Warehouse Inventory/Document/` | Document Template PDF |
| Finance (Cash/Bank) | `Finance/Flow/` | Flow PDF (01–03) |
| Finance Documents | `Finance/Document/` | Voucher Template PDF |
| Account (AR/AP/GL/Tax) | `Account/Flow/` | Flow PDF (00–12) |
| Account Documents | `Account/Document/` | Voucher Template PDF (01–10) |
| Service | `Service/` | Flow PDF (00–06) |
| Promotion | `Promotion/` | Flow PDF (00–02) |
| Master Data | `Master/` | Master Flow PDF (7 ไฟล์) |
| Data Transfer | `Data Transfer/` | Transfer Flow PDF (01–06) |
**ขั้นตอนการอ่านก่อนออกแบบ:**
```
1. ระบุ Module ที่จะทำ
2. เปิด Flow PDF ที่เกี่ยวข้องจาก subfolder ด้านบน
3. ทำความเข้าใจ Status Flow + BC365 Entity ใน Flow
4. ตรวจ Document Template PDF (ถ้ามี) เพื่อดู Field ที่ต้องแสดง
5. จึงเริ่ม Spec / Screen Design
```
---
### Rule 2: ไฟล์ซ้ำ — ถามก่อนเสมอ
ถ้าพบว่า folder มีไฟล์ชื่อคล้ายกันหรือเลขซ้ำกัน ต้องหยุด เปรียบเทียบ และถามผู้ใช้ก่อน ห้ามเลือกเองโดยไม่แจ้ง
**ไฟล์ซ้ำที่ตัดสินใจแล้ว (ห้ามถามซ้ำ):**
| Module | ไฟล์ที่ซ้ำ | การตัดสินใจ |
|---|---|---|
| Service / Claims | `06 Service - Claim Intake รับเรื่องเคลม ตรวจสอบสินค้า คืนของ Vendor.pdf` vs `06 Service - Claim Intake รับเรื่องเคลมและตรวจสอบสินค้า.pdf` | ✅ ใช้ **"คืนของ Vendor"** เป็น Reference หลัก (Flow ครบกว่า) |
| Sales / Document | `Credit Note (ใบลดหนี้ ใบกำกับภาษี).pdf` vs `Credit Note (ใบลดหนี้).pdf` | ✅ **คนละ Case**: ใบลดหนี้ ใบกำกับภาษี = **ในประกัน** / ใบลดหนี้ = **นอกประกัน** |
---
## 🧠 Mental Model ที่ถูกต้อง (CRITICAL — อ่านก่อนทุกอย่าง)
### Portal = UI Layer เท่านั้น — BC365 = System of Record
```
User (Browser)
↓
Sangwijit Web Portal ← React/Vue + TypeScript + Tailwind CSS
↓ REST API
BC365 Business Central ← Ledger, Posting, Stock, Document Number
↓
Azure / SQL (BC Database)
```
**WRONG (ห้ามคิดแบบนี้):**
- ❌ Portal มี Database ของตัวเอง (ไม่มี — ดึงข้อมูลจาก BC ทั้งหมด)
- ❌ Portal Post Transaction เองโดยไม่ผ่าน BC
- ❌ UI ออกแบบอิสระโดยไม่ดู BC Entity / Field
**CORRECT:**
- ✅ Portal = Smart Frontend + Workflow Engine ที่ call BC REST API
- ✅ ทุก Post / Confirm → ส่งไป BC แล้วค่อย Refresh หน้าจอ
- ✅ Status, เลขที่เอกสาร, ราคา → มาจาก BC เสมอ
### Service Account Strategy
- ใช้ BC Service Account **1 บัญชี** (ลดค่า License)
- Portal ทำ RBAC เอง (ไม่พึ่ง BC Permission ต่อ User)
- Retry + Queue เมื่อ BC API ช้าหรือ Error
---
## 📦 Modules Overview
### 9 Core Modules + Extensions (v2.1 — Confirmed)
| Module | ย่อ | Phase | หน้าจอหลัก |
|---|---|---|---|
| Sales | SL | P1 | Quotation, SO, Invoice, Credit Memo, Deposit, Cash Sale |
| Warehouse | WH | P1 | GRN, Issue, Transfer, Adjust, Stock Card, Serial |
| Purchase | PO | P1 | PR, PO, GRN, AP Invoice, Credit Memo, Vendor Return, **Sale-In Accrual (PO-7)**, **PO บิลฝาก (PO-8)** |
| Finance | FI | P1+P2+P3 | AR Receive, AP Payment, Expense Voucher (P2), Bank Recon, Credit Control (P2), Period Close, **Fixed Asset (FI-9/10/11)**, **WHT (FI-12)**, **Dual-Book (FI-13)** |
| Service & Delivery | SV | P2 | Service Queue, Job Card, QA Close, Delivery & Installation (4.x), Mobile (Group A) |
| Promotion/Pricing | PM | P1+P3 | Price List, Step Discount, Bundle, Promotion Scheme, Quota, Simulator |
| Master Data | MD | P1 | Item, Customer, Vendor, Employee (ใหม่), Branch & Warehouse (ใหม่) |
| System Config | CF | P1 | Tax Setup, Number Series, Customer/Vendor Config, Bin Policy, Item Config |
| Claims | CL | P2 | Claims List, CN, AP CM, Approval |
| Integration/API | IA | P2+P3 | API Monitor, Webhook, BC Sync Status, Error Log |
| e-Tax Invoice | TX | P2 | XML Generator, Digital Signature, RD API, WHT |
| Marketplace | MK | P3 | Order Inbox, SKU Map, Stock Sync, Tab ออนไลน์ใน Sales |
| Mobile App | MB | P2/P4 | Group A: Service Tech (P2), Group B: Manager (P4) |
| HRM Hook | HR | P3 | Employee Directory, Leave Status, Commission Hook |
**กฎแยก Master Data vs System Config:**
- **Master Data (MD)** = ข้อมูลอ้างอิงที่ User สร้างขึ้น (Item, Customer, Vendor, Employee, Branch)
- **System Config (CF)** = ตั้งค่าระบบโดย Admin (Tax Code, Number Series, Posting Group, Bin Policy)
- **Promotion Scheme** อยู่ใน Promotion module ไม่ใช่ Config → เพราะเกี่ยวข้องกับ Business Logic การขาย
---
## 🎨 UI Design Principles (7 หลักการ — ห้ามละเมิด)
1. **BC-First Data** — ทุก Field ต้องมาจาก BC Entity ที่ระบุในเอกสาร
2. **Progressive Disclosure** — แสดงข้อมูลตาม Role และ Context
3. **Status-Driven UI** — สีและ ActionBar เปลี่ยนตาม Document Status เสมอ
4. **Shared Component First** — ดู SC1-SC9 ก่อนสร้าง Component ใหม่
5. **Bilingual Ready** — ทุก Label มี Key ทั้งไทยและอังกฤษ
6. **Error Recovery** — ทุก API Error ต้องมี User-readable Message + Retry
7. **RBAC Everywhere** — Field, Button, Route ต้องเช็ค Permission
---
## 📐 ERP Transaction Form — Standard Structure (7 Sections)
**ห้ามเปลี่ยนลำดับ Section เด็ดขาด**
```
┌─────────────────────────────────────────────────┐
│ 1. PAGE HEADER │
│ Module Title | Document Type | Status Badge │
│ Breadcrumb | Action Bar (context-sensitive) │
├─────────────────────────────────────────────────┤
│ 2. DOC HEADER │
│ Document No. | Date | Reference | Branch │
│ (Read-only ถ้า Posted/Confirmed) │
├─────────────────────────────────────────────────┤
│ 3. PARTY │
│ SC1/CustomerSearch หรือ Vendor Search │
│ Auto-fill: Price Group, Credit, Address │
├─────────────────────────────────────────────────┤
│ 4. LINE ITEMS │
│ SC2/ItemSearch | Qty | Price | Discount | VAT│
│ Serial Panel (SC8) | Inline Edit | Add Row │
├─────────────────────────────────────────────────┤
│ 5. TABS (ตามประเภทเอกสาร) │
│ Payment | Delivery | Reference | Notes | Log │
├─────────────────────────────────────────────────┤
│ 6. SUMMARY │
│ Subtotal | Discount | VAT 7% | Total (THB) │
│ Deposit Applied | Net Due │
├─────────────────────────────────────────────────┤
│ 7. ACTION BAR (ล่าง — sticky) │
│ ปุ่มตาม Status + Role Permission │
└─────────────────────────────────────────────────┘
```
### ActionBar Modes ตาม Status
| Status | ปุ่มที่แสดง |
|---|---|
| Draft | Save Draft, Submit for Approval, Delete |
| Pending Approval | (Maker: รอ) / (Approver: Approve, Reject) |
| Confirmed | Post, Edit (ถ้า Role อนุญาต), Cancel |
| Posted | Print, Duplicate, View GL Entries |
| Cancelled | View Only |
---
## 🏷️ Status System — สีมาตรฐาน (ห้ามใช้สีอื่น)
| Status | สี | Hex | ใช้กับ |
|---|---|---|---|
| Draft | Gray | #6B7280 | ทุกเอกสาร |
| Pending Approval | Orange/Amber | #F59E0B | เอกสารที่ต้องอนุมัติ |
| Confirmed | Blue | #3B82F6 | อนุมัติแล้ว รอ Post |
| Posted | Green | #10B981 | Post สู่ BC แล้ว |
| Cancelled | Red | #EF4444 | ยกเลิก |
| Scheduled | Purple | #8B5CF6 | งานที่นัดไว้ล่วงหน้า |
| Live | Bright Green | #22C55E | Promotion ที่ Active |
| Expired | Brown/Warm Gray | #92400E | Promotion หมดอายุ |
---
## 🔧 Shared Components SC1-SC9 (Full Spec)
### ตาราง Usage Matrix — 130+ Screens (v2.1)
| SC | ชื่อ Component | หน้าจอที่ใช้หลัก |
|---|---|---|
| SC1 | SharedCustomerSearch | บิลขาย, ใบจอง, ใบเสนอราคา, ใบมัดจำ, ใบลดหนี้, Service Intake, รับเรื่องเคลม, อนุมัติวงเงิน, ประกบบิล AR |
| SC2 | SharedItemSearch | บิลขาย, ใบจอง, ใบเสนอราคา, PR, PO, RFQ, โอนสินค้า, GRN, เบิกอะไหล่, Stock Count |
| SC3 | SharedPaymentPanel | บิลขาย, ใบมัดจำ, ใบจอง, ใบลดหนี้ขาย, ตัดชำระเจ้าหนี้, PO-8 Deposit Bill |
| SC4 | SharedDeliveryPanel | บิลขาย (③ จัดส่ง/ติดตั้ง), ใบจอง, Transfer Order (ปลายทาง) |
| SC5 | SharedDocRefPanel | ทุกเอกสารที่มี Reference: บิลขาย←Quote/จอง/มัดจำ, PO←PR/RFQ, Service←บิล, GR←PO, PO-8←PO |
| SC6 | SharedDepositPanel | บิลขาย (Payment Section), ใบจอง |
| SC7 | SharedTimeline | **ทุกเอกสาร** — Queue/Dashboard, Sales, WH, Purchase, Service, Finance, Claims, FA |
| SC8 | SharedSerialPanel | GRN, โอนสินค้า, ใส่ Serial หลังขาย, Stock Count, Service รับซ่อม, เบิกอะไหล่, Item Master |
| SC9 | SharedPromoPrice | ใบเสนอราคา, ใบจอง, บิลขาย (④ โปรฯ Auto-Match), Employee Master (Commission), Sales Price List |
| **SC10** | **SharedVendorSearch** *(NEW)* | **PR, PO, AP Invoice, PO-7 Accrual, PO-8 Deposit Bill, FI-2 AP Payment, FI-12 WHT** |
---
### SC1 — SharedCustomerSearch
```
Search Fields (v2 — เพิ่มจากเดิม):
รหัสลูกค้า, ชื่อ (TH), นามสกุล (TH), ชื่อ (EN), เบอร์โทร, Email,
เลขผู้เสียภาษี, รหัสบัตรประชาชน (ID Card), ที่อยู่ (partial search)
Filter:
ประเภทลูกค้า: บุคคลธรรมดา / นิติบุคคล / ราชการ / Walk-in
กลุ่มลูกค้า: ค้าปลีก / ค้าส่ง / ดีลเลอร์ / ออนไลน์
กลุ่มราคา: A / B / C / VIP (Price List Group)
สาขาที่สังกัด: HQ / สาขา 1 / สาขา 2 / ...
สถานะ: Active / Blocked / Overdue
มียอดค้าง: All / มี AR ค้าง / ไม่มี
Search: Real-time ≥ 2 ตัวอักษร; Keyboard + ID Card Scan (Post GoLive)
Result: รหัส, ชื่อ-นามสกุล, ประเภท, กลุ่มราคา, วงเงิน, คงเหลือ, เบอร์, สาขา, Overdue Badge
Auto-fill: Party Section + ดึง Price List/โปร ตามกลุ่มลูกค้า
Blocked: สถานะ Blocked → Warning + ขออนุมัติก่อนเปิดบิล (ห้ามผ่าน)
Quick-Create: สร้างลูกค้าใหม่จาก popup (Draft status, รอ KYC ภายหลัง)
Customer 3 Address: ที่อยู่บัตรปชช / ที่อยู่จัดส่ง / ที่อยู่ออกใบกำกับ
API: GET /customers?$filter=..., GET /customers/{id}, POST /customers
```
### SC2 — SharedItemSearch
```
Search Fields (v2 — เพิ่มจากเดิม):
รหัสสินค้า, ชื่อ (TH), ชื่อ (EN), ยี่ห้อ/แบรนด์, รุ่น/Model, Barcode/QR
Filter:
หมวดสินค้า: แอร์ / พัดลม / เครื่องซักผ้า / ตู้เย็น / TV / เครื่องครัว / อื่นๆ
ยี่ห้อ/แบรนด์: Daikin / Mitsubishi / Samsung / LG / Toshiba / ...
ช่วงราคา: 0-5K / 5K-15K / 15K-50K / 50K+
สถานะ: Active / Discontinued / Pending
สต็อก: All / มี Stock > 0 / หมดสต็อก / สต็อกต่ำ (< Min)
สาขา/คลัง: เฉพาะคลังที่ระบุ (Stock by Location)
Serial Flag: All / มี Serial / ไม่มี Serial
Search: Keyboard + Barcode Scan; แสดงสต๊อก real-time แยกตามคลัง
Result: รหัส, ชื่อ, หมวด, ยี่ห้อ, รุ่น, UOM, ราคาตามกลุ่มลูกค้า, สต๊อก, สต๊อกจอง, Serial Flag
Alt Items: แสดงสินค้าทดแทน + Bundle แนะนำเมื่อสต๊อกหมด
Serial: Serial Flag = true → เปิด SC8 อัตโนมัติใน line
Inline Edit: แก้ไขข้อมูล line ได้เลย ห้ามใช้ Popup
Import/Export: Serial No. Import/Export CSV ที่ระดับ Line
API: GET /items?$expand=itemVariants, GET /items/{id}/stockByLocation
GET /priceLists?customerId=&date=
GET /itemCategories → ดึงหมวดสินค้า
```
### SC3 — SharedPaymentPanel
```
ยอด: ยอดสุทธิ, ยอดมัดจำที่หัก, ยอดคงเหลือ, VAT, ส่วนลดท้ายบิล
VAT Options: รวม VAT / ไม่รวม VAT / ไม่แสดง VAT (กลมยอด) — เลือกต่อเอกสาร
วิธีชำระ: เงินสด, โอน, เช็ค, บัตรเครดิต/เดบิต, QR Payment, เครดิต, บางส่วน
Split: เลือกหลายวิธีต่อบิลได้ (split payment)
เครดิต: ตรวจวงเงิน real-time → เกิน → Auto trigger Approval Flow
Status: ยังไม่ชำระ / ชำระบางส่วน / ชำระครบ / เกินกำหนด / รออนุมัติวงเงิน
QR Payment (2 layers) — EMVCo PromptPay via Biller ID (SWT):
• ชั้น 1 — Invoice QR : Ref1 = เลขที่บิล, ยอด fix → ลูกค้าจ่ายตรงบิลเดียว
• ชั้น 2 — Customer QR : Ref1 = รหัสลูกค้า, ยอด open/ค้างรวม/ระบุ
→ ส่งลูกค้าทาง LINE, จ่ายได้หลายบิลพร้อมกัน, แยก FI-1Q Apply Queue
• เงินเข้า → bank statement → IA-Q sync → URC → FI-1Q Queue → auto-apply
```
### SC4 — SharedDeliveryPanel
```
จัดส่ง: ที่อยู่จัดส่ง, ผู้รับ, เบอร์, วันที่-ช่วงเวลา, วิธีจัดส่ง
ติดตั้ง: ต้องการติดตั้ง (Y/N) → auto-create Service Work Order หลัง Post
Status: รอจัดส่ง → กำลังจัดส่ง → ส่งแล้ว → ติดตั้งเสร็จ
QR Track: ลูกค้าดูสถานะผ่าน QR Code บนใบเสร็จ
```
### SC5 — SharedDocRefPanel
```
ดึงเอกสาร: แต่ละประเภทกำหนด Source ที่ดึงได้:
บิลขาย ← Quote, ใบจอง, มัดจำ
PO ← PR, RFQ
Service ← บิลขาย (serial ref)
GR ← PO
Partial: ดึงบางส่วนได้; ติดตามยอดที่ดึงไปแล้ว vs. เหลือ
Cascade: ดึงมา → auto-fill รายการสินค้า + ลูกค้า
Chain Link: กด PO → เห็น PR ต้นทาง / กด Invoice → เห็น Shipment ปลายทาง
```
### SC6 — SharedDepositPanel
```
ค้นหา: เลขมัดจำ / เลขจอง / ลูกค้า — แสดงเฉพาะที่ยังตัดได้
ตัดมัดจำ: ยอดทั้งหมด, ใช้แล้ว, คงเหลือ, จะตัดในบิลนี้
หลายใบ: รองรับหลายใบมัดจำต่อบิลเดียว
Auto: ตัดครบ → สถานะมัดจำ = Fully Applied → บันทึก AR Ledger
สร้างใหม่: จากใบจองหรือ Stand-alone → auto generate เลขที่, พิมพ์ได้ทันที
```
### SC7 — SharedTimeline (Audit Log)
```
Document Chain: แสดง Quote→จอง→มัดจำ→Invoice→Shipment→Payment
คลิกเอกสารใดก็ข้ามไปได้
Reverse Link: บิลขายรู้ว่ามี Shipment/Payment ไหนอ้างอิงมา
Activity Log: ทุก Action อัตโนมัติ (สร้าง/แก้/อนุมัติ/ปฏิเสธ/พิมพ์) — ลบไม่ได้
Comment: Internal note + mention @พนักงาน → Notification; ไม่แสดงลูกค้า
PDPA: Phase 1 ต้องมี Audit Log ทุก Access
```
### SC8 — SharedSerialPanel
```
กรอก/สแกน: กรอก Manual หรือ Scan Barcode; validate ไม่ซ้ำ real-time
Bulk: Upload CSV (กรณีจำนวนมาก)
ประวัติ: กด "ดูประวัติ" → lifecycle ทั้งหมด: รับเข้า→ขาย→ซ่อม→เคลม
Status: ว่าง / ใช้งานอยู่ / ซ่อม / เคลม
Serial Policy: ไม่บังคับตอนขาย — บังคับตอนคลัง "เบิก" เท่านั้น
```
### SC9 — SharedPromoPrice
```
ราคา: ดึง Price List ตามกลุ่มลูกค้า + ช่องทาง + วันที่บิล; ใช้ Priority สูงสุด
โปร Badge: แสดง badge บน line item; คลิกดูเงื่อนไขได้
ของแถม: auto-add Free Item Line (ราคา 0, flag Gift) เมื่อครบเงื่อนไข
Price Alert: แจ้งเมื่อราคาจะเปลี่ยนภายใน N วัน
Override: แก้ราคาต่ำกว่า Floor → Auto Approval Flow + บันทึก Override Log
Accrual: ขายสินค้าที่มี Vendor Sale-In → บันทึก Accrual Entry อัตโนมัติ
Commission: บันทึก PC Commission record แนบกับบิล
Priority: Contract Price > Step Discount > Bundle > Trade-in > Normal
Block [T6]: คำนวณที่ Portal หรือ BC? — ยังไม่ตัดสินใจ
```
### SC10 — SharedVendorSearch (NEW)
```
Search Fields:
รหัส Vendor, ชื่อบริษัท (TH/EN), เบอร์โทร, Email, เลขผู้เสียภาษี,
ชื่อผู้ติดต่อ (Contact Person)
Filter:
ประเภท Vendor: สินค้า / บริการ / ค่าเช่า / ค่าขนส่ง / อื่นๆ
WHT Category: 1% / 2% / 3% / 5% / ไม่หัก
สถานะ: Approved / Pending Approval / Blocked
Credit Term: Cash / 30 วัน / 60 วัน / 90 วัน
มี AP ค้าง: All / มี AP ค้าง / ไม่มี
Search: Real-time ≥ 2 ตัวอักษร
Result: รหัส, ชื่อ, ประเภท, WHT Category, Credit Term, AP Outstanding, สถานะ
Auto-fill: Vendor Section + ดึง WHT Rate + Credit Term + Price List
Blocked: Vendor ยังไม่ Approve → ห้ามสร้าง PO (ต้องผ่าน PO-3 Onboarding ก่อน)
ใช้ใน:
PO-1 (PR), PO-4 (PO), PO-6 (AP Invoice), PO-7 (Accrual), PO-8 (Deposit Bill)
FI-2 (AP Payment), FI-12 (WHT)
API: GET /vendors?$filter=..., GET /vendors/{id}, POST /vendors
GET /vendorLedgerEntries?vendorId=&open=true → AP ค้าง
```
---
## 🔌 BC365 API — Endpoints หลัก
### Pattern มาตรฐาน
```
Base: https://{tenant}.api.businesscentral.dynamics.com/v2.0/{tenant}/Production/api/v2.0/
Auth: OAuth2 Client Credentials (Service Account)
Retry: Exponential Backoff (3 ครั้ง), Queue เมื่อ Timeout
```
### Sales Module
```
GET /salesQuotes → SO Draft list
POST /salesOrders → สร้าง SO
PATCH /salesOrders/{id} → แก้ไข SO (ก่อน Post)
POST /salesOrders/{id}/post → Post SO → Invoice + Stock
POST /salesCreditMemos → CN
POST /salesOrders/{id}/shipmentLines → Delivery
```
### Warehouse
```
GET /locations → คลังทั้งหมด
GET /items/{id}/stockByLocation
POST /purchaseReceipts → GRN
POST /inventoryAdjustments → Adjust
POST /itemTransferOrders → Transfer
GET /serialNumbers?itemId= → Serial Lookup
```
### Purchase
```
POST /purchaseOrders → PO
POST /purchaseOrders/{id}/receive → GRN (ตัด Stock)
POST /purchaseInvoices/{id}/post → AP + GL
POST /purchaseCreditMemos → Vendor Return/CN
```
### Finance
```
POST /cashReceiptJournals → AR Receive
POST /vendorPaymentJournals → AP Payment
POST /generalJournals → JV / Accrual
POST /bankAccounts/{id}/reconcile → Bank Recon
POST /accountingPeriods/{id}/close → ปิดงวด
```
### Service (BC Extension Required)
```
GET /serviceOrders → [?] Standard BC มีหรือต้อง Custom?
POST /serviceOrders → สร้าง Job Card
PATCH /serviceOrders/{id} → อัปเดตสถานะ
POST /serviceOrders/{id}/complete → ปิดงาน → Auto AP ช่าง
```
---
## 👥 RBAC — Permission Matrix (28 Functions × 9 Roles)
| ฟังก์ชัน | Super Admin | บัญชี | จัดซื้อ | ฝ่ายขาย | คลัง | ศูนย์บริการ | ช่าง | ฝ่ายเคลม | ผู้บริหาร |
|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| จัดการ User/Role | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| เปิดบิลขาย | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| ใบจอง / ใบเสนอราคา | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| สร้างลูกค้า | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| รับสินค้าเข้า (GRN) | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | 🔍 |
| โอนสินค้าคลัง | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | 🔍 |
| สร้าง Vendor | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| เสนอราคา Supplier (RFQ) | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| ตั้งหนี้สินค้า (AP Invoice) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| ตั้งหนี้โปร/รีเบต | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| อนุมัติ PO | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| รับสินค้าซ่อม | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | 🔍 |
| นัดหมายคิวช่าง | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | 🔍 |
| ช่างรับงาน (Mobile) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
| เบิกอะไหล่ซ่อม | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | 🔍 |
| เบิกค่าแรงช่าง | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | 🔍 |
| รับเรื่องเคลม | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | 🔍 |
| ส่งเคลม Supplier | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | 🔍 |
| ติดตามสถานะเคลม | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | 🔍 |
| ใบตั้งหนี้ / ใบจ่ายเงิน | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| ตัดหนี้เจ้าหนี้ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| ประกบบิลลูกหนี้ (AR) | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| วงเงินลูกค้า / Credit | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| คืนเงินลูกค้า (CN) | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| บันทึกค่าใช้จ่าย | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| กระทบยอดธนาคาร | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 🔍 |
| Field-Level Permission | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| ดูรายงานรวม | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
> 🔍 = View Only (ผู้บริหาร) | ✅ = Full Access | ❌ = No Access
**กฎ RBAC ที่ห้ามละเมิด:**
- Maker ≠ Checker: ห้าม Approve งานตัวเอง (บังคับทุกโมดูลที่มี Approval)
- Field-Level: ราคาต้นทุน, วงเงิน Credit → ซ่อนตาม Role
- Route Guard: ป้องกัน URL ที่ไม่มีสิทธิ์
- Approval Matrix: กำหนดใน System Config ว่า Tier ไหน → Approver คนไหน
---
## 📅 Phase Plan
### Phase 1 — Run ASAP
**โมดูล:** Sales, Warehouse, Purchase Basic, Price List P1, Finance Basic (AR/AP/JV), Master Data, System Config
**เงื่อนไข Go-Live:** Master Data พร้อม + BC Sandbox ผ่าน
**Key Deliverables:** SC1-SC9 ครบ → Sales SO/Invoice → WH GRN/Issue → PO/GRN/AP → AR/AP Basic
### Phase 2 — Scale & Control
**โมดูล:** Step Discount/Bundle, Credit Memo, Service+Delivery (4.x), Claims, Finance 2.5 Expense Voucher, Finance 2.6 Credit Control, Bank Recon, Integration/API Monitor, e-Tax Invoice, Mobile App Group A (ช่าง)
**เงื่อนไข:** Phase 1 UAT ผ่าน
**Key Deliverables:**
- Service Queue/JobCard + Delivery & Installation sub-module (4.1-4.3)
- Expense & Payment Voucher (จ่ายค่าใช้จ่ายทั่วไป)
- Credit Control Dashboard (ติดตามวงเงิน + Alert ลูกหนี้เกิน)
- Integration API Monitor (สถานะ Sync BC / Error Log)
- e-Tax XML + RD API, Mobile Service Tech
### Phase 3 — Automate
**โมดูล:** Finance Full (Period Close / Tax Report), Promotion Full, Accrual Auto, Real-time, Service Notification+Performance, Marketplace (Shopee/Lazada)
**เงื่อนไข:** Phase 2 Stable
**Key Deliverables:** Marketplace Tab ออนไลน์ใน Sales, Order Inbox, Stock Sync, Technician Performance Dashboard
### Phase 4 — Optimize
**โมดูล:** Trade-in, Promo Simulator, Advanced SLA, Mobile App Group B (ผู้บริหาร), Marketplace Dashboard, BI/KPI Full, PDPA
**เงื่อนไข:** Phase 3 Stable
---
## 🇹🇭 Thailand Compliance
### e-Tax Invoice (Phase 2)
| Component | รายละเอียด |
|---|---|
| XML Generator | ออก Tax Invoice XML ตาม RD Standard |
| Digital Signature | Sign ด้วย Certificate ขององค์กร |
| RD API Connector | ส่ง XML ไป RD Portal + รับผลกลับ |
| Status Tracker | Pending → Submitted → Accepted / Rejected |
| WHT Certificate | ภ.ง.ด.3 / 53 — ตาม B10 (Auto/Manual TBD) |
| e-Filing Dashboard | รายการที่ส่งแล้ว, ยังไม่ส่ง, Rejected |
> ⚠️ [T9] ต้องตรวจก่อนว่า BC365 Standard Thailand Extension ครอบคลุมหรือต้อง Custom
### VAT & WHT
- VAT 7% บังคับทุกใบกำกับภาษี
- WHT (ภ.ง.ด.3/53) ตัดเมื่อ AP Payment
- ทุก Posted Document ต้องมี Tax Invoice No. ที่ถูกต้อง
### PDPA (Phase 4)
- Consent Record + Withdrawal Flow
- Data Retention Policy + Auto-Delete Hook
- Audit Log ทุก Access — SC7 ต้องมีตั้งแต่ Phase 1
---
## 🛒 Marketplace Integration (Phase 3)
### Concept: POS-Style Tab ใน Sales Module
```
Sales Module
├── Tab: ขายหน้าร้าน ← Sales Order ปกติ
└── Tab: ออนไลน์ ← Marketplace Orders (ใหม่ Phase 3)
├── Order Inbox (Shopee + Lazada)
├── SKU Mapping Manager
├── Auto-Create SO in BC
├── Stock Sync (BC → Marketplace)
└── Shipping Tracking
```
### Business Rules
- คำสั่งซื้อ Marketplace → Auto-create SO ใน BC (ยืนยันหรือ Auto)
- Stock Sync: BC คือ Source of Truth → Push ไป Marketplace [T12]
- Return จาก Marketplace → Credit Memo Flow ปกติ
> ⚠️ [T10] Shopee/Lazada Partner Account และ Production Key พร้อมหรือยัง?
---
## 📱 Mobile App (2 Groups)
### Group A — Service Tech (Phase 2, เร่งด่วน)
- รับ Job Card / นัดหมาย
- บันทึกผลงาน + รูปถ่าย Before/After
- Check-in/out ที่หน้างาน
- บันทึกอะไหล่ที่ใช้
- [T1] Native / PWA / Responsive Web?
- [T2] Offline Mode?
### Group B — Manager/Sales (Phase 4)
- Sales Dashboard + KPI ส่วนตัว
- อนุมัติ Quotation / SO จากมือถือ
- ดูสต็อก Real-time
- Service Performance Report
---
## ⚠️ Open Questions — ห้าม Implement จนกว่าจะได้คำตอบ
### Technical
| # | คำถาม | Phase |
|---|---|---|
| T1 | Mobile: Native / PWA / Responsive Web? | P2 |
| T2 | Offline Mode ช่าง: Sync ยังไง? | P2 |
| T5 | BC Extension: Standard หรือ Custom AL? | P1 |
| T6 | Promotion Engine: คำนวณที่ Portal หรือ BC? | P1 |
| T9 | e-Tax: BC365 Standard Thailand Extension ครอบคลุมไหม? | P2 |
| T10 | Marketplace: Partner Account พร้อมหรือยัง? | P3 |
| T11 | Customer Notification: SMS หรือ LINE Notify? | P3 |
| T12 | Stock Sync Marketplace: Real-time หรือ Batch? | P3 |
### Business Rules
| # | คำถาม | Phase |
|---|---|---|
| ~~B1~~ | ~~Promotion Conflict Priority~~ ✅ **RESOLVED** — Priority Number + Stack ≤ 2 ชั้น (ดู PM_promotion.md) | P1 |
| ~~B5~~ | ~~Credit Approval Tier~~ ✅ **RESOLVED** — ทั้งฝั่งขาย (SL-F1) + ฝั่งซื้อ (PO) ตั้งใน CF-7 | P1 |
| B6 | Deposit GL Account | P1 |
| B9 | SLA กี่ชั่วโมงต่อ Doc Type? | P2 |
| ~~B10~~ | ~~WHT Certificate: Auto หรือ Manual?~~ ✅ **RESOLVED** — Auto จาก FI-2 AP Payment → WHT List (FI-12) → Release → Print | P1 |
| C1 | ⚠️ COA Mapping ระหว่าง 4 บริษัท (SWT/SWE/VMN/WPS) → ใช้ COA เดียวกันหรือต่างกัน? | P3 |
| C2 | ⚠️ Intercompany Transaction Threshold → จำนวนเท่าไหร่ถึง Auto-detect? | P3 |
---
## 🤖 วิธีออกแบบ Module ใหม่ (Template)
เมื่อขอออกแบบ Module หรือหน้าจอใหม่ ให้ตอบครอบคลุม:
### 1. Module Brief
```
Module: [ชื่อ]
Phase: [P1/P2/P3/P4]
BC Entity: [API Endpoint ที่เชื่อม]
Trigger: [อะไร trigger หน้าจอนี้]
Output: [เอกสารหรือ Action ที่เกิดขึ้น]
```
### 2. Screen List
```
[Module Code]-1: [ชื่อหน้า List/Queue]
[Module Code]-2: [ชื่อหน้า Form/Detail]
[Module Code]-3: [หน้า Approval/Review ถ้ามี]
```
### 3. ERP Transaction Form Breakdown
ระบุ Field ทั้ง 7 Sections ว่ามีอะไรบ้าง + BC Field Mapping
### 4. Status Flow
```
Draft → Submitted → Approved → Posted/Confirmed → (Cancelled)
```
### 5. Shared Components ที่ใช้
ระบุ SC ที่ต้องใช้พร้อม Config
### 6. RBAC
ระบุ Role + Permission (Create/Edit/Approve/Post/Cancel)
### 7. BC API Calls
ระบุ GET/POST/PATCH ที่ต้องใช้
### 8. Open Questions ที่ Block
ระบุ Question Number จาก Section Open Questions
---
## 📂 Module Spec Files (รายละเอียดทีละเมนู)
| ไฟล์ | Module | เมนูที่ครอบคลุม |
|---|---|---|
| `modules/SL_sales.md` | งานขาย (SL) | Quotation, Reservation, Deposit, **Invoice (5 ส่วน: สินค้า/ชำระ/จัดส่ง/โปรฯ/ใบกำกับ)**, Credit Memo, Credit Approval |
| `modules/PO_purchase.md` | งานจัดซื้อ (PO) | PR, RFQ, Vendor Onboarding, PO, GRN, AP Invoice, **Sale-In Accrual (PO-7)**, **PO บิลฝาก (PO-8)** |
| `modules/WH_warehouse.md` | งานคลัง (WH) | Queue, GRN, Transfer, Sales Issue, Stock Count, Stock Card, **Non-Move Report (WH-NM)** |
| `modules/FI_finance.md` | งานการเงิน (FI) | AR Receipt, AP Payment, Bank Recon, JV, Expense Voucher (P2), Credit Control (P2), Period Close (P3), **Accrual Monitor (FI-8)**, **Fixed Asset (FI-9/10/11)**, **WHT (FI-12)**, **Dual-Book (FI-13)** |
| `modules/SV_service.md` | งานบริการ + เคลม (SV+CL) | Service Intake, Job Card, Parts, QA Close, Delivery & Install, Claims 3 ประเภท |
| `modules/PM_promotion.md` | โปรโมชั่น (PM) | Price List, Promotion Scheme, Bundle/Step Discount, Quota, Simulator *(PM-6 Accrual ย้ายไป PO-7)* |
| `modules/MD_master.md` | ข้อมูลหลัก (MD) | Item, Customer, Vendor, Employee (NEW), Branch & Warehouse (NEW), Price List |
| `modules/CF_config.md` | ตั้งค่าระบบ (CF) | Tax, Number Series, RBAC, Posting Groups, Bin Policy, Technician Template, Approval Matrix |
| `modules/IA_integration.md` | Integration & API (IA) | BC Sync Monitor, Error Log, Webhook, Marketplace Connector (P3), Entity Explorer (P3) |
> อ่าน Module Spec ก่อนออกแบบหน้าจอใด ๆ ในโมดูลนั้น
---
## 📁 Reference Files ใน Workspace
| ไฟล์ | ใช้เพื่อ |
|---|---|
| `research.md` | ภาพรวมระบบ, Open Questions, Module Spec ครบ |
| `plan.md` | Task Breakdown ทุก Phase, สถานะ Task |
| `ui_design_pattern_guideline.md` | Design Rules, ERP Form 7 Sections, SC Spec, RBAC |
| `README.md` | Project Overview, 68 Screens, Phase Overview |
| `uxui_field_knowledge.docx` | Field Spec ทีละหน้าจอ |
| `1_component_fw_clean.docx` | Technical Spec SC1-SC9 |
| `sangwijit_reference_rev2.docx` | Business Reference + Gap Analysis |
| `dd_sales_phase1.docx` | Data Dictionary Phase 1 (Sales) |
| `dd_wh_pur_phase2.docx` | Data Dictionary Phase 2 (WH + Purchase) |
| `dd_finance_phase3.docx` | Data Dictionary Phase 3 (Finance) |
| `dd_svc_promo_master_phase4.docx` | Data Dictionary Phase 4 (Service/Claims/Promo/Master) |
| `sales-invoice-compact.html` | HTML Prototype — ตัวอย่าง UAT ชุดแรก |
### ลำดับการอ่านเอกสาร (Document Reading Order)
1. `research.md` — เริ่มที่นี่เสมอ
2. `plan.md` — Task Status + Blocked Items
3. `ui_design_pattern_guideline.md` — Design Rules
4. `uxui_field_knowledge.docx` — Field Detail ทีละหน้าจอ
5. `1_component_fw_clean.docx` — SC Technical Spec
6. Data Dictionary ตาม Phase
7. Workflow PDF — BC365 Mapping จริง
---
## 🔄 Status Transition Diagrams (ทุก Module)
### Sales / Invoice / Promotion / Claims
```
Draft → รออนุมัติวงเงิน → อนุมัติ → ออกใบกำกับแล้ว → ชำระเงินแล้ว → ปิดงาน
↓
ปฏิเสธ → Draft (แก้ไข/ส่งใหม่)
```
### Purchasing (PR → PO → GRN → AP)
```
Draft → รออนุมัติ → อนุมัติแล้ว → PO Open → สินค้าเข้าแล้ว → รอวางบิล → ปิดรายการ
↓
Rejected → Draft (แก้ไข/ส่งใหม่)
```
### Warehouse
```
Draft → รอตรวจสอบ → อนุมัติ → สินค้าเข้า/ออกแล้ว → ปิดงาน
```
### Service / ศูนย์บริการ
```
Draft → นัดหมายแล้ว → รอช่าง → ดำเนินงาน → ส่งงาน/รออนุมัติ → ปิดงาน
↓ (ช่างนอก)
ตั้งหนี้ช่าง
```
### Promotion / Accrual Claim (Supplier)
```
Draft → รออนุมัติ → Active → Claim → รอเงินเข้า → รับเงินแล้ว
↓
Expired
↓
Rejected → Draft
```
### AR / Credit
```
Draft → รออนุมัติ → อนุมัติ → วางบิล → ค้างชำระ → รับชำระแล้ว → ปิดบัญชี
↓
ปฏิเสธ → Draft
```
### Finance / Expense / AP / Tax
```
Draft → รออนุมัติ → อนุมัติ → จ่ายแล้ว → ปิดงาน
↓
ปฏิเสธ → Draft
```
### Online / Marketplace
```
Draft → รอตรวจสอบ → อนุมัติ → จัดส่งแล้ว → ปิดงาน
```
---
## 🎨 UX Rules — Confirmed Patterns (Oct 2025)
กฎ UX ที่ confirm แล้ว ห้ามละเมิด:
| # | กฎ | รายละเอียด |
|---|---|---|
| UX1 | **Inline Edit** | แก้ไข Line Items ได้เลยที่บรรทัด — ห้ามใช้ Popup |
| UX2 | **Barcode Scan** | ทุกช่องที่เหมาะสม (Item, Serial) รองรับ Barcode Scan |
| UX3 | **Serial Import/Export** | ที่ Line Level — ปุ่ม Import/Export CSV |
| UX4 | **Document Chain** | กดจาก PO → เห็น PR ต้นทาง ย้อนกลับได้ (SC5) |
| UX5 | **Show More/Less** | ซ่อน Field ที่ไม่ใช้บ่อย — ปุ่มขยาย/ย่อ |
| UX6 | **3 Address Types** | ลูกค้ามีที่อยู่ 3 แบบ: บัตรปชช / จัดส่ง / ใบกำกับภาษี |
| UX7 | **VAT Options** | ต่อเอกสาร: รวม VAT / ไม่รวม VAT / ไม่แสดง VAT |
| UX8 | **Bundle Item** | ต้องมีหน้าจอรองรับสินค้าชุด |
| UX9 | **QR Status Track** | ลูกค้าดูสถานะสินค้า/จัดส่งผ่าน QR Code บนใบเสร็จ |
| UX10 | **QR Payment (2 layers)** | (1) Invoice QR (Ref1=INV, ยอด fix) บน SL-3/SL-4 · (2) Customer QR (Ref1=CustCode, ยอด open) บนหน้าค้นลูกค้า + MD-2 → ส่ง LINE → FI-1Q Apply Queue |
| — | ID Card Scan | Post Go-Live |
| — | Document Flow Visual | Post Go-Live |
| — | Web Filter ละเอียด | ใช้ Power BI แทน |
---
## 🗄️ BC365 API — Table Numbers Reference
| Module | Endpoint | BC Table |
|---|---|---|
| Sales Invoice | POST /salesOrders | Sales Header (36), Sales Line (37) |
| Sales Quote / Reservation | POST /salesQuotes | Sales Quote Header (6660), Sales Quote Line (6661) |
| Sales Prepayment (Deposit) | Custom API | Sales Prepayment Header (Custom) |
| Customer Create | POST /customers | Customer (18) |
| WH Transfer Order | POST /transferOrders | Transfer Header (5740), Transfer Line (5741) |
| Serial Entry | PATCH /itemLedgerEntries | Item Ledger Entry (32) |
| Vendor Create | POST /vendors | Vendor (23) |
| Purchase Order | POST /purchaseOrders | Purchase Header (38), Purchase Line (39) |
| Item Approve | POST /items | Item (27) |
| Service Receive | POST /serviceOrders | Service Header (5900), Service Line (5901) |
| Parts Requisition | POST /serviceItemComponents | Service Item Components (5943) |
| Claim | Custom API | Claim Custom Table |
| AP Invoice | POST /purchaseInvoices | Purchase Invoice Header (122), Purchase Invoice Line (123) |
| Payment Journal | POST /paymentJournals | Gen. Journal Line (81) |
| AR Match | POST /salesInvoices | Sales Invoice Header (112), Sales Invoice Line (113) |
| Credit Limit | PATCH /customers | Customer (18) — CreditLimit field |
| Sales Credit Memo | POST /creditMemos | Sales Credit Memo Header (114) |
---
## 🚚 Service Module — Delivery & Installation Sub-module (Phase 2)
### Sub-module 4.x — บริการจัดส่งและติดตั้ง
| หน้าจอ | รหัส | รายละเอียด |
|---|---|---|
| Delivery Queue | SV-4.1 | คิวงานจัดส่ง/ติดตั้ง แสดงตาม Branch + วันที่ + สถานะ |
| Delivery Job Card | SV-4.2 | Form บันทึกงานจัดส่ง/ติดตั้ง (Serial, Address, Technician) |
| Delivery Completion | SV-4.3 | ปิดงาน: รูปถ่าย Before/After, ลูกค้าเซ็นรับ, Rating |
**Business Rules:**
- ทริก: Sales Invoice ที่มี Delivery Flag = true → สร้าง Delivery Job อัตโนมัติ
- Serial ต้องบันทึกก่อนปิดงาน (SC8)
- Address ใช้ SC1 → 3 Address Types (ที่อยู่จัดส่ง)
- ช่างใช้ Mobile App Group A เพื่อ Check-in / ถ่ายรูป
- Status Flow: `ใบแจ้งงาน → นัดหมาย → จัดส่ง → ติดตั้งสำเร็จ → ปิดงาน`
---
## 💰 Finance Module — ส่วนที่เพิ่มใหม่ (Phase 2)
### Finance 2.5 — Expense & Payment Voucher
```
วัตถุประสงค์: บันทึกค่าใช้จ่ายทั่วไป (ที่ไม่ผ่าน AP/PO) และออก Payment Voucher
หน้าจอ:
- Expense List: รายการค่าใช้จ่าย + สถานะ
- Expense Form: เจ้าหนี้ / ประเภทค่าใช้จ่าย / GL Account / Amount
- Payment Voucher: เลขที่ใบสำคัญ / วันที่จ่าย / วิธีชำระ (เช็ค/โอน)
Status Flow: Draft → รออนุมัติ → อนุมัติ → จ่ายแล้ว → ปิดงาน
BC API: POST /paymentJournals, POST /generalLedgerEntries
RBAC: Accountant (Create), Finance Manager (Approve+Post)
```
### Finance 2.6 — Credit Control Dashboard
```
วัตถุประสงค์: ติดตามลูกหนี้ที่เกินวงเงินหรือเกินกำหนดชำระ
หน้าจอ:
- Credit Control List: ลูกหนี้ทั้งหมด + ยอดค้าง + เกินกำหนดกี่วัน + Alert
- Customer Credit Profile: ประวัติชำระ, วงเงิน, เอกสารค้าง
- Alert Actions: ปล่อยให้ขายต่อ / Hold / ส่ง Notice
Business Rules:
- ถ้า Outstanding > Credit Limit → ขึ้น Alert สีแดงทุก Module
- ถ้า Overdue > 30 วัน → Email/LINE Notify อัตโนมัติ (B5)
- SC1 ต้องแสดง Credit Status ก่อน User เปิดบิลใหม่
BC API: GET /customerLedgerEntries?customerId=, PATCH /customers (credit fields)
```
---
## 🔌 Integration & API Module (Phase 2+3) — Module #8
### วัตถุประสงค์
ศูนย์กลางติดตามการเชื่อมต่อระหว่าง Portal ↔ BC365 ↔ ระบบภายนอก
### หน้าจอหลัก
| หน้าจอ | Phase | รายละเอียด |
|---|---|---|
| API Sync Monitor | P2 | แสดงสถานะการ Sync แต่ละ Module: ล่าสุดเมื่อ, Success/Fail Count |
| Error Log | P2 | รายการ API Error + Response Code + Retry Button |
| Webhook Config | P2 | กำหนด Webhook URL ที่รับ Event จาก BC (Post, Approve, etc.) |
| Marketplace Connector | P3 | ตั้งค่า Shopee/Lazada API Key, Sync Status |
| BC Entity Explorer | P3 | ดู BC Entity ที่ Portal ใช้ + Field Mapping Summary |
### Business Rules
- ทุก API Call ต้องมี Retry (3 ครั้ง) ก่อน Error Log
- Error ร้ายแรง → Alert Admin ผ่าน LINE Notify
- Log เก็บ 90 วัน (PDPA)
- Admin Only — ซ่อน Module นี้จาก Non-Admin Role
---
## 📂 Master Data vs System Config — แนวทางออกแบบ
### Master Data Module (MD) — ข้อมูลอ้างอิง
**ใครสร้าง:** User ทั่วไปที่มีสิทธิ์ (Sales Coordinator, Admin)
**ลักษณะ:** เปลี่ยนบ่อย ตามธุรกิจ
| หน้าจอ | รายละเอียด |
|---|---|
| Item Master | สินค้า: รหัส, ชื่อ TH/EN, หมวด, UOM, Serial Flag, ราคาต้นทุน |
| Customer Master | ลูกค้า: ข้อมูล KYC, กลุ่มราคา, วงเงิน, 3 Address |
| Vendor Master | ผู้จัดจำหน่าย: ข้อมูล + เงื่อนไขการค้า |
| Employee Master (ใหม่) | พนักงาน: รหัส, ชื่อ, ตำแหน่ง, Branch, Commission Rate |
| Branch & WH Master (ใหม่) | สาขา: ที่อยู่, Warehouse ที่สังกัด, Contact, Manager |
| Price List | ราคาตามกลุ่มลูกค้า / ช่วงเวลา |
### System Config Module (CF) — ตั้งค่าระบบ
**ใครสร้าง:** System Admin เท่านั้น
**ลักษณะ:** เปลี่ยนน้อย เป็น Base Setting ของระบบ
| หน้าจอ | รายละเอียด |
|---|---|
| Tax Setup | VAT Code, WHT Category (ภ.ง.ด.3/53) |
| Number Series | เลขที่เอกสารแต่ละประเภท (SO, PO, SI, etc.) |
| Item Config | Default Posting Group, Location Policy |
| Customer/Vendor Config | Credit Term Template, Payment Method Default |
| WH Bin Policy | กฎการจัดวางสินค้าในคลัง |
| Technician Template | Template การคิดค่าแรงช่าง |
| User & Role | RBAC Matrix, Permission Assignment |
---
## 🔨 Development Checklist (ก่อนเริ่ม Implement ทุกหน้าจอ)
```
[ ] ⚠️ ตรวจ folder ว่ามีไฟล์ซ้ำไหม → ถ้ามี ต้องถามก่อนเสมอ
(ดูตาราง "ไฟล์ซ้ำที่ตัดสินใจแล้ว" ใน Rule 2 เพื่อเทียบว่าเคยตัดสินใจแล้วหรือยัง)
[ ] 📄 อ่าน Flowchart ใน Flow Design/ ของ Module นั้นก่อน
→ ดู Status Flow, BC Entity, Document Format
[ ] อ่าน research.md + plan.md → ตรวจ Open Questions ที่เกี่ยวข้อง
⛔ ห้าม Implement ส่วนที่มี [?] จนกว่าจะตัดสินใจ
[ ] ดู Data Dictionary (dd_*.docx) — Field ครบหรือยัง?
[ ] ตรวจ Component Usage Matrix — SC ที่ยังไม่มีต้องพัฒนาก่อน Page
[ ] ยืนยัน RBAC: Role, Field Permission, ปุ่ม Disable
[ ] พัฒนาตาม ERP Form 7 Sections — ห้ามเปลี่ยนลำดับ
[ ] ใช้ StatusBadge สีตาม Standard — ห้ามใช้สีอื่น
[ ] ทุก Label มีทั้งไทยและอังกฤษ
[ ] Unit Test Coverage > 80%
[ ] TypeScript Strict + ESLint Airbnb + Prettier ก่อน PR
```
---
*Sangwijit Group © 2024–2026 | Proprietary — ห้ามเผยแพร่ภายนอก*
*Skill Version: 1.0 | เมษายน 2026*
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
