# 🎓 ระบบสอบออนไลน์ (ASL Online Exam System)

# 🇹🇭 ภาษาไทย (Thai Version)

## 👥 กลุ่มผู้ใช้งาน (User Roles)

ระบบนี้มี 2 กลุ่มผู้ใช้หลัก:

### 1. 👨‍🏫 ครูผู้สอน (Teachers)

แบ่งเป็น 2 ระดับ:

- **ผู้ดูแลระบบ (Admin)**: จัดการข้อสอบทั้งหมด จัดการผู้ใช้งาน และดูผลการสอบทั้งหมด

- **ครูทั่วไป**: จัดการข้อสอบของตนเอง และดูผลการสอบของข้อสอบที่ตนเองสร้าง

### 2. 🎓 นักเรียน (Students)

- ทำข้อสอบที่เปิดให้ระดับชั้นของตนเอง

- ดูผลการสอบและประวัติการสอบย้อนหลัง

- ตรวจสอบเฉลยหลังทำข้อสอบเสร็จ

---

## 🎯 คุณสมบัติหลัก (Key Features)

### สำหรับครู (For Teachers)

1. **📚 การจัดการข้อสอบ**

   - สร้างข้อสอบพร้อมกำหนดเวลาและคะแนนผ่าน

   - กำหนดช่วงเวลาเปิด-ปิดการทำข้อสอบ

   - จำกัดให้เฉพาะระดับชั้น/ห้องที่กำหนดทำได้

   - สลับลำดับคำถามอัตโนมัติ

2. **📝 การจัดการคำถาม**

   - เพิ่มคำถามแบบปรนัย 4 ตัวเลือก (A, B, C, D)

   - แนบรูปภาพประกอบคำถาม

   - อัพโหลดคำถามแบบกลุ่มผ่านไฟล์ CSV

3. **📊 การตรวจสอบผล**

   - ดูคะแนนและสถิติแบบเรียลไทม์

   - กรองผลตามระดับชั้น ห้อง หรือชื่อนักเรียน

   - ส่งออกผลเป็นไฟล์ CSV

   - ตรวจสอบการละเมิดกฎการสอบ

4. **👥 การจัดการนักเรียน (เฉพาะผู้ดูแลระบบ)**

   - เพิ่ม/แก้ไข/ลบบัญชีนักเรียน

   - ลงทะเบียนนักเรียนแบบกลุ่มผ่านไฟล์ CSV

   - กำหนดระดับชั้นและห้องให้นักเรียน

### สำหรับนักเรียน (For Students)

1. **📝 การทำข้อสอบ**

   - เข้าทำข้อสอบที่เปิดให้ระดับชั้นของตนเอง

   - ดูจับเวลาถอยหลังแบบเรียลไทม์

   - ติดตามความคืบหน้าการตอบคำถาม

   - บันทึกคำตอบอัตโนมัติ

2. **📈 การดูผลการสอบ**

   - ดูคะแนนเปอร์เซ็นต์และผลผ่าน/ไม่ผ่าน

   - ตรวจสอบจำนวนข้อที่ตอบถูก/ผิด

   - ดูเฉลยและอธิบายคำตอบที่ถูกต้อง

   - ดูประวัติการสอบย้อนหลังทั้งหมด

---

## 🛡️ ระบบป้องกันการโกง (Anti-Cheat System)

ระบบนี้มีฟีเจอร์ป้องกันการโกงอัตโนมัติ:

1. **🚫 ห้ามคลิกขวา (Disable Right-Click)**

   - ป้องกันการเปิดเมนูคลิกขวาเพื่อคัดลอกคำถาม

2. **📋 ห้ามคัดลอก/วาง (Disable Copy/Paste)**

   - บล็อก Ctrl+C, Ctrl+V, Ctrl+X, Ctrl+A

   - บล็อกการคัดลอกข้อความบนอุปกรณ์มือถือ

