เริ่มตรงไหน

1. เข้าใช้งาน

1. เปิด Vexinio CRM บนเครื่องที่รันโปรแกรมอยู่
2. ใส่ Email และ Password แล้วกด Sign in
3. เลือก TH หรือ EN ด้านบน ภาษาเก็บตามบัญชีผู้ใช้
4. ใช้เมนูทางซ้ายซึ่งจัดเป็นหมวดงาน หากเมนูยาวให้เลื่อนภายในแถบเมนู บนมือถือกดปุ่ม เปิดเมนู มุมซ้ายบน เลือกหน้าแล้วเมนูจะปิดเอง ปิดด้วยปุ่ม ×, แตะพื้นหลัง หรือกด Escape ได้
5. เมื่อต้องการเปลี่ยนบัญชี กดไอคอนลูกศรออกจากระบบด้านขวาบน ซึ่งมีชื่อ Sign out

127.0.0.1 หมายถึงเครื่องของผู้เปิดเว็บ ถ้าลูกค้าเปิดจากอีกเครื่อง ต้องให้ผู้ดูแลจัด URL ที่เข้าถึงได้ก่อน

เมนู 7 หมวด

รวม 19 เมนูใน 7 หมวด (เห็นเฉพาะเมนูที่บทบาทมีสิทธิ์)

เมนูและหมวดที่ไม่มีสิทธิ์จะไม่แสดง เช่น Sales ไม่มีหมวดจัดการระบบและเมนูอนุมัติ ตำแหน่งหมวด/หน้าปัจจุบันอยู่ด้านบน กด คู่มือการใช้งาน ใต้เมนูเพื่อเปิด HTML ในแท็บใหม่

ค้นหาและใช้คีย์บอร์ด

• ช่องค้นหาด้านบนค้นข้ามหมวด กดปุ่ม / ขณะไม่ได้พิมพ์ในฟอร์มเพื่อย้ายไปช่องนี้
• ช่อง ค้นหาในรายการนี้… อยู่เหนือแผนยอดขาย หมวดหมู่สินค้า และรายการลูกค้า ผู้ติดต่อ Inquiry Visit สินค้า ใบเสนอราคา SO Activity และ Audit ค้นเฉพาะข้อความในข้อมูลที่หน้าโหลดแล้ว จำนวนแสดงเป็นพบ/ทั้งหมด
• ถ้าไม่พบรายการ กด ล้างคำค้น เพื่อกลับมาดูทั้งหมด การค้นหานี้ไม่เปลี่ยนข้อมูลและไม่เปลี่ยน filter ของ Reports
• ตารางกว้างเลื่อนแนวนอนภายในตารางได้ ใช้ Tab ไปยังตารางและปุ่มต่าง ๆ; dialog ปิดด้วย Escape และคืน focus ไปปุ่มเดิม
• เมนูมือถือปิดอยู่จะไม่รับ Tab เมื่อเปิดแล้ว Tab อยู่ภายในเมนูจนปิด

บัญชีตัวอย่าง

รหัสผ่านเริ่มต้นทุกบัญชี: Demo@123 ใช้สำหรับฐานข้อมูลตัวอย่างนี้ หากผู้ดูแลเปลี่ยนรหัสแล้วให้ใช้รหัสที่ได้รับ

สิทธิ์: Management ดูข้อมูลได้ แต่ API ปฏิเสธการแก้งาน และหน้าหลักซ่อนปุ่มแก้ไข หน้า Admin Center ของ Sales Admin เปิดได้โดยแสดงเฉพาะข้อมูลที่มีสิทธิ์ ใน Customer 360/รายละเอียดใบเสนอราคา Management ไม่มีปุ่มเพิ่มไฟล์และส่งอีเมล ยังดูรายละเอียดและดาวน์โหลด PDF ได้

ข้อมูลบริษัท บุคคล และงานในชุดตัวอย่างเป็นข้อมูลสมมติสำหรับ UAT ปรับชื่อและเนื้อหาให้อ่านเป็นงานขายปกติ อีเมลธุรกิจใช้โดเมน .example บัญชี Login และรหัสเดิมยังใช้ได้

เตรียมข้อมูลทดสอบ

• ตั้งชื่อข้อมูลใหม่ขึ้นต้น UAT-ชื่อผู้ทดสอบ-วันที่-ลำดับ เช่น UAT-Mali-20261003-01
• ใช้ข้อมูลสมมติและบัญชีอีเมลสำหรับทดสอบ
• สร้างข้อมูลของตัวเองแทนแก้รายการตัวอย่างที่ผู้ทดสอบคนอื่นใช้
• จดเลข Customer, Inquiry, Opportunity, Quotation/Rev. และ SO ที่ได้
• แบบทดสอบ Reset Password, Deactivate, Transfer และ Archive ให้ใช้ผู้ใช้/ข้อมูล UAT ที่แยกไว้

2. เส้นทางทดสอบหลัก

ใช้ Sales A, Manager และ Sales Admin สลับบัญชีตามตาราง หากใช้ browser เดียว ให้ Sign out ก่อนเปลี่ยนบัญชี

ตัวอย่างตรวจยอดด้วยตัวเอง

สร้าง Custom item จำนวน 2, ราคา/หน่วย 1,000 บาท, ส่วนลด 8%, VAT 7%

หน้ารายการบางจุดปัดเป็นจำนวนเต็ม ให้ดูยอดทศนิยมจาก PDF/ข้อมูลรายละเอียดที่ทีมเทคนิคช่วยตรวจ ถ้า Rev.ใหม่เพิ่มราคาต่อหน่วยเป็น 1,200 โดยค่าอื่นเท่าเดิม ยอดรวมควรเป็น 2,362.56

3. Dashboard และค้นหา

หน้าเมนู แดชบอร์ด ใช้หัวข้อ ภาพรวมการขาย ด้านบน มีสรุปยอด 4 ช่อง กราฟขั้นตอนขาย งานที่ต้องทำต่อ ใบเสนอราคาปัจจุบันล่าสุด 3 รายการ และทางลัด ลูกค้า/Pipeline/สินค้า/Activity คลิกเลขใบเสนอราคาเพื่อดูรายละเอียด หรือ ดูทั้งหมด ไปหน้ารายการ ตัวเลขในทางลัดเป็นจำนวนข้อมูลตามสิทธิ์ของบัญชี ไม่ใช่เป้าการขายหรืออัตราเติบโต

• มูลค่า Pipeline: มูลค่าดีลที่ยังไม่ Won/Lost
• Pipeline ถ่วงน้ำหนัก: มูลค่าดีล × probability
• ยอดขายจาก Sales Order: ยอด SO รวมภาษีในระบบปัจจุบัน
• งานเกินกำหนด: Activity ที่เปิดอยู่และพ้น due date
• ภาพรวมขั้นตอนการขาย: แยกดีลตาม stage
• งานที่ต้องทำต่อ: รายการ Activity ที่เปิดอยู่

ค้นหาจากช่องด้านบนโดยพิมพ์อย่างน้อย 2 ตัวอักษร เช่นชื่อลูกค้าหรือเลข Inquiry แล้วคลิกผลลัพธ์ ลูกค้าจะเปิด Customer 360 ส่วน Inquiry/Opportunity/Product จะพาไปหน้ารายการของหมวดนั้น ยังไม่ได้เปิดรายละเอียดของรายการนั้นโดยตรง

ทดสอบ: ดูก่อน/หลังสร้างข้อมูล UAT และเปรียบเทียบยอดของตนกับ Manager

ขอบเขต: Dashboard ไม่นับดีลที่ archive และยอดขายนับ SO ที่ Confirmed เท่านั้น Sales ค้นหาสินค้าที่ไม่ถูก archive จากช่อง global search ได้

