add: useCase Example

Author: Zag5A6167

week3/LAB3_UseCaseExamples.md

@@ -1,167 +1,95 @@
-# ENGCE301 – LAB 3
-Use Case Examples (Short Version)
+## UC-01: View Activity History
 
-ใช้เป็นตัวอย่าง/แม่แบบให้นักศึกษาเขียน Use Case Scenario  
-จาก User Stories ของระบบ Lab Submission Portal
-
----
-
-## 1. Template – Use Case Scenario (สั้น)
-
-ให้นักศึกษาคัดลอก template นี้แล้วกรอกของตัวเอง
-
-```markdown
-## UC-XX: <ชื่อ Use Case>
-
-**Primary Actor:** <Student / Instructor / TA>  
-**Goal:** <เป้าหมายหลักที่ Actor ต้องการทำให้สำเร็จ>
+**Primary Actor:** Student
+**Goal:** ดูรายการกิจกรรมทั้งหมดที่เคยเข้าร่วมและชั่วโมงกิจกรรมที่ได้รับ
 
 ### Preconditions
-- เงื่อนไขที่ต้องเป็นจริงก่อนเริ่ม Use Case
+- Student ต้องเข้าสู่ระบบ (Authenticated) สำเร็จแล้ว
+- ระบบมีข้อมูลกิจกรรมที่ Student เคยเข้าร่วมอย่างน้อย 1 กิจกรรม
 
 ### Postconditions
-- เงื่อนไขที่ต้องเป็นจริงหลัง Use Case สำเร็จ
+- Student เห็นกิจกรรมที่เคยเข้าร่วมและชั่วโมงกิจกรรมที่ได้รับ พร้อมชั่วโมงสะสมรวม
 
 ### Main Flow (Happy Path)
-1. ...
-2. ...
-3. ...
-4. ...
+1. Student เลือกเมนูหรือกดปุ่ม **"ประวัติกิจกรรม / History"**
+2. ระบบดึงข้อมูลกิจกรรมทั้งหมดที่ Student เข้าร่วมสำเร็จแล้ว
+3. ระบบแสดงตารางหรือรายการกิจกรรม พร้อมรายละเอียด: ชื่อกิจกรรม, วันที่เข้าร่วม, ชั่วโมงกิจกรรมที่ได้รับ
+4. ระบบคำนวณและแสดง **ชั่วโมงกิจกรรมสะสมรวม** ท้ายตาราง
+5. Use Case จบลง
 
 ### Alternative Flows / Exceptions
-- **AF-1 – <ชื่อกรณีย่อย>**
-  1. ...
-  2. ...
-- **AF-2 – <ชื่อ error หรือกรณีพิเศษ>**
-  1. ...
-  2. ...
-```
+- **AF-1 – ไม่มีประวัติการเข้าร่วม**
+  1. ที่ขั้นตอน 2 ระบบไม่พบข้อมูลกิจกรรมที่ Student เคยเข้าร่วม
+  2. ระบบแสดงข้อความ **“คุณยังไม่เคยเข้าร่วมกิจกรรมใด ๆ”**
+  3. Use Case จบลง
+
+
 
----
 
-## 2. Example UC-01 – View Lab List
 
-**เชื่อมจาก:** US-01 View Lab List
 
