251127:1700 Frontend Start Build

frontend/lib/services/circulation.service.ts

@@ -0,0 +1,54 @@
+// File: lib/services/circulation.service.ts
+import apiClient from "@/lib/api/client";
+
+// Import DTO ที่สร้างไว้
+import { CreateCirculationDto } from "@/types/dto/circulation/create-circulation.dto";
+import { SearchCirculationDto } from "@/types/dto/circulation/search-circulation.dto";
+import { UpdateCirculationRoutingDto } from "@/types/dto/circulation/update-circulation-routing.dto";
+
+export const circulationService = {
+  /**
+   * ดึงรายการใบเวียนทั้งหมด (รองรับ Search & Filter)
+   */
+  getAll: async (params?: SearchCirculationDto) => {
+    // GET /circulations
+    const response = await apiClient.get("/circulations", { params });
+    return response.data;
+  },
+
+  /**
+   * ดึงรายละเอียดใบเวียนตาม ID
+   */
+  getById: async (id: string | number) => {
+    // GET /circulations/:id
+    const response = await apiClient.get(`/circulations/${id}`);
+    return response.data;
+  },
+
+  /**
+   * สร้างใบเวียนใหม่ (Create Circulation)
+   */
+  create: async (data: CreateCirculationDto) => {
+    // POST /circulations
+    const response = await apiClient.post("/circulations", data);
+    return response.data;
+  },
+
+  /**
+   * อัปเดตสถานะการเวียน (เช่น รับทราบ / ดำเนินการเสร็จสิ้น)
+   * มักจะใช้ routingId หรือ circulationId ขึ้นอยู่กับการออกแบบ API หลังบ้าน
+   */
+  updateRouting: async (id: string | number, data: UpdateCirculationRoutingDto) => {
+    // PATCH /circulations/:id/routing (หรือ endpoint ที่ Backend กำหนด)
+    const response = await apiClient.patch(`/circulations/${id}/routing`, data);
+    return response.data;
+  },
+
+  /**
+   * ลบ/ยกเลิกใบเวียน
+   */
+  delete: async (id: string | number) => {
+    const response = await apiClient.delete(`/circulations/${id}`);
+    return response.data;
+  }
+};

frontend/lib/services/contract-drawing.service.ts

@@ -0,0 +1,50 @@
+// File: lib/services/contract-drawing.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateContractDrawingDto, 
+  UpdateContractDrawingDto, 
+  SearchContractDrawingDto 
+} from "@/types/dto/drawing/contract-drawing.dto";
+
+export const contractDrawingService = {
+  /**
+   * ดึงรายการแบบสัญญา (Contract Drawings)
+   */
+  getAll: async (params: SearchContractDrawingDto) => {
+    // GET /contract-drawings?projectId=1&page=1...
+    const response = await apiClient.get("/contract-drawings", { params });
+    return response.data;
+  },
+
+  /**
+   * ดึงรายละเอียดตาม ID
+   */
+  getById: async (id: string | number) => {
+    const response = await apiClient.get(`/contract-drawings/${id}`);
+    return response.data;
+  },
+
+  /**
+   * สร้างแบบสัญญาใหม่
+   */
+  create: async (data: CreateContractDrawingDto) => {
+    const response = await apiClient.post("/contract-drawings", data);
+    return response.data;
+  },
+
+  /**
+   * แก้ไขข้อมูลแบบสัญญา
+   */
+  update: async (id: string | number, data: UpdateContractDrawingDto) => {
+    const response = await apiClient.put(`/contract-drawings/${id}`, data);
+    return response.data;
+  },
+
+  /**
+   * ลบแบบสัญญา (Soft Delete)
+   */
+  delete: async (id: string | number) => {
+    const response = await apiClient.delete(`/contract-drawings/${id}`);
+    return response.data;
+  }
+};

frontend/lib/services/correspondence.service.ts