4. ลูกค้าและ Customer 360

สร้าง: ลูกค้า → + ลูกค้าใหม่ → กรอกบริษัท, New/Existing, Industry, Tax ID, ติดต่อ, ที่อยู่, Source, ผู้รับผิดชอบ, Price List, Active/Inactive → บันทึก

แก้ไข: กด แก้ไข ในแถว → เปลี่ยนข้อมูล → บันทึก → กลับมาตรวจค่า

ดูภาพรวม: กด 360° → ดู Customer Profile, Contacts และ Timeline ของ Inquiry/Visit/Quotation/SO → แนบไฟล์ได้ในส่วน Attachments

Archive: กด เก็บเข้าคลัง → ใส่เหตุผล → ยืนยัน รายการจะออกจากรายการปกติ ถ้ามีดีลเปิดอยู่ระบบควรปฏิเสธ

ทดสอบ: สร้างใหม่, แก้เบอร์ติดต่อ, ดู 360°, ทดลองสร้างใหม่ด้วย Tax ID เดิม ต้องถูกปฏิเสธ การตรวจ Tax ID ตอนแก้ลูกค้ายังต้องทดสอบเป็นกรณีต่างหาก

ทดสอบ: เลือก Price List แล้วรีสตาร์ตโปรแกรม ราคาที่เลือกต้องคงอยู่ Restore ยังไม่มีปุ่มบนจอ ให้ทีมเทคนิคช่วยและคืน Parent ก่อน Child

5. ผู้ติดต่อ

ผู้ติดต่อ → + Contact → เลือกลูกค้า → กรอก Name, Position, Phone, Email และ Primary Contact → บันทึก

• บริษัทหนึ่งมีหลาย Contact ได้
• กด แก้ไข เพื่อปรับข้อมูลหรือ Primary
• กด เก็บเข้าคลัง เพื่อ archive ข้อมูล UAT ที่แยกไว้
• เมื่อเลือก Contact ใน Inquiry/Visit ต้องเป็นคนของลูกค้ารายเดียวกัน

ทดสอบ: เพิ่มสองคนในบริษัทเดียว ดูใน Customer 360; แก้คนหนึ่งเป็น Primary; archive คนที่ไม่ได้ใช้ใน flow หลัก

6. Inquiry

Inquiry → + Inquiry ใหม่ → เลือกลูกค้าและ Contact → กรอกเรื่อง, Source, Estimated Value, Priority, Status, Owner, Expected Close, Next Action/Date และ Notes → บันทึก

กด แก้ไข เพื่อเพิ่มความต้องการลูกค้า/next action กด เก็บเข้าคลัง ได้เมื่อไม่มีดีลเปิดที่ขัดกับเงื่อนไข

ทดสอบ: ข้อมูลครบแล้วบันทึกได้, ไม่กรอกเรื่องแล้วบันทึกไม่ได้, เปลี่ยนลูกค้าแล้วรายการ Contact ควรตรงกับบริษัทใหม่

Inquiry คือเรื่องที่ลูกค้าสอบถาม ยังไม่ใช่ดีลการขาย การสร้าง Opportunity ต้องทำอีกขั้น

7. เข้าพบลูกค้า / Visit

เข้าพบลูกค้า → + Visit ใหม่ → เลือก Inquiry → เลือก Contact ที่ตรงบริษัท → กรอก Visit Date, Purpose, Participants, Result, Requirement, Next Action/Date, Owner → บันทึก

• เพิ่มหลาย Visit ให้ Inquiry เดียวได้
• กด แก้ไข เพื่อบันทึกผลหลังเข้าพบ
• กด เก็บเข้าคลัง สำหรับ Visit UAT ที่ไม่ใช้แล้ว

ทดสอบ: เปลี่ยน Inquiry ในฟอร์ม Visit แล้ว Contact ต้องเปลี่ยนตามบริษัท หากบริษัทไม่มี Contact ให้เลือก - การเพิ่ม Visit ต้องไม่ลดสถานะ Inquiry ที่อยู่ QUOTATION/NEGOTIATION/WON/LOST

8. Opportunity / Sales Pipeline

Sales Pipeline → + Opportunity → เลือก Inquiry ที่ยังไม่มีดีลในหน้าจอ → กรอกชื่อ, Value, Expected Close, Owner → บันทึก

แก้รายละเอียด: กด แก้ไข บนการ์ด ไม่ใช่การย้าย stage

ย้าย stage: กด Move → เลือก stage, probability ถ้าต้องการ, Reason → Move

หากเลือก Lost ต้องใส่ Lost Reason probability ต้องอยู่ 0–100 เมนู Move อาจเสนอ stage ที่กระโดดข้ามได้ แต่ backend จะปฏิเสธตามตาราง

ทดสอบ: Inquiry → Contacted → Visit; ทดลองกระโดด Inquiry → Negotiation ต้องถูกปฏิเสธ; ทดสอบ Lost บนอีกดีล; ห้ามกด Won เอง ให้สร้าง SO ตาม flow

การสร้าง Quotation/เข้าสู่ Negotiation/สร้าง SO อาจย้าย stage อัตโนมัติและบันทึกประวัติด้วย

9. สินค้า / บริการ / Price List

Product

ใช้ Admin, Manager หรือ Sales Admin → สินค้า / บริการ → + สินค้า/บริการ → กรอก SKU, Unit, Name TH/EN, หมวดหมู่สินค้า, ราคา, ต้นทุน, Active/Inactive และรายละเอียด → บันทึก

กด แก้ไข เพื่อปรับ master data หรือ เก็บเข้าคลัง เพื่อ archive สินค้า UAT รายการในใบเสนอราคาเก่าควรเก็บ snapshot เดิม

ทดสอบ: SKU ซ้ำถูกปฏิเสธ; ราคา/ต้นทุนติดลบถูกปฏิเสธ; เปลี่ยน master price แล้วตรวจใบเสนอราคาเดิม; สินค้า Inactive ไม่ควรเลือกเพิ่มใน quote ใหม่

Price List

หน้าสินค้า → Price List → ดูรายการและราคา → แก้ช่องราคาของรายการที่มีอยู่ → ออกจากช่อง ระบบบันทึกทันทีและแจ้ง Price updated

กด + Price List → Name, Currency, Active → บันทึก จากนั้นเลือก price list ให้ลูกค้าในฟอร์มลูกค้า

เปิด Price List → + สินค้า → เลือก Product และ Unit Price → บันทึก หน้า Quotation ใช้ราคาของลูกค้าจาก Opportunity ที่เลือก หากไม่มีราคาลูกค้าที่ใช้งานได้จะใช้ Standard Price การเปลี่ยน Opportunity โหลดราคาใหม่ ตรวจราคาให้ครบก่อนส่งอนุมัติ หากโหลดราคาล้มเหลวให้เลือกสินค้าอีกครั้ง

จัดหมวดหลัก–หมวดย่อย

1. เปิด สินค้าและราคา → หมวดหมู่สินค้า ใช้ Admin, Manager หรือ Sales Admin เพื่อจัดการ
2. กด + เพิ่มหมวดหมู่ กรอกรหัส (อังกฤษ/ตัวเลข/-/_) ชื่อ TH/EN และสถานะ
3. ถ้าเป็นหมวดหลัก เลือก เป็นหมวดหลัก ถ้าเป็นหมวดย่อย เลือกหมวดหลักที่ใช้งานอยู่ แล้วบันทึก
4. เปิด สินค้า / บริการ → แก้ไข เลือกหมวด เช่น Hardware / อุปกรณ์ควบคุม แล้วบันทึก
5. ใช้ กรองหมวดหมู่ (รวมหมวดย่อย) ในหน้าสินค้า เลือกหมวดหลักเพื่อดูสินค้าในหมวดย่อยด้วย เลือกทุกหมวดเพื่อกลับมาแสดงทั้งหมด
6. กดแก้ไขหมวดเพื่อเปลี่ยนชื่อ หมวดหลัก หรือปิดใช้ ต้องย้าย/ปิดสินค้าที่ยัง Active และหมวดย่อยที่ Active ก่อนปิดหมวด

