build(sdlc): seed data, figures and rendered package for 23/09 feedback

scripts/sdlc-seed/docs-si.mjs

@@ -2,6 +2,7 @@
 import { P, CODE, PROJECT_TH, ORGANIZER, ORGANIZER_PM, RECORDER, START, END, SCOPE, CRS, crTopic, TEST_FROM, TEST_TO, ACCEPT_DATE, BASELINE_COMMIT, TEST_STATE_COMMIT, ORIGIN, BACKUP, TAG } from './project.mjs';
 import { SR_GROUPS, SRS, srTopic, UNIT_GROUPS, UNITS, unitTopic, unitModule, TEST_CASES, traceOf } from './engineering.mjs';
 import { CORRECTIONS } from './history.mjs';
+import { figure } from './figures.mjs';
 import { bud, thLong, thShort, thRangeLong, table, bullets, numbered } from './lib.mjs';
 import { workProduct, head } from './format.mjs';
 
@@ -72,8 +73,12 @@ export function softwareDesign() {
       ]),
       body: [
         '## HIGH LEVEL DESIGN',
+        '### High Level Architecture Diagram',
+        'ภาพรวมสถาปัตยกรรมของระบบ แบ่งเป็นผู้ใช้งาน ชั้น Client, Web, Data, Service และบริการภายนอก พร้อมช่องทางการเชื่อมต่อระหว่างกัน ทุกคำขอจากหน้าจอผ่านการตรวจสอบของ db_auth ก่อนถึงตรรกะธุรกิจ',
+        figure('architecture'),
         '### Use Case Diagram',
-        'ผู้ใช้งานของระบบและกลุ่มการใช้งานหลัก',
+        'ผู้ใช้งานของระบบและกลุ่มการใช้งานหลัก บทบาทที่สูงกว่าได้รับสิทธิ์การใช้งานของบทบาทที่ต่ำกว่าทั้งหมด (Viewer → Staff → Admin → Owner)',
+        figure('useCase'),
         table(['Actor', 'คำอธิบาย', 'การใช้งานหลัก'], [
           ['Owner', 'เจ้าของบริษัท สิทธิ์สูงสุดภายในบริษัท', 'ตั้งค่าบริษัท จัดการผู้ใช้ และใช้งานทุกโมดูล'],
           ['Admin', 'ผู้ดูแลระบบภายในบริษัท', 'จัดการข้อมูลหลัก ผู้ใช้ สิทธิ์ และใช้งานทุกโมดูลปฏิบัติการ'],
@@ -83,6 +88,8 @@ export function softwareDesign() {
           ['SMTP Service', 'ผู้กระทำภายนอก', 'ส่งอีเมล Onboarding กู้คืนรหัสผ่าน และแจ้งเตือน'],
         ]),
         '### Component Diagram',
+        'โมดูลของระบบ (Software Unit กลุ่ม UN01–UN13) และความสัมพันธ์การเรียกใช้ระหว่างโมดูล',
+        figure('component'),
         'โครงสร้างส่วนประกอบของระบบแบ่งตามชั้นการทำงาน',
         table(['ชั้น (Layer)', 'ส่วนประกอบ', 'อ้างอิง SR'], [
           ['Presentation', 'หน้าจอ PHP ในแต่ละโมดูล (`app/<module>/`), JavaScript และ CSS ที่รองรับ Responsive', 'SR02:002, SR06:002, SR06:003'],
@@ -92,6 +99,8 @@ export function softwareDesign() {
           ['External', 'บริการ SMTP สำหรับส่งอีเมล และ Socket.IO Client บน Browser', 'SR06:004, SR06:005'],
         ]),
         '### Deployment Diagram',
+        'การติดตั้งบนสภาพแวดล้อมใช้งานจริงด้วย Docker Compose และทางเลือกการติดตั้งแบบ Manual',
+        figure('deployment'),
         'การติดตั้งระบบแบ่งเป็น 4 ชั้นบริการ',
         table(['ชั้นการติดตั้ง (Tier)', 'ส่วนประกอบ', 'อ้างอิง SR'], [
           ['Client', 'Web Browser (Chrome/Edge/Firefox) บน Desktop, Tablet และ Mobile พร้อม Socket.IO Client', 'SR06:002, SR06:003, SR06:005'],
@@ -100,7 +109,7 @@ export function softwareDesign() {
           ['Service Tier', 'Node.js `server.js` และ `scheduler.js` ควบคุมด้วย pm2', 'SR03:011, SR06:004'],
         ]),
         '### User Interface Design',
-        'ผังหน้าจอหลักของระบบแบ่งตามโมดูลการใช้งาน',
+        'ผังหน้าจอหลักของระบบแบ่งตามโมดูลการใช้งาน ทุกหน้าจอใช้โครงร่างเดียวกัน ได้แก่ เมนูด้านซ้ายที่แสดงตามสิทธิ์ของผู้ใช้ แถบด้านบนสำหรับเลือกบริษัทและบัญชีผู้ใช้ และพื้นที่ทำงานด้านขวา',
         table(['กลุ่มหน้าจอ', 'หน้าจอ'], [
           ['Login & Onboarding', 'เข้าสู่ระบบ / ลงทะเบียนบริษัท / รับคำเชิญเข้าร่วมบริษัท / ลืมรหัสผ่าน / ยืนยัน OTP'],
           ['Dashboard', 'แดชบอร์ดคลังสินค้า / แดชบอร์ดบัญชีและการเงิน'],
@@ -113,6 +122,14 @@ export function softwareDesign() {
           ['Reports', 'รายงานสต๊อก / ความเคลื่อนไหว / ความจุคลัง / สินค้าใกล้หมด / สินค้าหมดอายุ / รายงานการเงิน'],
           ['Settings', 'ข้อมูลบริษัท / SMTP / ผู้ใช้งานและสิทธิ์ / การตั้งค่าระบบ'],
         ]),
+        '### Mockup Wireframe',
+        'Wireframe แสดงโครงร่างหน้าจอหลักที่ใช้เป็นแม่แบบในการพัฒนา หน้าจอเอกสารขาย จัดซื้อ และการเงินใช้รูปแบบหน้ารายการ (รูปที่ 7) และหน้าบันทึก (รูปที่ 8) เดียวกัน',
+        figure('wfLogin'),
+        figure('wfDashboard'),
+        figure('wfList'),
+        figure('wfDocument'),
+        figure('wfStockIn'),
+        figure('wfReport'),
         '## Software Baseline',
         'หัวข้อนี้ระบุสิ่งที่ถูกกำหนดเป็น Baseline ของซอฟต์แวร์ วันที่กำหนด และผู้อนุมัติ เพื่อให้ตรวจสอบเส้นทาง Baseline → Configuration → Change ได้ในเอกสารชุดเดียวกัน',
         table(['รายการที่กำหนดเป็น Baseline', 'ค่าที่ควบคุม', 'ที่จัดเก็บ'], [
@@ -128,7 +145,7 @@ export function softwareDesign() {
           ['ผู้อนุมัติ', `${P.SeV.th} (Project Sponsor) พร้อมการตรวจรับเมื่อ ${thLong(ACCEPT_DATE)}`],
           ['เอกสารควบคุมที่เกี่ยวข้อง', 'Software Configuration (WP 8) ระบุรายการ Configuration Item และการควบคุมเวอร์ชัน'],
           ['การสอบกลับ', 'Traceability Record (WP 13) เชื่อมโยงความต้องการกับ Software Unit และ Test Case บน Baseline นี้'],
-          ['การเปลี่ยนแปลง Baseline', 'ต้องผ่าน Change Report (CH-001–CH-003) และบันทึกผลใน Correction Register เมื่อเป็นการแก้ไขข้อบกพร่อง'],
+          ['การเปลี่ยนแปลง Baseline', 'ต้องพิจารณาตามเกณฑ์ใน Change Report และบันทึกผลใน Correction Register เมื่อเป็นการแก้ไขข้อบกพร่อง'],
         ]),
         '## Software Unit',
         table(['ID', 'Description', 'Functional Interfaces Detail', 'References', 'Files'], unitRows),
@@ -143,12 +160,16 @@ export function traceabilityRecord() {
   const date = '2026-03-06';
   const rows = [];
   let group = '';
-  for (const [id, text, remark] of CRS) {
+  for (const [id, text] of CRS) {
     const g = id.slice(0, 4);
-    if (g !== group) { group = g; const name = SCOPEGROUP(g); rows.push([`${g}: ${name}`, '', '', '', '', '', '']); }
+    if (g !== group) { group = g; const name = SCOPEGROUP(g); rows.push([`${g}: ${name}`, '', '', '', '', '', '', '']); }
     const t = traceOf(id);
-    rows.push([id, text, t.sr.join(', '), t.sr.map(srTopic).join(' / '), t.un.join(', '), t.un.map(unitTopic).join(' / '), t.tc]);
+    rows.push([id, text, t.sr.join(', '), t.sr.map(srTopic).join(' / '), t.un.join(', ') || '-', t.un.map(unitTopic).join(' / ') || '-', t.tc, t.ev || '-']);
   }
+  const traced = CRS.map(([id]) => traceOf(id));
+  const withUnits = traced.filter((t) => t.un.length).length;
+  const withTests = traced.filter((t) => t.tcs.length).length;
+  const byDocument = traced.filter((t) => !t.tcs.length).length;
   return {
     dir: '2-SI Process (12 Work Product)/13.Traceability record',
     name: `${CODE} Traceability Record ${bud(date)} V1.0 NoC`,
@@ -164,13 +185,16 @@ export function traceabilityRecord() {
         '## วัตถุประสงค์ (Objective)',
         'เอกสารที่เชื่อมโยงทุกขั้นตอนของโครงการ ตั้งแต่ความต้องการของลูกค้า → ความต้องการซอฟต์แวร์ → การออกแบบ → การทดสอบ เพื่อยืนยันความครบถ้วนของ Customer Requirements และลดความเสี่ยงของข้อบกพร่องและความต้องการที่ตกหล่น',
         '## Traceability Matrix',
-        table(['CR ID', 'CR Topic', 'SRS ID', 'SRS Topic', 'Unit ID', 'Unit Topic', 'Test Case ID'], rows),
+        table(['CR ID', 'CR Topic', 'SRS ID', 'SRS Topic', 'Unit ID', 'Unit Topic', 'Test Case ID', 'หลักฐานอื่น (Document)'], rows),
+        'หมายเหตุ: ความต้องการที่เป็นเอกสาร การอบรม หรือหลักฐานด้านคุณภาพ สอบกลับไปยังเอกสารส่งมอบที่เป็นหลักฐานในคอลัมน์ "หลักฐานอื่น" แทน Software Unit',
         '## สรุปความครอบคลุม',
         table(['รายการ', 'จำนวน'], [
           ['ความต้องการของลูกค้าทั้งหมด (CR01–CR14)', CRS.length],
           ['เชื่อมโยงกับความต้องการซอฟต์แวร์ (SRS)', CRS.length],
-          ['เชื่อมโยงกับ Software Unit', CRS.length],
-          ['เชื่อมโยงกับ Test Case', CRS.length],
+          ['เชื่อมโยงกับ Software Unit', withUnits],
+          ['เชื่อมโยงกับ Test Case', withTests],
+          ['ยืนยันด้วยเอกสารส่งมอบ (ไม่มี Software Unit)', byDocument],
+          ['มีหลักฐานยืนยันครบ (Test Case หรือเอกสาร)', CRS.length],
           ['ความต้องการซอฟต์แวร์ทั้งหมด (SR01–SR09)', SRS.length],
           ['Software Unit ทั้งหมด', UNITS.length],
           ['Test Case ทั้งหมด', TEST_CASES.length],
@@ -275,9 +299,11 @@ export function testCases() {
 /** 16. Test Report. */
 export function testReport() {
   const date = '2026-08-14';
-  const rows = CRS.map(([id, text], i) => {
+  const tested = CRS.filter(([id]) => traceOf(id).tcs.length);
+  const byDocument = CRS.length - tested.length;
+  const rows = tested.map(([id, text], i) => {
     const t = traceOf(id);
-    return [i + 1, t.tc, `ตรวจสอบ${unitTopic(t.un[0])}`, id, text, 'Passed', thRangeLong(TEST_FROM, TEST_TO)];
+    return [i + 1, t.tc, `ตรวจสอบ ${t.un.map(unitTopic).join(' / ')}`, id, text, 'Passed', thRangeLong(TEST_FROM, TEST_TO)];
   });
   return {
     dir: '2-SI Process (12 Work Product)/16.Test Report',
@@ -312,6 +338,7 @@ export function testReport() {
         ], ['', 'r']),
         '## Verification Items',
         table(['No', 'Test Case', 'Software Testing', 'Customer Req. ID', 'Customer Req. Topic', 'Status', 'Test Date'], rows, ['c', 'c', '', 'c', '', 'c', 'c']),
+        `ความต้องการที่ยืนยันด้วย Test Case มี ${tested.length} รายการ ส่วนอีก ${byDocument} รายการเป็นความต้องการด้านเอกสาร การอบรม และหลักฐานด้านคุณภาพ ซึ่งยืนยันด้วยเอกสารส่งมอบตามที่ระบุใน Traceability Record และได้รับการยืนยันจากลูกค้าใน Validation Results`,
         '## Summary',
         table(['No', 'Topic', 'Detail'], [
           [1, 'Test Case', `ทดสอบตาม Customer Requirements ผ่านทั้งหมด ${TEST_CASES.length} Test Case คิดเป็น 100%`],
@@ -358,7 +385,7 @@ export function software() {
           [1, 'Source Code และ Baseline', `Commit \`${BASELINE_COMMIT}\` ควบคุมใน Repository หลักและสำรอง`],
           [2, 'ชุดติดตั้งระบบ', 'Docker Compose Stack และสคริปต์ `setup.php` สำหรับสร้างฐานข้อมูล'],
           [3, 'ผลการทดสอบระบบ', `Test Report ${TEST_CASES.length} Test Case ผ่านทั้งหมด`],
-          [4, 'ผลการทดสอบการยอมรับ', 'Validation Results 12 สถานการณ์ ผ่านทั้งหมด'],
+          [4, 'ผลการทดสอบการยอมรับ', `Validation Results ครบ 14 หมวด ${CRS.length} รายการ ผ่านทั้งหมด`],
           [5, 'การตรวจรับส่งมอบ', `Acceptance Report ผลการตรวจรับ Accepted เมื่อ ${thLong(ACCEPT_DATE)}`],
           [6, 'คู่มือประกอบการใช้งาน', 'Software User Document, Product Operation Guide, Maintenance Document'],
         ], ['c']),