3. **🔄 ตรวจจับการสลับหน้าจอ (Tab Switch Detection)**

   - นับจำนวนครั้งที่สลับไปแอปอื่นหรือแท็บอื่น

   - ส่งข้อสอบอัตโนมัติเมื่อเกินจำนวนครั้งที่กำหนด (ค่าเริ่มต้น 3 ครั้ง)

   - แจ้งเตือนก่อนส่ง 5 วินาที

4. **🖥️ โหมดเต็มหน้าจอ (Fullscreen Mode)**

   - ขยายหน้าจอเต็มจอเมื่อเริ่มทำข้อสอบ

   - แจ้งเตือนหากออกจากโหมดเต็มจอ

5. **⚠️ บันทึกการละเมิด (Violation Logging)**

   - บันทึกทุกการละเมิดลงฐานข้อมูล

   - แสดงจำนวนครั้งที่ละเมิดในผลการสอบ

   - ครูสามารถตรวจสอบประวัติการละเมิดได้

---

## 📖 วิธีใช้งานสำหรับครู (How to Use - Teachers)

### ขั้นตอนที่ 1: เข้าสู่ระบบ

1. เปิดเบราว์เซอร์และเข้าไปที่ลิงก์ระบบ https://exam.asl.ac.th/

2. ใส่ชื่อผู้ใช้และรหัสผ่านที่ได้รับ

3. คลิก "เข้าสู่ระบบ"

### ขั้นตอนที่ 2: สร้างข้อสอบ

1. คลิก "จัดการข้อสอบ" ในเมนู

2. คลิกปุ่ม "สร้างข้อสอบใหม่"

3. กรอกข้อมูล:

   - ชื่อข้อสอบ

   - คำอธิบาย (ถ้ามี)

   - จำกัดเวลา (นาที)

   - คะแนนผ่าน (%)

   - วันเวลาเปิด-ปิด

   - ระดับชั้นที่เปิดให้ทำ

4. ตั้งค่าการป้องกันการโกงตามต้องการ

5. คลิก "สร้างข้อสอบ"

### ขั้นตอนที่ 3: เพิ่มคำถาม

1. ในหน้ารายการข้อสอบ คลิก "จัดการคำถาม"

2. คลิก "เพิ่มคำถาม"

3. กรอก:

   - คำถาม

   - ตัวเลือก A, B, C, D

   - เลือกคำตอบที่ถูกต้อง

   - URL รูปภาพ (ถ้ามี)

4. คลิก "เพิ่มคำถาม" หรือ "บันทึกการเปลี่ยนแปลง"

### ขั้นตอนที่ 4: ดูผลการสอบ

1. คลิก "ผลการสอบ" ในเมนู

2. เลือกข้อสอบที่ต้องการดู (ถ้ามีหลายชุด)

3. กรองตามระดับชั้น ห้อง หรือชื่อนักเรียน

4. คลิก "ส่งออก CSV" เพื่อดาวน์โหลดไฟล์ผลการสอบ

---

## 📖 วิธีใช้งานสำหรับนักเรียน (How to Use - Students)

### ขั้นตอนที่ 1: ลงทะเบียน / เข้าสู่ระบบ

**สำหรับนักเรียนที่ยังไม่มีบัญชี:**

1. คลิก "ลงทะเบียน" ในหน้าเข้าสู่ระบบ

2. กรอกข้อมูล:

   - ชื่อผู้ใช้

   - รหัสผ่าน

   - ชื่อ-นามสกุล

   - อีเมล (ถ้ามี)

   - ระดับชั้น (ม.1-ม.6)

   - ห้องเรียน

   - เลขที่

3. คลิก "ลงทะเบียน"

**สำหรับนักเรียนที่มีบัญชีแล้ว:**

1. ใส่ชื่อผู้ใช้และรหัสผ่าน

2. คลิก "เข้าสู่ระบบ"

### ขั้นตอนที่ 2: ทำข้อสอบ

1. ในแผงควบคุม จะแสดงข้อสอบที่เปิดให้ทำ

2. คลิก "เริ่มทำข้อสอบ"