Sales และ Management ดูหมวดและกรองสินค้าได้ แต่แก้หมวดไม่ได้ รหัสหมวดห้ามซ้ำแม้ใช้ตัวพิมพ์เล็ก/ใหญ่ต่างกัน และระบบไม่อนุญาตหมวดวนกลับมาหาตัวเอง จำนวนสินค้าในหน้าหมวดเป็นการผูกโดยตรง ไม่รวมหมวดย่อย

Product Group เดิมถูกย้ายเป็นหมวดโดยรักษาสินค้า ราคา และต้นทุนเดิม จัดหมวดใหม่ผ่านหน้านี้แทน Master Data ใบเสนอราคา/SO เก่ายังคง snapshot เดิม การเปลี่ยนหมวดไม่ใช่การจัดประเภทประวัติยอดขายย้อนหลัง

10. ใบเสนอราคา

สร้างและแก้ไข Draft

ใบเสนอราคา → + ใบเสนอราคา → เลือก Opportunity → Validity Days, Payment Term, Delivery Term, Currency, VAT และ Owner

เพิ่มรายการโดยเลือก Product หรือ Custom item → Description, Qty, Unit, Unit Price, Discount → + Item เพิ่มบรรทัด / × ลบบรรทัด → บันทึก

รอบนี้รองรับ THB เท่านั้น ทั้งใบเสนอราคาและ Price List การส่ง currency อื่นผ่าน API ถูกปฏิเสธ ยังไม่มีการแปลงค่าเงิน

แก้ไขได้: Rev.ปัจจุบันที่เป็น Draft และไม่อยู่ Pending Approval การแก้ Draft ที่เคย approved จะกลับเป็น Not Requested ต้อง Submit ใหม่

การคำนวณปัดจำนวนเงินแต่ละบรรทัดและส่วนลดเป็นสองตำแหน่งแบบ HALF_UP จากนั้นรวมยอดสุทธิแล้วปัด VAT สองตำแหน่ง ผลรวมบรรทัดต้องตรงกับ Subtotal โอกาสการขายใหม่เริ่มที่ Inquiry เท่านั้น งานที่ Parent ถูก archive หรือดีล Lost ไม่สามารถสร้างหรือดำเนินเอกสารขายต่อได้

ปุ่มแต่ละตัว

Send ไม่ได้ส่งอีเมล ต้องใช้ปุ่มอีเมลด้านล่างแยกต่างหาก

Revision

1. ก่อน Accept ให้กด Revise
2. ตรวจเลข Quotation เดิมและ Rev.เพิ่มขึ้น
3. Rev.เก่าควรเป็น Superseded; Rev.ใหม่ Draft / Not Requested
4. แก้ Rev.ใหม่แล้ว Submit → อนุมัติ → Send → Accept อีกครั้ง

PDF และอีเมล

• PDF: เปิดไฟล์แล้วตรวจบริษัท, ลูกค้า, เลข/Rev., รายการ, VAT, ยอดรวม และการตัดบรรทัด PDF ไทยบน Mac ยังต้องตรวจฟอนต์ หากเห็นสี่เหลี่ยมหรืออักษรหายให้รายงาน
• อีเมล: กด ดู → อีเมล → Recipient, Subject, Message → Action = Save preview only → Process ควรได้ Preview ไม่มีอีเมลออกจริง
• Send via configured SMTP: ใช้เฉพาะเมื่อผู้ดูแลเตรียม mail server และผู้รับทดสอบไว้แล้ว สถานะ Sent/Failed ต้องให้ผู้ดูแลช่วยตรวจ ไม่เท่ากับการกด Send ในตาราง

11. อนุมัติ

Sales กด Submit จากใบเสนอราคา ส่วน Manager/Admin เข้าเมนู อนุมัติ → ตรวจเลข/Rev., Total, Max Discount, Required Role → Approve หรือ Reject → ใส่ Comment/Reason

กรณีส่วนลดทศนิยมตกในช่องว่างของกฎ เช่น 5.00001% ระบบส่งให้ Admin ตรวจแทนการอนุมัติด้วยสิทธิ์ต่ำกว่า กฎปรับได้โดย Admin ใช้ค่าทดสอบ 5%, 8%, 12% และตรวจ Required Role ก่อนอนุมัติ กฎใช้ ส่วนลดสูงสุดของบรรทัด ไม่ใช่ค่าเฉลี่ยทั้งเอกสาร

ทดสอบ: Approve หนึ่งรายการ, Reject อีกหนึ่งรายการ, Manager ทดลองอนุมัติรายการ Required Role=Admin ต้องถูกปฏิเสธ ใบเสนอราคาที่ reject approval ยังเป็น Draft ผู้ขายแก้แล้ว Submit ใหม่ได้

12. Sales Order

Admin / Manager / Sales Admin → Sales Order → + Sales Order → เลือก Accepted Quotation → ใส่ PO Number, Order Date, Notes → Create Sales Order

ระบบคัดยอดและรายการจาก quote ให้ ไม่ต้องกรอกยอดขายซ้ำ ต้องเป็น Current + Accepted + Approved และ family นั้นยังไม่มี SO

ทดสอบ: SO ได้เลขใหม่และยอดตรง quote; Opportunity เป็น Won; Inquiry เป็น WON; สร้างซ้ำไม่ได้; Draft/Rev.เก่าไม่ควรมีสิทธิ์สร้าง

ถ้าไม่มี quote ให้เลือก ให้ตรวจ Accept/Approval/Current revision และ SO ที่เคยสร้าง หน้า SO ปัจจุบันเป็นรายการ ยังไม่มีแก้ไข ยกเลิก หรือพิมพ์ SO จากหน้าจอ

13. ติดตามงาน / Activity

ติดตามงาน → + Activity → Customer, Type, Subject, Due Date, Owner, Notes → บันทึก

Type มี Call, Email, Meeting, Visit, Follow-up, Task เมื่อทำงานแล้วกด เสร็จสิ้น สถานะควรเปลี่ยนจาก Open เป็น Completed

ทดสอบ: สร้างงานครบกำหนดเมื่อวาน ดู Overdue และ notification; Complete แล้วไม่ควรนับเป็นงานเกินกำหนดที่ยังเปิดอยู่

หน้าเว็บปัจจุบันยังไม่มี edit/reschedule/calendar และฟอร์มสร้างยังไม่ผูก Inquiry/Opportunity การผูกผ่าน API ต้องให้ทีมเทคนิคตรวจความสัมพันธ์บริษัทด้วย

14. การแจ้งเตือน

กดไอคอนแจ้งเตือนด้านบนหรือเมนู การแจ้งเตือน → ดูหัวข้อ/รายละเอียด/เวลา → กด อ่านแล้ว → badge ควรลดลง กด รีเฟรช เพื่อประเมินกฎใหม่

กฎมี Overdue Activity, ใบเสนอราคาใกล้หมดอายุ 3 วัน, Approval pending เกิน 24 ชั่วโมง และ Opportunity ไม่มี activity 14 วัน

