คู่มือการใช้งานระบบเช็คแถวหน้าเสาธง
และกำกับติดตามการปฏิบัติหน้าที่ครูที่ปรึกษา

สารบัญเนื้อหาเชิงลึก (Table of Contents)

บทที่ 1: สถาปัตยกรรมระบบ โครงสร้างฐานข้อมูล และระบบสิทธิ์

1.1 ภาพรวมและวัตถุประสงค์ของการพัฒนาโมดูลหน้าเสาธง

ระบบเช็คแถวหน้าเสาธงและกำกับติดตามการปฏิบัติหน้าที่ครูที่ปรึกษา ได้รับการออกแบบขึ้นเพื่อเป็นแพลตฟอร์มสารสนเทศระดับองค์กร (Enterprise Web Application) ในการบันทึก รวบรวม ประมวลผล และรายงานผลสัมฤทธิ์กิจกรรมหน้าเสาธงของนักเรียนนักศึกษา ตลอดจนการกำกับดูแลวินัยการปฏิบัติหน้าที่ของครูที่ปรึกษาประจำกลุ่มเรียน ให้เป็นไปตามเกณฑ์มาตรฐานของสำนักงานคณะกรรมการการอาชีวศึกษา (สอศ.)

ระบบช่วยลดภาระงานเอกสารกระดาษ (Paperless Workflow) เพิ่มความโปร่งใส ป้องกันข้อผิดพลาดในการคำนวณร้อยละการเข้าแถว และมีระบบแจ้งเตือนเชิงรุก (Early Warning Dashboard) ช่วยให้ผู้บริหารสถานศึกษา หัวหน้าแผนกวิชา และครูที่ปรึกษา สามารถมองเห็นสถิตินักเรียนกลุ่มเสี่ยงที่อาจไม่ผ่านกิจกรรมเข้าแถวก่อนสิ้นภาคการศึกษาได้อย่างทันท่วงที

1.2 สถาปัตยกรรมฐานข้อมูลความสัมพันธ์ (Relational Schema & Auto-Fix)

ระบบใช้ระบบจัดการฐานข้อมูล MySQL/MariaDB โดยมีกลไก Auto-Fix Self-Healing Schema ที่ทำงานทันทีเมื่อไฟล์ถูกโหลด หากตารางหรือฟิลด์ที่จำเป็นยังไม่ถูกสร้างในฐานข้อมูล ระบบจะสร้างขึ้นให้อัตโนมัติ ป้องกันปัญหา Database Missing หรือ Script Crash

1.3 ตารางการกำหนดสิทธิ์ผู้ใช้งาน (Access Control List Matrix)

ระบบจำแนกผู้ใช้งานออกเป็น 4 ระดับสิทธิ์หลัก เพื่อให้การเข้าถึงข้อมูลสอดคล้องกับระเบียบว่าด้วยการรักษาความลับและความปลอดภัยของข้อมูลนักศึกษา โดยมีการตรวจสอบระดับสิทธิ์แบบ Server-Side Session Validation อย่างเข้มงวด

บทที่ 2: โมดูลแดชบอร์ดสถิติและการวิเคราะห์เชิงลึก (Tab 0)

2.1 กลไกการคำนวณและประมวลผลดัชนีชี้วัด (KPIs Metrics Engine)

หน้าจอแดชบอร์ดเชิงลึกทำหน้าที่เป็นศูนย์กลางการประมวลผลข้อมูล (Data Analytics Center) โดยประมวลผลข้อมูลการเช็คแถวแบบเรียลไทม์ แบ่งออกเป็นตัวชี้วัดหลัก 2 แถว ดังนี้:

แถวที่ 1 (Macro Infrastructure KPIs): แสดงจำนวนทรัพยากรทั้งหมดในระบบ ได้แก่ จำนวนนักเรียนทั้งหมด (คน), จำนวนครูที่ปรึกษาที่ลงทะเบียน (ท่าน) และจำนวนกลุ่มเรียนที่เปิดในภาคเรียน (กลุ่ม)

แถวที่ 2 (Daily Operational KPIs): แสดงสถิติการเช็คชื่อประจำวันที่เลือก ได้แก่ จำนวนครั้งที่มาเรียน, ขาดเรียน, มาสาย, ลา/กิจกรรม ตลอดจนจำนวนนักศึกษาที่ผ่านเกณฑ์ประเมินสะสม (≥80%) และไม่ผ่านเกณฑ์ (<80%)

2.2 การแจกแจงนักเรียนกลุ่มเสี่ยง (At-Risk Early Warning System)

