เอกสารนี้สรุปขั้นตอนเตรียมระบบ UAT จากชุด CSV ใน setup/ALLA-ONVALLA โดยเล่าแบบ user action ทีละ step เพื่อให้ tester รู้ว่าต้องทำอะไร ระบบทำอะไร และควรเห็นผลลัพธ์อะไรหลังจบแต่ละช่วง
ให้ไล่จากซ้ายไปขวา หาก step ใดขึ้น FAIL ให้แก้ข้อมูลหรือ environment ก่อนค่อยไปต่อ ห้าม commit CSV ถ้า preview ยังมี blocking error
ทุก step ด้านล่างออกแบบให้ tester หรือ admin ทำตามได้โดยไม่ต้องอ่านโค้ด
ยืนยันว่าจะล้างข้อมูล UAT แล้วรัน reset database ด้วย explicit confirmation
ลบ schema และตารางเดิม แล้วสร้าง schema ว่างสำหรับเริ่มรอบใหม่
ฐานข้อมูลไม่มีข้อมูล business เดิมค้างอยู่
ถ้า reset ถูก block ให้ตรวจ host, database name และ flag reset safety
รัน migration เพื่อสร้างตารางตาม schema ล่าสุด
Drizzle applies migrations และสร้าง migration history
ตารางหลัก เช่น users, organizations, memberships, CRM, approval พร้อมใช้งาน
ถ้า migrate fail ให้แก้ schema/migration ก่อน import CSV
เลือก source เป็น configured directory: setup/ALLA-ONVALLA
อ่าน 11 required CSV, validate header, duplicate, enum, dependency และ references
Preview ต้องมี 0 errors ก่อน commit
ถ้ามี unknown option ให้เติม master option หรือแก้ code ให้ตรงไฟล์อ้างอิง
ใช้ preview hash ล่าสุดเพื่อ commit ข้อมูล CSV
นำข้อมูลเข้าแบบ transaction/upsert ตามลำดับ dependency
ข้อมูล users, orgs, memberships, roles, approvals, sequences ถูกสร้างครบ
ถ้า hash mismatch ให้ preview ใหม่ แล้ว commit ด้วย hash ใหม่
กด complete หรือเรียก setup completion หลัง required steps ผ่านแล้ว
บันทึก setup run, seed manifest และล็อกสถานะ bootstrap เป็น completed
Setup run ล่าสุดเป็น completed และระบบออกจาก bootstrap mode
ถ้า complete ถูก block ให้ดู missing step หรือ readiness check ที่ยังไม่ผ่าน
ตรวจจำนวนข้อมูลและจุด readiness ก่อนเริ่ม UAT
เช็ค active organization, role assignment, approval setup และ document sequences
ALLA และ ONVALLA มี users, Lead status, THB currency, quotation sequence พร้อม
ถ้า Lead สร้างไม่ได้ ให้ตรวจ crm_lead_status:new_job และ crm_lead sequence
ตัวเลขเหล่านี้มาจาก CSV source ปัจจุบัน ไม่รวม row ที่ระบบสร้างเองระหว่าง runtime
ระบบต้องอ่านตามลำดับนี้ เพราะไฟล์ท้าย ๆ อ้างอิงข้อมูลจากไฟล์ก่อนหน้า
| Order | CSV File | Tester Checkpoint |
|---|---|---|
| 01 | users.csv | มี user UAT ครบทั้ง ALLA และ ONVALLA |
| 02 | organizations.csv | มีองค์กร ALLA และ ONVALLA |
| 03 | memberships.csv | user ทุกคนมี organization access |
| 05 | crm-role-assignments.csv | role/scopes พร้อมสำหรับ marketing, sales, manager, admin |
| 06 | master-options.csv | options สำคัญ เช่น currency, lead status, customer status พร้อม |
| 07 | branches.csv | branch head_office พร้อมใช้งานในแต่ละ org |
| 08 | product-types.csv | product type เช่น crane, dockdoor, solarcell พร้อม |
| 14 | document-sequences.csv | เลขเอกสารสำหรับ customer, lead, opportunity, quotation พร้อม |
| 15 | approval-workflows.csv | workflow quotation 3 ระดับต่อ org |
| 16 | approval-steps.csv | step approval เรียงตาม role |
| 17 | approval-matrix.csv | routing approval ตาม product และ amount พร้อม |
ใช้รายการนี้เป็น gate สั้น ๆ ก่อนส่งให้ tester เริ่มใช้งานจริง
ALLA Company Limited และ ONVALLA Demo Company พร้อม
25 users มี active organization และ membership
27 role assignments ครอบคลุม UAT roles
new_job status และ crm_lead sequence พร้อม
workflow, steps, matrix พร้อมสำหรับ quotation routing
WARNING แบบ AUDIT_GAP คือข้อจำกัด import engine ไม่ใช่ข้อมูลผิด
เอกสารนี้ไม่แสดง password ให้เปิดดูจากช่องทางจัดการ credential หรือไฟล์ CSV เฉพาะผู้มีสิทธิ์เท่านั้น
| Role | ALLA | ONVALLA | ใช้ทดสอบอะไร |
|---|---|---|---|
| System Admin | super_admin@allaos.local | - | setup, admin access, configuration |
| Marketing | mk.uat@allaos.local | mk.onvalla@allaos.local | สร้าง Lead และติดตาม handoff |
| Sales Manager | manager.uat@allaos.local | manager.onvalla@allaos.local | ดูทีม, assign, approve ขั้นต้น |
| Sales | sales_crane.uat@allaos.local | sales_crane.onvalla@allaos.local | Opportunity และ Quotation |
| Department / Top Manager | gm.uat@allaos.local / ceo.uat@allaos.local | gm.onvalla@allaos.local / ceo.onvalla@allaos.local | approval ระดับสูงและ dashboard monitoring |
นี่คือ business flow สั้น ๆ เพื่อยืนยันว่าระบบ UAT พร้อมใช้งานจริง
My Day คือหน้ารวม “งานที่ควรทำก่อน” ของผู้ใช้ในวันนั้น ไม่ใช่ที่เก็บข้อมูลหลักของ CRM แต่เป็น workspace ที่ดึงงานจาก Activities, Calendar, Approvals, Hot Projects และ Timeline มาเรียงให้ตัดสินใจง่าย
Login ด้วย user UAT แล้วเข้าเมนู CRM > My Day
โหลด workspace ตามสิทธิ์ของ user และแสดงโหมด Personal mode หรือ Manager mode
เห็นสรุป Activities, Meetings, Visits, Overdue, Hot Projects และ Approvals
ถ้าไม่เห็นเมนู ให้ตรวจ membership, CRM role assignment และ permission crm.activity.read
กดตัวกรอง today, tomorrow หรือ this week เพื่อดูคิวงานตามช่วงเวลา
กรองรายการตามวันครบกำหนด เวลาใน calendar และ scope ของ user หรือทีม
Priority Queue และ Today's Schedule เปลี่ยนตาม range ที่เลือก
ถ้ารายการว่าง ให้เช็คว่า activity มี assignee, due date/start date และอยู่ใน organization เดียวกับ user
เริ่มจากรายการ P1/P2 ก่อน แล้วคลิกงานเพื่อเปิด record ต้นทาง เช่น Activity, Opportunity, Quotation หรือ Approval
รวม overdue activities, งานครบกำหนด, approval pending และ hot project แล้วจัดลำดับความสำคัญ
ผู้ใช้รู้ว่าต้อง follow-up งานไหนก่อน โดยไม่ต้องเปิดหลายหน้าเพื่อหาเอง
ถ้าคลิกแล้วไปหน้าที่ไม่เห็นข้อมูล ให้ตรวจสิทธิ์ของ source record และ branch/product scope
กด Add Activity เมื่อมีงาน follow-up ใหม่ หรือเปิด Activity เดิมเพื่ออัปเดตสถานะ/กำหนดเวลา
บันทึก Activity เป็นแหล่งข้อมูลหลัก แล้วส่งผลให้ My Day, Calendar และ Timeline แสดงงานล่าสุด
งานที่มี due date หรือ schedule จะกลับมาแสดงใน My Day ตามช่วงเวลาที่ถูกต้อง
ถ้าเพิ่ม Activity แล้วไม่ขึ้น ให้กด Refresh และตรวจว่า status ยังไม่ completed/cancelled
Calendar คือมุมมองแบบเวลา ใช้ดู meeting, visit, task, reminder และ milestone จาก CRM โดยดึงข้อมูลจาก calendar projection ที่ผูกกับ Activity หรือ record ต้นทาง
เข้าเมนู CRM > Calendar เพื่อดูตารางงานของตัวเองหรือทีมตามสิทธิ์
โหลด event ตาม date range, organization, lens, user/team scope และ permission visibility
เห็น event พร้อมสรุป Due Today, Overdue, Meetings, Visits และ Hot Projects
ถ้า calendar ว่าง ให้เช็คช่วงวันที่, owner/assignee, activity schedule และสิทธิ์การมองเห็นของ user
ใช้ช่อง search เพื่อค้นหาชื่อ event, รายละเอียด, user หรือ source type แล้วคลิก event เพื่อดูรายละเอียด
กรองรายการบนหน้าจอ และแสดงข้อมูลเวลา สถานที่ ผู้รับผิดชอบ และ record ที่เกี่ยวข้อง
tester เข้าใจว่างานนี้เกี่ยวกับ customer, lead, opportunity, quotation หรือ approval ใด
ถ้า search ไม่เจอ ให้ลองล้าง keyword และตรวจว่างานอยู่ในช่วงวันที่ที่ calendar โหลดอยู่
ลากหรือปรับเวลา event เฉพาะรายการที่เป็น editable activity และ user มีสิทธิ์แก้ไข
แปลงการลากเป็นคำสั่ง reschedule Activity แล้ว invalidate Calendar, My Day และ Activity cache
เวลาใหม่แสดงใน Calendar และ My Day หลังบันทึกสำเร็จ
ถ้าแก้ไม่ได้ อาจเป็น milestone/read-only event หรือ user ไม่มีสิทธิ์ update activity
เมื่อต้องเพิ่มนัดหมายใหม่ ให้ไปสร้างที่ Activity เพราะ Activity คือ source of truth ของงาน
หลัง Activity ถูกสร้าง ระบบสร้างหรืออัปเดต calendar projection เพื่อให้ event ปรากฏใน Calendar
event ใหม่แสดงใน Calendar ตามเวลา และแสดงใน My Day ถ้าอยู่ในช่วงที่เลือก
ถ้าสร้างแล้วไม่ขึ้น ให้ตรวจ start/end time, timezone, assignee และ refresh calendar
สามส่วนนี้ทำงานร่วมกัน แต่ตอบคำถามคนละแบบ: วันนี้ควรทำอะไร, งานอยู่เวลาไหน, และข้อมูลต้นทางอยู่ที่ใด
| ส่วนของระบบ | ใช้ตอบคำถาม | User Action หลัก | สิ่งที่ต้องจำ |
|---|---|---|---|
| My Day | วันนี้ฉันควรทำอะไรก่อน | ดู Priority Queue, Schedule, Overdue, Pending Approval แล้วเปิด record เพื่อทำงานต่อ | เหมาะกับเริ่มวันและ follow-up งานเร่งด่วน |
| Calendar | งานนี้เกิดขึ้นวันและเวลาไหน | ดูตาราง, search event, เปิดรายละเอียด, reschedule event ที่แก้ได้ | เหมาะกับวางแผนเวลาและดูภาระงานรายวัน/สัปดาห์/เดือน |
| Activity | รายละเอียดงานและ follow-up คืออะไร | สร้างงาน, ใส่ assignee, ตั้งเวลา, อัปเดตสถานะ, บันทึกผลการติดตาม | เป็น source of truth ของงานที่ actionable |
| Lead / Opportunity / Quotation | งานนี้เกี่ยวกับดีลหรือเอกสารใด | เปิด record ต้นทางเพื่อดู customer, stage, amount, approval และเอกสาร | เป็น business context ไม่ใช่คิวงานประจำวันโดยตรง |
ใช้ scenario ด้านล่างเพื่อยืนยันว่า workspace ทั้งสองหน้าเชื่อมกับ CRM flow จริง และ tester เห็นผลลัพธ์ที่คาดหวัง
Activity Type คือชนิดของงานที่ต้องทำ มีผลต่อการกรองงาน, badge, สถิติใน My Day, การแสดงใน Calendar และการตีความว่าผู้ใช้ต้อง action แบบไหน
| Activity Type | ใช้เมื่อไร | ตัวอย่าง User Action | ผลต่อระบบ |
|---|---|---|---|
| meeting | มีนัดประชุมกับลูกค้า ทีมขาย หรือทีมภายใน | นัด review requirement, demo solution, kickoff | นับเป็น Meeting และแสดงเป็น event ใน Calendar เมื่อมี scheduled date |
| visit | ออกไปพบลูกค้าหรือไปพื้นที่ลูกค้า | MK/Sales ไปเยี่ยมลูกค้า A วันที่กำหนด | นับเป็น Visit ใน My Day/Calendar และช่วยตามประวัติการเข้าพบ |
| phone_call | โทรติดตามหรือโทรสอบถามข้อมูล | โทรถามความคืบหน้า, โทรยืนยันวันนัด | ใช้แยกงานโทรออกจาก meeting/visit เพื่อดู workload ได้ชัด |
| ส่งอีเมลเป็น action หลัก | ส่ง catalog, ส่งเอกสาร, ส่งสรุปหลังประชุม | ช่วยให้ Timeline เห็นว่ามีการสื่อสารผ่านอีเมล | |
| site_survey | ต้องเข้าสำรวจหน้างานเพื่อเก็บข้อมูลเทคนิค | นัดสำรวจพื้นที่ติดตั้ง crane, dock door, solar | เหมาะกับงานก่อนเสนอราคา และช่วยทีมเห็น milestone สำรวจหน้างาน |
| presentation | นำเสนอสินค้า โซลูชัน หรือ proposal | Demo solution, present quotation, present project concept | ทำให้แยกกิจกรรมเชิงขาย/นำเสนอออกจาก meeting ทั่วไป |
| reminder | ตั้งเตือนให้กลับมาทำบางอย่างในอนาคต | เตือน follow-up ลูกค้าอีก 2 เดือน, เตือนขอข้อมูลเพิ่ม | ขึ้นใน My Day/Calendar ตาม due/scheduled date แต่ไม่ใช่งานอนุมัติ |
| internal_task | งานภายในที่ไม่ใช่การติดต่อกับลูกค้าโดยตรง | เตรียมเอกสาร, ตรวจข้อมูล, ประสานทีม service | มักใช้กับ Primary Entity = internal หรือ record ที่เกี่ยวข้อง |
| follow_up | ติดตามต่อจาก activity/lead/opportunity/quotation เดิม | ติดตาม lead หลังลูกค้าขอคิดก่อน, ติดตาม quotation หลังส่งราคา | เป็น type หลักสำหรับงานต่อเนื่อง และมักโผล่ใน Priority Queue |
| delivery_coordination | ประสานงานส่งมอบ ติดตั้ง หรือส่งเอกสารหลังปิดงาน | นัดวันส่งของ, ประสาน schedule ติดตั้ง, แจ้งทีม operation | ช่วยแยกงาน post-sale/operation ออกจากงานขายปกติ |
| approval_action | งานที่เกี่ยวกับการอนุมัติหรือรอ action จากผู้อนุมัติ | ตรวจ quotation ก่อน approve, request revision, follow approval | ช่วยเชื่อมงานผู้อนุมัติกับ My Day แต่ approval workflow ยังเป็น source หลัก |
| email_follow_up | alias เก่าสำหรับ follow-up ผ่านอีเมล | ติดตามลูกค้าด้วยอีเมล | ยังรองรับเพื่อ compatibility แต่ควรใช้ email หรือ follow_up ให้ชัดกว่า |
| reminder_action | alias เก่าสำหรับ action เตือนความจำ | งานเตือนที่ถูกสร้างจาก flow เก่า | ยังรองรับเพื่อ compatibility แต่ type หลักที่ควรเลือกใหม่คือ reminder |
| other | ใช้เมื่อไม่มี type ใดตรงจริง ๆ | งานเฉพาะกิจที่ยังไม่เข้าหมวด | ควรใช้ให้น้อย เพราะทำให้ reporting และการกรองงานไม่คม |
reminder คือ Activity Type หลักสำหรับตั้งเตือนใน CRM ส่วน reminder_action เป็น alias เก่าที่ระบบยังรับได้เพื่อไม่ให้ข้อมูลเก่าพัง งานใหม่ควรเลือก reminder เป็นหลักกรณีเป็นการวิ่งหาลูกค้าใหม่ ยังไม่รู้บริษัทชัด ยังไม่มี contact และยังไม่มี lead ให้บันทึกเป็น Activity แบบ internal/prospecting ก่อน เพื่อเก็บงานของทีมโดยไม่สร้าง customer หรือ lead ปลอม
เลือก internal
เว้นว่าง เพราะยังไม่มี customer/lead/opportunity จริงในระบบ
เลือก visit ถ้าออกพื้นที่, phone_call ถ้าโทรหา, หรือ internal_task ถ้าเป็นงานเตรียมรายชื่อ
เขียนให้ค้นเจอ เช่น Prospecting visit - Industrial estate A
Complete activity เดิม แล้วใส่ Outcome Summary ว่าเจอข้อมูลอะไร แต่ยังไม่มี lead confirmed
เก็บเป็นประวัติการทำงานของ MK/Sales โดยยังไม่ผูกกับ customer record
ผู้จัดการเห็นว่ามี prospecting activity เกิดขึ้น แต่ pipeline/lead ยังไม่บวมจากข้อมูลที่ยังไม่ยืนยัน
ถ้าต้องตามต่อ ให้สร้าง Activity ใหม่ชนิด reminder หรือ follow_up ในวันที่เหมาะสม
สร้าง customer/contact เมื่อรู้ชื่อบริษัทหรือผู้ติดต่อมากพอ
สร้าง lead เมื่อมี requirement หรือโอกาสงานที่ยืนยันได้
Activity ใหม่หลังจากนั้นควรผูกกับ customer หรือ lead แทน internal
Timeline ของ customer/lead เริ่มสะสมประวัติจากจุดที่มี record จริง
internal + visit, scheduled date เป็นวันออกไปพื้นที่, subject ระบุพื้นที่หรือกลุ่มเป้าหมาย
บันทึกว่า “ยังไม่ได้ lead แต่ได้ยินว่าจะมีงานในอีก 2 เดือน”
สร้าง reminder หรือ follow_up อีก 2 เดือน เพื่อกลับไปตรวจสอบโอกาสงาน
อย่าสร้าง Customer/Lead ปลอมถ้ายังไม่มีข้อมูลยืนยัน เพราะจะทำให้ UAT pipeline และ report เพี้ยน
Status คือสถานะการทำงานของ Activity มีผลต่อคิวงานใน My Day, การนับ overdue, การแก้ไขงานต่อ และ Timeline ของ record ที่เกี่ยวข้อง
| Status | ความหมาย | ควรใช้เมื่อไร | ผลต่อระบบ |
|---|---|---|---|
| draft | ร่างงานไว้ก่อน ยังไม่ถือว่าเริ่มทำจริง | ยังไม่พร้อมนัดหมาย หรือยังรอข้อมูลก่อน assign/schedule | ยังเป็นงานเปิด แต่ไม่ควรใช้เป็นงานปฏิบัติประจำวันนานเกินไป |
| scheduled | วางแผนแล้ว มีวันทำงานหรือวันครบกำหนด | มีนัด visit, meeting, call, follow-up หรือ reminder ที่ต้องทำในอนาคต | แสดงใน Calendar/My Day ตาม Scheduled Date หรือ Due Date และอาจกลายเป็น overdue เมื่อเลยเวลา |
| in_progress | กำลังทำงานนี้อยู่ | เริ่มติดต่อ เริ่มติดตาม หรือกำลังประสานงานแต่ยังไม่เสร็จ | ยังเป็น active work และถ้าเลย Due Date จะถูกมองเป็น overdue |
| completed | ทำงานเสร็จแล้ว | โทรแล้ว, ไปพบแล้ว, ส่งอีเมลแล้ว, follow-up แล้ว และบันทึกผลลัพธ์แล้ว | ปิดงาน ไม่ถูกดันเป็น overdue อีก และควรมี Outcome Summary / Next Action ถ้าต้องตามต่อ |
| cancelled | ยกเลิกงาน | นัดถูกยกเลิก ลูกค้าไม่ต้องการแล้ว หรือสร้างผิด | ปิดงาน ไม่ขึ้นเป็น overdue และควรใส่ Cancellation Reason |
| skipped | ข้ามงานนี้ไป | งานไม่จำเป็นแล้ว แต่ไม่ใช่การยกเลิกแบบ error เช่น ลูกค้าตอบผ่านช่องทางอื่นแล้ว | ปิดงาน ไม่ขึ้นเป็น overdue และควรใส่ Skip Reason เพื่ออธิบายเหตุผล |
| overdue | เลยกำหนดแล้ว | โดยปกติไม่ต้องเลือกเอง ระบบคำนวณจากวันที่ | เป็น effective status: ถ้างานยังไม่ completed/cancelled/skipped และเลย Due Date หรือ Scheduled Date ระบบจะแสดงเป็น overdue |
draft ไป scheduled หรือ cancelled; scheduled ไป in_progress, completed, cancelled, skipped; งานที่ completed, cancelled, skipped แล้วถือว่าปิดและไม่ควรย้อนกลับสองช่องนี้คล้ายกันแต่ตอบคนละคำถาม: Scheduled Date คือ “จะทำเมื่อไร” ส่วน Due Date คือ “ต้องเสร็จไม่เกินเมื่อไร”
วันที่วางแผนให้ activity เกิดขึ้น เช่น วันนัดประชุม วันไปพบลูกค้า วันโทร
ใช้กับงานที่มีเวลาทำชัดเจน เช่น meeting, visit, site_survey, phone_call
ทำให้งานแสดงเป็น event ใน Calendar และถ้าลาก event ใน Calendar ระบบจะ reschedule Activity
งานจะเข้า Schedule/คิวประจำวันเมื่ออยู่ในช่วง today, tomorrow หรือ this week
วันครบกำหนดที่งานควรเสร็จ ไม่จำเป็นต้องเป็นวันเดียวกับวันที่นัดทำงาน
ใช้กับงานที่มี deadline เช่น ส่งเอกสารภายในวันศุกร์, follow-up ไม่เกินสิ้นเดือน
ระบบใช้ Due Date เป็นตัวเทียบก่อน ถ้าเลยกำหนดและงานยังไม่ปิด จะแสดงเป็น overdue
งานที่ due ใกล้หรือ overdue มีโอกาสถูกดันให้เห็นชัดใน My Day / Priority Queue
นัด visit วันที่ 2026-07-17 แต่ต้องส่งสรุปไม่เกิน 2026-07-18
ใส่วันที่งานเกิดขึ้นจริง: 2026-07-17
ใส่ deadline: 2026-07-18
Calendar ช่วยดูวันนัด ส่วน My Day/Overdue ช่วยเตือน deadline
เหมาะกับนัดหมายที่เกิดวันนั้นและไม่มี deadline แยก ระบบจะใช้ scheduled date ช่วยคำนวณ overdue ถ้างานไม่ปิด
เหมาะกับ task/reminder ที่ต้องเสร็จภายในวันหนึ่ง แต่ไม่ได้มีเวลานัดชัดเจน
งานจะค้นเจอใน Activity แต่ My Day/Calendar จะช่วยเตือนได้จำกัด
ถ้าต้องการให้งานขึ้น Calendar ให้ใส่ Scheduled Date; ถ้าต้องการกันลืม deadline ให้ใส่ Due Date
Scheduled Date = วัน/เวลาที่จะทำงาน, Due Date = วันสุดท้ายที่งานต้องเสร็จ. ถ้า Due Date มีค่า ระบบจะใช้ Due Date เป็นหลักในการตัดสิน overdue; ถ้าไม่มี Due Date จึงใช้ Scheduled Date แทนALLA OS UAT Setup Flow - generated from setup/ALLA-ONVALLA CSV dataset.