ข้อสังเกตสำหรับทดสอบ: ดีลที่ยังไม่เคยมี Activity ผูกผ่าน opportunity_id อาจแจ้งเตือนทันทีตามกฎปัจจุบัน; Activity ที่สร้างจากฟอร์มทั่วไปยังไม่ได้ผูกดีล และการ Complete งานไม่ได้ลบแจ้งเตือนเก่าที่สร้างไว้ ให้แยกตรวจสถานะงานกับสถานะอ่านแจ้งเตือน

ทดสอบ: รีเฟรชซ้ำไม่ควรสร้างรายการเดียวกันซ้ำ; สลับ Sales A/B ต้องเห็นการแจ้งเตือนของบัญชีตน

ข้อจำกัด: ยังไม่มี jump-to-record/snooze ดีลใหม่ที่ยังไม่มี Activity ใช้วันสร้างดีลเป็นจุดเริ่มนับ stale 14 วัน ให้ทีมเทคนิคเตรียมข้อมูลเวลาแยกเพื่อทดสอบ ไม่ต้องรอจริง

15. รายงานการขาย

รายงานการขาย → เลือก From / To / Sales / Customer → Apply ผู้ใช้ Sales ถูกจำกัดเป็นข้อมูลของตน

ตรวจ Sales Value, Average Deal, Win Rate, Avg. Sales Cycle, Conversion Funnel, Sales Performance, Quotation Aging, Opportunity Aging, Target vs Actual, Lost Reasons, Sales by Customer/Industry/Product และ Activity Performance

• Sales Value: ยอด SO รวมภาษี ไม่ใช่ pipeline หรือมูลค่า quote ทั้งหมด
• Export CSV: ดาวน์โหลด sales_orders.csv และเปิดตรวจเลข SO/ลูกค้า/ยอด/Owner
• ตัวกรอง: CSV ใช้ From/To/Sales/Customer เดียวกับฟอร์ม และนับเฉพาะ SO Confirmed เช่นเดียวกับยอดรายงาน Sales เห็นเฉพาะงานของตน แม้เปลี่ยนตัวกรอง Owner ผ่าน API
• SO ใช้วัน Order; Quote ใช้วัน Quotation; Pipeline/Aging ใช้วันสร้าง Opportunity; Activity ใช้ Due Date หรือวันสร้างถ้าไม่มี Due Date
• Conversion ติดตาม Inquiry ที่เปิดในช่วงที่เลือกจนถึง To: Inquiry→Visit เป็นสัดส่วนที่เข้าพบ; Visit→Quote เป็นสัดส่วนของ Inquiry ที่เข้าพบแล้วมี quote; Quote→Won เป็นสัดส่วน Inquiry ที่มี quote แล้วมี SO Confirmed รวมงานที่ไม่ต้อง Visit
• Target ใช้ช่วงเป้าหมายที่ทับกับตัวกรอง ยอดจริงนับเฉพาะช่วงที่ทับกัน หน้าจอระบุช่วงทั้งสองแยกกัน ไม่แบ่งยอดเป้าหมายตามสัดส่วนวัน ถ้าเลือก Customer จะไม่แสดง Target เพราะยังไม่มีเป้ารายบริษัท
• Quotation Status, Lead Source และ Monthly Sales มีข้อมูล API แต่ยังไม่มีตารางแยกในหน้ารายงานนี้ ให้ทีมเทคนิคช่วยทดสอบ

ทดสอบ: ใช้ช่วงวันที่ของ SO UAT แล้วเทียบยอดกับรายการ SO, เปลี่ยน Owner/Customer, ดูช่วงไม่มีรายการ, ดาวน์โหลด CSV และรายงานความต่างของ filter

16. ศูนย์ควบคุม / Admin Center

ใช้ Admin เป็นบัญชีหลักสำหรับหน้ารวมนี้

ทดลองเปลี่ยน matrix/โอนพอร์ตเฉพาะข้อมูลและ user ที่แยกไว้ และให้ผู้ดูแลบันทึกค่าเดิมก่อนเริ่ม

รหัสผ่าน: บัญชีที่ถูก Force Change เปิดงานอื่นไม่ได้ทั้งหน้าจอและ API จนเปลี่ยนรหัสสำเร็จ หลังเปลี่ยนระบบยกเลิกทุก Session ของบัญชีนั้น ให้ Login ใหม่

ข้อจำกัด: ไม่มีหน้า Change Password ทั่วไปถ้าไม่ถูก flag; Edit Target อยู่หน้าแผนยอดขายแล้ว; ปุ่ม Edit Rule/Edit Master ยังไม่มีใน UI (Revoke Sessions ใช้ปุ่ม ออกจากระบบ ในหน้า ผู้ใช้งาน); Industry ในฟอร์ม Customer ยังเป็นช่องกรอก ไม่ใช่ dropdown จาก Master Data

หน้า ผู้ใช้งาน

เมนู จัดการระบบ → ผู้ใช้งาน (อยู่ระหว่างศูนย์ควบคุมกับ Audit Trail) เห็นได้เฉพาะ Admin, Manager, Management โดย Manager/Management ดูอย่างเดียว ปุ่มทุกปุ่มเป็นของ Admin ทุกการเปลี่ยนแปลงบันทึกใน Audit Trail

ภาพรวมหน้า: การ์ด KPI 4 ใบ — ผู้ใช้ทั้งหมด, ใช้งานอยู่, กำลังเข้าระบบ (มี session ที่ยังไม่หมดอายุ), รอเปลี่ยนรหัสผ่าน แถบเครื่องมือค้นหาชื่อ/อีเมล, กรองบทบาท (รวม Super Admin) และสถานะ ทั้งหมด/ใช้งาน/ปิดบัญชี ตารางแสดงผู้ใช้ (avatar, ชื่อ, ป้าย คุณ/รอเปลี่ยนรหัส/ออนไลน์, อีเมล · ภาษา), บทบาท, สถานะ, เข้าระบบล่าสุด และปุ่มจัดการ จอกว้างน้อยกว่า 760px แต่ละแถวแสดงเป็นการ์ด

ปุ่มในแถวเรียงตามลำดับ: แก้ไข · รีเซ็ตรหัส · ออกจากระบบ · ปิดบัญชี/เปิดบัญชี · ลบถาวร แถวของตัวเองไม่มีปุ่มปิดบัญชีและลบถาวร

ลบถาวร: ลบได้เฉพาะบัญชีที่ไม่มีข้อมูลธุรกิจผูกอยู่ ถ้ายังเป็นเจ้าของหรือถูกอ้างอิงใน ลูกค้า, Inquiry, การเข้าพบ, ดีล, ใบเสนอราคา, Sales Order, งานติดตาม, คำขออนุมัติ, ไฟล์แนบ, ประวัติ Stage, ประวัติโอนงาน, แผน/งบ ฯลฯ หน้าต่างจะแสดงจำนวนแต่ละประเภท และให้เลือก ไปหน้าโอนงาน (โอนพอร์ตที่ศูนย์ควบคุม แล้วกลับมาลบ) หรือ ปิดบัญชีแทน บัญชีของตัวเอง, Super Admin และ Admin ที่ใช้งานอยู่คนสุดท้ายลบไม่ได้ เมื่อลบได้ หน้าต่างเตือนว่า การลบย้อนกลับไม่ได้: ลบบัญชี, session, เป้าการขาย และการแจ้งเตือนของผู้ใช้ ส่วนประวัติ Audit เดิมเก็บไว้แต่ไม่ผูกกับบัญชีนี้อีก ต้องพิมพ์อีเมลของผู้ใช้เอง (วางข้อความไม่ได้) ปุ่ม ลบถาวร จึงกดได้ แนะนำให้ปิดบัญชีแทนถ้าต้องเก็บประวัติ