@@ -0,0 +1,74 @@
+// File: lib/services/correspondence.service.ts
+import apiClient from "@/lib/api/client";
+import { SearchCorrespondenceDto } from "@/types/dto/correspondence/search-correspondence.dto";
+import { CreateCorrespondenceDto } from "@/types/dto/correspondence/create-correspondence.dto";
+// Import DTO ใหม่
+import { SubmitCorrespondenceDto } from "@/types/dto/correspondence/submit-correspondence.dto";
+import { WorkflowActionDto } from "@/types/dto/correspondence/workflow-action.dto";
+import { AddReferenceDto, RemoveReferenceDto } from "@/types/dto/correspondence/add-reference.dto";
+
+export const correspondenceService = {
+  // ... (getAll, getById, create, update, delete เดิมคงไว้) ...
+
+  getAll: async (params?: SearchCorrespondenceDto) => {
+    const response = await apiClient.get("/correspondences", { params });
+    return response.data;
+  },
+
+  getById: async (id: string | number) => {
+    const response = await apiClient.get(`/correspondences/${id}`);
+    return response.data;
+  },
+
+  create: async (data: CreateCorrespondenceDto) => {
+    const response = await apiClient.post("/correspondences", data);
+    return response.data;
+  },
+
+  update: async (id: string | number, data: any) => {
+    const response = await apiClient.put(`/correspondences/${id}`, data);
+    return response.data;
+  },
+
+  delete: async (id: string | number) => {
+    const response = await apiClient.delete(`/correspondences/${id}`);
+    return response.data;
+  },
+
+  // --- 🔥 New Methods ---
+
+  /**
+   * ส่งเอกสาร (Submit) เพื่อเริ่ม Workflow
+   */
+  submit: async (id: string | number, data: SubmitCorrespondenceDto) => {
+    const response = await apiClient.post(`/correspondences/${id}/submit`, data);
+    return response.data;
+  },
+
+  /**
+   * ดำเนินการ Workflow (เช่น Approve, Reject) ในขั้นตอนปัจจุบัน
+   */
+  processWorkflow: async (id: string | number, data: WorkflowActionDto) => {
+    const response = await apiClient.post(`/correspondences/${id}/workflow`, data);
+    return response.data;
+  },
+
+  /**
+   * เพิ่มเอกสารอ้างอิง
+   */
+  addReference: async (id: string | number, data: AddReferenceDto) => {
+    const response = await apiClient.post(`/correspondences/${id}/references`, data);
+    return response.data;
+  },
+
+  /**
+   * ลบเอกสารอ้างอิง
+   */
+  removeReference: async (id: string | number, data: RemoveReferenceDto) => {
+    // ใช้ DELETE method โดยส่ง body ไปด้วย (axios รองรับผ่าน config.data)
+    const response = await apiClient.delete(`/correspondences/${id}/references`, {
+      data: data
+    });
+    return response.data;
+  }
+};

frontend/lib/services/index.ts

@@ -0,0 +1,21 @@
+// File: lib/services/index.ts
+
+// --- Core Master Data & Projects ---
+export * from './project.service';
+export * from './master-data.service';
+
+// --- Document Modules ---
+export * from './correspondence.service';
+export * from './rfa.service';
+export * from './contract-drawing.service';
+export * from './shop-drawing.service';
+export * from './circulation.service';
+export * from './transmittal.service';
+
+// --- System & Support Modules (New) ---
+export * from './user.service';
+export * from './search.service';
+export * from './notification.service';
+export * from './workflow-engine.service';
+export * from './monitoring.service';
+export * from './json-schema.service';

frontend/lib/services/json-schema.service.ts

