utiller 1.0.356 → 1.0.358

package/lib/utiller/index.js

@@ -4106,6 +4106,149 @@ var Utiller = /*#__PURE__*/function () {
       }).value() // 取出 moment 物件
       .format("YYYYMMDDHHmmss"));
     }
+
+    /** ============== 排課系統公式 開始 ============== */
+
+    /**
+     * /const arrayWithDup = [
+     *   { idOfBooze: "A111", idOfVariant: "V001", period: "202508151400-202508151500" },
+     *   { idOfBooze: "B222", idOfVariant: "V002", period: "202508151600-202508151700" },
+     *   { idOfBooze: "A111", idOfVariant: "V001", period: "202508161400-202508161500" }, // 🔁 與第一筆 PK 相同
+     *   { idOfBooze: "B222", idOfVariant: "V003", period: "202508171600-202508171700" },
+     *   { idOfBooze: "A111", idOfVariant: "V004", period: "202508181400-202508181500" }
+     *
+     * ];
+     * const result = getFilteredPeriods(arrayWithDup, "B222"); console.log(result);
+     *   [ "202508151400-202508151500", "202508181400-202508181500" ]
+     * 1. 刪掉所有 idOfBooze = "B222" 的項目
+     * 2. idOfBooze和idOfVariant為PK， 重複的只保留一組
+     * 3. 回傳filter array,(反查出哪些課程重複會用到其他資訊)
+     * */
+  }, {
+    key: "getFilteredHeraPeriods",
+    value: function getFilteredHeraPeriods(arr, idOfCurrentBooze) {
+      return _lodash["default"].chain(arr)
+      // 1️⃣ 刪掉 idOfBooze 等於目標值的項目
+      .filter(function (item) {
+        return item.idOfBooze !== idOfCurrentBooze;
+      })
+      // 2️⃣ 根據 idOfBooze+idOfVariant 組成唯一鍵 僅保留一組
+      .uniqBy(function (item) {
+        return "".concat(item.idOfBooze, "_").concat(item.idOfVariant);
+      })
+      // 3️⃣ 只保留 period 欄位
+      // .map('period')
+      // 4️⃣ 過濾掉沒有 period 的項目（避免 undefined）
+      // .filter(Boolean)
+      // 5️⃣ 轉回陣列
+      .value();
+    }
+
+    /**
+     * 檢查新任務與既有任務是否有時間衝突
+     * @param {Object} newTask - 新任務物件，需包含 timeSlot 屬性 (格式: YYYY/MM/DD (週)｜HH:mm-HH:mm)
+     * @param {Array} existingTasks - 已安排的任務陣列，每個物件需包含 period 屬性 (格式: yyyymmddHHmm-yyyymmddHHmm)
+     * @param {number} resourceCount - 可同時處理任務的人員/資源數量
+     * @returns {Object} { conflict: boolean, items: Array }
+     */
+  }, {
+    key: "checkPeriodConflict",
+    value: function checkPeriodConflict(newTask, existingTasks) {
+      var resourceCount = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+      // 1️⃣ 解析 timeSlot 拆成日期與時間
+      var _newTask$content$spli = newTask.content.split("｜"),
+        _newTask$content$spli2 = (0, _slicedToArray2["default"])(_newTask$content$spli, 2),
+        datePart = _newTask$content$spli2[0],
+        timePart = _newTask$content$spli2[1];
+      var date = (0, _momentTimezone["default"])(datePart.split(" ")[0], "YYYY/MM/DD");
+      var _timePart$split = timePart.split("-"),
+        _timePart$split2 = (0, _slicedToArray2["default"])(_timePart$split, 2),
+        startTimeStr = _timePart$split2[0],
+        endTimeStr = _timePart$split2[1];
+      var start = (0, _momentTimezone["default"])("".concat(date.format("YYYY/MM/DD"), " ").concat(startTimeStr), "YYYY/MM/DD HH:mm");
+      var end = (0, _momentTimezone["default"])("".concat(date.format("YYYY/MM/DD"), " ").concat(endTimeStr), "YYYY/MM/DD HH:mm");
+
+      // 2️⃣ 篩選出有真實時間重疊的任務
+      var conflictItems = _lodash["default"].filter(existingTasks, function (task) {
+        var _task$period$split = task.period.split("-"),
+          _task$period$split2 = (0, _slicedToArray2["default"])(_task$period$split, 2),
+          pStartStr = _task$period$split2[0],
+          pEndStr = _task$period$split2[1];
+        var pStart = (0, _momentTimezone["default"])(pStartStr, "YYYYMMDDHHmm");
+        var pEnd = (0, _momentTimezone["default"])(pEndStr, "YYYYMMDDHHmm");
+
+        // 判斷條件：有交集才算衝突
+        return start.isBefore(pEnd) && end.isAfter(pStart);
+      });
+
+      // 3️⃣ 根據資源數量判斷是否真的構成衝突
+      var conflict = conflictItems.length >= resourceCount;
+
+      // 4️⃣ 回傳結果
+      return {
+        conflict: conflict,
+        // true: 超過資源負荷
+        items: conflictItems // 衝突的任務列表
+      };
+    }
+  }, {
+    key: "testOfConflict",
+    value: function testOfConflict() {
+      // ===== 測試資料 =====
+      var newTask = {
+        timeSlot: "2025/08/20 (三)｜16:00-17:00",
+        // 格式: YYYY/MM/DD (週)｜HH:mm-HH:mm
+        id: "JOB001",
+        description: "安裝冷氣"
+      };
+      var existingTasks = [{
+        id: "T001",
+        period: "202508151400-202508151500"
+      }, {
+        id: "T002",
+        period: "202508151600-202508151700"
+      }, {
+        id: "T003",
+        period: "202508161400-202508161500"
+      }, {
+        id: "T004",
+        period: "202508171600-202508171700"
+      }, {
+        id: "T005",
+        period: "202508201630-202508201700"
+      },
+      // 衝突
+      {
+        id: "T006",
+        period: "202508201645-202508201700"
+      } // 衝突
+      ];
+
+      // 測試：一人資源
+      console.log(checkPeriodConflict(newTask, existingTasks, 1));
+      /*
+      {
+      conflict: true,
+      items: [
+      { id: 'T005', period: '202508201630-202508201700' },
+      { id: 'T006', period: '202508201645-202508201700' }
+      ]
+      }
+      */
+
+      // 測試：兩人資源
+      console.log(checkPeriodConflict(newTask, existingTasks, 2));
+      /*
+      {
+      conflict: false,
+      items: [
+      { id: 'T005', period: '202508201630-202508201700' },
+      { id: 'T006', period: '202508201645-202508201700' }
+      ]
+      }
+      */
+    }
+    /** ============== 排課系統公式 結束 ============== */
   }]);
 }();
 var _default = exports["default"] = Utiller;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utiller",
-  "version": "1.0.356",
+  "version": "1.0.358",
   "description": "",
   "main": "index.js",
   "scripts": {

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.11",
-    "utiller": "^1.0.355",
+    "utiller": "^1.0.357",
     "linepayer": "^1.0.4",
     "databazer": "^1.0.12",
     "lodash": "^4.17.20",