Super Admin: บัญชี Admin ที่มีสิทธิ์สูงสุด ผ่านการตรวจสิทธิ์ทุกบทบาท แสดงป้ายสีเข้ม Super Admin ในตารางและแถบบน มีเฉพาะ Super Admin เท่านั้นที่แก้ไข/ปิดบัญชี/รีเซ็ตรหัส/ออกจากระบบ ให้ Super Admin คนอื่นได้ Admin ทั่วไปจะเห็นแถวนั้นเป็น สงวนสิทธิ์ Super Admin บทบาทของ Super Admin คงเป็น Admin และลบไม่ได้ สร้างจากหน้าจอไม่ได้ ต้องให้ทีมเทคนิคใช้เครื่องมือ tools/create_superadmin.py ตาม ภาคผนวก

ทดสอบ: ใช้บัญชี UAT ที่แยกไว้ทุกครั้ง ทดลองลบเฉพาะบัญชีที่เพิ่งสร้างและยังไม่มีข้อมูล บันทึกผลใน USR-01–USR-17 ของ เช็กลิสต์ UAT

17. Audit Trail

Admin / Manager / Management → Audit Trail → ตรวจ Time, Actor, Entity, Action, Detail, Before, After

ให้ตรวจหลังสร้าง/แก้ลูกค้า, Move Stage, Revise, อนุมัติ, สร้าง SO, แนบไฟล์ และโอนพอร์ต ชี้เมาส์ที่ Before/After เพื่อดูข้อความเพิ่มเติม

ผู้ใช้ Sales ไม่ควรเข้าดู Audit ได้ หน้าปัจจุบันโหลดรายการล่าสุดจำนวนจำกัด ไม่มี filter/export Audit แยกบนจอ

18. ไฟล์แนบ

เปิด Customer → 360° หรือ ใบเสนอราคา → ดู → Attachments → + File → เลือกไฟล์ → ตรวจชื่อ/ขนาด/ผู้ upload → Download แล้วตรวจเนื้อหา

ขนาดสูงสุด 15 MB; ไฟล์ใหญ่กว่าควรถูกปฏิเสธ ผู้ใช้ต้องมีสิทธิ์ใน parent record

ทดสอบ: ไฟล์ข้อความ/PDF ขนาดเล็ก, download ตรงต้นฉบับ, ไฟล์เกินขนาด, Sales คนอื่นไม่ควรอ่านไฟล์ของข้อมูลที่ไม่มีสิทธิ์

API รองรับไฟล์ของ Inquiry/Opportunity/SO/Activity ด้วย แต่ยังไม่มี upload panel ของ entity เหล่านี้ใน UI ไม่มีปุ่ม delete attachment ในเวอร์ชันนี้

19. เมื่อพบปัญหา

บันทึก feedback แบบสั้น: บัญชี/บทบาท → หน้าจอ → ขั้นตอน → ผลที่คาดหวัง → ผลจริง → เลขรายการ → ภาพประกอบ แล้วลงเช็กลิสต์เป็น Pass / Fail / Blocked / Not tested ไม่ใส่รหัสผ่านใน feedback

20. งานที่ทีมเทคนิคช่วยทดสอบ

ผู้ใช้ไม่ต้องค้นหาปุ่มที่ยังไม่มี ให้ขอทีมเทคนิคช่วยตาม รายการฟังก์ชันที่มีเฉพาะ API/เครื่องมือ เช่น Restore, Stage History, Pagination, การแก้กฎ/เป้า/Master, Email Logs และ Backup/Restore

ภาพรวมขอบเขต route ทั้งหมดอยู่ใน แผนที่ฟังก์ชัน เพื่อให้ทีมตรวจว่าไม่มีฟังก์ชันตกหล่น

การดูแลคู่มือ

ทุกครั้งที่หน้าจอ โปรแกรม สิทธิ์ ขั้นตอน หรือโครงสร้างไฟล์เปลี่ยน ต้องแก้คู่มือ หัวข้อทดสอบ รูปประกอบ/ลิงก์ และภาคผนวกที่เกี่ยวข้อง พร้อมบันทึกวันที่และสรุปการเปลี่ยนแปลง แล้วซิงก์เข้า Obsidian ก่อนส่งมอบ

หลังแก้ Markdown ให้เรียก python3 tools/build_user_guide.py เพื่อสร้าง static/user-guide.html ใหม่ สคริปต์ซิงก์ Obsidian จะทำขั้นตอนนี้ให้อัตโนมัติก่อนคัดลอกคู่มือ HTML ไปยัง outputs และ Vault

คู่มือเป็นเอกสารของ build 3.0.0 ณ วันที่ข้างต้น ข้อจำกัดที่เปิดอยู่ให้ดู CORE_REVIEW.md ควบคู่ ไม่ตีความข้อความ “ควรได้” ว่าเป็นผลทดสอบที่ผ่านแล้ว

21. แผนยอดขาย / Sales Plans

แผนและงบประมาณ → แผนยอดขาย ทุกบทบาทดูได้ Sales เห็นเฉพาะแผนของตน Admin/Manager สร้างและแก้แผนได้

1. กด + ตั้งเป้ายอดขาย เลือกผู้รับผิดชอบ
2. เลือกประเภท รายเดือน และปี/เดือน, รายปี และปี หรือ กำหนดเอง แล้วกรอกวันเริ่ม–สิ้นสุด ระบบเติมวันที่เมื่อเลือกประเภท/ปี/เดือน
3. กรอกยอดเป้าหมาย THB รวม VAT แล้วบันทึก วันที่สิ้นสุดต้องไม่น้อยกว่าวันเริ่ม และยอดอย่างน้อย 0.01 บาท
4. ตารางแสดงเป้า ยอดจริง ยังขาดจากเป้า และ % สำเร็จ กด แก้ไข เพื่อแก้แผนเดิม

สูตร: ยอดจริง = ผลรวม grand_total ของ SO Confirmed ที่มีเจ้าของตรงกับแผนและ order_date อยู่ในช่วงวันที่รวมวันแรก/สุดท้าย; % สำเร็จ = ยอดจริง ÷ เป้า × 100; ยังขาด = ค่าสูงสุดระหว่าง 0 กับเป้า−จริง

เจ้าของเดียวกันสร้างแผนทับช่วงเวลาไม่ได้ เช่น ไม่เพิ่มแผนรายปีซ้อนรายเดือนเดิม ให้เลือกใช้ช่วงแผนแบบเดียวกันเพื่อไม่ให้นับซ้ำ แผนไม่ใช่ Forecast หรือยอดใบเสนอราคา และยังไม่มีเป้ารายทีม/ลูกค้า การแก้เป้าบันทึก Audit; ไม่มีปุ่มลบเป้า

22. งบโครงการ / Project Budgets

แผนและงบประมาณ → งบโครงการ สรุปงบ Approved/Closed ยอดใช้จริง คงเหลือ และจำนวนรออนุมัติ กรองสถานะได้ ตัวเลขทั้งหมดเป็น THB

สร้างและส่งงบ

1. Sales, Sales Admin, Manager หรือ Admin กด + สร้างงบโครงการ กรอกชื่อ เจ้าของ และวันเริ่ม–สิ้นสุด
2. เลือกลูกค้าหรือโครงการภายใน หากเลือกบริษัท ระบบตั้งเจ้าของตามบริษัท เจ้าของงบต้องตรงเจ้าของบริษัท/ดีล เลือกโอกาสขายได้เฉพาะบริษัทนั้น (ไม่บังคับ)
3. กรอกรายได้ตามแผนและต้นทุน ไม่รวม VAT ที่ขอคืนได้ แยกจากเป้ายอดขายซึ่งใช้ยอดรวม VAT
4. เพิ่มรายการต้นทุนอย่างน้อยหนึ่งรายการ: วัสดุ/สินค้า, ค่าแรง, ผู้รับเหมาช่วง, เดินทาง หรืออื่น ๆ กรอกรายละเอียด/ยอด กดเพิ่มรายการหรือลบรายการที่ไม่ใช้ งบรวมต้องมากกว่า 0
5. บันทึกเป็น Draft → เปิดรายละเอียด → ส่งอนุมัติ เป็น Pending