@@ -0,0 +1,75 @@
+// File: lib/services/json-schema.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateJsonSchemaDto, 
+  UpdateJsonSchemaDto, 
+  SearchJsonSchemaDto 
+} from "@/types/dto/json-schema/json-schema.dto";
+
+export const jsonSchemaService = {
+  /**
+   * ดึงรายการ Schema ทั้งหมด (สำหรับ Admin จัดการ Registry)
+   */
+  getAll: async (params?: SearchJsonSchemaDto) => {
+    // GET /json-schemas
+    const response = await apiClient.get("/json-schemas", { params });
+    return response.data;
+  },
+
+  /**
+   * ดึงรายละเอียด Schema ตาม ID
+   */
+  getById: async (id: number | string) => {
+    // GET /json-schemas/:id
+    const response = await apiClient.get(`/json-schemas/${id}`);
+    return response.data;
+  },
+
+  /**
+   * ดึง Schema ตาม "Code" (ใช้บ่อยที่สุดสำหรับ Dynamic Form)
+   */
+  getByCode: async (code: string) => {
+    // GET /json-schemas/code/:code
+    const response = await apiClient.get(`/json-schemas/code/${code}`);
+    return response.data;
+  },
+
+  /**
+   * สร้าง Schema ใหม่ (Admin)
+   */
+  create: async (data: CreateJsonSchemaDto) => {
+    // POST /json-schemas
+    const response = await apiClient.post("/json-schemas", data);
+    return response.data;
+  },
+
+  /**
+   * อัปเดต Schema (Admin)
+   */
+  update: async (id: number | string, data: UpdateJsonSchemaDto) => {
+    // PUT /json-schemas/:id
+    const response = await apiClient.put(`/json-schemas/${id}`, data);
+    return response.data;
+  },
+
+  /**
+   * ลบ Schema (Soft Delete)
+   */
+  delete: async (id: number | string) => {
+    // DELETE /json-schemas/:id
+    const response = await apiClient.delete(`/json-schemas/${id}`);
+    return response.data;
+  },
+
+  /**
+   * (Optional) ตรวจสอบความถูกต้องของข้อมูลกับ Schema ฝั่ง Server
+   */
+  validate: async (code: string, data: any) => {
+    // POST /json-schemas/validate
+    const response = await apiClient.post(`/json-schemas/validate`, {
+      schemaCode: code,
+      data: data
+    });
+    return response.data; // { valid: true, errors: [] }
+  }
+};

frontend/lib/services/master-data.service.ts

@@ -0,0 +1,84 @@
+// File: lib/services/master-data.service.ts
+import apiClient from "@/lib/api/client";
+
+// Import DTOs
+import { CreateTagDto, UpdateTagDto, SearchTagDto } from "@/types/dto/master/tag.dto";
+import { CreateDisciplineDto } from "@/types/dto/master/discipline.dto";
+import { CreateSubTypeDto } from "@/types/dto/master/sub-type.dto";
+import { SaveNumberFormatDto } from "@/types/dto/master/number-format.dto";
+
+export const masterDataService = {
+  // --- Tags Management ---
+  
+  /** ดึงรายการ Tags ทั้งหมด (Search & Pagination) */
+  getTags: async (params?: SearchTagDto) => {
+    const response = await apiClient.get("/tags", { params });
+    return response.data;
+  },
+
+  /** สร้าง Tag ใหม่ */
+  createTag: async (data: CreateTagDto) => {
+    const response = await apiClient.post("/tags", data);
+    return response.data;
+  },
+
+  /** แก้ไข Tag */
+  updateTag: async (id: number | string, data: UpdateTagDto) => {
+    const response = await apiClient.put(`/tags/${id}`, data);
+    return response.data;
+  },
+
+  /** ลบ Tag */
+  deleteTag: async (id: number | string) => {
+    const response = await apiClient.delete(`/tags/${id}`);
+    return response.data;
+  },
+
+  // --- Disciplines Management (Admin / Req 6B) ---
+
+  /** ดึงรายชื่อสาขางาน (มักจะกรองตาม Contract ID) */
+  getDisciplines: async (contractId?: number) => {
+    const response = await apiClient.get("/disciplines", { 
+      params: { contractId } 
+    });
+    return response.data;
+  },
+
+  /** สร้างสาขางานใหม่ */
+  createDiscipline: async (data: CreateDisciplineDto) => {
+    const response = await apiClient.post("/disciplines", data);
+    return response.data;
+  },
+
+  // --- Sub-Types Management (Admin / Req 6B) ---
+
+  /** ดึงรายชื่อประเภทย่อย (กรองตาม Contract และ Type) */
+  getSubTypes: async (contractId?: number, typeId?: number) => {
+    const response = await apiClient.get("/sub-types", {
+      params: { contractId, correspondenceTypeId: typeId }
+    });
+    return response.data;
+  },
+
+  /** สร้างประเภทย่อยใหม่ */
+  createSubType: async (data: CreateSubTypeDto) => {
+    const response = await apiClient.post("/sub-types", data);
+    return response.data;
+  },
+
+  // --- Document Numbering Format (Admin Config) ---
+
+  /** บันทึกรูปแบบเลขที่เอกสาร */
+  saveNumberFormat: async (data: SaveNumberFormatDto) => {
+    const response = await apiClient.post("/document-numbering/formats", data);
+    return response.data;
+  },
+
+  /** ดึงรูปแบบเลขที่เอกสารปัจจุบัน (เพื่อมาแก้ไข) */
+  getNumberFormat: async (projectId: number, typeId: number) => {
+    const response = await apiClient.get("/document-numbering/formats", {
+      params: { projectId, correspondenceTypeId: typeId }
+    });
+    return response.data;
+  }
+};