3. อ่านคำเตือนและคลิก "เข้าสู่โหมดสอบ"

4. ตอบคำถามทีละข้อ:

   - เลือกตัวเลือก A, B, C หรือ D

   - คำตอบจะบันทึกอัตโนมัติ

5. ติดตามเวลาที่เหลือด้านบนหน้าจอ

6. ตรวจสอบความคืบหน้าด้านล่าง

**⚠️ คำเตือนสำคัญ:**

- ห้ามสลับไปแอปอื่นหรือแท็บอื่น

- ห้ามคลิกขวาหรือคัดลอกข้อความ

- หากทำผิดกฎเกิน 3 ครั้ง ข้อสอบจะถูกส่งอัตโนมัติ

### ขั้นตอนที่ 3: ส่งข้อสอบ

- **ส่งก่อนหมดเวลา**: คลิก "ส่งข้อสอบ" แล้วยืนยัน

- **หมดเวลา**: ระบบจะส่งอัตโนมัติ

- **ละเมิดกฎ**: ระบบจะส่งอัตโนมัติและบันทึกการละเมิด

### ขั้นตอนที่ 4: ดูผลการสอบ

1. หลังส่งข้อสอบ ระบบจะแสดงผลทันที

2. หรือคลิก "ผลการสอบ" ในเมนูเพื่อดูประวัติ

3. คลิก "ดูรายละเอียด" เพื่อดูเฉลยและคำอธิบาย

---

## 💡 เคล็ดลับการใช้งาน (Tips)

### สำหรับครู

- ทดสอบข้อสอบก่อนเปิดให้นักเรียนทำจริง

- ตั้งค่าเวลาให้เหมาะสมกับจำนวนข้อ

- ตรวจสอบการตั้งค่าระดับชั้นให้ถูกต้อง

- ดูผลสถิติเพื่อวิเคราะห์จุดอ่อนของนักเรียน

### สำหรับนักเรียน

- ตรวจสอบอุปกรณ์และอินเทอร์เน็ตก่อนทำข้อสอบ

- อย่าพยายามสลับหน้าจอหรือคัดลอกข้อความ

- จัดสรรเวลาให้เหมาะสมกับจำนวนข้อ

- ตรวจสอบคำตอบก่อนส่งหากมีเวลาเหลือ

---

## ⚠️ ข้อควรระวัง (Important Notes)

1. **การสอบจริงควร:**

   - ใช้อุปกรณ์ที่เชื่อถือได้

   - เชื่อมต่ออินเทอร์เน็ตที่เสถียร

   - ไม่เปิดแอปพลิเคชันอื่นระหว่างสอบ

2. **หากเกิดปัญหา:**

   - อย่ากดรีเฟรชหน้าจอระหว่างทำข้อสอบ

   - แจ้งครูผู้คุมสอบทันที

   - หากถูกตัดคะแนนจากการละเมิดกฎ ไม่สามารถยื่นอุทธรณ์ได้

# 🇬🇧 English Version

## 👥 User Roles

This system has 2 main user groups:

### 1. 👨‍🏫 Teachers

Divided into 2 levels:

- **Administrator (Admin)**: Manage all exams, manage users, and view all exam results

- **Regular Teachers**: Manage their own exams and view results for exams they created

### 2. 🎓 Students

- Take exams open to their grade level

- View exam results and exam history

- Check answers after completing exams

---

## 🎯 Key Features

### For Teachers

1. **📚 Exam Management**

   - Create exams with time limits and passing scores

   - Set exam open/close time periods

   - Restrict to specific grade levels/classes

   - Automatic question shuffling

2. **📝 Question Management**

   - Add multiple-choice questions with 4 options (A, B, C, D)

   - Attach images to questions

   - Bulk upload questions via CSV file

3. **📊 Results Checking**

   - View scores and statistics in real-time

   - Filter results by grade, class, or student name

   - Export results to CSV file

   - Check exam violation records

4. **👥 Student Management (Admin Only)**

   - Add/edit/delete student accounts

   - Bulk student registration via CSV file

   - Assign grade levels and classes to students