อนุมัติและบันทึกใช้จริง

1. เปลี่ยนเป็นบัญชี Manager/Admin ซึ่งไม่ใช่เจ้าของหรือผู้ส่งงบ → เปิดรายการ Pending → เปิดรายละเอียด
2. กด อนุมัติ หรือ ไม่อนุมัติ (ต้องกรอกเหตุผล) งบ Rejected แก้ไขแล้วกลับ Draft หรือส่งอีกครั้งได้
3. หลัง Approved เจ้าของ Sales หรือ Admin/Manager/Sales Admin กด + บันทึกค่าใช้จ่าย เลือกรายการงบ วันที่ ยอด รายละเอียด และเลขเอกสารอ้างอิง
4. วันที่ค่าใช้จ่ายต้องอยู่ในช่วงงบ ยอดอย่างน้อย 0.01 บาท ระบบปัดทศนิยม 2 ตำแหน่งแบบ HALF_UP
5. ค่าใช้จ่ายเกินงบบันทึกได้ ระบบเตือนและแสดงยอดคงเหลือติดลบ ดูยอดแผน/จริง/คงเหลือทั้งรายรายการและโครงการ
6. ถ้าบันทึกผิด กด ยกเลิกรายการ กรอกเหตุผล ระบบหักรายการนั้นออกจากยอดจริง แต่เก็บประวัติและ Audit ไม่ลบรายการทิ้ง ให้บันทึกรายการใหม่ที่ถูกต้อง
7. Manager/Admin กด ปิดโครงการ หลังทบทวนค่าใช้จ่าย เปลี่ยนเป็น Closed แล้วเพิ่ม/ยกเลิกค่าใช้จ่ายไม่ได้

Sales เห็นและทำงานเฉพาะงบที่ตนเป็นเจ้าของ Management อ่านได้อย่างเดียว งบ Approved/Pending/Closed แก้แผนไม่ได้ ผู้อนุมัติเป็นอิสระจากผู้ส่งและเจ้าของงบ การย้าย portfolio ย้ายเจ้าของงบไปด้วยโดยรักษาประวัติผู้อนุมัติ/ผู้บันทึก

สูตร: งบ = ผลรวมรายการแผน; จริง = ค่าใช้จ่ายที่ยังไม่ถูกยกเลิก; คงเหลือ = งบ−จริง; ผลต่างเกินแผน = จริง−งบ; ส่วนต่างรายได้–ต้นทุนตามแผน = รายได้ที่กรอก−งบ เช่น งบ 100,000 ใช้ 105,000.25 จะแสดงคงเหลือ −5,000.25 และเตือนเกินงบ 5,000.25

ขอบเขตของรุ่นนี้

รายได้โครงการเป็นแผนที่กรอกเอง ไม่ใช่รายได้จริงจากบัญชีหรือกำไรจริง ไม่ดึงต้นทุนสินค้าใน SO มาเป็นค่าใช้จ่ายอัตโนมัติ ยังไม่มีเชื่อมบัญชี ภาระผูกพัน/ใบสั่งซื้อ การแก้งบหลังอนุมัติ การเปิดงบ Closed ใหม่ การแบ่งงบทีม หรือ Export งบโดยเฉพาะ เมนูอนุมัติเดิมเป็นใบเสนอราคา; งบอนุมัติในหน้างบโครงการและยังไม่มี notification งบ

ภาพประกอบของฟีเจอร์ใหม่ถ่ายจากฐานข้อมูลทดสอบสำเนา ไม่ได้เพิ่มรายการทดลองเหล่านี้ในข้อมูลจริง หลัง deploy ต้อง restart backend ด้วย app.py และ planning_schema.py ใหม่พร้อม static/planning.js, workspace.js, workspace.css และ index.html

23. คู่มือ Obsidian และการส่งต่อ ZIP

ไฟล์คู่มือสำหรับเปิดทันทีคือ outputs/02_User_Manual/VEXINIO_CRM_USER_GUIDE.html หน้าเลือกเอกสารอยู่ outputs/00_START_HERE.html ส่วน Vault เดิมอยู่ outputs/Vexinio CRM Vault เลือก Open folder as vault ใน Obsidian ที่โฟลเดอร์นั้นแล้วเปิด 01 - Current Project.md

เมื่อต้องส่งให้น้อง ให้ส่ง outputs/01_Ready_to_Send/2026-10-04/Vexinio CRM.zip แตกแล้วเปิด 00_START_HERE.html ภายใน จะเห็น 01_Application (โปรแกรม), 02_User_Manual (คู่มือ), 03_Obsidian/Vexinio CRM Vault (Obsidian) ครบใน ZIP เดียว อ่านคู่มือ HTML ได้โดยไม่ติดตั้งโปรแกรม ภาพฝังอยู่ใน HTML แล้ว

ตำแหน่ง outputs ด้านบนเป็นของแชทผู้ส่ง เมื่อรับ ZIP ให้ใช้โครงสร้างที่แตกไฟล์แทน ห้ามเปิดโปรแกรมจากใน ZIP ต้องแตกทั้งหมดก่อน และต้องมี Python/pip/อินเทอร์เน็ตสำหรับติดตั้ง dependencies ครั้งแรก รายละเอียดและวิธีทำแพ็กใหม่อยู่ HANDOFF_GUIDE.md

1. เข้าระบบและสิทธิ์

2. ลูกค้า ผู้ติดต่อ Inquiry และ Visit

3. Pipeline สินค้า และราคา

4. ใบเสนอราคาและอนุมัติ

ใช้ตัวอย่างคำนวณในคู่มือ: 2 × 1,000 ส่วนลด 8% VAT 7% → รวม 1,968.80 ตรวจทศนิยมในรายละเอียด/PDF เพราะบางช่องหน้าจอปัดจำนวนเต็ม

5. Sales Order งานติดตาม และแจ้งเตือน

6. รายงาน ไฟล์แนบ และหน้าจอ

7. ผู้ดูแลและ Audit

ทำด้วยบัญชีและข้อมูล UAT เท่านั้น การเปลี่ยน Approval Rule กระทบ Quote ใหม่ ควรใช้ฐานข้อมูลทดสอบแยก

8. ฟังก์ชันที่ให้ผู้ดูแลทดสอบเพิ่ม

• □ TECH-01: Preferences และ Change Password ผ่าน API รวมการเพิกถอน Session
• □ TECH-02: Duplicate lookup, pagination, search role scope และ Stage History
• □ TECH-03: Restore records และ Archive Opportunity ผ่าน API
• □ TECH-04: เพิ่มสินค้าใน Price List ใหม่ และตรวจ resolved-price พร้อม customer_id
• □ TECH-05: แก้ Target ผ่าน UI และ Master Value/Approval Rule/Price List metadata ผ่าน API
• □ TECH-06: Quote Rejected/Expired และ Email Logs ผ่าน API
• □ TECH-07: Attachment ของ Inquiry/Opportunity/Sales Order/Activity ผ่าน API
• □ TECH-08: Activity ที่ผูก Customer กับ Opportunity คนละบริษัท — บันทึกข้อบกพร่องที่ยังเปิด
• □ TECH-09: Login throttling และ Session expiry ในระบบทดสอบแยก
• □ TECH-10: Backup/Restore/Migration/Diagnostics/Notification worker ตามภาคผนวก
• □ TECH-11: Regression ของ startup Price List, archived Dashboard และ force-password-change enforcement
• □ TECH-12: delete-check/DELETE ผู้ใช้และสิทธิ์ Super Admin ผ่าน API ตามภาคผนวก