-```markdown
-## UC-01: View Lab List
 
-**Primary Actor:** Student  
-**Goal:** ดูรายการ LAB ทั้งหมดของวิชา ENGCE301
+## UC-02: Propose New Activity
+
+**Primary Actor:** Member (Student / Staff)
+**Goal:** เสนอแบบฟอร์มขอจัดกิจกรรมเพื่อรอการอนุมัติจากผู้มีอำนาจ
 
 ### Preconditions
-- นักศึกษาเข้าหน้า Home ของ Portal ได้
-- มี LAB อย่างน้อย 1 รายการในระบบ
+- Member ต้องเข้าสู่ระบบ (Authenticated ด้วยบัญชีมหาวิทยาลัย)
 
 ### Postconditions
-- นักศึกษาเห็นรายการ LAB ทุกตัว พร้อมข้อมูลสำคัญ
+- ระบบบันทึกข้อเสนอจัดกิจกรรมพร้อมสถานะ **"Pending Approval"**
 
-### Main Flow
-1. นักศึกษาเปิดหน้า Home
-2. ระบบโหลดรายการ LAB ของวิชา ENGCE301
-3. ระบบแสดง list/card ของ LAB แต่ละตัว
-4. แต่ละ LAB แสดงชื่อ, คำอธิบายสั้น ๆ, deadline, สถานะ (Open/Closed)
-5. นักศึกษาตรวจดู LAB ที่ต้องทำ และเลือก LAB ที่สนใจ
+### Main Flow (Happy Path)
+1. Member เลือกเมนูหรือกดปุ่ม **"เสนอจัดกิจกรรม / Access Event"**
+2. ระบบแสดงแบบฟอร์มให้กรอกรายละเอียดข้อเสนอ (ชื่อ, วันที่, เป้าหมาย, ผู้เข้าร่วมที่คาดหวัง, ฯลฯ)
+3. Member กรอกข้อมูลที่จำเป็นทั้งหมด
+4. Member กดปุ่ม **"Submit Proposal"**
+5. ระบบตรวจสอบความสมบูรณ์ของข้อมูล และบันทึกข้อเสนอ
+6. ระบบแสดงข้อความยืนยัน **“เสนอกิจกรรมสำเร็จ รอการอนุมัติ”**
+7. Use Case จบลง (รอ Primary Actor ใน UC-03 มาดำเนินการต่อ)
 
-### Alternative Flow
-- **AF-1 – ไม่มี LAB ในระบบ**
-  1. ที่ขั้นตอน 2 ระบบไม่พบ LAB
-  2. ระบบแสดงข้อความ “ยังไม่มี LAB สำหรับรายวิชานี้”
-  3. Use Case จบลง
-```
+### Alternative Flows / Exceptions
+- **AF-1 – ข้อมูลฟอร์มไม่สมบูรณ์**
+  1. ที่ขั้นตอน 5, Member กรอกข้อมูลที่จำเป็น (Required Field) ไม่ครบถ้วน
+  2. ระบบแจ้งเตือนให้กรอกข้อมูลให้ครบถ้วน โดยเน้น Field ที่ขาดหายไป
+  3. กลับไปขั้นตอนที่ 3 เพื่อให้ Member แก้ไขข้อมูล
 
----
 
-## 3. Example UC-03 – Submit Lab
 
-**เชื่อมจาก:** US-03 Submit Lab File, US-05 Late Submission Notice
 
