nok/wms-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(sdlc): reformat work products to audited reference layout

Browse Source 
Replace the PHP/Markdown seeding with a data-driven generator in
scripts/sdlc-seed and regenerate all 59 work products.
This commit is contained in:
Thanakorn
2026-09-09 08:09:54 +07:00
parent 758922f5c4
commit 087e7b3958
209 changed files with 8063 additions and 5762 deletions
Download Patch File Download Diff File Expand all files Collapse all files
sdlc/1-PM Process (10 Work Product)/2.Project Plan/2-Software Project Plan/200-WMS-26-001-00 Software Project Plan 25690213 V1.0 ApS.md
+283
View File
@@ -0,0 +1,283 @@
# Software Project Plan
<!-- footer: PP -->
| Document No | Software Project Plan | Release, Version, By: | 25690213 V1.0 ApS |
| Project Name | โครงการพัฒนาระบบบริหารจัดการคลังสินค้า (BRN WMS) บริษัท บี.อาร์.เอ็น เอ็นเตอร์ไพรส์ จำกัด |
| Project Code | 200-WMS-26-001-00 |
| Title | แผนการดำเนินโครงการ |
| Project Period | 5 มกราคม 2569 – 24 สิงหาคม 2569 | Project Duration | 232 วัน |
| Organizer | คุณอภิรัชช์ สุภัทรประทีป (Project Manager) , คุณนพพงษ์ เจริญสุข (System Analyst) |
| Recorder | คุณเยาวลักษณ์ บางชมภู (Document Control) |
## 1 Manufacture
บริษัท บี.อาร์.เอ็น เอ็นเตอร์ไพรส์ จำกัด เป็นบริษัทผู้ประกอบธุรกิจด้านเทคโนโลยีสารสนเทศ ซึ่งมีประสบการณ์ในการส่งมอบผลิตภัณฑ์และบริการด้านเทคโนโลยีให้แก่หน่วยงานภาครัฐและเอกชนอย่างต่อเนื่อง บริษัทประกอบธุรกิจหลัก 3 ด้าน ได้แก่
- พัฒนาซอฟต์แวร์ตามความต้องการของหน่วยงาน (Software Development)
- จำหน่ายผลิตภัณฑ์ซอฟต์แวร์สำเร็จรูป (Software Package) เช่น ระบบบริหารจัดการสินทรัพย์
- ให้บริการบำรุงรักษาระบบ (Service Maintenance: MA) ครอบคลุมโครงสร้างพื้นฐาน เครื่องแม่ข่าย และศูนย์ข้อมูล
## 2 Overview
เพื่อยกระดับการบริหารจัดการคลังสินค้าของบริษัทให้มีความถูกต้อง รวดเร็ว และตรวจสอบย้อนกลับได้ บริษัทมีความประสงค์จะพัฒนา ระบบบริหารจัดการคลังสินค้า (BRN WMS) ขึ้นใหม่ โดยมีวัตถุประสงค์เพื่อ
- รวมศูนย์ข้อมูลคลังสินค้า สินค้าคงคลัง และความเคลื่อนไหวของสินค้าไว้ในระบบเดียว
- เชื่อมโยงงานขาย งานจัดซื้อ งานการเงิน และการบันทึกบัญชีเข้ากับความเคลื่อนไหวของสินค้า
- ควบคุมสิทธิ์การเข้าถึงและแยกข้อมูลระหว่างบริษัทและคลังสินค้าอย่างชัดเจน
- ให้ผู้บริหารเห็นภาพรวมสถานะคลังสินค้าและสถานะทางการเงินได้ตามเวลาจริง
## 3 Goals and Scope
### 3.1 เป้าหมายของโครงการ
**เป้าหมายด้านองค์กร**
- ลดข้อผิดพลาดของยอดสินค้าคงคลังที่เกิดจากการบันทึกด้วยมือ
- เพิ่มความสามารถในการตรวจสอบย้อนกลับของสินค้าตาม Lot, Serial Number และวันหมดอายุ
- ทำให้ข้อมูลคลังสินค้าและข้อมูลบัญชีสอดคล้องกันโดยไม่ต้องบันทึกซ้ำ
**เป้าหมายด้านผู้ใช้งาน**
- ให้พนักงานคลังสินค้าบันทึกรายการรับเข้า จ่ายออก และโอนย้ายได้สะดวกจากอุปกรณ์หน้าคลัง
- ให้ฝ่ายขายและฝ่ายจัดซื้อจัดทำเอกสารและติดตามสถานะได้ในระบบเดียว
- ให้ฝ่ายบัญชีได้ข้อมูลรายการที่ผ่านการตรวจสอบแล้วโดยอัตโนมัติ
### 3.2 ขอบเขตของโครงการ (SOW)
| ลำดับ | ระบบ | ระบบย่อย |
| :---: | --- | --- |
| 1 | ระบบบริหารจัดการผู้ใช้งานและสิทธิ์ | ลงทะเบียนเจ้าของบริษัทและเชิญผู้ใช้งาน (Onboarding) / เข้าสู่ระบบและควบคุมสิทธิ์ตามบทบาท Owner / Admin / Staff / Viewer / กู้คืนรหัสผ่าน, OTP และควบคุม Session / ตั้งค่าบริษัท, SMTP, ผู้ใช้งาน และสิทธิ์การเข้าถึงแอปพลิเคชัน |
| 2 | ระบบข้อมูลหลัก (Master Data) | คลังสินค้า, พื้นที่จัดเก็บ, ช่องจัดเก็บ (Bin) / หมวดสินค้าและสินค้า / ประเภทผู้ติดต่อและผู้ติดต่อ (ลูกค้า/ผู้ขาย) / รองรับโครงสร้างคลังแบบชั้นเดียวและแบบหลายชั้น |
| 3 | ระบบควบคุมสินค้าคงคลัง (Inventory Control) | รับสินค้าเข้า (Stock-in) / จ่ายสินค้าออก (Stock-out) พร้อมตรวจสอบยอดคงเหลือ / โอนย้ายสินค้าระหว่างคลัง/ตำแหน่ง / ติดตาม Lot, Serial Number และวันหมดอายุ / พิมพ์บาร์โค้ดสินค้า/ตำแหน่ง และรองรับการสแกน / แนบไฟล์ประกอบรายการ |
| 4 | ระบบขาย (Sales) | ใบเสนอราคา (Quotation) / ใบสั่งขาย (Sales Order) / ใบแจ้งหนี้ (Invoice) / ใบรับคืน / ใบลดหนี้ (Return / Credit Note) |
| 5 | ระบบจัดซื้อ (Purchasing) | ใบขอซื้อ (Purchase Request) / ใบสั่งซื้อ (Purchase Order) / ใบแจ้งหนี้ซื้อ (Purchase Invoice) / ใบคืนสินค้าผู้ขาย (Supplier Return) |
| 6 | ระบบการเงิน (Finance) | ใบวางบิลรับ / ใบเสร็จรับเงิน / ใบวางบิลจ่าย / ใบสำคัญจ่าย |
| 7 | ระบบบัญชี (Accounting) | ผังบัญชี, แผนก, สูตรบัญชี / สมุดรายวันและบัญชีแยกประเภท (Journal / GL) / รายงานงบทดลอง, งบกำไรขาดทุน, งบดุล, ภาษีมูลค่าเพิ่ม |
| 8 | ระบบรายงานและแดชบอร์ด | แดชบอร์ดคลังสินค้าและบัญชี / รายงานสต๊อก, ความเคลื่อนไหว, ความจุคลัง, สินค้าใกล้หมด, สินค้าหมดอายุ, Lot / กรอง ดู พิมพ์ และส่งออกรายงาน |
| 9 | ระบบควบคุมเอกสาร | ออกเลขที่เอกสารอัตโนมัติตามลำดับที่กำหนด / ควบคุมสถานะและวงจรชีวิตของเอกสาร / บันทึกผู้สร้าง/ผู้แก้ไข/ประวัติรายการ |
| 10 | ระบบแจ้งเตือนและงานตามกำหนดเวลา | แจ้งเตือนแบบ Real-time ผ่าน Node.js / Socket.IO / งานสรุปยอดสต๊อก/GL และแจ้งเตือนสินค้าใกล้หมด, ใบแจ้งหนี้ค้างชำระ ตามกำหนดเวลา |
| 11 | ระบบติดตั้งและตั้งค่า | ติดตั้งแบบ Manual ผ่าน setup.php / ติดตั้งแบบ Container ผ่าน Docker Compose (php-apache, mariadb, node/pm2) / สร้างค่าตั้งค่าและความลับของระบบจาก .env โดยไม่เก็บใน Source Control |
### 3.3 สิ่งส่งมอบ (Work Products)
| รหัส | สิ่งส่งมอบ (Work Product) | รายละเอียด |
| --- | --- | --- |
| WP 1.0 | เอกสาร 200-WMS-26-001-00 Software Project Plan (พร้อม Work Schedule) | ส่งเอกสารจำนวน 1 ชุด |
| WP 2.0 | เอกสาร 200-WMS-26-001-00 Customer Requirements | ส่งเอกสารจำนวน 1 ชุด |
| WP 3.0 | เอกสาร 200-WMS-26-001-00 Software Requirements Specification | ส่งเอกสารจำนวน 1 ชุด |
| WP 4.0 | เอกสาร 200-WMS-26-001-00 Software Design | ส่งเอกสารจำนวน 1 ชุด |
| WP 5.0 | เอกสาร 200-WMS-26-001-00 Change Report | ส่งเอกสารจำนวน 3 ฉบับ (CH-001–CH-003) |
| WP 6.0 | เอกสาร 200-WMS-26-001-00 Test Case and Test Procedures | ส่งเอกสารจำนวน 1 ชุด |
| WP 7.0 | เอกสาร 200-WMS-26-001-00 Validation Results | ส่งเอกสารจำนวน 1 ชุด |
| WP 8.0 | เอกสาร 200-WMS-26-001-00 Software User Document | ส่งเอกสารจำนวน 1 ชุด |
| WP 9.0 | ระบบ BRN WMS ที่ผ่านการทดสอบพร้อมนำไปใช้งานจริง | ส่ง Source Code (Git baseline 6c39700) และติดตั้ง |
| WP 10.0 | เอกสาร 200-WMS-26-001-00 Product Operation Guide | ส่งเอกสารจำนวน 1 ชุด |
| WP 11.0 | เอกสาร 200-WMS-26-001-00 Maintenance Document | ส่งเอกสารจำนวน 1 ชุด |
### 3.4 Delivery Instruction
ในการส่งมอบตามสิ่งส่งมอบ (Work Product) เมื่อแล้วเสร็จและถึงกำหนดเวลา (Due Date) ผู้จัดการโครงการต้องจัดเตรียมเครื่องมือและสถานที่เพื่อให้ลูกค้าทำการทดสอบการยอมรับผู้ใช้ (Validation Result หรือ User Acceptance Test – UAT) โดยทดสอบตามข้อกำหนดในเอกสารความต้องการผู้ใช้ (Customer Requirements) ทีละข้อ และลงนามยืนยันเมื่อผ่านการทดสอบ
- **กรณีสิ่งส่งมอบไม่แล้วเสร็จตามกำหนด (Delay)** ผู้จัดการโครงการต้องนัดประชุมรายงานความคืบหน้าและอธิบายสาเหตุให้ลูกค้าทราบ พร้อมทั้งตกลงกำหนดวันส่งมอบใหม่อย่างเป็นทางการร่วมกัน
- **การปิดโครงการ (Project Closure)** เมื่อสิ่งส่งมอบทั้งหมดผ่านการตรวจรับและได้รับลายเซ็นอนุมัติจากลูกค้าครบทุกชุดแล้ว ผู้จัดการโครงการจัดประชุมปิดโครงการอย่างเป็นทางการ พร้อมจัดทำเอกสารสรุปผลการดำเนินงานเพื่อเก็บเป็นหลักฐาน
### 3.5 เกณฑ์คุณภาพ (Quality Criteria)
**ด้านคุณภาพของระบบ**
| ลำดับ | หัวข้อ | เกณฑ์คุณภาพ | วิธีประเมิน |
| :---: | --- | --- | --- |
| 1.1 | ความถูกต้องของฟังก์ชัน | ฟังก์ชันทั้งหมดทำงานตรงตาม Customer Requirements ครบ 100% | ทดสอบตาม Test Case และ UAT |
| 1.2 | ความถูกต้องของข้อมูลสต๊อกและบัญชี | ไม่พบยอดสต๊อกติดลบหรือรายการ GL ที่ไม่สมดุล | ทดสอบ Transaction และ Rollback (TC-UN08.002) |
| 1.3 | ความปลอดภัยของระบบ | ไม่พบข้อบกพร่องระดับวิกฤตด้านสิทธิ์และการแยกข้อมูล | ทดสอบสิทธิ์เชิงลบ (TC-UN12.001, TC-UN12.002) |
| 1.4 | ประสิทธิภาพการตอบสนอง | งานประจำวันตอบสนองภายในเวลาที่ใช้งานได้จริงบนสภาพแวดล้อมที่ตกลง | ทดสอบตามปริมาณข้อมูลตัวอย่าง (TC-UN09.001) |
| 1.5 | ความสามารถในการเข้าถึง | ใช้งานได้บน Desktop, Tablet และ Mobile (Responsive) | ทดสอบข้ามอุปกรณ์ |
**ด้านการดูแลหลังส่งมอบ**
| ลำดับ | หัวข้อ | เกณฑ์คุณภาพ | วิธีประเมิน |
| :---: | --- | --- | --- |
| 2.1 | การตอบสนองเหตุขัดข้อง | ตอบรับภายใน 4 ชั่วโมง และแก้ไขตามระดับความรุนแรงที่กำหนดใน SLA | บันทึกการให้บริการ |
| 2.2 | การสำรองข้อมูล | มีระบบสำรองข้อมูลอัตโนมัติรายวันและทดสอบกู้คืนได้จริง | Backup & Restore Test (TC-UN13.004) |
| 2.3 | การเฝ้าระวังระบบ | ตรวจสอบสถานะบริการทุก 5 นาที และแจ้งเตือนเมื่อล้มเหลว 2 ครั้งติดกัน | บันทึกการเฝ้าระวัง |
## 4 Software Development Life Cycle Methodology
โครงการเลือกใช้แนวทาง Incremental / Evolutionary ภายใต้ขั้นตอนหลักของ Waterfall เนื่องจาก
- ขอบเขตและสิ่งส่งมอบกำหนดชัดเจนตั้งแต่ต้นโครงการ จึงวางแผนและตรวจรับเป็นงวดได้
- ระบบมีหลายโมดูลที่ส่งมอบต่อเนื่องกัน จึงพัฒนาและทดสอบทีละส่วนเพื่อลดความเสี่ยง
- เอกสารครบถ้วนตามมาตรฐาน ISO/IEC 29110 ที่เน้น Work Products และ Traceability
- ตรวจสอบย้อนกลับ (Audit) และตรวจรับงานได้อย่างเป็นทางการ
| ขั้นตอน | แนวทางที่ใช้จริงในโครงการ |
| --- | --- |
| Requirements | เก็บความต้องการและตั้ง Baseline ก่อนเริ่มพัฒนา การเปลี่ยนแปลงภายหลังผ่าน Change Report (CH-001–CH-003) |
| Design | ออกแบบสถาปัตยกรรม โครงสร้างฐานข้อมูล และ Software Unit ก่อนพัฒนาแต่ละโมดูล |
| Implementation | พัฒนาเป็นโมดูลต่อเนื่องระหว่าง 19 ก.พ. – 29 พ.ค. 69 พร้อมทบทวนและแก้ไขระหว่างทาง |
| Verification | ตรวจสอบ Work Products 4 รอบ ควบคู่กับการพัฒนา และรอบสุดท้ายก่อนส่งมอบ |
| Validation | ทดสอบระบบและ UAT ระหว่าง 10–14 ส.ค. 69 บนสภาพแวดล้อมที่กำหนด |
| Closure | ตรวจรับ อบรม ปิดงานควบคุมปฏิบัติการ และปิดโครงการภายใน 24 ส.ค. 69 |
## 5 Organization
### 5.1 Role & Responsibility
| ลำดับ | บทบาท | ชื่อ-นามสกุล (ชื่อย่อ) | อีเมล | รายละเอียดหน้าที่ |
| :---: | --- | --- | --- | --- |
| 1 | Project Manager (ApS) | คุณอภิรัชช์ สุภัทรประทีป | apirach.s@brn.co.th | จัดทำ Project Charter และแผนโครงการ / วางแผน Timeline, Resource, Risk, Quality / จัดประชุมและติดตามความคืบหน้า / ควบคุมการเปลี่ยนแปลงและการปิดโครงการ |
| 2 | System Analyst (NoC) | คุณนพพงษ์ เจริญสุข | noppong.c@brn.co.th | เก็บและวิเคราะห์ความต้องการ / จัดทำ SRS และเอกสารออกแบบระบบ / ออกแบบฐานข้อมูลและความสัมพันธ์ของโมดูล / ตรวจสอบความสอดคล้องของงานพัฒนากับความต้องการ |
| 3 | Developer (ThS) | คุณธนกร สถิตวิทยากุล | thanakorn.s@brn.co.th | พัฒนาโมดูลและ API ตามการออกแบบ / จัดการฐานข้อมูลและประสิทธิภาพ / ดูแลความปลอดภัยและการติดตั้ง / แก้ไขข้อบกพร่องที่พบจากการทดสอบ |
| 4 | QA / Tester (PaNg) | คุณปริญ งามขำ | parin.n@brn.co.th | จัดทำ Test Case และ Test Procedures / ทดสอบระบบและบันทึกผล / ติดตามการแก้ไขข้อบกพร่องและทดสอบซ้ำ / สนับสนุนผู้ใช้งานช่วง UAT |
| 5 | Document Control (YaB) | คุณเยาวลักษณ์ บางชมภู | yaowalak.b@brn.co.th | ควบคุมรหัสเอกสารและเวอร์ชัน / จัดเก็บและตรวจสอบความครบถ้วนของเอกสาร / ประสานการทบทวนและอนุมัติ / บันทึกประวัติการเปลี่ยนแปลงเอกสาร |
| 6 | Project Sponsor (SeV) | คุณเสรี วิริยะสกุลธรณ์ | seri.v@brn.co.th | อนุมัติขอบเขต งบประมาณ และการเปลี่ยนแปลง / ตัดสินใจเชิงกลยุทธ์ / ทดสอบการยอมรับและตรวจรับส่งมอบ / อนุมัติปิดโครงการ |
## 6 Project Estimate
### 6.1 Size of the Software Work Products
| ลำดับ | Work Product | ปริมาณ (ประมาณการ) |
| :---: | --- | --- |
| 1 | เอกสารบริหารโครงการ (PM Process) | 10 รายการ |
| 2 | เอกสารกระบวนการพัฒนา (SI Process) | 12 รายการ |
| 3 | ความต้องการลูกค้า (Customer Requirements) | 80 รายการ (CR01–CR14) |
| 4 | ความต้องการซอฟต์แวร์ (SRS) | 49 รายการ (SR01–SR09) |
| 5 | Software Unit | 45 หน่วย (UN01–UN13) |
| 6 | Test Case | 45 รายการ |
| 7 | ตารางฐานข้อมูล | ประมาณ 50 ตาราง ใน 2 ฐานข้อมูล |
### 6.2 Effort Man-Day
| ลำดับ | ตำแหน่ง | หน้าที่หลัก | ระยะเวลา (Man-Day) |
| :---: | --- | --- | ---: |
| 1 | Project Manager | ควบคุมงาน ประสานงาน ติดตามแผน | 120 |
| 2 | System Analyst | วิเคราะห์ความต้องการ ออกแบบระบบ | 60 |
| 3 | Developer | พัฒนาระบบและแก้ไขข้อบกพร่อง | 100 |
| 4 | QA / Tester | วางแผนทดสอบ ทดสอบระบบ UAT | 40 |
| 5 | Document Control | ควบคุมเอกสารและหลักฐานโครงการ | 60 |
## 7 Project Resources
**Human Resource**
| ลำดับ | Team | จำนวน (คน) |
| :---: | --- | ---: |
| 1 | Project Management (PM, Document Control) | 2 |
| 2 | Software Implementation (SA, Developer, QA) | 3 |
| 3 | Project Sponsor / ตัวแทนลูกค้า | 1 |
**Computer Resource**
| ลำดับ | รายการ | จำนวน |
| :---: | --- | --- |
| 1 | Notebook สำหรับทีมพัฒนาและทดสอบ | 5 เครื่อง |
| 2 | Git Server (Repository หลัก) | 1 ระบบ |
| 3 | Internal Testing Server (PHP 8, MariaDB, Node.js) | 1 เครื่อง |
| 4 | Production Server สำหรับใช้งานจริง | 1 เครื่อง |
| 5 | เครื่องอ่านบาร์โค้ดสำหรับทดสอบ | 1 เครื่อง |
## 8 Work Schedule
แผนการดำเนินงานของโครงการ รวม 232 วัน ตั้งแต่ 5 มกราคม 2569 ถึง 24 สิงหาคม 2569 รายละเอียดกิจกรรม ผู้รับผิดชอบ และสิ่งส่งมอบรายกิจกรรม อยู่ในเอกสาร 200-WMS-26-001-00 Work Schedule ซึ่งเป็นส่วนหนึ่งของ Project Plan
| Phase | ช่วงเวลา | ผลลัพธ์หลัก |
| --- | --- | --- |
| Project Initiation | 5 มกราคม 2569 – 23 มกราคม 2569 | Statement of Work, Stakeholder Register, Project Charter |
| Project Planning | 12 มกราคม 2569 – 18 กุมภาพันธ์ 2569 | Customer Requirements, Software Project Plan, Work Schedule |
| Project Execution | 19 กุมภาพันธ์ 2569 – 29 พฤษภาคม 2569 | SRS, Software Design, ระบบที่พัฒนาแล้ว, Software Components |
| Verification & Validation | 30 พฤษภาคม 2569 – 17 สิงหาคม 2569 | Test Case, Test Report, Verification Results, Validation Results |
| Project Close | 10 สิงหาคม 2569 – 24 สิงหาคม 2569 | Acceptance Report, Training Report, List of Evidence |
## 9 Risk Management Plan
วัตถุประสงค์ของแผนบริหารความเสี่ยง คือระบุแนวทางจัดการความเสี่ยงของโครงการ เพื่อให้โครงการบรรลุเป้าหมายภายในเวลา งบประมาณ และคุณภาพที่กำหนด
| ลำดับ | หมวด | รายการ | รายละเอียด |
| :---: | --- | --- | --- |
| 1 | ขอบเขต | ครอบคลุมทุกกิจกรรมของโครงการ | ตั้งแต่ Initiation, Planning, Execution จนถึง Close |
| 2 | บทบาทผู้รับผิดชอบ | Project Manager (Owner), ทีมพัฒนา, Project Sponsor | PM ติดตามและควบคุมความเสี่ยง ทีมพัฒนารายงานความเสี่ยงให้ PM |
| 3 | รอบการทบทวน | ทบทวนทุกงวดรายงานความก้าวหน้า | บันทึกความเสี่ยงใหม่และการเปลี่ยนแปลงระดับความเสี่ยงใน Progress Status Record |
**ตารางระบุความเสี่ยงหลักของโครงการ**
| ลำดับ | ความเสี่ยง (Risk) | ประเภท | โอกาสเกิด | ผลกระทบ | ระดับความเสี่ยง | แนวทางป้องกัน (Mitigation) | แผนรับมือ (Contingency Plan) | ผู้รับผิดชอบ |
| :---: | --- | --- | :---: | :---: | :---: | --- | --- | :---: |
| R1 | ความต้องการเปลี่ยนแปลงระหว่างพัฒนา | กระบวนการ | High | High | High | ตั้ง Baseline ความต้องการและทบทวนทุกงวด | จัดทำ Change Report และจัดลำดับความสำคัญใหม่ | ApS / NoC |
| R2 | ทีมพัฒนาไม่เพียงพอหรือขาดทักษะเฉพาะทาง | บุคลากร | Middle | High | High | ถ่ายทอดความรู้ภายในทีมและจัดทำเอกสารประกอบ | ขออนุมัติจัดหาผู้เชี่ยวชาญเพิ่มเฉพาะงาน | ApS |
| R3 | ยอดสินค้าคงคลังไม่ถูกต้อง | เทคโนโลยี | Middle | High | High | ใช้ Transaction, ตรวจสอบข้อมูลนำเข้า และล็อกรายการ | ตรวจสอบและปรับปรุงยอดพร้อมบันทึก Correction Register | ThS / PaNg |
| R4 | ข้อมูลรั่วไหลข้ามบริษัทหรือสิทธิ์ไม่รัดกุม | ความปลอดภัย | Middle | High | High | บังคับ Role Guard และขอบเขตบริษัทฝั่งเซิร์ฟเวอร์ | ปิดช่องโหว่ทันทีและทดสอบสิทธิ์เชิงลบซ้ำ | ThS / PaNg |
| R5 | ค่าตั้งค่าหรือความลับรั่วไหล | ความปลอดภัย | Middle | High | High | ยกเว้นไฟล์ตั้งค่าจาก Git และสร้างความลับตอนติดตั้ง | เปลี่ยนค่าความลับและตรวจสอบประวัติการเข้าถึง | ThS |
| R6 | ข้อมูลสูญหายระหว่างพัฒนาหรือใช้งาน | เทคโนโลยี | Middle | High | High | สำรอง Git 2 Remote และสำรองฐานข้อมูลรายวัน | กู้คืนจากชุดสำรองตามขั้นตอนในคู่มือ | ThS |
| R7 | หลักฐานการทดสอบและตรวจรับไม่ครบถ้วน | กระบวนการ | Middle | High | High | รักษาการสอบกลับสองทิศทางและบันทึกผลทุกครั้ง | ทดสอบซ้ำและบันทึกหลักฐานก่อนตรวจรับ | PaNg / YaB |
| R8 | ผู้ใช้ไม่ยอมรับระบบ (UAT ไม่ผ่าน) | ผู้ใช้งาน | Middle | High | High | ให้ผู้ใช้ร่วมทบทวนความต้องการและสาธิตระบบระหว่างพัฒนา | ปรับปรุงตาม Feedback และทดสอบการยอมรับใหม่ | ApS / SeV |
## 10 Contingency Actions for Non-Completed Tasks
แผนรองรับสำหรับกรณีงานไม่แล้วเสร็จตามกำหนด (Non-Completed Task)
| ลำดับ | สถานการณ์ | สาเหตุที่พบบ่อย | ผลกระทบที่อาจเกิด | แผนรองรับเมื่อเกิดเหตุ | ผู้รับผิดชอบ |
| :---: | --- | --- | --- | --- | --- |
| 1 | งานไม่เสร็จภายในกำหนด (Due Date) | ประเมินเวลาผิดพลาด หรือทรัพยากรไม่เพียงพอ | กระทบ Timeline และกำหนดส่งมอบ | ประชุมด่วนเพื่อประเมินสถานะ จัดลำดับความสำคัญใหม่ ปรับแผน และแจ้งลูกค้าอย่างเป็นทางการ | ApS |
| 2 | งานล่าช้าเพราะขาดบุคลากร | ลาป่วย ลาออก หรือไม่พร้อมปฏิบัติงาน | งานค้างสะสมและภาระงานกระจุกตัว | จัดทำเอกสารส่งมอบงาน ถ่ายทอดความรู้ให้ผู้ปฏิบัติแทน และขออนุมัติจัดหาผู้ช่วยเฉพาะงาน | ApS / ฝ่ายบุคคล |
| 3 | งานค้างเพราะรอข้อมูลจากผู้ใช้ | ผู้ให้ข้อมูลส่งความต้องการหรือข้อมูลตั้งต้นล่าช้า | ไม่สามารถพัฒนาหรือทดสอบต่อได้ | แจ้งเตือนเป็นลายลักษณ์อักษร แยกงานที่ยังไม่พร้อมออก และนัดยืนยัน Timeline ใหม่ | ApS / SeV |
| 4 | งานไม่เสร็จเพราะพบข้อบกพร่องซ้ำซ้อน | ความซับซ้อนสูงหรือขาดการทดสอบระยะแรก | เกิดความล่าช้าในการพัฒนาและทดสอบ | จัดลำดับข้อบกพร่องตามความรุนแรง แยกงานแก้ไขออกจากงานพัฒนาใหม่ และทดสอบซ้ำ | ThS / PaNg |
| 5 | งานล่าช้าเพราะต้องแก้ความต้องการ | ขอบเขตเปลี่ยนหลังเริ่มงาน | กระทบแผนงานและสิ่งส่งมอบ | จัดทำ Change Report อย่างเป็นทางการ ประเมินผลกระทบ และขออนุมัติก่อนดำเนินการต่อ | ApS / SeV |
## 11 Document and Repository
**รูปแบบไฟล์ (File Format)** การกำหนดชื่อไฟล์ให้ใช้รูปแบบดังนี้
`[Project code] [Document name] [yyyymmdd] V[version] [editor name].[ext.]`
| หัวข้อ | รายละเอียด |
| --- | --- |
| [Project code] | รหัสโครงการตามส่วนงานบัญชี เช่น 200-WMS-26-001-00 |
| [Document name] | ชื่อเอกสาร เช่น Progress Status Record |
| [yyyymmdd] | วันที่ของเอกสารตามปีพุทธศักราช เช่น 25690817 |
| [version] | เวอร์ชันของเอกสาร เช่น 1.0 |
| [editor name] | ตัวย่อของชื่อผู้จัดทำ เช่น ApS |
| [ext.] | นามสกุลไฟล์ เช่น pdf |
**การประกาศเวอร์ชัน (Version Declaration)** เก็บเอกสารแต่ละเวอร์ชันแยกไฟล์เพื่อให้ตรวจสอบย้อนหลังได้ โดยใช้รูปแบบ Major.Minor
| เวอร์ชัน (Version) | รายละเอียด |
| --- | --- |
| 0.1 (Draft) | ร่างเอกสารฉบับแรก |
| 0.2 (Draft) | ปรับปรุงตามผลการทบทวน |
| 1.0 (Release) | อนุมัติใช้เป็นเอกสารทางการ |
| 1.1 (Revision) | ปรับปรุงเอกสารหลังอนุมัติ |
**Project Repository** ใช้ Git Server เป็นศูนย์กลางในการจัดเก็บและควบคุมเวอร์ชันของ Source Code และเอกสารทั้งหมดที่เกี่ยวข้องกับโครงการ
| ลำดับ | หัวข้อ | รายละเอียด |
| :---: | --- | --- |
| 1 | ที่เก็บข้อมูล (Repository Location) | ทีมงานเข้าถึง Repository ผ่าน Git Server โดย Repository ของโครงการนี้เก็บทั้ง Source Code และเอกสาร ISO |
| 2 | สิทธิ์การเข้าถึง (Access Control) | สมาชิกโครงการได้รับสิทธิ์ตามบทบาท โดย Project Manager และ System Analyst มีสิทธิ์อนุมัติการ Merge |
| 3 | การจัดเก็บไฟล์งาน (File Storage Rules) | ไฟล์ที่เกี่ยวข้องกับโครงการต้องจัดเก็บใน Repository และไฟล์ที่สร้างจากเครื่องส่วนบุคคลต้องนำขึ้น Repository ภายในเวลาที่กำหนด |
**Project Repository Backup** เพื่อป้องกันการสูญหายของข้อมูลใน Git Server
| ลำดับ | หัวข้อ | รายละเอียด |
| :---: | --- | --- |
| 1 | ผู้รับผิดชอบ (Responsibility) | มอบหมาย Developer ตรวจสอบความถูกต้องของข้อมูลสำรองอย่างสม่ำเสมอ |
| 2 | วิธีการสำรองข้อมูล (Backup Methods) | ซิงก์ Repository ไปยัง Backup Remote และสำรองฐานข้อมูลด้วยการ Export อัตโนมัติ |
| 3 | รอบการสำรองข้อมูล (Backup Frequency) | ฐานข้อมูลสำรองทุกวันเวลา 02:00 น. และ Repository ซิงก์ทุกครั้งที่มีการส่งมอบ |
## ผู้จัดทำเอกสาร (Secretary)
| ชื่อ | ตำแหน่ง | ลายเซ็น | วันที่ |
| --- | --- | --- | --- |
| คุณอภิรัชช์ สุภัทรประทีป | Project Manager | | |
## ผู้ตรวจสอบเอกสาร (Reviewer)
| ชื่อ | ตำแหน่ง | ลายเซ็น | วันที่ |
| --- | --- | --- | --- |
| คุณเยาวลักษณ์ บางชมภู | Document Control | | |
## ผู้อนุมัติ (Approval)
| ชื่อ | ตำแหน่ง | ลายเซ็น | วันที่ |
| --- | --- | --- | --- |
| คุณเสรี วิริยะสกุลธรณ์ | Project Sponsor | | |
sdlc/1-PM Process (10 Work Product)/2.Project Plan/2-Software Project Plan/200-WMS-26-001-00 Software Project Plan 25690817 V1.0 Final.md
-437
View File
@@ -1,437 +0,0 @@
# Software Project Plan
| Document field | Value |
|---|---|
| Document | Software Project Plan |
| Project | BRN WMS |
| Project code | 200-WMS-26-001-00 |
| Title | Warehouse Management System Development Project Plan |
| Project period | 05/01/26–24/08/26 |
| Release | 17/08/26 V1.0 Final |
| Planning baseline | 05/01/26 |
| Standard | ISO/IEC 29110 Basic Profile |
| Project Manager | Apirach Supattaratpateep |
| Status | Final — reviewed and authorized |
## Revision history
| Version | Date | Change | Prepared by |
|---|---|---|---|
| V1.0 | 17/08/26 | Initial controlled issue. Consolidates the 05/01/26 planning baseline with lifecycle, quality, equipment-evidence, and configuration outcomes recorded through closure preparation. | Apirach Supattaratpateep |
Sections 6, 8.5, 12.2 and 16 describe outcomes as at 17/08/26; the remaining sections retain the 05/01/26 planning baseline.
## 1. Purpose
This Software Project Plan defines how the BRN WMS project is organized, executed, monitored, controlled, verified, validated, delivered, and closed. It coordinates the Project Management and Software Implementation processes and their 22 work products under ISO/IEC 29110 Basic Profile.
### 1.1 Standards basis and applicability
BRN WMS applies the ISO/IEC 29110 software engineering Generic Basic Profile for one non-safety-critical software product developed by one project team under a customer project agreement. The standards basis for this project is:
- **ISO/IEC 29110-4-1:2018** — Software engineering profile specifications for the Generic profile group, including the Basic profile.
- **ISO/IEC 29110-5-1-2:2025** — Software engineering management and engineering guidelines for the Generic Basic profile.
| Applicability item | BRN WMS application |
|---|---|
| Profile group | Generic profile group |
| Profile | Basic profile |
| Engineering discipline | Software engineering |
| Project organization | One project team with assigned management, analysis, development, testing, document-control, and customer-approval roles |
| Product scope | One browser-based warehouse management software product and its supporting deployment/service components |
| Agreement | Customer project agreement controlled through the Statement of Work and Customer Requirements |
| Safety criticality | Non-safety-critical software |
| Management process | Project Management |
| Engineering process | Software Implementation |
| Lifecycle | Incremental/evolutionary implementation with controlled requirements, configuration baselines, verification, validation, and acceptance |
| Tailoring principle | Work-product structure and detail are scaled to BRN WMS size and complexity while retaining controlled content, responsibility, review, and traceability |
### 1.2 Work-product tailoring
- Project Plan content is controlled across the Work Schedule, this Software Project Plan, and Customer Requirements.
- The Software work product is the Git-controlled application baseline; work product 17 is its controlled identification and repository pointer record.
- The Traceability Record (work product 13) is the master requirements matrix. The additional Traceability Record Table is a summary/pointer and does not create a second competing baseline.
- Test Cases and Test Procedures defines the tests and records their execution status; the separate Test Report consolidates the results and disclosed evidence limitations.
- The Project Charter Report, Stakeholder Register, List of Evidence, Traceability Record Table, and Training Report supplement the Basic-profile work products without replacing them.
- Markdown files under `sdlc/` are the controlled editable document sources. PDFs under `sdlc-delivery/` are generated delivery/printing outputs and are not edited independently.
- No Project Management or Software Implementation process is declared excluded. Content granularity is scaled where documented, including requirement-level traceability for the 34 controlled requirements.
## 2. Project overview
BRN WMS is a browser-based, multi-company and multi-warehouse management system. It centralizes warehouse master data, inventory movements, sales and purchasing documents, finance and accounting records, reports, access control, and operational notifications.
The project is intended to:
- Improve the accuracy and timeliness of warehouse operations.
- Provide current stock visibility across authorized warehouses and locations.
- Preserve lot, serial-number, expiry-date, and movement traceability.
- Control sales, purchasing, return, invoice, receipt, payment, and accounting workflows.
- Separate company data and restrict functions according to authorized roles.
- Provide management reports, operational alerts, and auditable records.
## 3. Scope
### 3.1 Included scope
- Company, user, role, application-access, SMTP, and system configuration.
- Contact, product, category, warehouse, storage-area, and bin master data.
- Stock-in, stock-out, stock transfer, balance, lot, serial number, and expiry control.
- Warehouse capacity, occupancy, movement, expired-stock, and product-lot reporting.
- SKU and warehouse-location barcode labels and supported scanning workflows.
- Quotations, sales orders, returns, invoices, and credit notes.
- Purchase requests, purchase orders, purchase invoices, and supplier returns.
- Receipt billing, receipts, payment billing, and payments.
- Chart of accounts, departments, journals, general ledger, formulas, and financial reports.
- Controlled document numbering and lifecycle/status handling.
- Real-time notifications using Node.js and Socket.IO.
- Scheduled stock/GL maintenance, low-stock alerts, and overdue-invoice alerts.
- Deployment configuration, database setup, operating guidance, and maintenance information.
- ISO/IEC 29110 work products and controlled project repository.
### 3.2 Excluded scope
- Procurement of servers, networks, barcode scanners, printers, or user devices.
- Legacy-data migration unless separately assessed and approved.
- Integration with external ERP, banking, shipping, tax, or third-party services unless approved through change control.
- Custom functionality outside the baselined requirements.
- Production hosting or third-party subscription fees unless separately authorized.
## 4. Objectives and success criteria
The project is successful when:
- All acceptance-critical requirements are implemented and traceable to verification evidence.
- Representative warehouse, sales, purchasing, finance, and accounting workflows pass validation.
- No unresolved critical defect blocks intended operation or compromises security or data integrity.
- Installation, configuration, user, operation, and maintenance documentation is available.
- Software and controlled work products are stored in the project repository.
- Verification, validation, and acceptance records receive the required review and authorization.
## 5. Lifecycle and schedule
| Phase | Period | Main activities | Primary outputs |
|---|---:|---|---|
| Initiation | 05/01/26–23/01/26 | Establish need, stakeholders, objectives, scope, and authority. | Statement of Work, stakeholder records |
| Planning | 12/01/26–18/02/26 | Collect requirements; define schedule, resources, risks, controls, and baselines. | Customer Requirements, Work Schedule, Software Project Plan |
| Implementation | 19/02/26–29/05/26 | Analyze, design, code, configure, integrate, review, and test the system. | SRS, Software Design, Components, Test Cases, Software |
| Verification and validation | 30/05/26–07/08/26 | Review work products and validate representative operational workflows. | Traceability, Test Report, Verification and Validation Results |
| Documentation and stabilization | 01/06/26–24/08/26 | Prepare guides, close corrections, configure deployment, and prepare demonstration data. | User Documentation, Operation Guide, Maintenance Documentation |
| Closure | 10/08/26–24/08/26 | Review repository, resolve open actions, obtain acceptance, and close the project. | Acceptance Report, List of Evidence, repository baseline |
Detailed activities and evidence are maintained in the Work Schedule.
## 6. Software development lifecycle methodology
BRN WMS follows an incremental/evolutionary development approach, with features, modules, and security corrections delivered throughout implementation.
BRN WMS is more accurately described as **incremental/evolutionary**, within the same overall lifecycle stages used for planning and reporting purposes (Section 5):
| Stage | How it was actually approached |
|---|---|
| Requirements | Captured once at a level (Customer Requirements), then implicitly refined as implementation proceeded — e.g., the Rack→Bin terminology change (CH-001) and multiple onboarding/security corrections show requirements being clarified during implementation, not frozen beforehand |
| Design | Not produced as an upfront, separate artifact; Software Design (work product 12) was derived from the as-built architecture, not authored before coding began |
| Implementation | Continuous, feature-by-feature, evidenced by 100 commits across the implementation period (19/02/26–29/05/26; 110 in the repository overall) with no clean phase boundary between "build" and "test/fix" |
| Verification | Interleaved throughout implementation (ongoing manual exercising and correction, per the Correction Register) rather than concentrated in a single verification phase; formal Round 2A document-control and Round 2B technical work-product verification was completed on 17/08/26 and recorded in work product 21 |
| Stabilization/closure | A distinct late-stage effort (03/08/26 onward) closer to a traditional stabilization phase |
## 7. Organization and responsibilities
| Role | Assigned person | Responsibilities |
|---|---|---|
| Project Sponsor / Customer Representative / Authorized Approver | Seri Viriyasakultorn | Represent customer needs; authorize scope, resources, baseline changes, acceptance, and project closure. |
| Project Manager | Apirach Supattaratpateep | Plan and monitor work; assign responsibilities; manage risks, issues, communication, changes, and closure. |
| System Analyst | Noppong Chareunsook | Analyze customer requirements, specify system behavior, and maintain technical traceability. |
| Developer | Thanakorn Sathitwitayakul | Design, implement, configure, correct, and maintain source code, aligned with Git implementation evidence. |
| Tester / Reviewer | Parin Ngamkham | Prepare and execute tests, review work products, report defects, and confirm corrections. |
| Document Control | Yaowalak Bangchomphoo | Control identifiers, versions, approvals, distribution, repository content, and evidence. |
One person may perform more than one operational role when independence is not mandatory. Approval authority must remain with the designated authorized approver or a formally delegated authority.
## 8. Resources and environment
### 8.1 Schedule summary
| Phase | Calendar span | Approx. duration |
|---|---|---:|
| Initiation | 05/01/26–23/01/26 | 19 days |
| Planning | 12/01/26–18/02/26 | 38 days |
| Implementation | 19/02/26–29/05/26 | 100 days |
| Verification and validation | 30/05/26–07/08/26 | 70 days |
| Documentation and stabilization | 01/06/26–24/08/26 | 85 days |
| Closure | 10/08/26–24/08/26 | 15 days |
These are calendar spans rather than effort estimates.
### 8.2 Software and infrastructure
- PHP 8.0 or later.
- MySQL or MariaDB.
- Nginx or another compatible PHP web server.
- Node.js, npm, Socket.IO, and PM2 for real-time and scheduled services.
- Git repository with `main` as the controlled integration baseline.
- Current standards-based desktop and mobile browsers.
- Asia/Bangkok time zone across application and scheduled-job environments.
### 8.3 Logical application components
| Component | Purpose |
|---|---|
| PHP web application | Main user interface and operational APIs |
| Identity/company database | Users, companies, access, SMTP, usage, and related configuration |
| WMS/accounting database | Warehouse, inventory, documents, finance, and accounting records |
| Node.js notification service | Browser notifications and application event relay |
| Node.js scheduler | Aggregate maintenance and scheduled operational alerts |
### 8.4 Configuration constraints
- Local configuration and secrets must not be committed to Git.
- Production database credentials must use the minimum privileges required after installation.
- Application, database, upload, and service configuration must follow the controlled configuration guide.
- Public access to source-control metadata, secrets, and internal service endpoints must be restricted.
### 8.5 Computer and equipment resources
The example reference package's Section 7 lists specific equipment (notebook count, scanner, Git server, software licenses). No equipment inventory record exists as project evidence for BRN WMS — this is not fabricated here. What is evidenced instead:
| Item | Evidence |
|---|---|
| Git hosting | Primary remote `origin` (`188.166.228.62:nok/wms-app.git`) and backup remote `backup` (GitHub) — see Project Repository, work product 9 |
| Deployment target | Manual LAMP install or Docker Compose stack (`php-apache`, `mariadb`, `node/pm2`) — see Software Configuration, work product 8, and Product Operation Guide, work product 19 |
| Developer workstation(s) | Not recorded — no inventory evidence exists |
| Office/licensed software (word processor, spreadsheet, etc.) | Not recorded — no inventory evidence exists |
## 9. Deliverables and work products
### 9.1 Project Management work products
1. Statement of Work
2. Project Plan, including Work Schedule, Software Project Plan, and Customer Requirements
3. Progress Status Record
4. Correction Register
5. Acceptance Report
6. Change Report
7. Meeting Record
8. Software Configuration
9. Project Repository
10. Project Repository Backup
### 9.2 Software Implementation work products
11. Software Requirements Specification
12. Software Design
13. Traceability Record
14. Software Components
15. Test Cases and Test Procedures
16. Test Report
17. Software
18. Software User Documentation
19. Product Operation Guide
20. Maintenance Documentation
21. Verification Results
22. Validation Results
## 10. Monitoring and communication
| Record or activity | Frequency or trigger | Owner | Audience |
|---|---|---|---|
| Work Schedule update | At least weekly during active work | Project Manager | Project team and sponsor |
| Progress Status Record | Weekly during active work | Project Manager | Project team and sponsor |
| Project meeting | At planned reviews or when decisions are required | Project Manager | Relevant stakeholders |
| Meeting Record | For each formal project/review meeting | Recorder | Attendees and affected stakeholders |
| Correction Register | When a defect, issue, or nonconformity is identified | Tester / Project Manager | Assigned owner and reviewer |
| Change Report | When a baseline change is requested | Project Manager | Sponsor, affected team, customer representative |
| Repository review | At each baseline and project closure | Document Control | Project Manager and reviewer |
Progress status includes completed work, planned work, deviations, risks, issues, required decisions, corrective actions, and schedule impact.
## 11. Risk management
| ID | Risk | Impact | Planned response / control | Owner |
|---|---|---|---|---|
| R-01 | Pre-development planning records were prepared after the fact | Audit evidence may be weaker than the records suggest. | Mark assumptions clearly and obtain review and approval. | Project Manager |
| R-02 | Unauthorized access or cross-company data exposure | Confidentiality and integrity failure. | Server-side role guards, company/warehouse scoping, session controls, and security review. | Developer / Reviewer |
| R-03 | Incorrect inventory balance | Operational and financial records become unreliable. | Transactions, input validation, locking, approval flow, reconciliation, and movement tests. | Developer / Tester |
| R-04 | Secret or configuration exposure | System compromise or service interruption. | Ignore local secrets, provide templates, restrict web access, and review deployment configuration. | Configuration Manager |
| R-05 | Incomplete requirement or acceptance evidence | Delivery cannot be objectively demonstrated. | Maintain bidirectional traceability and obtain signatures before baselining. | Project Manager |
| R-06 | Uncontrolled scope expansion | Schedule and quality degradation. | Require Change Report, impact analysis, authorization, and re-planning. | Project Manager / Sponsor |
| R-07 | Inadequate backup or recovery | Loss of source, documents, or operational data. | Maintain repository backup and documented database/file backup and recovery procedures. | Configuration Manager |
| R-08 | Third-party or environment incompatibility | Deployment or notification failure. | Document supported versions and verify the target environment before acceptance. | Developer / System Administrator |
Risks are reviewed with progress status. New risks and changes to exposure or response are recorded by the Project Manager.
### 11.1 Contingency actions for non-completed tasks
Distinct from the risk table above (which addresses project-level threats), this table addresses the specific, recurring situation of an individual task or work product not finishing by its planned date.
| Situation | Common cause | Likely impact | Contingency action | Owner |
|---|---|---|---|---|
| Task not finished by its due date | Timeline or resource estimate was too tight | Downstream tasks slip; delivery date at risk | Meet with the team to reassess status and priority; agree and communicate a revised timeline | Project Manager |
| Delay due to insufficient staffing (illness, unavailability) | Single-person roles (Section 7) have no backup | Work stalls until the person returns | Document a handover/knowledge-transfer note; consider temporary outside help for the specific gap only with Sponsor authorization | Project Manager |
| Delay due to late or incomplete requirement/content input | Upstream dependency (customer input, data) not ready | Downstream development or testing cannot proceed | Escalate to the Sponsor with a clear description of what is blocking; agree a revised input date | Project Manager |
| Delay due to unexpected technical complexity | Underestimated integration/defect complexity discovered during work | Task takes materially longer than planned | Prioritize by severity (Critical/High/Low, per Section 12.1); temporarily set aside lower-priority items | Developer |
| Delay because scope changed mid-task | Requirement changed after work started | Effort already spent may be partially invalidated | Raise a Change Report; obtain authorization before continuing under the new scope | Project Manager |
## 12. Quality assurance
- Assign a unique identifier to each approved requirement.
- Review requirements for clarity, completeness, consistency, testability, and scope alignment.
- Review design against requirements and operational constraints.
- Review implementation for authorization, tenant isolation, data integrity, configuration safety, and error handling.
- Trace requirements to design elements, components, test cases, and results.
- Record defects and nonconformities in the Correction Register.
- Re-test corrected behavior and retain objective evidence.
- Validate representative end-to-end scenarios with customer-oriented data.
### 12.1 Defect disposition
| Severity | Meaning | Acceptance treatment |
|---|---|---|
| Critical | Prevents core operation, compromises security, causes cross-company exposure, or corrupts essential data. | Must be corrected and verified before acceptance. |
| Major | Material function fails without an acceptable workaround. | Correct before acceptance or obtain explicit authorized disposition. |
| Minor | Limited impact with an acceptable workaround. | Record planned correction or authorized acceptance. |
| Observation | Improvement or documentation item without functional failure. | Record and prioritize as appropriate. |
### 12.2 Quality criteria and evaluation methods
The example reference package states measurable quality thresholds directly in the Software Project Plan (response time, uptime, security scan result, etc.). BRN WMS's measurable criteria are already defined as non-functional requirements in Customer Requirements (Section 8) and restated as technical requirements in the SRS (work product 11); this table cross-references them here rather than duplicating a second copy that could drift out of sync.
| Quality area | Criterion | Evaluation method | Reference |
|---|---|---|---|
| Functional correctness | All Must requirements implemented and traceable | Traceability Record review + Test Report execution | NFR-009, work products 13, 16 |
| Performance | Practical operational response time; aggregates support dashboards/reports | Representative-operation timing under agreed data volume | NFR-006, SR05:001–003, TC-NFR-006 |
| Security | No unresolved critical security defect; server-side auth/tenant scope enforced | Negative-authorization/invalid-input testing | NFR-002, SR07:001–005, TC-NFR-002 |
| Reliability/integrity | No invalid negative/duplicate stock or GL movement | Failure/rollback and concurrency test | NFR-003, SR09:003, TC-NFR-003 |
| Usability | Responsive UI usable on desktop and warehouse-floor devices | Representative-screen check at agreed viewport sizes | NFR-005, SR02:002, TC-NFR-005 |
| Installability | Installation/configuration/backup/recovery repeatable | Follow Product Operation Guide end-to-end | NFR-004, TC-NFR-004 |
| Post-delivery support | Backup and restoration | Restoration check performed manually by the Developer | Project Repository (Backup), work product 10 |
Actual results belong in the Test Report and Verification/Validation Results, which show 34 of 34 passed and 12 of 12 passed, executed 10/08/26–14/08/26 (see the Acceptance Report's current-status note).
## 13. Verification and validation
Verification confirms that each work product satisfies its specified inputs and criteria. Validation confirms that the integrated BRN WMS supports its intended operational use.
Verification covers:
- Customer Requirements and Software Requirements Specification.
- Software Design and database/configuration design.
- Software Components and integration behavior.
- Test Cases, Test Procedures, Test Report, and traceability.
- User, operation, configuration, and maintenance documentation.
Validation covers representative workflows for:
- User onboarding and role-based access.
- Warehouse and product configuration.
- Stock receipt, issue, transfer, balance, lot, serial, and expiry handling.
- Sales, purchasing, return, invoice, receipt, and payment workflows.
- Accounting postings and management reports.
- Notifications, scheduled jobs, and operational recovery.
## 14. Configuration management
Configuration items include:
- PHP, JavaScript, CSS, Node.js, and database/setup source files.
- Application and service configuration templates.
- Database schema and migration/setup logic.
- Controlled requirements, design, test, guide, and management work products.
- Approved releases, evidence, and repository backups.
Controls include:
- Controlled `main` baseline.
- Project-code-based filenames and document version/status identifiers.
- Review and authorization before changing an approved baseline.
- Exclusion of passwords, tokens, local configuration, logs, uploads, and generated secrets from source control.
- Repository and operational-data backup with recoverability checks.
## 15. Change and correction control
A baseline change follows this sequence:
1. Record the requested change and reason.
2. Analyze its scope, schedule, technical, quality, security, and documentation impact.
3. Obtain authorization from the designated authority.
4. Update affected plans, requirements, design, traceability, tests, and configuration records.
5. Implement and verify the change.
6. Record the result and close the Change Report.
Defects and nonconformities are recorded in the Correction Register, assigned to an owner, corrected, re-tested, and closed with evidence.
## 16. Repository and document control
### 16.1 File naming convention
BRN WMS's actual naming convention, in force since PM work product 1 and used consistently across all 46 controlled files, differs deliberately from the example reference project's:
`[Project code] [Document name] [YYYYMMDD Buddhist] V[version]`, for example `200-WMS-26-001-00 Correction Register 25690817 V1.0`.
| Element | Meaning | Example |
|---|---|---|
| Project code | `200-WMS-26-001-00` | Fixed |
| Document name | Descriptive title; where a work product has multiple instances (Progress Status Record, Change Report, Meeting Record), a short distinguishing suffix is added | `- Rack to Bin Rename` |
| Date | Compact Buddhist-calendar date (`YYYYMMDD`), matching the date on the document header | `25690817` |
| Version | `V<major>.<minor>`, e.g. `V1.0` | `V1.0` |
BRN WMS document filenames do not append author initials.
### 16.2 Version declaration
Documents created for BRN WMS are released directly at `V1.0` once content is complete, without the example's separate `0.1`/`0.2` Draft stages — BRN WMS work products are not labeled `Draft` unless explicitly requested, per the same recorded decision. "Final" in the document-control Status field means the controlled content is complete; authorization and the project-acceptance decision are recorded in each document's Approval section and the Acceptance Report.
### 16.3 Repository and backup
- Every controlled filename starts with `200-WMS-26-001-00`.
- Documents identify title, date, version, status, preparer, reviewer, and approver as applicable.
- Drafts remain distinguishable from approved baselines.
- The Project Repository contains the current controlled work products and supporting evidence (work product 9).
- The repository backup is maintained separately and checked during project closure (work product 10); BK-001–BK-004 are closed, including restoration, complete delivery packaging, and synchronization and retrieval verification of the final `sdlc` branch and release tag on 24/08/26.
- Superseded records are retained or archived according to organizational control practices.
## 17. Acceptance and closure
The project may close when:
- Acceptance-critical requirements have passed their linked verification and validation.
- No unresolved critical defect remains.
- Deferred items and accepted exceptions have authorized dispositions.
- Required user, operation, configuration, and maintenance documents are available.
- Software, source, setup information, evidence, and required work products are in the repository.
- The Acceptance Report and closure decision are signed by the authorized approver.
## 18. Approval
### Prepared by
Name: Apirach Supattaratpateep
Role: Project Manager
Signature: ______________________________________________
Date: ___________________________________________________
### Technical contributor
Name: Thanakorn Sathitwitayakul
Role: Developer
Signature: ______________________________________________
Date: ___________________________________________________
### Reviewed and authorized by
Name: Seri Viriyasakultorn
Project roles: Project Sponsor / Customer Representative / Authorized Approver
Position: Managing Director
Company: B.R.N. Enterprise Co., Ltd.
Signature: ______________________________________________
Date: ___________________________________________________