ช่องติ๊กหมายถึงทำการทดสอบแล้ว ให้เขียนผลจริงและหลักฐานแยก ไม่ถือว่าติ๊กแล้วผ่าน ดูขั้นตอนใน ภาคผนวก และ รายการทุก endpoint

บันทึกข้อผิดพลาด

Case ID: ______ Role: ______ เลขรายการ: ______

ขั้นตอนที่ทำ: ______ ผลที่คาด: ______ ผลจริง: ______ ภาพ/ไฟล์: ______

ความรุนแรง: ใช้งานต่อไม่ได้ / ข้อมูลผิด / แสดงผล / ข้อเสนอแนะ

เมื่อระบบเปลี่ยน ให้แก้กรณีที่กระทบและบันทึกผลทดสอบใหม่ ห้ามถือผลของเวอร์ชันก่อนเป็นผลของเวอร์ชันใหม่

ตรวจเพิ่มจากการแก้บั๊ก 4 ต.ค. 2026

• □ Reset แบบ Force Change: งานอื่นถูกห้ามก่อนเปลี่ยนรหัส; เปลี่ยนสำเร็จต้อง Login ใหม่ทุกอุปกรณ์
• □ สร้าง Price List ว่างแล้วเพิ่มสินค้าได้; ลูกค้ายังคง List หลังรีสตาร์ต
• □ CSV ตรง SO Confirmed และตัวกรองรายงาน; ช่วงอนาคตต้องไม่มียอด
• □ Quote→Won นับงานที่ไม่มี Visit ได้; Conversion ไม่เกิน 100%
• □ Subtotal ตรงผลรวมบรรทัดและ VAT ปัดสองตำแหน่ง; currency อื่นถูกปฏิเสธ
• □ Activity ต่างบริษัท/Inquiry ถูกปฏิเสธ; Restore ลูกต้องคืน Parent ก่อน
• □ Revise รายการ Pending ถอนคำขอเก่า; เปิดงานใหม่ตรง Won ไม่ได้

รายการเพิ่มยังไม่มีผล UAT จากลูกค้า ผลอัตโนมัติแยกบันทึกใน QA_REPORT.md

UX/UI และหมวดเมนู — 4 ต.ค. 2026

ผลในตารางนี้ให้ลูกค้าบันทึกเอง การทดสอบโดยผู้พัฒนาอยู่ใน QA_REPORT.md

แผนยอดขาย งบโครงการ และหมวดสินค้า — 4 ต.ค. 2026

ผลด้านล่างเว้นว่างสำหรับผู้ทดสอบลูกค้า การผ่าน regression หรือ browser ของทีมพัฒนาไม่แทนผล UAT

หน้า ผู้ใช้งาน ลบถาวร และ Super Admin — 4 ต.ค. 2026

ใช้บัญชี UAT ที่สร้างใหม่เท่านั้น ห้ามลบหรือปิดบัญชีจริง ข้อ Super Admin ต้องให้ทีมเทคนิคสร้างบัญชีด้วย tools/create_superadmin.py บนระบบทดสอบก่อน ผลด้านล่างเว้นว่างสำหรับผู้ทดสอบลูกค้า

ส่งต่อไฟล์และเอกสาร

เตรียมระบบทดสอบ

ใช้สำเนาฐานข้อมูลและโฟลเดอร์ uploads ใน instance แยก ตั้งค่าตาม SECURITY_AND_DEPLOYMENT.md และ START_HERE_MAC.md ของโปรเจกต์ ตรวจว่าเส้นทาง DB และ uploads ชี้ไปยังสำเนาก่อนทดสอบ Archive/Restore/Rules/Ownership/รหัสผ่าน/เวลาหมดอายุ ดู request schema ของเวอร์ชันที่รันจริงใน /docs หรือ /openapi.json ไม่เดา field จากตัวอย่าง

API ของระบบที่เปิดอยู่: http://127.0.0.1:8000/docs เอกสารแสดงคำสั่งที่เขียนข้อมูลได้ด้วย ให้ทดสอบคำสั่งเขียนกับ instance ทดสอบเท่านั้น

1. เรียก POST /api/auth/login ด้วย email/password บัญชี UAT ของ Role ที่ต้องการ
2. ใช้ Token ที่ได้รับกับ Authorize แบบ Bearer ใน API docs
3. สร้างข้อมูลทดสอบและจด ID ที่ API ส่งกลับ แทนการใช้ ID ของลูกค้าจริง
4. บันทึก method/path, Role, status code และผลที่ตรวจได้ โดยไม่บันทึกรหัสผ่านหรือ Token ลงรายงาน
5. Logout เมื่อเสร็จ และทดสอบว่าการใช้ Token เดิมถูกปฏิเสธ

ผลปกติใช้ 2xx; 401 ต้อง Login; 403 ไม่มีสิทธิ์; 409 ขัดกฎสถานะ/ข้อมูลซ้ำ; 422 schema ไม่ถูกต้อง บาง validation ใช้ 400 ให้ดูข้อความและ code ที่ source ระบุ อย่ากำหนดทุกความผิดพลาดให้ต้องเป็น code เดียว

รายการ API ที่ไม่มีปุ่มใช้งานครบในหน้าจอ

รายการครบทุก route รวม GET ที่ UI เรียกอยู่ใน FUNCTION_COVERAGE.md ตารางนั้นเป็น inventory จาก source ไม่ใช่หลักฐานว่าทดสอบผ่าน

TECH-10: เครื่องมือดูแลระบบ

โค้ดต้นฉบับ: /Users/tanakritrungsang/Documents/ASTER_CRM_V3

ตรวจวิธีเรียก/arguments จากไฟล์และเอกสารที่ตรงเวอร์ชันก่อนรันเครื่องมือ โดยเฉพาะ restore/reset อย่าใช้คำสั่งบนโปรเจกต์หลักเพื่อทดลอง

ดูแลคู่มือเมื่อมีการเปลี่ยนระบบ

1. แก้ USER_GUIDE.md ให้ตรงเมนู ปุ่ม field สิทธิ์ กฎ และข้อจำกัดจริง
2. แก้ UAT_TEST_CHECKLIST.md และภาคผนวกตามพฤติกรรมที่เปลี่ยน พร้อมเพิ่ม case ใหม่
3. Regenerate FUNCTION_COVERAGE.md จาก app.py ด้วย tools/generate_function_coverage.py; ตรวจ UI/API classification เมื่อมี route ใหม่
4. เปลี่ยนภาพใน docs_assets/ เมื่อหน้าจอเปลี่ยนจนภาพเก่าทำให้เข้าใจผิด
5. อัปเดต README/BUILD_MANIFEST/RELEASE_NOTES/UPDATE_SUMMARY ตามผลจริง แล้วซิงก์ Obsidian

คู่มือสำหรับผู้ใช้ส่งมอบเป็น HTML: เรียก python3 tools/build_user_guide.py หลังแก้เอกสาร เพื่อสร้าง static/user-guide.html จาก Markdown ทั้ง 4 ไฟล์และฝังภาพไว้สำหรับออฟไลน์ Template อยู่ใน tools/user_guide_template.html สคริปต์ sync จะสร้าง HTML ใหม่และคัดลอกให้อัตโนมัติ ไม่ต้อง restart CRM เพื่ออัปเดต static HTML

Vault: /Users/tanakritrungsang/Documents/Codex/2026-10-03/new-chat/outputs/Vexinio CRM Vault

