feat(api): Access Attemp tLogs

Author: wanasart

server/src/controllers/logs.controller.ts

@@ -62,4 +62,36 @@ export async function getUserLogs(req: Request, res: Response, next: NextFunctio
     } catch (err) {
         next(err);
     }
+};
+
+/**
+ * สร้างบันทึกเหตุการณ์การเข้าถึงกล้อง (Camera Access Log)
+ * 
+ * ฟังก์ชันนี้ทำหน้าที่รับข้อมูลจากคำขอ (request) ได้แก่ user_id, status
+ * และรหัสกล้องจาก params (cam_id) จากนั้นส่งต่อไปยัง LogService
+ * เพื่อบันทึกเหตุการณ์ว่า ผู้ใช้เข้าถึงกล้องสำเร็จหรือเพียงพยายามเข้าถึง
+ *
+ * การตอบกลับ (response):  
+ * - หากบันทึกสำเร็จ จะส่งสถานะ 201 พร้อมข้อความและข้อมูลที่บันทึก  
+ * - หากเกิดข้อผิดพลาด จะส่งต่อไปยัง middleware จัดการ error
+ *
+ * @param {Request} req - อ็อบเจ็กต์คำขอจาก Express
+ * @param {Response} res - อ็อบเจ็กต์ตอบกลับจาก Express
+ * @param {NextFunction} next - ฟังก์ชันส่งต่อข้อผิดพลาดให้ middleware ถัดไป
+ * @returns {Promise<Response>} ส่งผลลัพธ์การสร้าง log กลับไปยัง client
+ * @throws {Error} หากเกิดข้อผิดพลาดจาก Service หรือฐานข้อมูล
+ *
+ * @author Wanasart
+ * @lastModified 2025-12-07
+ */
+export async function createAccessAttemptLogs(req: Request, res: Response, next: NextFunction) {
+    try {
+        const camera_id = Number(req.params.cam_id);
+        const { user_id, status } = req.body;
+
+        const log = await LogService.insertAccessAttemptLogs(user_id, camera_id, status);
+        return res.status(201).json({ message: 'Created successfully', data: log });
+    } catch (err) {
+        next(err);
+    }
 };

server/src/routes/logs.routes.ts

@@ -5,6 +5,7 @@
  *
  * ## Logs
  *  - GET    /camera    → ดึงรายการบันทึกกล้อง (Camera Logs)
+ *  - POST   /camera/:cam_id    → สร้างบันทึกการเข้าถึงกล้อง
  *  - GET    /alert     → ดึงรายการบันทึกแจ้งเตือน (Alert Logs)
  *  - GET    /user      → ดึงประวัติการทำงานของผู้ใช้ (User Activity Logs)
  *
@@ -16,7 +17,7 @@
  *
  * @author Wanasart
  * @created 2025-10-31
- * @lastModified 2025-11-26
+ * @lastModified 2025-12-07
  */
 import { Router } from 'express';
 import * as ctrl from '../controllers/logs.controller';
@@ -28,4 +29,6 @@ router.get('/camera', ctrl.getCameraLogs);
 router.get('/alert', ctrl.getAlertLogs);
 router.get('/user', ctrl.getUserLogs);
 
+router.post('/camera/:cam_id', ctrl.createAccessAttemptLogs);
+
 export default router;

server/src/services/logs.service.ts

@@ -88,4 +88,52 @@ export async function getUserLogs(){
     `);
 
     return rows.map(Mapping.mapUserLogsToSaveResponse);
+}
+
+/**
+ * บันทึกเหตุการณ์การเข้าถึงกล้อง (Camera Access Logs)
+ * โดยบันทึกว่า "ผู้ใช้พยายามเข้าถึง" หรือ "เข้าถึงสำเร็จ"
+ * ตามค่าที่ส่งเข้ามาในตัวแปร status
+ *
+ * - หาก status = true   → บันทึกเป็น ACCESS_GRANTED
+ * - หาก status = false  → บันทึกเป็น ACCESS_ATTEMPT
+ *
+ * ข้อมูลจะถูกบันทึกลงในตาราง camera_logs พร้อม timestamp ปัจจุบัน
+ *
+ * @param {number} user_id รหัสผู้ใช้งานที่พยายามเข้าถึง
+ * @param {number} camera_id รหัสกล้องที่ถูกเข้าถึง
+ * @param {boolean} status สถานะการเข้าถึง (true = สำเร็จ, false = พยายาม)
+ *
+ * @returns {Promise<void>} ไม่มีค่าที่ส่งกลับ (เป็นการบันทึกข้อมูลอย่างเดียว)
+ * @throws {Error} หากเกิดข้อผิดพลาดระหว่างการบันทึกลงฐานข้อมูล
+ *
+ * @author Wanasart
+ * @lastModified 2025-12-07
+ */
+export async function insertAccessAttemptLogs(
+    user_id: number, 
+    camera_id: number, 
+    status: boolean
+){
+
+    let action = 'UNKNOW';
+    if(status){
+        action = 'ACCESS_GRANTED';
+    } else {
+        action = 'ACCESS_ATTEMPT';
+    }
+
+    await pool.query(`
+      INSERT INTO camera_logs(
+        clg_usr_id,
+        clg_cam_id,
+        clg_action,
+        clg_created_at
+      )
+      VALUES($1, $2, $3, CURRENT_TIMESTAMP);
+    `, [
+    user_id,
+    camera_id,
+    action,
+  ]);
 }