frontend/lib/services/monitoring.service.ts

@@ -0,0 +1,27 @@
+// File: lib/services/monitoring.service.ts
+import apiClient from "@/lib/api/client";
+
+export interface SetMaintenanceDto {
+  enabled: boolean;
+  message?: string; // ข้อความที่จะแสดงหน้าเว็บตอนปิดปรับปรุง
+}
+
+export const monitoringService = {
+  /** ตรวจสอบสถานะสุขภาพระบบ (Health Check) */
+  getHealth: async () => {
+    const response = await apiClient.get("/health");
+    return response.data;
+  },
+
+  /** ดึง Metrics การทำงาน (CPU, Memory, Request Count) */
+  getMetrics: async () => {
+    const response = await apiClient.get("/monitoring/metrics");
+    return response.data;
+  },
+
+  /** เปิด/ปิด Maintenance Mode */
+  setMaintenanceMode: async (data: SetMaintenanceDto) => {
+    const response = await apiClient.post("/monitoring/maintenance", data);
+    return response.data;
+  }
+};

frontend/lib/services/notification.service.ts

@@ -0,0 +1,48 @@
+// File: lib/services/notification.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  SearchNotificationDto, 
+  CreateNotificationDto 
+} from "@/types/dto/notification/notification.dto";
+
+export const notificationService = {
+  /** * ดึงรายการแจ้งเตือนของผู้ใช้ปัจจุบัน 
+   * GET /notifications
+   */
+  getMyNotifications: async (params?: SearchNotificationDto) => {
+    const response = await apiClient.get("/notifications", { params });
+    return response.data;
+  },
+
+  /** * สร้างการแจ้งเตือนใหม่ (มักใช้โดย System หรือ Admin)
+   * POST /notifications
+   */
+  create: async (data: CreateNotificationDto) => {
+    const response = await apiClient.post("/notifications", data);
+    return response.data;
+  },
+
+  /** * อ่านแจ้งเตือน (Mark as Read) 
+   * PATCH /notifications/:id/read
+   */
+  markAsRead: async (id: number | string) => {
+    const response = await apiClient.patch(`/notifications/${id}/read`);
+    return response.data;
+  },
+
+  /** * อ่านทั้งหมด (Mark All as Read) 
+   * PATCH /notifications/read-all
+   */
+  markAllAsRead: async () => {
+    const response = await apiClient.patch("/notifications/read-all");
+    return response.data;
+  },
+
+  /** * ลบการแจ้งเตือน 
+   * DELETE /notifications/:id
+   */
+  delete: async (id: number | string) => {
+    const response = await apiClient.delete(`/notifications/${id}`);
+    return response.data;
+  }
+};

frontend/lib/services/project.service.ts

@@ -0,0 +1,63 @@
+// File: lib/services/project.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateProjectDto, 
+  UpdateProjectDto, 
+  SearchProjectDto 
+} from "@/types/dto/project/project.dto";
+
+export const projectService = {
+  // --- Basic CRUD ---
+
+  /**
+   * ดึงรายการโครงการทั้งหมด (รองรับ Search & Pagination)
+   * (เดิมคือ getAllProjects แต่ปรับให้รับ params ได้)
+   */
+  getAll: async (params?: SearchProjectDto) => {
+    // GET /projects
+    const response = await apiClient.get("/projects", { params });
+    return response.data;
+  },
+
+  /** ดึงรายละเอียดโครงการตาม ID */
+  getById: async (id: string | number) => {
+    const response = await apiClient.get(`/projects/${id}`);
+    return response.data;
+  },
+
+  /** สร้างโครงการใหม่ (Admin) */
+  create: async (data: CreateProjectDto) => {
+    const response = await apiClient.post("/projects", data);
+    return response.data;
+  },
+
+  /** แก้ไขโครงการ */
+  update: async (id: string | number, data: UpdateProjectDto) => {
+    const response = await apiClient.put(`/projects/${id}`, data);
+    return response.data;
+  },
+
+  /** ลบโครงการ (Soft Delete) */
+  delete: async (id: string | number) => {
+    const response = await apiClient.delete(`/projects/${id}`);
+    return response.data;
+  },
+
+  // --- Related Data / Dropdown Helpers ---
+
+  /** * ดึงรายชื่อองค์กรในโครงการ (สำหรับ Dropdown 'To/From') 
+   * GET /projects/:id/organizations
+   */
+  getOrganizations: async (projectId: string | number) => {
+    const response = await apiClient.get(`/projects/${projectId}/organizations`);
+    return response.data;
+  },
+
+  /** * ดึงรายชื่อสัญญาในโครงการ 
+   * GET /projects/:id/contracts
+   */
+  getContracts: async (projectId: string | number) => {
+    const response = await apiClient.get(`/projects/${projectId}/contracts`);
+    return response.data;
+  }
+};