Script sync: /Users/tanakritrungsang/Documents/Codex/2026-10-03/new-chat/outputs/sync-vexinio-docs.command

ต้นฉบับ Markdown อยู่ในโฟลเดอร์โปรเจกต์; Vault เป็นสำเนาสำหรับอ่าน Notes ของผู้ใช้จะไม่ถูกเขียนทับ การซิงก์เกิดเมื่อส่งมอบการอัปเดต ไม่ใช่ background watcher

การตรวจเพิ่มก่อน UAT — 4 ตุลาคม 2026

ทดสอบ Approval ขอบ 5/10% และช่องว่างทศนิยม, Revise ถอนคำขอ Pending เดิม, ไม่อนุมัติงานของ Parent ที่ archive, ไม่สร้าง Opportunity ตรงไป Won, ไม่เปลี่ยนบริษัท Inquiry เมื่อมีงานลูก, Last Admin ต้องคงอยู่, Role change ยกเลิก Session เดิม, target/master ซ้ำต้อง 409 แทน 500, CSV formula ถูก neutralize, Restore ผ่าน SQLite backup API เมื่อมี WAL โดยหยุด server/worker ก่อน และสำรอง uploads แยกด้วย ชุดอัตโนมัติผ่าน 56 เคสบนฐานข้อมูลแยก ไม่เท่ากับลูกค้าทดสอบผ่าน

UI workspace update — 4 ต.ค. 2026

หน้าตาและหมวดเมนูใช้ static/workspace.css และ static/workspace.js ร่วมกับ static/index.html ต้องส่งทั้งสามไฟล์ไปพร้อมกัน เส้นทาง API/schema เดิมทั้งหมด การค้นหาในตารางเป็น client-side กับรายการที่โหลดแล้ว ไม่ใช่ server pagination และ Audit ยังจำกัดรายการล่าสุดตาม endpoint ที่หน้าจอเรียก ตรวจสิทธิ์ฝั่ง API ควบคู่ UI เสมอ; Management ซ่อน upload และ email ใน detail dialog แล้ว

Planning/category release — 4 ต.ค. 2026

Migration 004_planning_categories เพิ่ม product_categories, project_budgets, budget_lines, budget_expenses และ products.category_id แบบ additive ย้าย Product Group หลัง seed เพียงครั้งเดียว ไม่ reset DB ทดสอบ restart ซ้ำแล้วชื่อหมวดที่แก้และราคาเดิมไม่ถูกทับ

Deploy app.py + planning_schema.py และ static/index.html/workspace.js/workspace.css/planning.js พร้อมกัน ต้อง restart backend ไม่ใช่แค่ refresh Browser ถ้า metadata ไม่มี features planning หน้าจอแจ้งเปิดรุ่นล่าสุดก่อนแทนการเรียก API ที่ไม่มี Backup ก่อน migration: backups/planning_20261004/crm_v3.db และไฟล์ source เดิมในโฟลเดอร์เดียวกัน

API ใหม่มี UI ครบ: GET/POST/PUT product-categories; GET/POST/PUT budgets; GET budgets/{id}; POST actions; POST expenses; POST expense void. Target PUT มี UI แล้ว จึงเอา update_target ออกจาก API_ONLY ส่วน update_master_value ยัง API-only; product_group ผ่าน Master Value ถูกปฏิเสธ ให้ใช้ Product Categories แทน

ตรวจ negative paths: ownership/customer/opportunity, code collision/cycle, parent active, inactive assignment, target overlapping boundaries, independent approval, transition lock, expense date/line ownership, decimal rounding, void idempotency และ portfolio transfer รวมข้อมูลจริง integrity/FK ก่อนส่งมอบ

นิยามเงิน: Sales target ใช้ SO grand_total รวม VAT; Project budget/expected revenue ใช้ยอดที่กรอกไม่รวม VAT ที่ขอคืนได้ อย่าเทียบ KPI ทั้งสองเป็นกำไรบัญชี งบยังไม่เชื่อม PO, commitments, inventory/accounting, automatic actual cost, revisions/export/notifications

Restore รุ่นเก่าต้องหยุด worker/server และเก็บ backup ของ DB/source ใหม่ก่อน การย้อน DB ย่อมไม่มีงบที่เพิ่มหลัง backup ห้ามนำ backup ก่อน migration มาทับข้อมูลโดยไม่ตกลงกับผู้ใช้

Handoff package checks — 2026-10-04

Run tools/package_handoff.py after documentation sync. Verify ZIP CRC/SHA256/manifest, embedded manual, vault Notes/home byte preservation, SQLite integrity/FK and business rows versus live source. Exclude local .venv/.git/cache/backups/logs/.env and WAL/SHM. Export only clears sessions/login_attempts in copied DB. Extract ZIP to a temporary folder to verify imported app/static dependencies and run isolated regression there. Do not interpret this as a fresh dependency install, Windows launcher, Obsidian desktop test or customer UAT pass.

User admin / Super Admin — 4 ต.ค. 2026

หน้า ผู้ใช้งาน (static/users.js, page key users) ย้ายงานจัดการผู้ใช้ออกจาก Admin Center การ์ดผู้ใช้ใน Admin Center เป็นสรุปพร้อมปุ่ม จัดการผู้ใช้งาน Deploy ต้องส่ง app.py + static/index.html/users.js/workspace.* พร้อมกันและ restart backend

Schema: migration เพิ่ม users.is_superadmin INTEGER NOT NULL DEFAULT 0 (0/1) แบบ additive บัญชีเดิมทั้งหมดเป็น 0

API ที่เปลี่ยน/เพิ่ม

Super Admin: require_roles ให้ผ่านทุก role เมื่อ is_superadmin=1 Admin ทั่วไปเรียก PUT/status/reset-password/revoke-sessions/delete-check/DELETE กับบัญชี Super Admin ได้ 403 Super Admin ต้องคง role Admin (เปลี่ยนเป็นอื่น 409) และลบไม่ได้ หน้าจอสร้าง Super Admin ไม่ได้

สร้าง Super Admin (CLI เท่านั้น) จากโฟลเดอร์ 01_Application:

python tools/create_superadmin.py --email <email> [--name "Super Admin"] --password-file <file>

หรือส่งรหัสทาง stdin (printf '%s' "$PASSWORD" | python tools/create_superadmin.py --email <email>) เพื่อไม่ให้รหัสอยู่ใน shell history รหัสอย่างน้อย 8 ตัว ใช้ CRM_DB_PATH แบบเดียวกับแอป idempotent: ถ้ามีอีเมลนี้แล้วจะตั้ง role Admin, active, is_superadmin=1, รหัสใหม่ และลบ session เดิม (Audit superadmin_update) ถ้ายังไม่มีจะสร้างใหม่ (Audit superadmin_create) บัญชี production: superadmin@vexinio.com ลบไฟล์รหัสหลังใช้งาน

Tests: tests/test_user_admin.py 7 tests: Super Admin ผ่าน role check และคืนค่าใน API, Admin จัดการ Super Admin ไม่ได้, Super Admin คง role/ลบไม่ได้, ลบต้องพิมพ์อีเมลตรงและ detach Audit, ลบไม่ได้เมื่อมีข้อมูลหรือเป็นตนเอง, non-Admin ลบไม่ได้, และ tools/create_superadmin.py

UI menus

Dashboard; Customers; Contacts; Inquiries; Visits; Pipeline; Products; Product Categories; Sales Plans; Project Budgets; Quotations; Approvals; Sales Orders; Activities; Notifications; Reports; Admin Center; Users; Audit.

Maintenance

Run python tools/generate_function_coverage.py from the project after route changes. Review new routes and the API_ONLY classification, update the user guide and test cases, and synchronize Obsidian before delivery.