ระบบ Early Warning คัดกรองรายชื่อนักเรียนที่มีพฤติกรรมขาดแถวหรือมาสายเกินกว่าเกณฑ์ปกติ โดยระบบจะจัดเข้าสู่ "ตารางนักเรียนกลุ่มเสี่ยง (At-Risk Table)" โดยอัตโนมัติ ตามเงื่อนไขทางคณิตศาสตร์สถิติ:

ตารางนี้จะเรียงลำดับจากผู้ที่มีสถิติขาดเรียนมากที่สุดขึ้นก่อน เพื่อให้ครูที่ปรึกษาและฝ่ายปกครองสามารถคลิกปุ่ม "ดูประวัติ (Timeline Drill-Down)" เพื่อตรวจสอบพฤติกรรมย้อนหลังรายวัน พร้อมแสดงหลักฐานว่าขาดแถวในวันที่ใดบ้าง

2.3 ตารางสรุปภาพรวมผู้บริหาร (Executive Summary & Timeline Drill-Down)

ตารางสรุปผลรายกลุ่มเรียน (Executive Summary Table) ออกแบบมาเพื่อให้ผู้บริหารระดับสูงมองเห็นภาพรวมในระดับมหภาค โดยสรุปยอดสะสมของแต่ละกลุ่มเรียน พร้อมแถบกราฟแสดงสัดส่วน (Progress Bar) ที่แยกสีตามสถานะ เขียว (มา), แดง (ขาด), ส้ม (สาย) และ ฟ้า (ลา) ทำให้สามารถเปรียบเทียบความมีวินัยของแต่ละกลุ่มเรียนได้อย่างชัดเจน

ระบบแบ่งหน้าและการค้นหาทันที (Instant Search & Pagination):
ตารางข้อมูลสรุปมีสคริปต์ JavaScript ประจำหน้าจอ จัดการแบ่งหน้าแสดงผลละ 5 แถว พร้อมปุ่มเลื่อนหน้าแบบตัวเลข ช่วยให้หน้าจอโหลดได้รวดเร็วแม้มีกลุ่มเรียนมากกว่า 100 กลุ่มในระบบ พร้อมช่องค้นหาที่กรองข้อมูลทันทีโดยไม่ต้องโหลดหน้าเว็บใหม่

บทที่ 3: ระบบบริหารจัดการกลุ่มเรียนและการมอบหมายครู (Tab 1)

3.1 การจับคู่ครูที่ปรึกษาและการจัดตั้งกลุ่มเรียนรายภาคเรียน

กลุ่มเรียนคือหน่วยอ้างอิงหลักในการแบ่งกลุ่มนักศึกษาเพื่อการเช็คชื่อหน้าเสาธง โดยในแท็บ **1. จัดการกลุ่มเรียน** ผู้ดูแลระบบสามารถสร้างรหัสกลุ่มเรียนใหม่ และมอบหมายครูที่ปรึกษาผู้รับผิดชอบได้อย่างเป็นอิสระ

3.2 ขั้นตอนการนำเข้าข้อมูลกลุ่มเรียนด้วย CSV Bulk Import

กรณีที่มีกลุ่มเรียนจำนวนมากในช่วงเปิดภาคการศึกษาใหม่ การพิมพ์สร้างทีละกลุ่มอาจใช้เวลานาน ระบบจึงจัดเตรียมโมดูล "นำเข้ากลุ่มเรียนผ่าน CSV" ซึ่งรองรับการอัปโหลดไฟล์ตารางข้อมูลครั้งเดียวทั้งสถานศึกษา

// ตัวอย่างโครงสร้างไฟล์ sample_groups.csv
รหัสกลุ่มเรียน
สทด. 1/1
สทด. 1/2
สบค. 1/1
ชย. 1/1
ชฟ. 1/1

บทที่ 4: ระบบบัญชีครูที่ปรึกษาและโครงสร้างสาขาวิชา (Tab 2)

4.1 การสร้างบัญชีผู้ใช้งานครูที่ปรึกษาและการกำหนดรหัสผ่าน

การกำกับดูแลการปฏิบัติหน้าที่อย่างถูกต้องจำเป็นต้องมีการลงทะเบียนบัญชีครูที่ปรึกษาเข้าสู่ระบบอย่างเป็นทางการ ในแท็บ **2. บัญชีครูที่ปรึกษา** ผู้ดูแลระบบสามารถสร้างบัญชีรายบุคคล กำหนดชื่อผู้ใช้ (Username) รหัสผ่าน (Password) ชื่อ-สกุลจริง และสังกัดสาขาวิชา