frontend/lib/services/rfa.service.ts

@@ -0,0 +1,69 @@
+// File: lib/services/rfa.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateRfaDto, 
+  UpdateRfaDto, 
+  SearchRfaDto 
+} from "@/types/dto/rfa/rfa.dto";
+
+// DTO สำหรับการอนุมัติ (อาจจะย้ายไปไว้ใน folder dto/rfa/ ก็ได้ในอนาคต)
+export interface WorkflowActionDto {
+  action: 'APPROVE' | 'REJECT' | 'COMMENT' | 'ACKNOWLEDGE';
+  comments?: string;
+  stepNumber?: number; // อาจจะไม่จำเป็นถ้า Backend เช็ค state ปัจจุบันได้เอง
+}
+
+export const rfaService = {
+  /**
+   * ดึงรายการ RFA ทั้งหมด (รองรับ Search & Filter)
+   */
+  getAll: async (params: SearchRfaDto) => {
+    // GET /rfas
+    const response = await apiClient.get("/rfas", { params });
+    return response.data;
+  },
+
+  /**
+   * ดึงรายละเอียด RFA และประวัติ Workflow
+   */
+  getById: async (id: string | number) => {
+    // GET /rfas/:id
+    const response = await apiClient.get(`/rfas/${id}`);
+    return response.data;
+  },
+
+  /**
+   * สร้าง RFA ใหม่
+   */
+  create: async (data: CreateRfaDto) => {
+    // POST /rfas
+    const response = await apiClient.post("/rfas", data);
+    return response.data;
+  },
+
+  /**
+   * แก้ไข RFA (เฉพาะสถานะ Draft)
+   */
+  update: async (id: string | number, data: UpdateRfaDto) => {
+    // PUT /rfas/:id
+    const response = await apiClient.put(`/rfas/${id}`, data);
+    return response.data;
+  },
+
+  /**
+   * ดำเนินการ Workflow (อนุมัติ / ตีกลับ / ส่งต่อ)
+   */
+  processWorkflow: async (id: string | number, actionData: WorkflowActionDto) => {
+    // POST /rfas/:id/workflow
+    const response = await apiClient.post(`/rfas/${id}/workflow`, actionData);
+    return response.data;
+  },
+
+  /**
+   * (Optional) ลบ RFA (Soft Delete)
+   */
+  delete: async (id: string | number) => {
+    const response = await apiClient.delete(`/rfas/${id}`);
+    return response.data;
+  }
+};

frontend/lib/services/search.service.ts

@@ -0,0 +1,26 @@
+// File: lib/services/search.service.ts
+import apiClient from "@/lib/api/client";
+import { SearchQueryDto } from "@/types/dto/search/search-query.dto";
+
+export const searchService = {
+  /**
+   * ค้นหาเอกสารทั้งระบบ (Full-text Search)
+   * ใช้ Elasticsearch ผ่าน Backend
+   */
+  search: async (query: SearchQueryDto) => {
+    // ส่ง params แบบ flat ตาม DTO
+    // GET /search?q=...&type=...&projectId=...
+    const response = await apiClient.get("/search", { 
+      params: query 
+    });
+    return response.data;
+  },
+
+  /**
+   * (Optional) Re-index ข้อมูลใหม่ กรณีข้อมูลไม่ตรง (Admin Only)
+   */
+  reindex: async (type?: string) => {
+    const response = await apiClient.post("/search/reindex", { type });
+    return response.data;
+  }
+};

