@ngockhoale/ukit 1.1.6

package/templates/.claude/skills/frontend-vue/composables/masterApi.js

@@ -0,0 +1,362 @@
+/**
+ * @file masterApi.js
+ * @description Các hàm truy vấn master data — dùng chung cho toàn bộ ứng dụng.
+ * Auto-import, gọi trực tiếp không cần import.
+ *
+ * NAMING CONVENTION:
+ *   - get_[entity]_by_[field]()       → Trả về 1 object {} hoặc {} rỗng
+ *   - get_[entity]_list()             → Trả về mảng raw data []
+ *   - get_[entity]_list_dropdown()    → Trả về Array<{value, label}> cho component Dropdown/Select
+ *   - get_permission_create_of_group_[menu]() → Kiểm tra quyền tạo mới, trả boolean
+ *
+ * @requires request - từ useRequest.js (GET /select)
+ * @requires convertToDropdownValue - từ utils.js
+ * @requires get_schema - từ state.js
+ */
+
+/**
+ * Lấy thông tin agreement theo ID
+ * @param {number|string} id_agreement - ID agreement
+ * @returns {Promise<Object>} Object agreement hoặc {} nếu không tìm thấy
+ */
+export const get_agreement_by_id = async (id_agreement) => {
+  let data = {
+    schema: get_schema(),
+    table: "v_agreement",
+    conditions: JSON.stringify({ id_agreement: id_agreement }),
+  };
+  const tmp = await request("/select", data, "get");
+  if (tmp.length > 0) {
+    return tmp[0];
+  }
+  return {};
+};
+/**
+ * Lấy thông tin agreement theo số hợp đồng
+ * @param {string} agreement_number - Số hợp đồng
+ * @returns {Promise<Object>} Object agreement hoặc {} nếu không tìm thấy
+ */
+export const get_agreement_by_number = async (agreement_number) => {
+  let data = {
+    schema: get_schema(),
+    table: "v_agreement",
+    conditions: JSON.stringify({ agreement_number: agreement_number }),
+  };
+  const tmp = await request("/select", data, "get");
+  if (tmp.length > 0) {
+    return tmp[0];
+  }
+  return {};
+};
+/**
+ * Lấy danh sách ngôn ngữ (raw data)
+ * @returns {Promise<Array>} Mảng lang objects
+ */
+export const get_lang_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "lang_list",
+  };
+  return await request("/select", data, "get");
+};
+/**
+ * Lấy danh sách ngôn ngữ cho Dropdown (value=code, label=name)
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_lang_list_dropdown = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "lang_list",
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "code", "name");
+};
+
+/**
+ * Lấy danh sách usergroup (raw data)
+ * @returns {Promise<Array>} Mảng usergroup objects
+ */
+export const get_usergroup_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "usergroup",
+  };
+  return await request("/select", data, "get");
+};
+/**
+ * Lấy danh sách usergroup cho Dropdown (value=code, label=name)
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_usergroup_list_dropdown = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "usergroup",
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "code", "name");
+};
+
+/**
+ * Lấy danh sách user (raw data)
+ * @returns {Promise<Array>} Mảng user objects
+ */
+export const get_user_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "user",
+  };
+  return await request("/select", data, "get");
+};
+/**
+ * Lấy danh sách user cho Dropdown (value=email, label=fullname)
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_user_list_dropdown = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "user",
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "email", "fullname");
+};
+
+/**
+ * Lấy danh sách token (raw data)
+ * @returns {Promise<Array>}
+ */
+export const get_token_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "token",
+  };
+  return await request("/select", data, "get");
+};
+
+/**
+ * Lấy danh sách notification (raw data)
+ * @returns {Promise<Array>}
+ */
+export const get_notification_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "notification",
+  };
+  return await request("/select", data, "get");
+};
+
+/**
+ * Lấy danh sách modern trade (raw data)
+ * @returns {Promise<Array>}
+ */
+export const get_modern_trade_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "modern_trade",
+  };
+  return await request("/select", data, "get");
+};
+/**
+ * Lấy danh sách modern trade cho Dropdown (value=name, label=name)
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_modern_trade_list_dropdown = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "modern_trade",
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "name", "name");
+};
+
+/**
+ * Lấy danh sách branch (raw data)
+ * @returns {Promise<Array>}
+ */
+export const get_branch_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "branch",
+  };
+  return await request("/select", data, "get");
+};
+/**
+ * Lấy danh sách branch cho Dropdown (value=name, label=name)
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_branch_list_dropdown = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "branch",
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "name", "name");
+};
+
+/**
+ * Lấy danh sách type of media (raw data)
+ * @returns {Promise<Array>}
+ */
+export const get_type_of_media_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "type_of_media",
+  };
+  return await request("/select", data, "get");
+};
+
+/**
+ * Lấy danh sách type of media cho Dropdown (value=name, label=name)
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_type_of_media_list_dropdown = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "type_of_media",
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "name", "name");
+};
+/**
+ * Lấy type of media theo ID
+ * @param {number|string} id - ID type of media
+ * @returns {Promise<Object>} Object hoặc {} nếu không tìm thấy
+ */
+export const get_type_of_media_by_id = async (id) => {
+  let data = {
+    schema: get_schema(),
+    table: "type_of_media",
+    conditions: JSON.stringify({ id_type_of_media: id }),
+  };
+  let resp = await request("/select", data, "get");
+  if (resp.length > 0) {
+    return resp[0];
+  } else {
+    return {};
+  }
+};
+/**
+ * Lấy type of media theo tên
+ * @param {string} name - Tên type of media
+ * @returns {Promise<Object>} Object hoặc {} nếu không tìm thấy
+ */
+export const get_type_of_media_by_name = async (name) => {
+  let data = {
+    schema: get_schema(),
+    table: "type_of_media",
+    conditions: JSON.stringify({ name: name }),
+  };
+  let resp = await request("/select", data, "get");
+  if (resp.length > 0) {
+    return resp[0];
+  } else {
+    return {};
+  }
+};
+
+/**
+ * Lấy danh sách agreement period (raw data)
+ * @returns {Promise<Array>}
+ */
+export const get_agreement_period_list = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "agreement_period",
+  };
+  return await request("/select", data, "get");
+};
+/**
+ * Lấy danh sách agreement period cho Dropdown (value=name, label=name)
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_agreement_period_list_dropdown = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "agreement_period",
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "name", "name");
+};
+/**
+ * Lấy danh sách agreement period loại "month" cho Dropdown, sắp xếp theo tên
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_agreement_period_list_dropdown_month = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "agreement_period",
+    conditions: JSON.stringify({ type: "month" }),
+    order_by: ["LENGTH(name) asc", "name asc"],
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "name", "name");
+};
+/**
+ * Lấy danh sách agreement period loại "year" cho Dropdown, sắp xếp theo tên
+ * @returns {Promise<Array<{value: string, label: string}>>}
+ */
+export const get_agreement_period_list_dropdown_year = async () => {
+  let data = {
+    schema: get_schema(),
+    table: "agreement_period",
+    conditions: JSON.stringify({ type: "year" }),
+    order_by: ["name asc"],
+  };
+  let resp = await request("/select", data, "get");
+  return convertToDropdownValue(resp, "name", "name");
+};
+
+/**
+ * Kiểm tra quyền tạo Agreement của usergroup
+ * @param {string|Array<string>} usergroup - Mã nhóm user (dùng operator "(in)")
+ * @returns {Promise<boolean>} true nếu có quyền tạo
+ */
+export const get_permission_create_of_group_agreement = async (usergroup) => {
+  let conditions = { "(in)usergroup": usergroup, menu: "Agreement", can_create: true };
+  let data = {
+    schema: get_schema(),
+    table: "permission",
+    conditions: JSON.stringify(conditions),
+  };
+  let resp = await request("/select", data, "get");
+  if (resp.length > 0) {
+    return true;
+  }
+  return false;
+};
+/**
+ * Kiểm tra quyền tạo Billing của usergroup
+ * @param {string|Array<string>} usergroup - Mã nhóm user
+ * @returns {Promise<boolean>} true nếu có quyền tạo
+ */
+export const get_permission_create_of_group_billing = async (usergroup) => {
+  let conditions = { "(in)usergroup": usergroup, menu: "Billing", "can_create": true };
+  let data = {
+    schema: get_schema(),
+    table: "permission",
+    conditions: JSON.stringify(conditions),
+  };
+  let resp = await request("/select", data, "get");
+  if (resp.length > 0) {
+    return true;
+  }
+  return false;
+};
+
+/**
+ * Kiểm tra quyền tạo Collect Point của usergroup
+ * @param {string|Array<string>} usergroup - Mã nhóm user
+ * @returns {Promise<boolean>} true nếu có quyền tạo
+ */
+export const get_permission_create_of_group_collect_point = async (usergroup) => {
+  let conditions = { "(in)usergroup": usergroup, menu: "Collect Point", "can_create": true };
+  let data = {
+    schema: get_schema(),
+    table: "permission",
+    conditions: JSON.stringify(conditions),
+  };
+  let resp = await request("/select", data, "get");
+  if (resp.length > 0) {
+    return true;
+  }
+  return false;
+};