-```markdown
-## UC-03: Submit Lab
 
-**Primary Actor:** Student  
-**Goal:** ส่งไฟล์งาน LAB ผ่านระบบ
 
-### Preconditions
-- นักศึกษาเข้าถึงหน้ารายละเอียด LAB นั้นได้
-- LAB ยังเปิดรับส่ง (ตาม Policy ของรายวิชา)
+## UC-03: Approve Activity Proposal
 
-### Postconditions
-- ระบบบันทึกไฟล์และเวลาส่งงานของนักศึกษา
-- สถานะ LAB ของนักศึกษาคนนี้อัปเดต (Submitted หรือ Late)
-
-### Main Flow (ส่งตรงเวลา)
-1. นักศึกษาเปิดหน้า Lab Details
-2. ระบบแสดงส่วน “Submit Your Lab”
-3. นักศึกษากดเลือกไฟล์ (.pdf/.docx/.zip)
-4. ระบบตรวจสอบชนิดและขนาดไฟล์เบื้องต้น
-5. นักศึกษากดปุ่ม “Submit”
-6. ระบบบันทึกไฟล์และเวลาส่ง (timestamp)
-7. ระบบตรวจสอบว่าไม่เกิน deadline
-8. ระบบอัปเดตสถานะเป็น “Submitted”
-9. ระบบแสดงข้อความ “ส่งงานเรียบร้อยแล้ว”
-
-### Alternative Flows
-- **AF-1 – File Type ไม่ถูกต้อง**
-  1. เกิดจากขั้นตอน 4 เมื่อไฟล์ไม่ใช่ชนิดที่รองรับ
-  2. ระบบแจ้งเตือน “ชนิดไฟล์ไม่รองรับ”
-  3. กลับไปที่ขั้นตอน 3 ให้เลือกไฟล์ใหม่
-
-- **AF-2 – ส่งหลัง deadline (Late)**
-  1. ที่ขั้นตอน 7 ระบบพบว่าเวลาส่งเกิน deadline
-  2. ถ้า policy อนุญาต Late:
-     - ระบบบันทึกไฟล์
-     - ตั้งสถานะเป็น “Late”
-  3. นักศึกษาเห็นสถานะ Late ในหน้า My Labs
-
-- **AF-3 – ไม่อนุญาตส่งหลัง deadline**
-  1. ที่ขั้นตอน 7 หาก policy ไม่รับหลัง deadline
-  2. ระบบไม่บันทึก submission
-  3. ระบบแสดงข้อความ “หมดเขตส่งงานแล้ว”
-```
-
----
-
-## 4. Example UC-04 – View My Lab Status
-
-**เชื่อมจาก:** US-04 View My Lab Status
-
-```markdown
-## UC-04: View My Lab Status
-
-**Primary Actor:** Student  
-**Goal:** ดูภาพรวมสถานะ LAB ทั้งหมดของตัวเอง
+**Primary Actor:** Approver (University Official / Activity Chairman)
+**Goal:** ตรวจสอบข้อเสนอจัดกิจกรรมที่ถูกส่งเข้ามา และอนุมัติ/ปฏิเสธข้อเสนอนั้น
 
 ### Preconditions
-- นักศึกษาเข้าหน้า My Labs ได้
-- ระบบมีข้อมูล LAB ของวิชานี้สำหรับนักศึกษาคนนี้
+- Approver ต้องเข้าสู่ระบบ (Authenticated) และมีสิทธิ์ในการอนุมัติกิจกรรม
+- มีข้อเสนอจัดกิจกรรมที่สถานะ **"Pending Approval"** อย่างน้อย 1 รายการ
 
 ### Postconditions
-- นักศึกษาเห็นสถานะ (Not Submitted / Submitted / Graded / Late) ของทุก LAB
-
-### Main Flow
-1. นักศึกษาเปิดหน้า “My Labs”
-2. ระบบดึงข้อมูล LAB และสถานะของนักศึกษาแต่ละ LAB
-3. ระบบแสดงตารางหรือ card ของ LAB ทั้งหมด
-4. แต่ละแถว/การ์ดแสดงชื่อ LAB, สถานะ, คะแนน (ถ้ามี)
-5. นักศึกษาดูว่า LAB ไหนเสร็จแล้ว และ LAB ไหนยังต้องทำ
-
-### Alternative Flows
-- **AF-1 – ยังไม่เคยส่งงาน**
-  1. ระบบพบว่า LAB ทั้งหมดเป็นสถานะ Not Submitted
-  2. ระบบแสดงข้อความเสริม เช่น “คุณยังไม่ได้ส่ง LAB ใดเลย”
-
-- **AF-2 – มี LAB ที่ Late**
-  1. ระบบพบ LAB บางตัวที่ Late
-  2. แสดงสถานะ Late ด้วยสี/ป้ายชัดเจน (เช่น สีแดง)
-```
-
----
-
-## 5. งานที่นักศึกษาต้องทำต่อ
-
-1. เลือก Use Case ของกลุ่มเองอย่างน้อย 2–3 ตัว  
-   (อาจใช้ UC-01, UC-03, UC-04 เป็นฐาน แล้วเพิ่ม UC อื่น)
-2. คัดลอก Template ในหัวข้อ 1 ไปใช้เขียน Use Case Scenario ของกลุ่ม  
-3. ตรวจว่า Use Case ที่เขียนสอดคล้องกับ User Stories ในไฟล์ `LAB3_UserStories.md`
-4. นำ Main Flow + Alternative Flows ไปช่วยออกแบบโครงหน้า HTML/CSS
+- สถานะกิจกรรมเปลี่ยนเป็น **"Approved"** หรือ **"Rejected"**
+- ระบบบันทึกการตัดสินใจพร้อมเหตุผล/Feedback (ถ้ามี)
+
+### Main Flow (Happy Path: อนุมัติ)
+1. Approver เลือกเมนู **"ตรวจสอบข้อเสนอ / Event Submission"**
+2. ระบบแสดงรายการข้อเสนอที่สถานะ "Pending Approval"
+3. Approver เลือกข้อเสนอที่ต้องการและดูรายละเอียดทั้งหมด
+4. Approver เลือกปุ่ม **"Approve"** (หรือ "Pass")
+5. ระบบบันทึกการอนุมัติและอัปเดตสถานะกิจกรรมเป็น **"Approved"**
+6. ระบบแจ้งเตือน/ส่งอีเมลไปยังผู้เสนอ
+7. Use Case จบลง
+
+### Alternative Flows / Exceptions
+- **AF-1 – ปฏิเสธพร้อม Feedback**
+  1. ที่ขั้นตอน 4, Approver เลือกปุ่ม **"Reject"** (หรือ "Not Pass")
+  2. ระบบบังคับให้ Approver กรอก **Feedback/เหตุผล** ในการปฏิเสธ
+  3. ระบบบันทึกการตัดสินใจและอัปเดตสถานะเป็น **"Rejected"**
+  4. ระบบแจ้งเตือนพร้อม Feedback ไปยังผู้เสนอ
+  5. Use Case จบลง
+- **AF-2 – ไม่มีสิทธิ์ในการอนุมัติ**
+  1. ที่ขั้นตอน 1, ผู้ใช้เข้าถึงเมนู "ตรวจสอบข้อเสนอ" แต่ระบบพบว่าไม่มีสิทธิ์ "Approver"
+  2. ระบบปฏิเสธการเข้าถึงและแสดงข้อความ "คุณไม่มีสิทธิ์ในการอนุมัติกิจกรรม"
+  3. Use Case จบลง