### For Students

1. **📝 Taking Exams**

   - Take exams open to their grade level

   - Real-time countdown timer

   - Track answering progress

   - Automatic answer saving

2. **📈 Viewing Results**

   - View percentage scores and pass/fail status

   - Check number of correct/incorrect answers

   - View answers and correct explanations

   - View complete exam history

---

## 🛡️ Anti-Cheat System

This system includes automatic cheating prevention features:

1. **🚫 Disable Right-Click**

   - Prevents opening context menu to copy questions

2. **📋 Disable Copy/Paste**

   - Blocks Ctrl+C, Ctrl+V, Ctrl+X, Ctrl+A

   - Blocks text copying on mobile devices

3. **🔄 Tab Switch Detection**

   - Counts times switching to other apps or tabs

   - Auto-submits exam when exceeding allowed times (default 3 times)

   - Shows 5-second warning before submission

4. **🖥️ Fullscreen Mode**

   - Expands to fullscreen when starting exam

   - Warns if exiting fullscreen mode

5. **⚠️ Violation Logging**

   - Records every violation to database

   - Shows violation count in exam results

   - Teachers can check violation history

---

## 📖 How to Use - For Teachers

### Step 1: Login

1. Open browser and go to the system link https://exam.asl.ac.th/

2. Enter username and password provided

3. Click "Login"

### Step 2: Create an Exam

1. Click "Manage Exams" in the menu

2. Click "Create New Exam" button

3. Fill in information:

   - Exam name

   - Description (if any)

   - Time limit (minutes)

   - Passing score (%)

   - Open/close date and time

   - Grade levels allowed

4. Set anti-cheat settings as needed

5. Click "Create Exam"

### Step 3: Add Questions

1. In exam list, click "Manage Questions"

2. Click "Add Question"

3. Fill in:

   - Question text

   - Options A, B, C, D

   - Select correct answer

   - Image URL (if any)

4. Click "Add Question" or "Save Changes"

### Step 4: Check Results

1. Click "Exam Results" in menu

2. Select exam to view (if multiple)

3. Filter by grade, class, or student name

4. Click "Export CSV" to download results file

---

## 📖 How to Use - For Students

### Step 1: Register / Login

**For students without an account:**

1. Click "Register" on login page

2. Fill in information:

   - Username

   - Password

   - Full name

   - Email (if any)

   - Grade level (M.1-M.6)

   - Classroom

   - Student number

3. Click "Register"

**For students with existing account:**

1. Enter username and password

2. Click "Login"

### Step 2: Take an Exam

1. On dashboard, exams available will be shown

2. Click "Start Exam"

3. Read warning and click "Enter Exam Mode"

4. Answer questions one by one:

   - Select option A, B, C, or D

   - Answers save automatically

5. Monitor remaining time at top of screen

6. Check progress at bottom

**⚠️ Important Warning:**

- Do not switch to other apps or tabs

- Do not right-click or copy text

- If violating rules more than 3 times, exam will auto-submit

### Step 3: Submit Exam

- **Submit before time ends**: Click "Submit Exam" and confirm

- **Time runs out**: System auto-submits

- **Rule violation**: System auto-submits and records violation

### Step 4: View Results

1. After submitting, results show immediately

2. Or click "Exam Results" in menu to view history

3. Click "View Details" to see answers and explanations

---

## 💡 Usage Tips

### For Teachers

- Test exam before opening to students

- Set appropriate time for number of questions

- Double-check grade level settings

- View statistics to analyze student weak points

### For Students

- Check device and internet before exam

- Don't try to switch screens or copy text

- Allocate time appropriately for number of questions

- Review answers before submitting if time remains

---

## ⚠️ Important Notes

1. **For actual exams:**

   - Use reliable devices

   - Connect to stable internet

   - Don't open other applications during exam

2. **If problems occur:**

   - Don't refresh screen during exam

   - Notify exam supervisor immediately

   - If points deducted for rule violations, cannot appeal