มาตรฐานความปลอดภัยด้านรหัสผ่าน (Cryptographic Hashing):
ระบบเข้ารหัสผ่านของครูด้วยฟังก์ชัน password_hash($password, PASSWORD_DEFAULT) โดยใช้อัลกอริทึม Bcrypt ที่มีความปลอดภัยสูง แม้ฐานข้อมูลจะถูกสำรองออกไป ผู้ไม่ประสงค์ดีจะไม่สามารถอ่านรหัสผ่านจริงได้

4.2 ระบบบริหารจัดการสาขาวิชา (เพิ่ม ลบ แก้ไขชื่อสาขาวิชา)

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

4.3 กลไกการดีดครูออกจากสาขาวิชา (Unlink & Eject Functionality)

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

UPDATE users SET department = '' WHERE id = ?

บทที่ 5: ฐานข้อมูลนักเรียนหน้าเสาธงและการคัดกรองข้อมูล (Tab 3)

5.1 การบันทึกรายชื่อนักเรียนรายบุคคลและการจัดกลุ่ม

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

5.2 การนำเข้าฐานข้อมูลระดับสถานศึกษาผ่าน CSV ป้องกันรหัสซ้ำ

การนำเข้าข้อมูลนักเรียนทั้งสถานศึกษา (1,000 - 3,000 คน) ดำเนินการผ่านไฟล์ CSV ได้อย่างรวดเร็ว โดยระบบมีสถาปัตยกรรม Upsert Engine (ON DUPLICATE KEY UPDATE) ที่ตรวจจับรหัสนักศึกษา หากรหัสมีอยู่แล้วจะทำการอัปเดตชื่อและกลุ่มเรียนให้อัตโนมัติ โดยไม่เกิดข้อผิดพลาดฐานข้อมูลล่ม

// คำสั่ง SQL ที่ทำงานเบื้องหลังการนำเข้า CSV
INSERT INTO flag_students (student_code, fullname, class_group) 
VALUES (?, ?, ?) 
ON DUPLICATE KEY UPDATE 
    fullname = VALUES(fullname), 
    class_group = VALUES(class_group);

5.3 ระบบความปลอดภัยในการเคลียร์ข้อมูลรายกลุ่มและการล้างฐานข้อมูล

เมื่อสิ้นสุดปีการศึกษาหรือมีการปรับปรุงข้อมูลครั้งใหญ่ ระบบมีโมดูลสำหรับการเคลียร์ข้อมูล 2 ระดับ พร้อมระบบกล่องข้อความยืนยัน 2 ชั้น (Two-Tier Confirmation Dialog) เพื่อป้องกันความผิดพลาดจากการกดปุ่มโดยไม่ตั้งใจ:

บทที่ 6: ระบบเช็คปฏิบัติหน้าที่ครูที่ปรึกษาลงแถว (Tab 4)

6.1 หน้าจอการเช็คแถวแบบแยกตามสาขาวิชาและการค้นหาแบบเรียลไทม์

แท็บ **4. เช็คปฏิบัติหน้าที่ครู** คือโมดูลสำคัญที่เปิดสิทธิ์ให้ทั้ง admin และ staff สามารถกำกับดูแลการปฏิบัติหน้าที่ลงแถวของครูที่ปรึกษาประจำวัน โดยระบบจะจัดกลุ่มครูแยกตาม "สาขาวิชา" อย่างชัดเจน ทำให้ผู้ตรวจแถวสามารถตรวจเช็คครูตามจุดรวมพลของแต่ละแผนกวิชาได้อย่างสะดวก รวดเร็ว

6.2 กลไกการบันทึกสถานะปฏิบัติหน้าที่ผ่าน AJAX Instant Sync

การบันทึกสถานะของครูแต่ละท่าน (มา, ขาด, สาย, ลา) ขับเคลื่อนด้วยสถาปัตยกรรม **AJAX Asynchronous Request** เมื่อผู้ตรวจคลิกเลือกปุ่มสถานะ ระบบจะส่งข้อมูลไปยังเซิร์ฟเวอร์ในเบื้องหลังทันที และตอบสนองกลับมาในเวลาไม่เกิน 0.2 วินาที พร้อมเอฟเฟกต์สีเขียวอ่อนกระพริบ (Visual Flash Feedback) ที่ตัวการ์ด เพื่อยืนยันว่าข้อมูลถูกบันทึกลงฐานข้อมูลเรียบร้อยแล้ว

