Process & Specification Hub — Kepler Universal QA

sequenceDiagram autonumber actor Planner as ผู้จัดการแผนจัดซื้อ (Planner) participant UI as หน้าจอ Routine Plan participant Morning as รายงานประมาณการสินค้าคงเหลือ participant Calc as โมดูลคำนวณรายวัน participant Alloc as โมดูลจัดสรรสัดส่วน participant Partner as โมดูลกระจายยอดคู่ค้า participant Export as โมดูลสรุปและส่งออก Excel Planner->>UI: 1. เลือกโรงงาน, วัตถุดิบ, สัปดาห์ (#379873) UI->>Morning: 2. ดึงสต็อกคงเหลือยกมา และค้างรับสุทธิ (#379273) Morning-->>UI: ส่งมอบข้อมูลตั้งต้น (Initial Data Snapshot) Planner->>UI: 3. ปรับยอดแผนรายวัน UI->>Calc: ส่งคำนวณยอดคงเหลือสุทธิและผลต่างสะสม Planner->>UI: 4. กด Auto Allocation หรือปรับสัดส่วน (#379751) UI->>Alloc: ประมวลผลจัดสรรสัดส่วนโควตา Planner->>UI: 5. ปรับยอดรายวันของคู่ค้าแต่ละเจ้า (#379899) UI->>Partner: ตรวจสอบผลรวมคู่ค้าตรงกับยอดโรงงาน 100% Planner->>UI: 6. ตรวจสอบแนวโน้ม 5 สัปดาห์ & ดาวน์โหลด (#378167) UI->>Export: สร้างและส่งมอบไฟล์ Excel

flowchart TD %% ========================================== %% Activity Diagram / BPMN: การบันทึก Snapshot และล้างข้อมูลรายวัน %% ========================================== subgraph Lane_User ["👤 ฝั่งผู้ใช้งาน (Local Trader)"] U_Start(["เริ่มต้น: เข้าสู่เมนูการทำแผน Routine"]) U_Select["เลือกวัตถุดิบ และวันที่ทำแผน"] U_EditCurrent["กรอกและแก้ไขข้อมูลในแท็บ ภาพรวม และ แผนรายคู่ค้า"] U_ClickSave["กดปุ่ม บันทึก"] U_ViewHistory["ดูข้อมูลย้อนหลัง และใช้ตัวกรองประวัติ"] end subgraph Lane_System ["⚙️ ฝั่งระบบงาน (บันทึกข้อมูลและระบบอัตโนมัติรอบดึก)"] S_CheckDate{"วันที่ทำแผนเป็นวันปัจจุบันหรือไม่?"} S_SaveDB["บันทึกข้อมูลลงฐานข้อมูลสำเร็จ"] S_LoadHistory["แสดงข้อมูลย้อนหลังแบบอ่านอย่างเดียว"] S_TriggerTime["ถึงเวลา 23:59:00 น. ตามเวลาประเทศไทย"] S_TakeSnapshot["ดึงข้อมูลล่าสุดสร้างภาพจำลองข้อมูล ครบทั้ง 2 แท็บ"] S_CheckSnapshot{"การสร้าง Snapshot สำเร็จหรือไม่?"} S_HaltClear["ระงับกระบวนการล้างข้อมูลทั้งหมดเพื่อความปลอดภัย"] S_ExecuteClear["ดำเนินการล้างข้อมูลตามขอบเขตที่กำหนด"] S_ClearOverview["ล้างข้อมูลแท็บภาพรวม: ยอดเสนอ, โอน, โปรแกรมขน"] S_ClearVendor["ล้างข้อมูลแท็บแผนรายคู่ค้า: ยอดรอเปิด, โอน, โปรแกรมขน"] S_ClearProg["ล้างข้อมูลโปรแกรมขน: เฉพาะวันก่อนหน้า และวันปัจจุบัน"] S_NewDay["เริ่มต้นวันใหม่: ช่องที่ถูกล้างจะเป็นค่าว่าง และไม่ดึงค่าเดิมมาแสดง"] S_End(["สิ้นสุดกระบวนการ"]) end U_Start --> U_Select U_Select --> S_CheckDate S_CheckDate -->|"เป็นวันปัจจุบัน"| U_EditCurrent U_EditCurrent --> U_ClickSave U_ClickSave --> S_SaveDB S_SaveDB --> S_TriggerTime S_CheckDate -->|"เป็นวันย้อนหลัง (อดีต)"| S_LoadHistory S_LoadHistory --> U_ViewHistory U_ViewHistory --> S_End S_TriggerTime --> S_TakeSnapshot S_TakeSnapshot --> S_CheckSnapshot S_CheckSnapshot -->|"ไม่สำเร็จ"| S_HaltClear S_HaltClear --> S_End S_CheckSnapshot -->|"สำเร็จ"| S_ExecuteClear S_ExecuteClear --> S_ClearOverview S_ExecuteClear --> S_ClearVendor S_ExecuteClear --> S_ClearProg S_ClearOverview --> S_NewDay S_ClearVendor --> S_NewDay S_ClearProg --> S_NewDay S_NewDay --> S_End

flowchart TD %% ========================================== %% Activity Diagram / BPMN: ภาพรวม และการคำนวณ %% ========================================== subgraph Lane_User ["👤 ฝั่งผู้ใช้งาน (Local Trader)"] U_Start(["เริ่มต้น: เข้าสู่ระบบเมนูการทำแผน Routine"]) U_SelectProdDate["เลือกวัตถุดิบ และวันที่ทำแผน"] U_EditData["กรอกและแก้ไขตัวเลขในช่องที่เปิดให้แก้ไข"] U_Action{"เลือกการดำเนินการ"} U_Save["กดปุ่ม บันทึก"] U_Navigate["เปลี่ยนเมนู หรือรีเฟรชหน้า ขณะมีข้อมูลค้างบันทึก"] U_Stay["เลือก อยู่ต่อ ในหน้าเดิม"] U_Leave["เลือก ออกจากหน้า"] end subgraph Lane_System ["⚙️ ฝั่งระบบงาน (ระบบคำนวณและตรวจสอบสิทธิ์)"] S_CheckPerm{"ตรวจสอบสิทธิ์การใช้งาน"} S_DenyAccess["ปฏิเสธการเข้าถึง หรือซ่อนเมนู"] S_CheckDate{"ตรวจสอบวันที่ทำแผน"} S_LoadHistory["โหลดข้อมูลย้อนหลังแบบอ่านอย่างเดียว"] S_LoadCurrent["โหลดข้อมูลรอบปัจจุบัน พร้อมเปิดช่องให้กรอกข้อมูล"] S_Recalculate["คำนวณผลลัพธ์และตรวจสอบค่าแบบทันที"] S_Validate{"ตรวจสอบความถูกต้องของข้อมูล"} S_SaveSuccess["บันทึกข้อมูลสำเร็จ และอัปเดตสถานะ"] S_ShowModal["แสดงหน้าต่างยืนยันการออกจากหน้า"] S_Discard["ละทิ้งข้อมูลที่ยังไม่บันทึก และเปลี่ยนหน้าจอ"] S_End(["สิ้นสุดกระบวนการ"]) end U_Start --> S_CheckPerm S_CheckPerm -->|"ไม่มีสิทธิ์"| S_DenyAccess S_DenyAccess --> S_End S_CheckPerm -->|"มีสิทธิ์ถูกต้อง"| U_SelectProdDate U_SelectProdDate --> S_CheckDate S_CheckDate -->|"วันที่ในอดีต (ย้อนหลัง)"| S_LoadHistory S_LoadHistory --> S_End S_CheckDate -->|"วันปัจจุบัน"| S_LoadCurrent S_LoadCurrent --> U_EditData U_EditData --> S_Recalculate S_Recalculate --> U_Action U_Action -->|"บันทึกข้อมูล"| U_Save U_Save --> S_Validate S_Validate -->|"ข้อมูลถูกต้อง"| S_SaveSuccess S_SaveSuccess --> S_End U_Action -->|"ออกจากหน้าจอ"| U_Navigate U_Navigate --> S_ShowModal S_ShowModal --> U_Stay S_ShowModal --> U_Leave U_Stay --> U_EditData U_Leave --> S_Discard S_Discard --> S_End

flowchart TD %% ========================================== %% Activity Diagram / BPMN: ภาพรวม แผนการขนส่ง 5 สัปดาห์ %% ========================================== subgraph Lane_User ["👤 ฝั่งผู้ใช้งาน (Local Trader)"] U_Start(["เริ่มต้น: เข้าสู่เมนูการทำแผน Routine"]) U_SelectDate["เลือก วันที่ทำแผน ในปฏิทิน"] U_InputProg["กรอกหรือแก้ไขยอดโปรแกรมขน
(เฉพาะโรงงานที่ตนเองดูแล)"] U_Action{"เลือกการดำเนินการ"} U_ClickCancel["กดปุ่ม ยกเลิก"] U_ClickSave["กดปุ่ม บันทึก"] end subgraph Lane_System ["⚙️ ฝั่งระบบงาน (ระบบตรวจสอบและคำนวณ)"] S_CheckDateType{"ตรวจสอบประเภทของวันที่เลือก"} S_ModeSunday["เข้าสู่โหมดดูอย่างเดียว
(ซ่อนส่วนกรอก 5 สัปดาห์ และซ่อนปุ่มบันทึก)"] S_ModeHistory["เข้าสู่โหมดดูอย่างเดียว
(ข้อมูลย้อนหลัง ไม่อนุญาตให้แก้ไข)"] S_DisableFuture["ปิดการเลือกวันในอนาคตบนปฏิทิน"] S_LoadCurrent["โหลดตารางแผน 5 สัปดาห์
(เริ่มต้นวันจันทร์ของรอบสัปดาห์ปัจจุบัน)"] S_CheckPlantPermission{"ตรวจสอบสิทธิ์การดูแลโรงงาน"} S_LockOtherPlant["กำหนดโรงงานอื่นเป็นโหมดดูอย่างเดียว"] S_Calculate["คำนวณยอดโปรแกรมขนสะสม และ O/H อัตโนมัติแยกตามสัปดาห์"] S_RevertData["คืนค่าข้อมูลในตารางกลับเป็นค่าก่อนแก้ไข"] S_Validate{"ตรวจสอบความถูกต้อง (เป็นจำนวนเต็ม)"} S_SaveSuccess["บันทึกข้อมูลลงระบบสำเร็จ และเปิดให้แก้ไขต่อได้"] S_End(["สิ้นสุดกระบวนการ"]) end U_Start --> U_SelectDate U_SelectDate --> S_CheckDateType S_CheckDateType -->|"เลือกวันอาทิตย์"| S_ModeSunday S_ModeSunday --> S_End S_CheckDateType -->|"เลือกวันย้อนหลัง (อดีต)"| S_ModeHistory S_ModeHistory --> S_End S_CheckDateType -->|"วันในอนาคต"| S_DisableFuture S_DisableFuture --> U_SelectDate S_CheckDateType -->|"วันปัจจุบัน (จันทร์-เสาร์)"| S_LoadCurrent S_LoadCurrent --> S_CheckPlantPermission S_CheckPlantPermission -->|"โรงงานที่ไม่ได้ดูแล"| S_LockOtherPlant S_LockOtherPlant --> S_End S_CheckPlantPermission -->|"โรงงานที่ตนเองดูแล"| U_InputProg U_InputProg --> S_Calculate S_Calculate --> U_Action U_Action -->|"ยกเลิกการแก้ไข"| U_ClickCancel U_ClickCancel --> S_RevertData S_RevertData --> S_End U_Action -->|"ต้องการบันทึก"| U_ClickSave U_ClickSave --> S_Validate S_Validate -->|"ข้อมูลถูกต้อง"| S_SaveSuccess S_SaveSuccess --> S_End

flowchart TD %% ========================================== %% Activity Diagram / BPMN: แผนรายคู่ค้า %% ========================================== subgraph Lane_User ["👤 ฝั่งผู้ใช้งาน (Local Trader)"] U_Start(["เริ่มต้นเข้าใช้งาน"]) U_OpenTab["เปิดแท็บ แผนรายคู่ค้า"] U_SelectFilter["เลือกตัวกรอง คู่ค้า และ สัปดาห์โปรแกรมขน"] U_InputData["กรอกหรือแก้ไขข้อมูล รอเปิด, โอน และแผนรายวันของคู่ค้า"] U_Action{"เลือกทำรายการ"} U_HoverClick["ชี้เมาส์หรือคลิกที่เซลล์ตัวเลข"] U_Save["กดปุ่ม บันทึก"] U_Nav["กดรีเฟรช หรือออกจากหน้า ขณะมีข้อมูลค้างบันทึก"] U_ConfirmStay["เลือก อยู่ต่อ"] U_ConfirmLeave["เลือก ออกจากหน้า"] end subgraph Lane_System ["⚙️ ฝั่งระบบงาน (ระบบคำนวณและประมวลผล)"] S_LoadData["โหลดข้อมูลและกรองตามเงื่อนไขที่เลือก"] S_CheckVendor{"ตรวจสอบข้อมูลคู่ค้าของโรงงาน"} S_ShowEmpty["แสดงข้อความแจ้งเตือน ไม่พบข้อมูล"] S_RenderTable["แสดงแถวคู่ค้าเรียงลำดับ ก-ฮ พร้อมยอดค้างรับแบบอ่านอย่างเดียว"] S_Calculate["คำนวณยอดรวมตั้งต้น, รวมคู่ค้า, ผลต่างรายวัน และคงเหลือสะสม"] S_ShowTooltip["แสดงกล่องข้อความอธิบายหัวคอลัมน์ และฐานการคำนวณแบบเต็ม"] S_Validate{"ตรวจสอบความถูกต้อง (เป็นจำนวนเต็ม)"} S_SaveSuccess["บันทึกข้อมูลสำเร็จ และอัปเดตสถานะล่าสุด"] S_ShowModal["แสดงหน้าต่างยืนยันการออกจากหน้า"] S_KeepData["คงข้อมูลที่ผู้ใช้แก้ไขไว้"] S_DiscardData["ละทิ้งข้อมูลที่แก้ไข และสลับหน้าจอ"] S_End(["สิ้นสุดกระบวนการ"]) end U_Start --> U_OpenTab U_OpenTab --> U_SelectFilter U_SelectFilter --> S_LoadData S_LoadData --> S_CheckVendor S_CheckVendor -->|"ไม่พบข้อมูลคู่ค้า"| S_ShowEmpty S_ShowEmpty --> S_End S_CheckVendor -->|"พบข้อมูลคู่ค้า"| S_RenderTable S_RenderTable --> U_InputData U_InputData --> S_Calculate S_Calculate --> U_Action U_Action -->|"ตรวจสอบรายละเอียด"| U_HoverClick U_HoverClick --> S_ShowTooltip S_ShowTooltip --> U_InputData U_Action -->|"ยืนยันข้อมูล"| U_Save U_Save --> S_Validate S_Validate -->|"ข้อมูลถูกต้อง"| S_SaveSuccess S_SaveSuccess --> S_End U_Action -->|"เปลี่ยนเส้นทาง/รีเฟรช"| U_Nav U_Nav --> S_ShowModal S_ShowModal --> U_ConfirmStay S_ShowModal --> U_ConfirmLeave U_ConfirmStay --> S_KeepData S_KeepData --> U_InputData U_ConfirmLeave --> S_DiscardData S_DiscardData --> S_End

flowchart TD %% ========================================== %% Activity Diagram / BPMN: ส่งออกไฟล์ Excel %% ========================================== subgraph Lane_User ["👤 ฝั่งผู้ใช้งาน (Local Trader)"] U_Start(["เริ่มต้น: เข้าสู่หน้าจอและเลือกตัวกรอง"]) U_SelectFilter["เลือกวัตถุดิบ, วันที่ทำแผน, คู่ค้า และสัปดาห์"] U_ClickExport["กดปุ่ม ส่งออกไฟล์ (Export File)"] U_DownloadFile["ดาวน์โหลดไฟล์ Excel เข้าเครื่องคอมพิวเตอร์"] end subgraph Lane_System ["⚙️ ฝั่งระบบงาน (ตรวจสอบสิทธิ์และสร้างไฟล์รายงาน)"] S_CheckPerm{"ตรวจสอบสิทธิ์การส่งออกรายงาน"} S_DenyAction["ไม่อนุญาตการทำงาน และไม่สร้างไฟล์"] S_CheckUnsaved{"มีข้อมูลที่แก้ไขค้างไว้และยังไม่บันทึกหรือไม่?"} S_ShowModalWarn["แสดงหน้าต่างแจ้งเตือนให้บันทึกข้อมูลก่อนส่งออก"] S_GenerateExcel["ประมวลผลสร้างไฟล์ Excel ตามเงื่อนไขและตัวกรอง"] S_CheckGenResult{"สร้างไฟล์สำเร็จหรือไม่?"} S_ShowError["แสดงข้อผิดพลาดตามเงื่อนไข และรองรับการลองใหม่"] S_ServeFile["ส่งไฟล์ ชื่อวัตถุดิบ_วันเดือนปี.xlsx ที่มีชีทภาพรวมและแผนคู่ค้า"] S_End(["สิ้นสุดกระบวนการ"]) end U_Start --> U_SelectFilter U_SelectFilter --> U_ClickExport U_ClickExport --> S_CheckPerm S_CheckPerm -->|"ไม่มีสิทธิ์"| S_DenyAction S_DenyAction --> S_End S_CheckPerm -->|"มีสิทธิ์ถูกต้อง"| S_CheckUnsaved S_CheckUnsaved -->|"มีข้อมูลค้างบันทึก"| S_ShowModalWarn S_ShowModalWarn --> S_DenyAction S_CheckUnsaved -->|"ไม่มีข้อมูลค้าง (บันทึกแล้ว)"| S_GenerateExcel S_GenerateExcel --> S_CheckGenResult S_CheckGenResult -->|"ไม่สำเร็จ"| S_ShowError S_ShowError --> S_End S_CheckGenResult -->|"สำเร็จ"| S_ServeFile S_ServeFile --> U_DownloadFile U_DownloadFile --> S_End

flowchart TD %% กำหนด Swimlanes สองฝั่งชัดเจน subgraph UserLane ["👤 ฝั่งผู้ใช้งาน (Local Trader / Approver / Support)"] A1["เริ่มต้น: เปิดเข้าระบบเมนู Local Price Ticket"] A2["เลือกตัวกรองประเทศ หรือกดเลือกแท็บสถานะคำขอ"] A3["คลิกเลือกแถว Ticket ในตารางเพื่อเปิดดูรายละเอียด"] A4{"บทบาทและสิทธิ์ของผู้ใช้?"} A5["Trader ที่เป็นเจ้าของใบ: เห็นปุ่ม แก้ไข / ยกเลิก / ส่งคำขอ"] A6["Trader อื่น หรือ Support: ดูข้อมูลแบบอ่านอย่างเดียว ไร้ปุ่มแก้ไข"] A7["คลิกดูแท็บความคิดเห็น Approver และกดไอคอนอ่านเหตุผล"] end subgraph SystemLane ["⚙️ ฝั่งระบบงาน (Local Price Portal & Security Gate)"] B1["ระบบตรวจสิทธิ์ Country Permission และ Role ประจำตัว"] B2["กรองและแสดงเฉพาะ Ticket ในประเทศที่ผู้ใช้มีสิทธิ์"] B3["โหลดข้อมูลรายละเอียดคำขอและตารางเปรียบเทียบราคาโรงงาน"] B4{"ผู้ใช้พยายามเข้าผ่าน Deep Link โดยไม่มีสิทธิ์?"} B5["ปฏิเสธการเข้าถึง แสดงหน้า 404/403 ไม่เปิดเผยข้อมูล Ticket"] B6["แสดงผล Dialog ความคิดเห็นของ Approver แบบ Read-only รายโรงงาน"] end %% เส้นทางเชื่อมต่อข้ามแดน A1 --> B1 B1 --> B2 B2 --> A2 A2 --> A3 A3 --> B3 B3 --> A4 A4 -->|เป็นเจ้าของและใบยังเปิด| A5 A4 -->|ไม่ใช่เจ้าของหรือสิทธิ์อ่าน| A6 A6 --> A7 A5 --> A7 A7 --> B6 %% เส้นทางความปลอดภัย Deep Link A1 -.->|พิมพ์ URL ตรงข้ามประเทศ| B4 B4 -->|ไม่มีสิทธิ์ในประเทศนั้น| B5

1. บทนำและเป้าหมายสูงสุด (Mission & Principle)

จุดมุ่งหมายหลักในการสร้างซอฟต์แวร์คุณภาพสูงประจำแพลตฟอร์ม Kepler

เป้าหมายสูงสุด (North Star Goal): "Zero Silent Defect" — ทุกระบบงานต้องทำงานได้อย่างถูกต้อง แม่นยำ และไร้ข้อบกพร่องตกค้าง 100% ก่อนส่งมอบสู่มือผู้ใช้งานจริง

การทดสอบที่มีประสิทธิภาพไม่ได้เริ่มต้นที่การเขียนโค้ด แต่เริ่มต้นที่ความเข้าใจในภาพรวมของระบบงานอย่างแท้จริง คู่มือฉบับนี้ถูกจัดทำขึ้นเพื่อให้ทุกคนในทีม (ไม่ว่าจะเป็นผู้บริหาร, ผู้จัดการโครงการ, วิศวกรซอฟต์แวร์ หรือผู้ตรวจสอบระบบ) มีความเข้าใจร่วมกันในมาตรฐานการวิเคราะห์ความต้องการ การออกแบบชุดทดสอบ และการตรวจรับรองคุณภาพระดับสากล

1. มองภาพรวมของงานก่อน

ทำความเข้าใจความสัมพันธ์ของงานทั้งหมดในรอบพัฒนาก่อนเริ่มเขียนชุดทดสอบ

2. ยึดลำดับขั้นตอนจริง

จัดลำดับการทำงานตามขั้นตอนความเป็นจริงของธุรกิจ ไม่เรียงตามรหัสการ์ดงาน

3. ยืนยันกับข้อมูลต้นทาง

ตัวเลขทุกตัวบนหน้าจอต้องตรวจสอบเทียบกับระบบต้นทางเสมอว่าถูกต้องตรงกัน

2. การมองภาพรวมของระบบงานทั้งหมด (Big Picture Overview)

ทำความเข้าใจความสัมพันธ์ของระบบงานให้ครบถ้วนก่อนลงมือปฏิบัติ

ปัญหาที่พบบ่อยในการพัฒนาซอฟต์แวร์คือการอ่านและออกแบบชุดทดสอบแยกตามการ์ด User Story ทีละใบ เมื่อนำฟังก์ชันแต่ละส่วนมารวมกันในระบบจริง มักพบข้อผิดพลาดที่รอยต่อระหว่างระบบ หรือเกิดลำดับการคำนวณที่ผิดพลาด

การทำงานแบบแยกส่วนเดิม (Silo Thinking)

อ่านการ์ดงาน User Story แยกทีละใบโดยไม่ดูความเชื่อมโยง
ออกแบบการทดสอบเฉพาะหน้าจอของตนเอง
เรียงลำดับการรันตามตัวเลขรหัส (เช่น Story 1 → 2 → 3)
ไม่ตรวจสอบว่าตัวเลขในหน้าจอมาจากระบบใดก่อนหน้า
เกิดข้อผิดพลาดเมื่อนำแต่ละหน้าจอมาต่อกันในการทำงานจริง

มาตรฐานกลางของ Kepler (Holistic Analysis)

อ่านทำความเข้าใจความต้องการทั้งหมดในรอบพัฒนานั้นพร้อมกัน
จัดกลุ่มงานที่มีความเกี่ยวข้องกันทางธุรกิจ
หาจุดเริ่มต้นของข้อมูล (Source Data) ให้พบก่อนเสมอ
จัดลำดับขั้นตอนการทดสอบตามการไหลของข้อมูลจริง
ร้อยเรียงชุดทดสอบให้ทำงานต่อเนื่องกันตั้งแต่ต้นทางถึงปลายทาง

3. ลำดับขั้นตอนการทำงานจริงของระบบ (End-to-End Workflow)

มาตรฐานการจัดลำดับการทำงานและการร้อยเรียงชุดทดสอบตามความเป็นจริงของธุรกิจ

กฎสำคัญ: ห้ามเรียงลำดับงานตามตัวเลขรหัส หรือลำดับการสร้างการ์ด User Story โดยเด็ดขาด เพราะผู้สร้างการ์ดอาจสร้างการ์ดหน้าจอปลายทางขึ้นมาก่อน แต่ในทางปฏิบัติ ข้อมูลจะต้องไหลตาม 5 ขั้นตอนนี้เสมอ:

ขั้นตอนที่ 1: กำหนดเงื่อนไขและตัวกรองขอบเขตงาน (Context & Selection Gate)

ผู้ใช้เลือกขอบเขตข้อมูลที่ต้องการทำงาน เช่น สาขา, ชนิดสินค้า, และรอบวันที่ต้องการ เพื่อให้ระบบเตรียมชุดข้อมูลที่ถูกต้อง

ขั้นตอนที่ 2: นำเข้าข้อมูลต้นทางและประมวลผลคำนวณแกนกลาง (Source Ingestion & Core Calculation)

ระบบดึงข้อมูลตั้งต้นจากระบบหลัก (เช่น ยอดสินค้าคงเหลือ และยอดสั่งซื้อที่ค้างรับ) มาเป็นฐานในการคำนวณความต้องการใช้จริง

ขั้นตอนที่ 3: จัดสรรสัดส่วนตามเงื่อนไขหรือโควตา (Allocation & Optimization)

นำยอดความต้องการรวมมาประมวลผลจัดสรรตามสัดส่วนหรือโควตาของแต่ละกลุ่ม พร้อมตรวจสอบแนวโน้มความเพียงพอของสินค้า

ขั้นตอนที่ 4: กระจายยอดการส่งมอบสู่ผู้ปฏิบัติการรายย่อย (Operational Distribution)

แตกย่อยยอดจัดสรรลงสู่คู่ค้าหรือผู้จัดจำหน่ายแต่ละราย พร้อมตรวจสอบกฎความคงที่: ผลรวมของคู่ค้าทุกรายต้องเท่ากับยอดรวมของสาขา 100%

ขั้นตอนที่ 5: สรุปภาพรวม ตรวจสอบความถูกต้อง และส่งมอบปลายทาง (Rollup & Delivery)

รวบรวมแนวโน้มภาพรวม ตรวจสอบตัวเลขขั้นสุดท้าย และส่งออกเป็นไฟล์รายงานเพื่อส่งต่อให้ผู้เกี่ยวข้องนำไปปฏิบัติงานจริง

4. การตรวจสอบเทียบกับแหล่งข้อมูลต้นทาง (Single Source of Truth)

หลักการตรวจสอบข้อมูลสองทาง (Dual-Source) และกฎความคงที่ของผลรวมข้อมูล

ในการทดสอบระบบงานคำนวณ เราจะตรวจสอบเฉพาะตัวเลขที่แสดงบนหน้าจอปลายทางไม่ได้ เพราะหากข้อมูลที่ระบบดึงเข้ามาตั้งแต่แรกผิดพลาด ผลลัพธ์ที่คำนวณได้ก็จะผิดพลาดตามไปด้วย

หลักการตรวจสอบข้อมูลสองทาง (Dual-Source Verification):

แหล่งที่มา 1: ระบบต้นทาง (Source Data)

ข้อมูลจากฐานข้อมูลหลัก / รายงานต้นทาง

ยอดสินค้าคงเหลือจริง + ยอดค้างรับสุทธิ

แหล่งที่มา 2: หน้าจอระบบงาน (Display Data)

ตัวเลขที่แสดงบนหน้าจอการทำงาน

ยอดที่นำมาแสดงและใช้เป็นฐานคำนวณต่อ

เกณฑ์การตรวจสอบ: ค่าตัวเลขตั้งต้นจากระบบต้นทาง จะต้องตรงกับค่าบนหน้าจอแบบ 1:1 ปราศจากการปัดเศษหรือการเปลี่ยนแปลงโดยไม่ได้รับอนุญาต

กฎความคงที่ของผลรวมข้อมูล (Volume Conservation):

ผลรวมของส่วนย่อยทุกรายการรวมกัน จะต้องเท่ากับยอดรวมของส่วนใหญ่เสมอ 100%:

ผลต่าง = ยอดรวมหลัก − ผลรวมของยอดคู่ค้าทุกราย (ต้องได้ 0 พอดีเสมอ)

5. มาตรฐานตารางเคสทดสอบ 11 คอลัมน์ (The 11-Column Standard)

โครงสร้างคอลัมน์มาตรฐานที่เป็น Single Source of Truth (SSOT) ตรงกันทุกระบบ

มาตรฐานชื่อคอลัมน์: กำหนดให้ใช้คำว่า "Test Type" เป็นมาตรฐานเดียวตรงกัน 100% ทั้งในเอกสาร ตาราง Google Sheets แดชบอร์ด และชุดคำสั่งทดสอบ

ลำดับ	ชื่อคอลัมน์มาตรฐาน	ชนิดข้อมูล	คำอธิบายและแนวทางการใช้งาน
1	Work Item	`String`	รหัสเฉพาะของเคสทดสอบ (เช่น `101_01`) หากเป็นเคสสำคัญสำหรับการสาธิต ให้ระบุ `MUST DEMO`
2	Title 2	`Text`	ชื่อสถานการณ์การทดสอบ ภาษาที่กระชับและสื่อพฤติกรรมของระบบชัดเจน
3	Brief description	`Text`	คำอธิบายสรุปสั้นๆ เกี่ยวกับเป้าหมายของการทดสอบข้อนี้
4	Pre_conditions	`Text`	เงื่อนไขก่อนเริ่มทดสอบ เช่น สิทธิ์ของผู้ใช้ หรือสถานะของข้อมูลตั้งต้น
5	Test Steps with Test Data	`List`	ขั้นตอนการทดสอบอย่างละเอียด พร้อมข้อมูลที่ต้องกรอก เรียงเป็นข้อๆ 1, 2, 3
6	Expected test result	`Text`	ผลลัพธ์ที่คาดหวัง ระบุสูตรคำนวณและตัวเลขผลลัพธ์ที่ถูกต้อง
7	Priority Level	`Badge`	ระดับความสำคัญ: `Critical`, `High`, `Medium`, `Low`
8	Test Type	`Category`	ประเภทของการทดสอบ: `Functional`, `E2E`, `Regression`, `Non-Functional`
9	Automation test status	`Status`	สถานะการทำงานอัตโนมัติ: `Automated`, `Manual`, `Draft`
10	Cannot automate reason	`Text`	เหตุผลที่ยังไม่สามารถทำแบบอัตโนมัติได้ (ถ้ามี)
11	Requirement Mapping	`Link`	รหัสอ้างอิงของ User Story หรือหัวข้อความต้องการของระบบ

6. โครงสร้างชุดทดสอบอัตโนมัติ (Automation Architecture)

รูปแบบการแยกส่วนหน้าจอ (POM) และกลยุทธ์การนำทางที่ทนทานต่อการเปลี่ยนแปลง

การนำทางแบบสองระบบ (Hybrid Navigation)

ลำดับที่ 1 (Direct Path Priority): เข้าสู่หน้าจอโดยตรงผ่าน URL ที่กำหนดไว้ เพื่อความรวดเร็วและแม่นยำสูงสุด

ลำดับที่ 2 (Auto-Crawl Fallback): หาก URL เปลี่ยนแปลง ระบบจะค้นหาและคลิกผ่านเมนูจริงบนหน้าจออัตโนมัติ เพื่อให้การทดสอบทำงานต่อเนื่องได้ไม่หยุดชะงัก

การระบุตำแหน่งบนหน้าจอ (Locators)

อันดับ 1: อ้างอิงจากข้อความและปุ่มที่ผู้ใช้มองเห็นจริง (เช่น ชื่อปุ่ม, ป้ายกำกับ)

อันดับ 2: อ้างอิงจากรหัสข้อมูลเฉพาะ (เช่น data-testid)

ข้อควรระวัง: หลีกเลี่ยงการอ้างอิงตำแหน่งด้วยชื่อคลาสสีหรือรูปแบบความสวยงามที่อาจเปลี่ยนแปลงบ่อย

7. ด่านตรวจรับรองคุณภาพก่อนส่งมอบงาน (4 Quality Gates)

คำว่า "ทดสอบผ่านแล้ว" จะเกิดขึ้นได้ก็ต่อเมื่อผ่านการพิสูจน์จริงครบทั้ง 4 ด่าน

ด่านที่ 1 SYNTAX

ตรวจโครงสร้างโค้ด

ตรวจไวยากรณ์ด้วยเครื่องมืออัตโนมัติ ต้องไม่มีข้อผิดพลาดด้านตัวแปรหรือฟังก์ชันที่ไม่ถูกประกาศ

ด่านที่ 2 INTEGRITY

ตรวจจุดเชื่อมต่อระบบ

ตรวจสอบว่าไม่มีการเรียกใช้ไฟล์หรือฟังก์ชันที่ถูกลบหรือย้ายที่ไปแล้ว

ด่านที่ 3 AUTOMATION

ชุดทดสอบอัตโนมัติ

รันชุดทดสอบอัตโนมัติทั้งหมดและต้องได้ผลลัพธ์ผ่าน 100% ไร้ข้อผิดพลาดตกค้าง

ด่านที่ 4 LIVE EXECUTION

รันจริงเห็นผลลัพธ์จริง

รันคำสั่งหรือฟังก์ชันจริงให้เห็นผลลัพธ์ที่ประจักษ์ชัด ไม่ใช่เพียงการคาดเดา

8. คำอธิบายศัพท์ทางเทคนิค (Glossary of Technical Terms)

คำอธิบายศัพท์เฉพาะเพื่อให้ทุกคนในทีมเข้าใจตรงกัน

Ruff AST: เครื่องมือตรวจสอบความถูกต้องของไวยากรณ์และโครงสร้างโค้ดโปรแกรมภาษา Python แบบอัตโนมัติด้วยความเร็วสูง

Undefined Names: ข้อผิดพลาดที่เกิดขึ้นเมื่อโค้ดพยายามเรียกใช้งานชื่อตัวแปรหรือฟังก์ชันที่ยังไม่ได้ประกาศในระบบ

UnboundLocalErrors: ข้อผิดพลาดที่เกิดขึ้นเมื่อโค้ดพยายามอ่านหรือนำตัวแปรไปใช้งาน ก่อนที่จะมีการกำหนดค่าเริ่มต้นให้กับตัวแปรนั้น

Page Object Model (POM): รูปแบบการออกแบบโค้ดทดสอบที่แยกข้อมูลหน้าจอออกจากขั้นตอนการทดสอบ เพื่อให้ง่ายต่อการดูแลรักษาเมื่อหน้าตาของเว็บมีการเปลี่ยนแปลง

Single Source of Truth (SSOT): หลักการกำหนดให้มีแหล่งข้อมูลหลักที่ถูกต้องเพียงแห่งเดียว เพื่อป้องกันไม่ให้ระบบอื่นๆ นำข้อมูลที่ขัดแย้งกันไปใช้งาน

Volume Conservation / Data Invariant: กฎความคงที่ของข้อมูล เช่น ผลรวมย่อยของคู่ค้าทุกรายรวมกัน จะต้องเท่ากับยอดรวมของโรงงานเสมอพอดี 100%

คู่สัญญาข้อมูลและสูตรคำนวณทางธุรกิจ: MORNING vs Routine Plan

เอกสารกำหนดมาตรฐานการเชื่อมโยงข้อมูลจากระบบต้นทาง สู่การประมวลผลและการจัดสรรวัตถุดิบรายสัปดาห์ เพื่อให้ทุกฝ่ายเข้าใจและตรวจสอบความถูกต้องได้อย่างโปร่งใส

ลำดับ	ฟิลด์ต้นทาง (Morning / Contract)	ฟิลด์บนหน้าจอ Routine Plan	ตำแหน่งบนหน้าจอ	ชนิดข้อมูล	เงื่อนไขทางธุรกิจ
1	Beginning Stock / Ending Balance	สินค้าคงเหลือ ณ เช้าวันนี้	Summary Bar & Detail Row	ทศนิยม 2 ตำแหน่ง	อ่านอย่างเดียว ดึงยอดคงเหลือยกมาล่าสุด ณ เช้าวันทำแผน
2	Pending Deliveries (PO Net)	ค้างรับ (Contract Report)	Summary Bar & Detail Row	จำนวนเต็ม	อ่านอย่างเดียว อิงตามรอบ Contract Report ณ เวลา 08:00 น.
3	Current Usage Rate	การใช้ปัจจุบัน	Detail Row (ใช้คำนวณ)	ทศนิยม 2 ตำแหน่ง	อัตราการใช้วัตถุดิบจริงปัจจุบันของแต่ละโรงงาน
4	Working Days (Config)	วันทำงาน	Detail Row (กรอกข้อมูล)	จำนวนเต็ม (1-7)	ผู้ใช้กรอกได้ (Default: 6) ห้ามเป็น 0, ติดลบ หรือทศนิยม
5	Storage Capacity	พื้นที่จัดเก็บ / Confirm Area	Detail Row (อ่านอย่างเดียว)	จำนวนเต็ม	ขีดความสามารถในการจัดเก็บวัตถุดิบของโรงงาน
6	Purchasing Target Days	เป้าซื้อ (วัน)	Detail Row (กรอกข้อมูล)	จำนวนเต็ม (Default: 15)	จำนวนวันที่ต้องการสำรองสต็อกคงคลังเป้าหมาย

ลำดับ

ฟิลด์ต้นทาง (Morning / Contract)

ฟิลด์บนหน้าจอ Routine Plan

ตำแหน่งบนหน้าจอ

ชนิดข้อมูล

เงื่อนไขทางธุรกิจ

Beginning Stock / Ending Balance

สินค้าคงเหลือ ณ เช้าวันนี้

Summary Bar & Detail Row

ทศนิยม 2 ตำแหน่ง

อ่านอย่างเดียว ดึงยอดคงเหลือยกมาล่าสุด ณ เช้าวันทำแผน

Pending Deliveries (PO Net)

ค้างรับ (Contract Report)

Summary Bar & Detail Row

จำนวนเต็ม

อ่านอย่างเดียว อิงตามรอบ Contract Report ณ เวลา 08:00 น.

Current Usage Rate

การใช้ปัจจุบัน

Detail Row (ใช้คำนวณ)

ทศนิยม 2 ตำแหน่ง

อัตราการใช้วัตถุดิบจริงปัจจุบันของแต่ละโรงงาน

Working Days (Config)

วันทำงาน

Detail Row (กรอกข้อมูล)

จำนวนเต็ม (1-7)

ผู้ใช้กรอกได้ (Default: 6) ห้ามเป็น 0, ติดลบ หรือทศนิยม

Storage Capacity

พื้นที่จัดเก็บ / Confirm Area

Detail Row (อ่านอย่างเดียว)

จำนวนเต็ม

ขีดความสามารถในการจัดเก็บวัตถุดิบของโรงงาน

Purchasing Target Days

เป้าซื้อ (วัน)

Detail Row (กรอกข้อมูล)

จำนวนเต็ม (Default: 15)

จำนวนวันที่ต้องการสำรองสต็อกคงคลังเป้าหมาย

PBI Process Flow & Specification Repository

ภาพรวมลำดับการทำงานจริงของระบบ (5 Stages Workflow Progression)

PBI 379873: 4.Routine— การเก็บข้อมูลที่ผู้ใช้กรอกและโปรแกรมขน พร้อม Snapshot และล้างข้อมูลรายวัน

PBI 379273: 1.Routine— ภาพรวม และการคำนวณ

PBI 379751: 2.Routine —ภาพรวม แผนการขนส่ง 5 สัปดาห์

PBI 379899: 3.Routine— แผนรายคู่ค้า

PBI 378167: 5.Routine— Export File Excel

PBI #385662: [Local Price Ticket] PBI-17 Trader หน้ารายการและรายละเอียดคำขอ

1. บทนำและเป้าหมายสูงสุด (Mission & Principle)

2. การมองภาพรวมของระบบงานทั้งหมด (Big Picture Overview)

3. ลำดับขั้นตอนการทำงานจริงของระบบ (End-to-End Workflow)

ขั้นตอนที่ 1: กำหนดเงื่อนไขและตัวกรองขอบเขตงาน (Context & Selection Gate)

ขั้นตอนที่ 2: นำเข้าข้อมูลต้นทางและประมวลผลคำนวณแกนกลาง (Source Ingestion & Core Calculation)

ขั้นตอนที่ 3: จัดสรรสัดส่วนตามเงื่อนไขหรือโควตา (Allocation & Optimization)

ขั้นตอนที่ 4: กระจายยอดการส่งมอบสู่ผู้ปฏิบัติการรายย่อย (Operational Distribution)

ขั้นตอนที่ 5: สรุปภาพรวม ตรวจสอบความถูกต้อง และส่งมอบปลายทาง (Rollup & Delivery)

4. การตรวจสอบเทียบกับแหล่งข้อมูลต้นทาง (Single Source of Truth)

5. มาตรฐานตารางเคสทดสอบ 11 คอลัมน์ (The 11-Column Standard)

6. โครงสร้างชุดทดสอบอัตโนมัติ (Automation Architecture)

7. ด่านตรวจรับรองคุณภาพก่อนส่งมอบงาน (4 Quality Gates)

8. คำอธิบายศัพท์ทางเทคนิค (Glossary of Technical Terms)

1. สถาปัตยกรรมข้อมูลและการส่งต่อ (Architectural Data Pipeline)

2. ตารางการจับคู่ฟิลด์ข้อมูล (Upstream to Downstream Field Mapping Matrix)

3. สูตรคำนวณแกนกลางใน Tab ภาพรวม (PBI #379273)

1. การใช้ต่อวัน (Daily Usage Rate)

2. รวมค้างรับ (Total Pending)

3. รวมยอดตั้งต้น (Initial Balance)

4. On-Hand Days (O/H)

5. Position (สถานะสต็อกสุทธิ)

4. การคำนวณแผนการขนส่งและจัดสรร 5 สัปดาห์ (PBI #379751)

โปรแกรมขนสะสม (Cumulative Logistics)

O/H รายสัปดาห์ (Multi-Week On-Hand)

5. การกระจายยอดคู่ค้าและกฎความคงที่ของข้อมูล (PBI #379899)

กฎความคงที่ของข้อมูล (Volume Invariant Rule & ผลต่างรายวัน)

ยอดคงเหลือสะสมระดับคู่ค้า (Week 1)

ยอดคงเหลือสะสมระดับคู่ค้า (Week N)

6. กฎการตรวจสอบความถูกต้องก่อนส่งมอบ (Data Validation Gate)

PBI Process Flow & Specification Repository

ภาพรวมลำดับการทำงานจริงของระบบ (5 Stages Workflow Progression)

PBI 379873: 4.Routine— การเก็บข้อมูลที่ผู้ใช้กรอกและโปรแกรมขน พร้อม Snapshot และล้างข้อมูลรายวัน

PBI 379273: 1.Routine— ภาพรวม และการคำนวณ

PBI 379751: 2.Routine —ภาพรวม แผนการขนส่ง 5 สัปดาห์

PBI 379899: 3.Routine— แผนรายคู่ค้า

PBI 378167: 5.Routine— Export File Excel

PBI #385662: [Local Price Ticket] PBI-17 Trader หน้ารายการและรายละเอียดคำขอ

Process Diagram View

Kepler Universal Quality Handbook

Kepler Universal Quality Handbook

1. บทนำและเป้าหมายสูงสุด (Mission & Principle)

2. การมองภาพรวมของระบบงานทั้งหมด (Big Picture Overview)

3. ลำดับขั้นตอนการทำงานจริงของระบบ (End-to-End Workflow)

ขั้นตอนที่ 1: กำหนดเงื่อนไขและตัวกรองขอบเขตงาน (Context & Selection Gate)

ขั้นตอนที่ 2: นำเข้าข้อมูลต้นทางและประมวลผลคำนวณแกนกลาง (Source Ingestion & Core Calculation)

ขั้นตอนที่ 3: จัดสรรสัดส่วนตามเงื่อนไขหรือโควตา (Allocation & Optimization)

ขั้นตอนที่ 4: กระจายยอดการส่งมอบสู่ผู้ปฏิบัติการรายย่อย (Operational Distribution)

ขั้นตอนที่ 5: สรุปภาพรวม ตรวจสอบความถูกต้อง และส่งมอบปลายทาง (Rollup & Delivery)

4. การตรวจสอบเทียบกับแหล่งข้อมูลต้นทาง (Single Source of Truth)

5. มาตรฐานตารางเคสทดสอบ 11 คอลัมน์ (The 11-Column Standard)

6. โครงสร้างชุดทดสอบอัตโนมัติ (Automation Architecture)

7. ด่านตรวจรับรองคุณภาพก่อนส่งมอบงาน (4 Quality Gates)

8. คำอธิบายศัพท์ทางเทคนิค (Glossary of Technical Terms)

Data Contract & Calculation Formula Matrix

คู่สัญญาข้อมูลและสูตรคำนวณทางธุรกิจ: MORNING vs Routine Plan

1. สถาปัตยกรรมข้อมูลและการส่งต่อ (Architectural Data Pipeline)

2. ตารางการจับคู่ฟิลด์ข้อมูล (Upstream to Downstream Field Mapping Matrix)

3. สูตรคำนวณแกนกลางใน Tab ภาพรวม (PBI #379273)

1. การใช้ต่อวัน (Daily Usage Rate)

2. รวมค้างรับ (Total Pending)

3. รวมยอดตั้งต้น (Initial Balance)

4. On-Hand Days (O/H)

5. Position (สถานะสต็อกสุทธิ)

4. การคำนวณแผนการขนส่งและจัดสรร 5 สัปดาห์ (PBI #379751)

โปรแกรมขนสะสม (Cumulative Logistics)

O/H รายสัปดาห์ (Multi-Week On-Hand)

5. การกระจายยอดคู่ค้าและกฎความคงที่ของข้อมูล (PBI #379899)

กฎความคงที่ของข้อมูล (Volume Invariant Rule & ผลต่างรายวัน)

ยอดคงเหลือสะสมระดับคู่ค้า (Week 1)

ยอดคงเหลือสะสมระดับคู่ค้า (Week N)

6. กฎการตรวจสอบความถูกต้องก่อนส่งมอบ (Data Validation Gate)