frontend/lib/services/shop-drawing.service.ts

@@ -0,0 +1,41 @@
+// File: lib/services/shop-drawing.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateShopDrawingDto, 
+  CreateShopDrawingRevisionDto, 
+  SearchShopDrawingDto 
+} from "@/types/dto/drawing/shop-drawing.dto";
+
+export const shopDrawingService = {
+  /**
+   * ดึงรายการแบบก่อสร้าง (Shop Drawings)
+   */
+  getAll: async (params: SearchShopDrawingDto) => {
+    const response = await apiClient.get("/shop-drawings", { params });
+    return response.data;
+  },
+
+  /**
+   * ดึงรายละเอียดตาม ID (ควรได้ Revision History มาด้วย)
+   */
+  getById: async (id: string | number) => {
+    const response = await apiClient.get(`/shop-drawings/${id}`);
+    return response.data;
+  },
+
+  /**
+   * สร้าง Shop Drawing ใหม่ (พร้อม Revision 0)
+   */
+  create: async (data: CreateShopDrawingDto) => {
+    const response = await apiClient.post("/shop-drawings", data);
+    return response.data;
+  },
+
+  /**
+   * สร้าง Revision ใหม่สำหรับ Shop Drawing เดิม
+   */
+  createRevision: async (id: string | number, data: CreateShopDrawingRevisionDto) => {
+    const response = await apiClient.post(`/shop-drawings/${id}/revisions`, data);
+    return response.data;
+  }
+};

frontend/lib/services/transmittal.service.ts

@@ -0,0 +1,54 @@
+// File: lib/services/transmittal.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateTransmittalDto, 
+  UpdateTransmittalDto, 
+  SearchTransmittalDto 
+} from "@/types/dto/transmittal/transmittal.dto";
+
+export const transmittalService = {
+  /**
+   * ดึงรายการ Transmittal ทั้งหมด (รองรับ Search & Filter)
+   */
+  getAll: async (params: SearchTransmittalDto) => {
+    // GET /transmittals
+    const response = await apiClient.get("/transmittals", { params });
+    return response.data;
+  },
+
+  /**
+   * ดึงรายละเอียด Transmittal ตาม ID
+   */
+  getById: async (id: string | number) => {
+    // GET /transmittals/:id
+    const response = await apiClient.get(`/transmittals/${id}`);
+    return response.data;
+  },
+
+  /**
+   * สร้างเอกสารนำส่งใหม่
+   */
+  create: async (data: CreateTransmittalDto) => {
+    // POST /transmittals
+    const response = await apiClient.post("/transmittals", data);
+    return response.data;
+  },
+
+  /**
+   * แก้ไขข้อมูล Transmittal (เฉพาะ Draft)
+   */
+  update: async (id: string | number, data: UpdateTransmittalDto) => {
+    // PUT /transmittals/:id
+    const response = await apiClient.put(`/transmittals/${id}`, data);
+    return response.data;
+  },
+
+  /**
+   * ลบเอกสาร (Soft Delete)
+   */
+  delete: async (id: string | number) => {
+    // DELETE /transmittals/:id
+    const response = await apiClient.delete(`/transmittals/${id}`);
+    return response.data;
+  }
+};

frontend/lib/services/user.service.ts