// โค้ด JavaScript เบื้องหลังการทำงานของระบบบันทึกแบบ AJAX
function saveTeacherDuty(teacherId, status) {
    let formData = new FormData();
    formData.append('action', 'save_teacher_duty');
    formData.append('teacher_id', teacherId);
    formData.append('status', status);
    formData.append('check_date', checkDate);

    fetch('', { method: 'POST', body: formData })
    .then(res => res.json())
    .then(data => {
        if(data.status === 'success') {
            let card = document.getElementById('teacher_card_' + teacherId);
            card.style.backgroundColor = '#f1f8e9'; // แสดงไฟเขียวตอบรับ
            setTimeout(() => { card.style.backgroundColor = '#fff'; }, 400);
        }
    });
}

6.3 ระบบเคลียร์ข้อมูลการเช็คชื่อครู (เคลียร์รายวัน vs เคลียร์ทั้งหมด)

เพื่อความสะดวกในการบริหารจัดการข้อมูลการลงเวลาปฏิบัติหน้าที่ของครู ระบบได้จัดเตรียมปุ่มเคลียร์ข้อมูลไว้ 2 ระดับ ติดตั้งอยู่บริเวณมุมขวาบนของแท็บ 4 ถัดจากปุ่มรายงานปฏิบัติหน้าที่ครู:

บทที่ 7: ระบบรายงานเอกสารราชการและการนำข้อมูลออก (Export Hub)

7.1 บันทึกข้อความราชการสรุปผลการเข้าแถวนักเรียน (ตามระเบียบงานสารบรรณ)

ระบบมีเทมเพลตเอกสาร **บันทึกข้อความราชการ** ในตัว จัดหน้าและรูปแบบตามระเบียบสำนักนายกรัฐมนตรีว่าด้วยงานสารบรรณ พร้อมตราครุฑทางการขนาดมาตรฐาน การแบ่งส่วนราชการ ที่หนังสือ วันที่ และเนื้อความสรุปยอดนักเรียนทั้งหมด ยอดมา ขาด สาย ลา และยอดผู้ผ่าน/ไม่ผ่านเกณฑ์ เพื่อนำเสนอต่อผู้อำนวยการวิทยาลัยเทคนิคอำนาจเจริญ

7.2 บันทึกข้อความสรุปผลการปฏิบัติหน้าที่ครูที่ปรึกษาและคิดร้อยละสะสม

เมื่อคลิกปุ่ม "รายงานปฏิบัติหน้าที่ครู" ในแท็บ 4 ระบบจะเปิดหน้าต่างรายงานสรุปเฉพาะของครูขึ้นมา โดยระบบจะประมวลผลข้อมูลเชิงลึกเฉพาะตัวของครูแต่ละท่าน ประกอบด้วย สถิติมา ขาด สาย ลา รวมจำนวนครั้งที่บันทึก และคำนวณ "ร้อยละผลการปฏิบัติหน้าที่สะสม" พร้อมระบุผลการประเมินว่า "ผ่านเกณฑ์" (≥80%) หรือ "ต้องปรับปรุง" (<80%)

7.3 สถาปัตยกรรมการส่งออกข้อมูลแบบแยกส่วนอิสระ (PDF / Word / CSV)

ระบบได้รับการปรับปรุงสถาปัตยกรรมการพิมพ์และส่งออกข้อมูลใหม่ โดยแยกกลไกการออกรายงานนักเรียน และรายงานครูที่ปรึกษาออกจากกันอย่างเด็ดขาด ป้องกันไม่ให้ข้อมูลของนักเรียนและครูปะปนกันในไฟล์เดียว:

บทที่ 8: แนวทางแก้ไขปัญหาและบำรุงรักษาเชิงเทคนิค (Troubleshooting)

8.1 ข้อผิดพลาดที่พบบ่อยและแนวทางแก้ไขทันที (Quick Fixes)

8.2 วงรอบการสำรองข้อมูล (Database Backup Routine)

ผู้ดูแลระบบควรสำรองข้อมูลฐานข้อมูล MySQL เป็นประจำทุกสัปดาห์ หรือก่อนการกดปุ่มเคลียร์ข้อมูล โดยสามารถใช้คำสั่งผ่าน Terminal บนเซิร์ฟเวอร์ Ubuntu:

# คำสั่งสำรองฐานข้อมูลระบบหน้าเสาธง
mysqldump -u root -p database_name flag_groups flag_students \
flag_attendance_log flag_teacher_duty_log flag_departments > backup_flag_system.sql