@@ -0,0 +1,57 @@
+// File: lib/services/user.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateUserDto, 
+  UpdateUserDto, 
+  AssignRoleDto, 
+  UpdatePreferenceDto 
+} from "@/types/dto/user/user.dto";
+
+export const userService = {
+  /** ดึงรายชื่อผู้ใช้ทั้งหมด (Admin) */
+  getAll: async (params?: any) => {
+    const response = await apiClient.get("/users", { params });
+    return response.data;
+  },
+
+  /** ดึงข้อมูลผู้ใช้ตาม ID */
+  getById: async (id: number | string) => {
+    const response = await apiClient.get(`/users/${id}`);
+    return response.data;
+  },
+
+  /** สร้างผู้ใช้ใหม่ (Admin) */
+  create: async (data: CreateUserDto) => {
+    const response = await apiClient.post("/users", data);
+    return response.data;
+  },
+
+  /** แก้ไขข้อมูลผู้ใช้ */
+  update: async (id: number | string, data: UpdateUserDto) => {
+    const response = await apiClient.put(`/users/${id}`, data);
+    return response.data;
+  },
+
+  /** แก้ไขการตั้งค่าส่วนตัว (Preferences) */
+  updatePreferences: async (id: number | string, data: UpdatePreferenceDto) => {
+    const response = await apiClient.put(`/users/${id}/preferences`, data);
+    return response.data;
+  },
+
+  /** * กำหนด Role ให้ผู้ใช้ (Admin) 
+   * หมายเหตุ: Backend DTO มี userId ใน body ด้วย แต่ API อาจจะรับ userId ใน param
+   * ขึ้นอยู่กับการ Implement ของ Controller (ในที่นี้ส่งไปทั้งคู่เพื่อความชัวร์)
+   */
+  assignRole: async (userId: number | string, data: Omit<AssignRoleDto, 'userId'>) => {
+    // รวม userId เข้าไปใน body เพื่อให้ตรงกับ DTO Validation ฝั่ง Backend
+    const payload: AssignRoleDto = { userId: Number(userId), ...data };
+    const response = await apiClient.post(`/users/${userId}/roles`, payload);
+    return response.data;
+  },
+
+  /** ลบผู้ใช้ (Soft Delete) */
+  delete: async (id: number | string) => {
+    const response = await apiClient.delete(`/users/${id}`);
+    return response.data;
+  }
+};

frontend/lib/services/workflow-engine.service.ts

@@ -0,0 +1,77 @@
+// File: lib/services/workflow-engine.service.ts
+import apiClient from "@/lib/api/client";
+import { 
+  CreateWorkflowDefinitionDto, 
+  UpdateWorkflowDefinitionDto, 
+  EvaluateWorkflowDto, 
+  GetAvailableActionsDto 
+} from "@/types/dto/workflow-engine/workflow-engine.dto";
+
+export const workflowEngineService = {
+  // --- Engine Execution (Low-Level) ---
+
+  /**
+   * ตรวจสอบ Action ที่ทำได้ ณ สถานะหนึ่งๆ (ถาม Engine)
+   * POST /workflow-engine/available-actions
+   */
+  getAvailableActions: async (data: GetAvailableActionsDto) => {
+    const response = await apiClient.post("/workflow-engine/available-actions", data);
+    return response.data; // string[] e.g. ['APPROVE', 'REJECT']
+  },
+
+  /**
+   * ประมวลผล Transition (ถาม Engine ว่าถ้าทำ Action นี้แล้วจะไป State ไหน)
+   * POST /workflow-engine/evaluate
+   */
+  evaluate: async (data: EvaluateWorkflowDto) => {
+    const response = await apiClient.post("/workflow-engine/evaluate", data);
+    return response.data; // { nextState: '...', events: [...] }
+  },
+
+  // --- Definition Management (Admin / Workflow Editor) ---
+
+  /**
+   * ดึง Workflow Definition ทั้งหมด
+   * GET /workflow-engine/definitions
+   */
+  getDefinitions: async () => {
+    const response = await apiClient.get("/workflow-engine/definitions");
+    return response.data;
+  },
+
+  /**
+   * ดึง Workflow Definition ตาม ID
+   * GET /workflow-engine/definitions/:id
+   */
+  getDefinitionById: async (id: string | number) => {
+    const response = await apiClient.get(`/workflow-engine/definitions/${id}`);
+    return response.data;
+  },
+
+  /**
+   * สร้าง Workflow Definition ใหม่
+   * POST /workflow-engine/definitions
+   */
+  createDefinition: async (data: CreateWorkflowDefinitionDto) => {
+    const response = await apiClient.post("/workflow-engine/definitions", data);
+    return response.data;
+  },
+
+  /**
+   * อัปเดต Workflow Definition
+   * PATCH /workflow-engine/definitions/:id
+   */
+  updateDefinition: async (id: string | number, data: UpdateWorkflowDefinitionDto) => {
+    const response = await apiClient.patch(`/workflow-engine/definitions/${id}`, data);
+    return response.data;
+  },
+
+  /**
+   * ลบ Workflow Definition
+   * DELETE /workflow-engine/definitions/:id
+   */
+  deleteDefinition: async (id: string | number) => {
+    const response = await apiClient.delete(`/workflow-engine/definitions/${id}`);
+    return response.data;
+  }
+};