From e391c9a2376774c2be26cec9bf19745511299de2 Mon Sep 17 00:00:00 2001
From: chiayin <chiayin.kuo@dsp.im>
Date: Fri, 29 Mar 2024 15:49:05 +0800
Subject: [PATCH] docs: Update all files JSDoc.

---
 src/assets/tailwind.css                       |  1 -
 src/assets/vendors.css                        |  6 ---
 src/components/Compare/SidebarStates.vue      |  8 +---
 .../Conformance/ConformanceResults.vue        | 12 ++---
 .../Conformance/ConformanceSidebar.vue        |  7 ++-
 .../ConformanceSidebar/ActList.vue            |  3 ++
 .../ConformanceSidebar/ActRadio.vue           |  3 ++
 .../ConformanceSidebar/ActSeqDrag.vue         |  1 -
 .../ConformanceRadioGroup.vue                 | 15 +++++++
 .../ConformanceSelectResult.vue               | 22 ----------
 .../ConformanceSidebar/ConformanceShowBar.vue | 22 +++++-----
 .../ConformanceTimeRange.vue                  |  8 ++--
 .../ConformanceSidebar/ResultArrow.vue        | 13 ------
 .../ConformanceSidebar/TimeRangeDuration.vue  |  6 +--
 .../Discover/Conformance/MoreModal.vue        |  8 ++--
 .../Discover/Map/Filter/ActAndSeq.vue         |  2 +
 src/components/Discover/Map/Filter/ActOcc.vue |  5 ++-
 .../Discover/Map/Filter/ActOccCase.vue        | 14 ++++++
 .../Discover/Map/Filter/Attributes.vue        | 12 +++--
 src/components/Discover/Map/Filter/Funnel.vue |  3 +-
 .../Discover/Map/Filter/Timeframes.vue        | 15 +++++++
 src/components/Discover/Map/Filter/Trace.vue  |  9 ++--
 src/components/Discover/Map/SidebarFilter.vue | 17 ++++---
 src/components/Discover/Map/SidebarState.vue  |  2 +-
 src/components/Discover/Map/SidebarTraces.vue |  9 ++--
 src/components/Discover/Map/SidebarView.vue   | 10 ++---
 src/components/Discover/StatusBar.vue         |  2 +-
 src/components/File/UploadModal.vue           |  4 ++
 src/components/Header.vue                     |  3 ++
 src/components/Navbar.vue                     |  7 +--
 src/components/durationjs.vue                 | 19 ++++----
 src/module/abbreviateNumber.js                |  2 +-
 src/module/alertModal.js                      | 44 +++++++++----------
 src/module/apiError.js                        |  4 +-
 src/module/cytoscapeMap.js                    |  2 +-
 src/module/cytoscapeMapTrace.js               |  2 +-
 src/module/numberLabel.js                     |  2 +-
 src/module/setChartData.js                    |  8 ++--
 src/module/shortScaleNumber.js                |  2 +-
 src/module/sortNumEngZhtw.js                  |  2 +-
 src/module/timeLabel.js                       |  4 +-
 src/router/index.js                           | 18 ++++----
 src/stores/allMapData.js                      |  2 +
 src/stores/compare.js                         |  3 ++
 src/stores/conformance.js                     | 10 +++++
 src/stores/files.js                           | 19 ++++----
 src/stores/login.js                           |  2 +-
 src/stores/performance.js                     |  2 +
 src/views/Compare/Dashboard/index.vue         | 10 ++---
 src/views/Discover/Map/index.vue              | 16 +++----
 src/views/Discover/Performance/index.vue      | 10 ++---
 src/views/Files/index.vue                     | 34 +++++++-------
 src/views/Login/index.vue                     |  1 +
 src/views/MemberArea/index.vue                |  2 -
 src/views/Upload/index.vue                    | 10 ++---
 55 files changed, 260 insertions(+), 219 deletions(-)

diff --git a/src/assets/tailwind.css b/src/assets/tailwind.css
index 85ab496..3bc5e88 100644
--- a/src/assets/tailwind.css
+++ b/src/assets/tailwind.css
@@ -6,7 +6,6 @@
 @tailwind utilities;
 
 @layer  tailwind-base, primevue;
-/* @layer tailwind-base, primevue, tailwind-utilities; */
 
 @layer tailwind-base {
     @tailwind base;
diff --git a/src/assets/vendors.css b/src/assets/vendors.css
index 5851a61..fd323fe 100644
--- a/src/assets/vendors.css
+++ b/src/assets/vendors.css
@@ -71,7 +71,6 @@
   @apply !h-1
 }
 /* radio */
-/* inline-block h-4 w-4 m-2 cursor-pointer rounded-full ring-2 ring-neutral-300 shadow-sm peer-checked:ring-2 peer-checked:ring-primary peer-checked:ring-offset-2 peer-checked:bg-primary */
 /* p-radiobutton
 p-radiobutton-box
 p-radiobutton-icon */
@@ -95,11 +94,6 @@ p-radiobutton-icon */
   @apply !p-0
 }
 /* DataTable */
-/* .p-datatable table {
-  border-collapse: collapse;
-  min-width: 100%;
-  table-layout: fixed;
-} */
 .p-datatable-resizable > .p-datatable-wrapper {
   @apply !overflow-x-visible
 }
diff --git a/src/components/Compare/SidebarStates.vue b/src/components/Compare/SidebarStates.vue
index 1a50fc7..67481ba 100644
--- a/src/components/Compare/SidebarStates.vue
+++ b/src/components/Compare/SidebarStates.vue
@@ -2,9 +2,6 @@
   <Sidebar :visible="sidebarState" :closeIcon="'pi pi-angle-right'" :modal="false" position="right" :dismissable="false" class="!w-[440px]" @hide="hide" @show="show">
     <template #header>
       <p class="pl-2 text-base font-bold text-neutral-900">Summary</p>
-      <!-- <ul class=" pl-4">
-        <li class="h1 text-neutral-900">Summary</li>
-      </ul> -->
     </template>
     <!-- header: summary -->
     <div class="flex justify-start items-start">
@@ -183,7 +180,7 @@ export default {
   methods: {
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string} 轉換完成的百分比字串
      */
      getPercentLabel(val){
@@ -194,7 +191,7 @@ export default {
      * setting stats data
      * @param { object } data fetch API stats data
      * @param { string } fileName file Name
-     * @returns { object }  primaryStatData | secondaryStatData
+     * @returns { object }  primaryStatData | secondaryStatData，回傳 primaryStatData 或 secondaryStatData
      */
     getStatData(data, fileName) {
       return {
@@ -269,7 +266,6 @@ export default {
     const secondaryFileName = await this.compareStore.getFileName(secondaryId)
     this.primaryStatData = await this.getStatData(primaryData, primaryFileName);
     this.secondaryStatData = await this.getStatData(secondaryData, secondaryFileName);
-
   }
 }
 </script>
diff --git a/src/components/Discover/Conformance/ConformanceResults.vue b/src/components/Discover/Conformance/ConformanceResults.vue
index 4d3394a..c2a4859 100644
--- a/src/components/Discover/Conformance/ConformanceResults.vue
+++ b/src/components/Discover/Conformance/ConformanceResults.vue
@@ -284,7 +284,7 @@ export default {
   methods: {
     /**
      * set progress bar width
-     * @param   {number} value
+     * @param   {number} value 百分比數字
      * @returns {string}      樣式的寬度設定
      */
      progressWidth(value){
@@ -292,7 +292,7 @@ export default {
     },
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string} 轉換完成的百分比字串
      */
     getPercentLabel(val){
@@ -301,7 +301,7 @@ export default {
     },
     /**
      * Convert seconds to days
-     * @param {number} sec
+     * @param {number} sec 秒數
      * @returns {number} day
      */
     convertSecToDay(sec) {
@@ -309,7 +309,7 @@ export default {
     },
     /**
      * Open Issues Modal.
-     * @param {number} no trace no
+     * @param {number} no trace 編號
      */
     async openMore(no) {
       // async await 解決非同步資料延遲傳遞導致未讀取到而出錯的問題
@@ -321,7 +321,7 @@ export default {
     },
     /**
      * Open Loop Modal.
-     * @param {number} no trace no
+     * @param {number} no trace 編號
      */
     async openLoopMore(no) {
       // async await 解決非同步資料延遲傳遞導致未讀取到而出錯的問題
@@ -333,7 +333,7 @@ export default {
     },
     /**
      * set conformance report data
-     * @param   {object} data new watch's value
+     * @param   {object} data new watch's value 監聽到後端傳來的報告 data
      */
     setConformanceTempReportData(data){
       let total = getNumberLabel(Object.values(data.counts).reduce((acc, val) => acc + val, 0));
diff --git a/src/components/Discover/Conformance/ConformanceSidebar.vue b/src/components/Discover/Conformance/ConformanceSidebar.vue
index 5c24a5b..aaa0f70 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar.vue
@@ -691,14 +691,14 @@ export default {
   methods: {
     /**
      * get min total seconds
-     * @param {Number} e
+     * @param {Number} e 最小值總秒數
      */
      minTotalSeconds(e) {
       this.selectTimeRangeMin = e;
     },
     /**
      * get min total seconds
-     * @param {Number} e
+     * @param {Number} e 最大值總秒數
      */
     maxTotalSeconds(e) {
       this.selectTimeRangeMax = e;
@@ -784,7 +784,7 @@ export default {
       this.isSubmitTimeCfmCtEteSE = { base: {}, rule: {}};
     },
     /**
-     * @param {boolean} massage true | false 清空選單選項, 選擇的結果
+     * 清空選單的行為
      */
      reset() {
       // Results page Cover Plate(遮罩為 ture)
@@ -825,7 +825,6 @@ export default {
           isEndSelected: true
         };
       }
-
     },
     /**
      * Apply button 發送選項，取得 Check Id.
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ActList.vue b/src/components/Discover/Conformance/ConformanceSidebar/ActList.vue
index b1b3c50..dc54366 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ActList.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ActList.vue
@@ -32,6 +32,9 @@ export default {
     }
   },
   methods: {
+    /**
+     * 將選取的 Activities 傳出去
+     */
     actListData() {
       this.$emitter.emit('actListData', this.actList);
     }
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ActRadio.vue b/src/components/Discover/Conformance/ConformanceSidebar/ActRadio.vue
index 96617c2..6ede655 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ActRadio.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ActRadio.vue
@@ -33,6 +33,9 @@ export default {
     },
   },
   methods: {
+    /**
+     * 將選取的 Activity 傳出去
+     */
     actRadioData() {
       this.localSelect = null;
       this.$emitter.emit('actRadioData', {
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ActSeqDrag.vue b/src/components/Discover/Conformance/ConformanceSidebar/ActSeqDrag.vue
index 5f70466..11f05dc 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ActSeqDrag.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ActSeqDrag.vue
@@ -40,7 +40,6 @@
       </div>
     </div>
   </div>
-
 </template>
 <script>
 import { sortNumEngZhtw } from '@/module/sortNumEngZhtw.js';
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceRadioGroup.vue b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceRadioGroup.vue
index 4a38390..2b874fa 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceRadioGroup.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceRadioGroup.vue
@@ -99,6 +99,9 @@ export default {
     }
   },
   methods: {
+    /**
+     * 切換 Rule Type 的選項時的行為
+     */
     changeRadio() {
       this.selectedActivitySequence = 'Start & End';
       this.selectedMode = 'Directly follows';
@@ -107,15 +110,27 @@ export default {
       this.selectedActSeqFromTo = 'From';
       this.$emitter.emit('isRadioChange', true); // Radio 切換時，資料要清空
     },
+    /**
+     * 切換 Activity sequence 的選項時的行為
+     */
     changeRadioSeq() {
       this.$emitter.emit('isRadioSeqChange',true);
     },
+    /**
+     * 切換 Processing time 的選項時的行為
+     */
     changeRadioProcessScope() {
       this.$emitter.emit('isRadioProcessScopeChange', true);
     },
+    /**
+     * 切換 Process Scope 的選項時的行為
+     */
     changeRadioActSeqMore() {
       this.$emitter.emit('isRadioActSeqMoreChange', true);
     },
+    /**
+     * 切換 Activity Sequence 的選項時的行為
+     */
     changeRadioActSeqFromTo() {
       this.$emitter.emit('isRadioActSeqFromToChange', true);
     },
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceSelectResult.vue b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceSelectResult.vue
index f04ccf7..613424a 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceSelectResult.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceSelectResult.vue
@@ -143,28 +143,6 @@ export default {
     },
   },
   methods: {
-    /**
-     * set Time Result Data
-     * @param   {array} data
-     * @returns {array}
-     * timeResultData: [
-     *  {
-     *    id: 1,
-     *    category: 'start', start|end|from|to
-     *    task: '到院'
-     *  },
-     * ]
-     */
-    setTimeResultData(data) {
-      let result = data.map((item, index) => {
-        return {
-          id: index + 1,
-          category: item.category.replace(/^./, item.category[0].toUpperCase()),
-          task: item.task
-        }
-      });
-      return result;
-    },
     /**
      * All reset
      */
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceShowBar.vue b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceShowBar.vue
index 5cf14fe..35444b2 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceShowBar.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceShowBar.vue
@@ -202,8 +202,8 @@ export default {
   methods: {
     /**
      * 設定 start and end 的 Radio Data
-     * @param {object} data cfmSeqStart | cfmSeqEnd | cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE
-     * @param {string} category start | end
+     * @param {object} data cfmSeqStart | cfmSeqEnd | cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE，傳入以上任一後端接到的 Activities 列表 Data。
+     * @param {string} category 'start' | 'end'，傳入 'start' 或 'end'。
      * @returns {array}
      */
     setTaskData(data, category) {
@@ -213,9 +213,9 @@ export default {
     },
     /**
      * 重新設定連動的 start and end 的 Radio Data
-     * @param {object} data cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE
-     * @param {string} category start | end
-     * @param {string} task task
+     * @param {object} data cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE，傳入以上任一後端接到的 Activities 列表 Data。
+     * @param {string} category 'start' | 'end'，傳入 'start' 或 'end'。
+     * @param {string} task 已選擇的 Activity task
      * @returns {array}
      */
     setStartAndEndData(data, category, task) {
@@ -227,9 +227,9 @@ export default {
     },
     /**
      * 重新設定 Activity sequence 連動的 start and end 的 Radio Data
-     * @param {object} data cfmSeqStart | cfmSeqEnd
-     * @param {string} category sources | sinks
-     * @param {string} task task
+     * @param {object} data cfmSeqStart | cfmSeqEnd，傳入以上任一後端接到的 Activities 列表 Data。
+     * @param {string} category 'sources' | 'sinks'，傳入 'sources' 或 'sinks'。
+     * @param {string} task 已選擇的 Activity task
      * @returns {array}
      */
     setSeqStartAndEndData(data, category, task) {
@@ -239,7 +239,7 @@ export default {
     },
     /**
      * select start list's task
-     * @param {event} e
+     * @param {event} e 觸發 input 的詳細事件
      */
     selectStart(e) {
       this.taskStart = e;
@@ -256,7 +256,7 @@ export default {
     },
     /**
      * select End list's task
-     * @param {event} e
+     * @param {event} e 觸發 input 的詳細事件
      */
     selectEnd(e) {
       this.taskEnd = e;
@@ -283,7 +283,7 @@ export default {
     },
     /**
      * Radio 切換時，Start & End Data 連動改變
-     * @param {boolean} data true | false
+     * @param {boolean} data true | false，傳入 true 或 false
      */
     setResetData(data) {
       if(data) {
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceTimeRange.vue b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceTimeRange.vue
index 3b14705..a61e8cd 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ConformanceTimeRange.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ConformanceTimeRange.vue
@@ -84,22 +84,22 @@ export default {
   methods: {
     /**
      * get min total seconds
-     * @param {Number} e
+     * @param {Number} e 最小值總秒數
      */
     minTotalSeconds(e) {
       this.$emit('min-total-seconds', e);
     },
     /**
      * get min total seconds
-     * @param {Number} e
+     * @param {Number} e 最大值總秒數
      */
     maxTotalSeconds(e) {
       this.$emit('max-total-seconds', e);
     },
     /**
      * get Time Range(duration)
-     * @param {array} data API data
-     * @param {string} category act | single | double
+     * @param {array} data API data，Activity 列表
+     * @param {string} category 'act' | 'single' | 'double'，傳入以上任一值。
      * @param {string} task select Radio task or start
      * @param {string} taskTwo end
      * @returns {object} {min:12, max:345}
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/ResultArrow.vue b/src/components/Discover/Conformance/ConformanceSidebar/ResultArrow.vue
index ccb22bd..b756d2c 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/ResultArrow.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/ResultArrow.vue
@@ -12,18 +12,5 @@
 export default {
   name: 'ResultArrow',
   props:['data', 'select'],
-  // data() {
-  //   return {
-  //     datadata: []
-  //   }
-  // },
-  // watch: {
-  //   data: function(newValue) {
-  //     this.datadata = newValue;
-  //   },
-  //   select: function(newValue) {
-  //     this.datadata = newValue;
-  //   }
-  // }
 }
 </script>
diff --git a/src/components/Discover/Conformance/ConformanceSidebar/TimeRangeDuration.vue b/src/components/Discover/Conformance/ConformanceSidebar/TimeRangeDuration.vue
index 27211ed..a122d39 100644
--- a/src/components/Discover/Conformance/ConformanceSidebar/TimeRangeDuration.vue
+++ b/src/components/Discover/Conformance/ConformanceSidebar/TimeRangeDuration.vue
@@ -68,16 +68,16 @@ export default {
     },
     /**
      * get min total seconds
-     * @param {Number} e
+     * @param {Number} e 元件傳來的最小值總秒數
      */
-    minTotalSeconds(e) {
+     minTotalSeconds(e) {
       this.timeRangeMin = e;
       this.updateMin = e;
       this.$emit('min-total-seconds', e);
     },
     /**
      * get min total seconds
-     * @param {Number} e
+     * @param {Number} e 元件傳來的最大值總秒數
      */
     maxTotalSeconds(e) {
       this.timeRangeMax = e;
diff --git a/src/components/Discover/Conformance/MoreModal.vue b/src/components/Discover/Conformance/MoreModal.vue
index 6d01d2e..e17546a 100644
--- a/src/components/Discover/Conformance/MoreModal.vue
+++ b/src/components/Discover/Conformance/MoreModal.vue
@@ -160,7 +160,7 @@ export default {
   methods: {
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string}     轉換完成的百分比字串
      */
      getPercentLabel(val){
@@ -169,7 +169,7 @@ export default {
     },
     /**
      * set progress bar width
-     * @param   {number} value
+     * @param   {number} value 百分比數字
      * @returns {string}      樣式的寬度設定
      */
      progressWidth(value){
@@ -177,7 +177,7 @@ export default {
     },
     /**
      * switch case data
-     * @param {number} id
+     * @param {number} id case id
      */
     async switchCaseData(id) {
       if(id == this.showTraceId) return;
@@ -262,7 +262,7 @@ export default {
     },
     /**
      * 無限滾動: 監聽 scroll 有沒有滾到底部
-     * @param {element} event
+     * @param {element} event 監聽時回傳的事件
      */
     handleScroll(event) {
       if(this.maxItems || this.infiniteData.length < 20 || this.infiniteFinish === false) return;
diff --git a/src/components/Discover/Map/Filter/ActAndSeq.vue b/src/components/Discover/Map/Filter/ActAndSeq.vue
index 05d80b7..5093e4d 100644
--- a/src/components/Discover/Map/Filter/ActAndSeq.vue
+++ b/src/components/Discover/Map/Filter/ActAndSeq.vue
@@ -124,6 +124,7 @@ export default {
     },
     /**
      * Element dragging started
+     * @param {event} evt input 傳入的事件
      */
     onStart(evt) {
       const lastChild = evt.to.lastChild.lastChild;
@@ -137,6 +138,7 @@ export default {
     },
     /**
      * Element dragging ended
+     * @param {event} evt input 傳入的事件
      */
     onEnd(evt) {
       // 顯示拖曳元素
diff --git a/src/components/Discover/Map/Filter/ActOcc.vue b/src/components/Discover/Map/Filter/ActOcc.vue
index 09b7cc8..3c42af3 100644
--- a/src/components/Discover/Map/Filter/ActOcc.vue
+++ b/src/components/Discover/Map/Filter/ActOcc.vue
@@ -30,7 +30,6 @@
     </div>
   </div>
 </template>
-
 <script>
 import Search from '@/components/Search.vue';
 
@@ -68,6 +67,10 @@ export default {
     }
   },
   methods: {
+    /**
+     * 將選取的 row 傳到父層
+     * @param {event} e input 傳入的事件
+     */
     onRowSelect(e) {
       this.$emit('on-row-select', e)
     }
diff --git a/src/components/Discover/Map/Filter/ActOccCase.vue b/src/components/Discover/Map/Filter/ActOccCase.vue
index 464e26f..06173d8 100644
--- a/src/components/Discover/Map/Filter/ActOccCase.vue
+++ b/src/components/Discover/Map/Filter/ActOccCase.vue
@@ -61,16 +61,30 @@ export default {
     }
   },
   methods: {
+    /**
+     * 選擇 Row 的行為
+     */
     onRowSelect() {
       this.$emit('on-row-select', this.select);
     },
+    /**
+     * 取消選取 Row 的行為
+     */
     onRowUnselect() {
       this.$emit('on-row-select', this.select);
     },
+    /**
+     * 全選 Row 的行為
+     * @param {event} e input 傳入的事件
+     */
     onRowSelectAll(e) {
       this.select = e.data;
       this.$emit('on-row-select', this.select);
     },
+    /**
+     * 取消全選 Row 的行為
+     * @param {event} e input 傳入的事件
+     */
     onRowUnelectAll(e) {
       this.select = null;
       this.$emit('on-row-select', this.select)
diff --git a/src/components/Discover/Map/Filter/Attributes.vue b/src/components/Discover/Map/Filter/Attributes.vue
index 3fea6b9..f2134e2 100644
--- a/src/components/Discover/Map/Filter/Attributes.vue
+++ b/src/components/Discover/Map/Filter/Attributes.vue
@@ -327,7 +327,7 @@ export default {
     },
     /**
      * 選取類別型 table 的全選項
-     * @param {event} e
+     * @param {event} e input 傳入的事件
      */
     onRowSelectAll(e) {
       this.selectedAttRange = e.data;
@@ -352,7 +352,7 @@ export default {
     },
     /**
      * 切換 Attribute Name Radio
-     * @param {event} e
+     * @param {event} e input 傳入的事件
      */
     switchAttNameRadio(e) {
       this.selectedAttRange = null;
@@ -401,7 +401,7 @@ export default {
     },
     /**
      * set progress bar width
-     * @param   {number} value
+     * @param   {number} value 百分比數字
      * @returns {string}      樣式的寬度設定
      */
      progressWidth(value){
@@ -409,7 +409,7 @@ export default {
     },
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string}     轉換完成的百分比字串
      */
      getPercentLabel(val){
@@ -429,7 +429,6 @@ export default {
     /**
      * 調整左邊遮罩大小
      * @param {object} chart 取得 chart.js 資料
-     * @param {number} chart 取得 chart.js 資料
      */
     resizeLeftMask(chart, from) {
       const canvas = document.querySelector('#chartCanvasId canvas');
@@ -440,7 +439,7 @@ export default {
       mask.style.height = `${chart.chartArea.height}px`;
     },
     /**
-     * 調整又邊遮罩大小
+     * 調整右邊遮罩大小
      * @param {object} chart 取得 chart.js 資料
      */
     resizeRightMask(chart, to) {
@@ -453,7 +452,6 @@ export default {
     },
     /**
      * create chart
-     * @param   {object} valueData 選取的 Attribute，包含後端原始數據的 type、key
      */
     createChart() {
       const valueData = this.valueData;
diff --git a/src/components/Discover/Map/Filter/Funnel.vue b/src/components/Discover/Map/Filter/Funnel.vue
index 68e731e..0c8f9e4 100644
--- a/src/components/Discover/Map/Filter/Funnel.vue
+++ b/src/components/Discover/Map/Filter/Funnel.vue
@@ -54,7 +54,7 @@ export default {
   },
   methods: {
     /**
-     * @param {boolean} e ture | false
+     * @param {boolean} e ture | false，可選 ture 或 false
      * @param {numble} index rule's index
      */
     isRule(e, index){
@@ -66,6 +66,7 @@ export default {
     },
     /**
      * header:Funnel 刪除全部的 Funnel
+     * @param {numble|string} index rule's index 或 全部
      */
     async deleteRule(index) {
       if(index === 'all') {
diff --git a/src/components/Discover/Map/Filter/Timeframes.vue b/src/components/Discover/Map/Filter/Timeframes.vue
index 8a7c7a9..227dc7c 100644
--- a/src/components/Discover/Map/Filter/Timeframes.vue
+++ b/src/components/Discover/Map/Filter/Timeframes.vue
@@ -152,6 +152,10 @@ export default{
     },
   },
   methods: {
+    /**
+     * 調整遮罩大小
+     * @param {object} chart 取得 chart.js 資料
+     */
     resizeMask(chart) {
       let from = (this.selectArea[0] * 0.01) / (this.selectRange * 0.01);
       let to = (this.selectArea[1] * 0.01) / (this.selectRange * 0.01);
@@ -160,6 +164,10 @@ export default{
         this.resizeRightMask(chart, to);
       }
     },
+    /**
+     * 調整左邊遮罩大小
+     * @param {object} chart 取得 chart.js 資料
+     */
     resizeLeftMask(chart, from) {
       const canvas = document.getElementById("chartCanvasId");
       const mask = document.getElementById("chart-mask-left");
@@ -168,6 +176,10 @@ export default{
       mask.style.top = `${canvas.offsetTop + chart.chartArea.top}px`;
       mask.style.height = `${chart.chartArea.height}px`;
     },
+    /**
+     * 調整右邊遮罩大小
+     * @param {object} chart 取得 chart.js 資料
+     */
     resizeRightMask(chart, to) {
       const canvas = document.getElementById("chartCanvasId");
       const mask = document.getElementById("chart-mask-right");
@@ -176,6 +188,9 @@ export default{
       mask.style.top = `${canvas.offsetTop + chart.chartArea.top}px`;
       mask.style.height = `${chart.chartArea.height}px`;
     },
+    /**
+     * create chart
+     */
     createChart() {
       const max = this.filterTimeframe.y_axis.max * 1.1;
       const minX = this.timeFrameData[0]?.x;
diff --git a/src/components/Discover/Map/Filter/Trace.vue b/src/components/Discover/Map/Filter/Trace.vue
index 5afeb63..f07f845 100644
--- a/src/components/Discover/Map/Filter/Trace.vue
+++ b/src/components/Discover/Map/Filter/Trace.vue
@@ -233,7 +233,7 @@ export default {
     },
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string}     轉換完成的百分比字串
      */
      getPercentLabel(val){
@@ -242,7 +242,7 @@ export default {
     },
     /**
      * set progress bar width
-     * @param   {number} value
+     * @param   {number} value 百分比數字
      * @returns {string}      樣式的寬度設定
      */
      progressWidth(value){
@@ -250,7 +250,8 @@ export default {
     },
     /**
      * switch case data
-     * @param {number} id
+     * @param {number} id case id
+     * @param {number} count 所有的 case 數量
      */
      async switchCaseData(id, count) {
       // 點同一筆 id 不要有動作
@@ -317,7 +318,7 @@ export default {
     },
     /**
      * 無限滾動: 監聽 scroll 有沒有滾到底部
-     * @param {element} event
+     * @param {element} event 滾動傳入的事件
      */
      handleScroll(event) {
       if(this.infinitMaxItems || this.baseCases.length < 20 || this.infiniteFinish === false) return;
diff --git a/src/components/Discover/Map/SidebarFilter.vue b/src/components/Discover/Map/SidebarFilter.vue
index a759a45..b2d776e 100644
--- a/src/components/Discover/Map/SidebarFilter.vue
+++ b/src/components/Discover/Map/SidebarFilter.vue
@@ -300,7 +300,7 @@ export default {
     },
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string}     轉換完成的百分比字串
      */
      getPercentLabel(val){
@@ -309,7 +309,7 @@ export default {
     },
     /**
      * set progress bar width
-     * @param   {number} value
+     * @param   {number} value 百分比數字
      * @returns {string}      樣式的寬度設定
      */
      progressWidth(value){
@@ -336,7 +336,7 @@ export default {
     },
     // 調整 filterStartData / filterEndData / filterStartToEndData / filterEndToStartData 的內容
     /**
-     * @param {array} array filterStartToEnd / filterEndToStart
+     * @param {array} array filterStartToEnd / filterEndToStart，可傳入以上任一。
      */
     setActData(array) {
       let list = [];
@@ -379,7 +379,7 @@ export default {
       this.selectFilterEnd = e.data;
     },
     /**
-     * @param {array} e Update List Seq
+     * @param {array} listSeq Update List Seq
      */
      onUpdateListSeq(listSeq) {
        this.listSeq = listSeq;
@@ -397,6 +397,9 @@ export default {
         this.rowData = e.data;
       }
     },
+    /**
+     * @param {object} e object contains selected row's data
+     */
     endRow(e) {
       this.selectFilterEndToStart = e.data;
       if(this.isEndSelected === null || this.isEndSelected === true){
@@ -500,7 +503,7 @@ export default {
       };
     },
     /**
-     * @param {boolean} massage true | false 清空選項
+     * @param {boolean} massage true | false 清空選項，可選以上任一。
      */
     reset(massage) {
       // Sequence
@@ -527,7 +530,9 @@ export default {
       // 成功訊息
       massage ? this.$toast.success('Filter cleared.') : null;
     },
-    // header:Filter 發送選取的資料
+    /**
+     * header:Filter 發送選取的資料
+     */
     async submit(){
       this.isLoading = true;
       let data;
diff --git a/src/components/Discover/Map/SidebarState.vue b/src/components/Discover/Map/SidebarState.vue
index 844e243..0010af6 100644
--- a/src/components/Discover/Map/SidebarState.vue
+++ b/src/components/Discover/Map/SidebarState.vue
@@ -255,7 +255,7 @@ export default {
     },
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string}     轉換完成的百分比字串
      */
     getPercentLabel(val){
diff --git a/src/components/Discover/Map/SidebarTraces.vue b/src/components/Discover/Map/SidebarTraces.vue
index f15a256..a5c173e 100644
--- a/src/components/Discover/Map/SidebarTraces.vue
+++ b/src/components/Discover/Map/SidebarTraces.vue
@@ -152,7 +152,7 @@ export default {
   methods: {
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string}     轉換完成的百分比字串
      */
     getPercentLabel(val){
@@ -161,7 +161,7 @@ export default {
     },
     /**
      * set progress bar width
-     * @param   {number} value
+     * @param   {number} value 百分比數字
      * @returns {string}      樣式的寬度設定
      */
     progressWidth(value){
@@ -169,7 +169,8 @@ export default {
     },
     /**
      * switch case data
-     * @param {number} id
+     * @param {number} id case id
+     * @param {number} count 總 case 數量
      */
     async switchCaseData(id, count) {
       // 點同一筆 id 不要有動作
@@ -246,7 +247,7 @@ export default {
     },
     /**
      * 無限滾動: 監聽 scroll 有沒有滾到底部
-     * @param {element} event
+     * @param {element} event 滾動傳入的事件
      */
     handleScroll(event) {
       if(this.infinitMaxItems || this.cases.length < 20 || this.infiniteFinish === false) return;
diff --git a/src/components/Discover/Map/SidebarView.vue b/src/components/Discover/Map/SidebarView.vue
index f74068b..6a3466b 100644
--- a/src/components/Discover/Map/SidebarView.vue
+++ b/src/components/Discover/Map/SidebarView.vue
@@ -108,7 +108,7 @@ export default {
   methods: {
     /**
      * switch map type
-     * @param {string} type processMap | bpmn
+     * @param {string} type 'processMap' | 'bpmn'，可傳入以上任一。
      */
      switchMapType(type) {
        this.mapType = type;
@@ -116,7 +116,7 @@ export default {
     },
     /**
      * switch curve style
-     * @param {string} style 直角 unbundled-bezier | taxi
+     * @param {string} style 直角 'unbundled-bezier' | 'taxi'，可傳入以上任一。
      */
     switchCurveStyles(style) {
       this.curveStyle = style;
@@ -124,7 +124,7 @@ export default {
     },
     /**
      * switch rank
-     * @param {string} rank 直向 TB | 橫向 LR
+     * @param {string} rank 直向 'TB' | 橫向 'LR'，可傳入以上任一。
      */
     switchRank(rank) {
       this.rank = rank;
@@ -132,8 +132,8 @@ export default {
     },
     /**
      * switch Data Layoer Type or Option.
-     * @param {string} e
-     * @param {string} type freq | duration
+     * @param {string} e 切換時傳入的選項
+     * @param {string} type 'freq' | 'duration'，可傳入以上任一。
      */
     switchDataLayerType(e, type){
       let value = '';
diff --git a/src/components/Discover/StatusBar.vue b/src/components/Discover/StatusBar.vue
index 0147ab2..86154af 100644
--- a/src/components/Discover/StatusBar.vue
+++ b/src/components/Discover/StatusBar.vue
@@ -104,7 +104,7 @@ export default {
   methods: {
     /**
      * Number to percentage
-     * @param   {number} val
+     * @param   {number} val 原始數字
      * @returns {string} 轉換完成的百分比字串
      */
      getPercentLabel(val){
diff --git a/src/components/File/UploadModal.vue b/src/components/File/UploadModal.vue
index 8da5b26..6c3ccff 100644
--- a/src/components/File/UploadModal.vue
+++ b/src/components/File/UploadModal.vue
@@ -37,6 +37,10 @@ export default {
     IconUploarding,
   },
   methods: {
+    /**
+     * 上傳的行為
+     * @param {event} event input 傳入的事件
+     */
     async upload(event) {
       const fileInput = document.getElementById('uploadFiles');
       const target = event.target;
diff --git a/src/components/Header.vue b/src/components/Header.vue
index 18833f5..57fb993 100644
--- a/src/components/Header.vue
+++ b/src/components/Header.vue
@@ -48,6 +48,9 @@ export default {
     IconMember
   },
   methods: {
+    /**
+     * 登出的行為
+     */
     logOutButton() {
       if ((this.$route.name === 'Map' || this.$route.name === 'CheckMap') && this.tempFilterId) {
         // 傳給 Map，通知 Sidebar 要關閉。
diff --git a/src/components/Navbar.vue b/src/components/Navbar.vue
index a05e517..7ace95c 100644
--- a/src/components/Navbar.vue
+++ b/src/components/Navbar.vue
@@ -82,11 +82,11 @@ export default {
       showNavbarBreadcrumb: false,
       navViewData:
       {
-        // FILES: ['ALL', 'DISCOVER', 'COMPARE', 'DESIGN', 'SIMULATION'],
+        // 舉例：FILES: ['ALL', 'DISCOVER', 'COMPARE', 'DESIGN', 'SIMULATION'],
         FILES: ['ALL', 'DISCOVER', 'COMPARE'],
-        // DISCOVER: ['MAP', 'CONFORMANCE', 'PERFORMANCE', 'DATA']
+        // 舉例：DISCOVER: ['MAP', 'CONFORMANCE', 'PERFORMANCE', 'DATA']
         DISCOVER: ['MAP', 'CONFORMANCE', 'PERFORMANCE'],
-        // COMPARE: ['PROCESS MAP', 'DASHBOARD']
+        // 舉例：COMPARE: ['PROCESS MAP', 'DASHBOARD']
         COMPARE: ['DASHBOARD']
       },
       navViewName: 'FILES',
@@ -130,6 +130,7 @@ export default {
   methods: {
     /**
      * switch navbar item
+     * @param {event} event 選取 Navbar 選項後傳入的值
      */
     switchNavItem(event) {
       let type;
diff --git a/src/components/durationjs.vue b/src/components/durationjs.vue
index 66a29d0..d4028b5 100644
--- a/src/components/durationjs.vue
+++ b/src/components/durationjs.vue
@@ -148,12 +148,15 @@ export default {
     },
   },
   methods: {
+    /**
+     * 關閉選單視窗
+     */
     onClose () {
     this.openTimeSelect = false;
     },
     /**
      * get focus element
-     * @param {event} event
+     * @param {event} event input 傳入的事件
      */
     onFocus(event) {
       this.lastInput = event.target;
@@ -161,7 +164,7 @@ export default {
     },
     /**
      * when blur update input value and show number
-     * @param {event} event
+     * @param {event} event input 傳入的事件
      */
     onBlur(event) {
       let baseInputValue = event.target.value;
@@ -202,7 +205,7 @@ export default {
     },
     /**
      * 上下箭頭時的行為
-     * @param {event} event
+     * @param {event} event input 傳入的事件
      */
     onKeyUp(event) {
       event.target.value = event.target.value.replace(/\D/g, '');
@@ -213,9 +216,9 @@ export default {
     },
     /**
      * 上下箭頭時的行為
-     * @param {element} input
-     * @param {number} goUp
-     * @param {boolean} selectIt
+     * @param {element} input input 傳入的事件
+     * @param {number} goUp 上箭頭的鍵盤代號
+     * @param {boolean} selectIt 是否已執行
      */
     actionUpDown(input, goUp, selectIt = false) {
       const tUnit = input.dataset.tunit;
@@ -291,8 +294,8 @@ export default {
     },
     /**
      * 設定 dhms 的數值
-     * @param {number} totalSeconds
-     * @param {string} size
+     * @param {number} totalSeconds 總秒數
+     * @param {string} size 'min' | 'max'，可選以上任一，最大值或最小值
      */
     secondToDate(totalSeconds, size) {
       totalSeconds = parseInt(totalSeconds);
diff --git a/src/module/abbreviateNumber.js b/src/module/abbreviateNumber.js
index 97ca1a9..63229f1 100644
--- a/src/module/abbreviateNumber.js
+++ b/src/module/abbreviateNumber.js
@@ -1,6 +1,6 @@
 /**
  * 將數字轉換成簡寫的形式，設定 dhms 的數值
- * @param {number} totalSeconds
+ * @param {number} totalSeconds 總秒數
  * @returns {string}
  */
 export default function abbreviateNumber(totalSeconds) {
diff --git a/src/module/alertModal.js b/src/module/alertModal.js
index bcddc14..c0f51f6 100644
--- a/src/module/alertModal.js
+++ b/src/module/alertModal.js
@@ -16,7 +16,7 @@ const customClass = {
 };
 /**
  * Map Saved
- * @param { function } addFilterId
+ * @param { function } addFilterId 後端 API
  */
 export async function saveFilter(addFilterId) {
   let fileName = '';
@@ -55,7 +55,7 @@ export async function saveFilter(addFilterId) {
 }
 /**
  * Saved Success
- * @param { string } value
+ * @param { string } value File's name
  */
 export async function savedSuccessfully(value) {
   value = value ? value : '';
@@ -71,10 +71,10 @@ export async function savedSuccessfully(value) {
 };
 /**
  * leave Map page
- * @param { function } next
- * @param { function } addFilterId
- * @param { string } toPath
- * @param { function } logOut
+ * @param { function } next 執行完函式後的步驟
+ * @param { function } addFilterId 後端 API
+ * @param { string } toPath route path
+ * @param { function } logOut 登出函式
  */
 export async function leaveFilter(next, addFilterId, toPath, logOut) {
   const allMapDataStore = AllMapDataStore();
@@ -108,7 +108,7 @@ export async function leaveFilter(next, addFilterId, toPath, logOut) {
 };
 /**
  * Conformance Saved
- * @param { function } addConformanceCreateCheckId
+ * @param { function } addConformanceCreateCheckId 後端 API
  */
 export async function saveConformance(addConformanceCreateCheckId) {
   let fileName = '';
@@ -147,10 +147,10 @@ export async function saveConformance(addConformanceCreateCheckId) {
 }
 /**
  * leave Conformance page
- * @param { function } next
- * @param { function } addConformanceCreateCheckId
- * @param { string } toPath
- * @param { function } logOut
+ * @param { function } next 執行完函式後的步驟
+ * @param { function } addConformanceCreateCheckId 後端 API
+ * @param { string } toPath route path
+ * @param { function } logOut 登出函式
  */
 export async function leaveConformance(next, addConformanceCreateCheckId, toPath, logOut) {
   const conformanceStore = ConformanceStore();
@@ -184,8 +184,8 @@ export async function leaveConformance(next, addConformanceCreateCheckId, toPath
 };
 /**
  * Upload failde First
- * @param { string } failureType
- * @param { string } failureMsg
+ * @param { string } failureType 後端檔案錯誤類型
+ * @param { string } failureMsg 後端檔案錯誤訊息
  */
 export async function uploadFailedFirst(failureType, failureMsg, failureLoc) {
   // msg: 'not in UTF-8' | 'insufficient columns' | 'the csv file is empty' | 'the filename does not ends with .csv' | 'not a CSV file'
@@ -224,7 +224,7 @@ export async function uploadFailedFirst(failureType, failureMsg, failureLoc) {
 };
 /**
  * Upload failde Second
- * @param { array } detail
+ * @param { array } detail 後端回傳的失敗訊息
  */
 export async function uploadFailedSecond(detail) {
   let srt = '';
@@ -284,7 +284,7 @@ export async function uploadFailedSecond(detail) {
 };
 /**
  * Upload Success
- * @param { string } value
+ * @param { string } value File's name
  */
 export async function uploadSuccess() {
   await Swal.fire({
@@ -298,7 +298,7 @@ export async function uploadSuccess() {
 };
 /**
  * Confirm whether to upload the file
- * @param { object } fetchData
+ * @param { object } fetchData 後端 API POST data
  */
 export async function uploadConfirm(fetchData) {
   const filesStore = FilesStore();
@@ -333,10 +333,10 @@ export async function uploadloader() {
 };
 /**
  * Rename Modal
- * @param { function } rename
- * @param { string } type
- * @param { number } id
- * @param { string } baseName
+ * @param { function } rename 後端 API
+ * @param { string } type File 檔案類型
+ * @param { number } id File ID
+ * @param { string } baseName 改名前的檔名
  */
 export async function renameModal(rename, type, id, baseName) {
   let fileName = baseName;
@@ -379,8 +379,8 @@ export async function renameModal(rename, type, id, baseName) {
 /**
  * Delete File
  * @param { string } files 有關連的檔案
- * @param { string } type
- * @param { number } id
+ * @param { string } type  File 檔案類型
+ * @param { number } id    File ID
  * @param { string } name 原本的檔案
  */
 export async function deleteFileModal(files, type, id, name) {
diff --git a/src/module/apiError.js b/src/module/apiError.js
index 5121bfe..5ebfb10 100644
--- a/src/module/apiError.js
+++ b/src/module/apiError.js
@@ -12,8 +12,8 @@ const delay = (s = 0) =>  new Promise((resolve, reject) => setTimeout(resolve, s
 
 /**
  * API catch error function
- * @param   {object} Error
- * @param   {string} toastMessage
+ * @param   {object} Error 後端 ERROR
+ * @param   {string} toastMessage Toast 的提示文字
  * @returns {string}        Error HTTP Status
  */
 export default async function apiError(error, toastMessage) {
diff --git a/src/module/cytoscapeMap.js b/src/module/cytoscapeMap.js
index 02449c7..2b6567e 100644
--- a/src/module/cytoscapeMap.js
+++ b/src/module/cytoscapeMap.js
@@ -8,7 +8,7 @@ import { getTimeLabel } from '@/module/timeLabel.js'; // 時間格式轉換器
 cytoscape.use( dagre );
 
 /**
- * @param {object}  mapData processMapData | bpmnData
+ * @param {object}  mapData processMapData | bpmnData，可選以上任一。
  * mapData:{
  *  startId: 0,
  *  endId: 1,
diff --git a/src/module/cytoscapeMapTrace.js b/src/module/cytoscapeMapTrace.js
index 4b1ada2..685280d 100644
--- a/src/module/cytoscapeMapTrace.js
+++ b/src/module/cytoscapeMapTrace.js
@@ -18,7 +18,7 @@ cytoscape.use( dagre );
  *  width: number
  * }
  * @param {array}  edges it's similar to nodes
- * @param {string} graphId
+ * @param {string} graphId graph Id
  */
 export default function cytoscapeMapTrace(nodes, edges, graphId) {
   // create Cytoscape
diff --git a/src/module/numberLabel.js b/src/module/numberLabel.js
index 9299d6a..22c6102 100644
--- a/src/module/numberLabel.js
+++ b/src/module/numberLabel.js
@@ -1,7 +1,7 @@
 /**
  * 將數字轉換成帶有逗號格式(ex: 1000 -> 1,000)
  * 也可以改用原生 JS 方法 `.toLocaleString('en-US')`
- * @param {number} num
+ * @param {number} num 數字
  * @returns
  */
 export default function numberLabel(num) {
diff --git a/src/module/setChartData.js b/src/module/setChartData.js
index b0722a2..e868508 100644
--- a/src/module/setChartData.js
+++ b/src/module/setChartData.js
@@ -153,8 +153,8 @@ export function getXIndex(data, xValue) {
   return closestIndex;
 };
 /**
- *
- * @param {number} seconds
+ * 有 dhms 表達的時間單位
+ * @param {number} seconds 總秒數
  * @returns {string}
  */
 export function formatTime(seconds) {
@@ -180,8 +180,8 @@ export function formatTime(seconds) {
   } else return null;
 }
 /**
- *
- * @param {array} times
+ * 只顯示最大的兩個單位
+ * @param {array} times 時間
  * @returns {array}
  */
 export function formatMaxTwo(times) {
diff --git a/src/module/shortScaleNumber.js b/src/module/shortScaleNumber.js
index a080675..b3a1eb4 100644
--- a/src/module/shortScaleNumber.js
+++ b/src/module/shortScaleNumber.js
@@ -1,6 +1,6 @@
 /**
  * 數量單位轉換，輸出 k m b t 數值。
- * @param {number} number
+ * @param {number} number 總秒數
  * @returns {string}
  */
 export default function shortScaleNumber(number) {
diff --git a/src/module/sortNumEngZhtw.js b/src/module/sortNumEngZhtw.js
index ac6540b..1b4dd4a 100644
--- a/src/module/sortNumEngZhtw.js
+++ b/src/module/sortNumEngZhtw.js
@@ -1,6 +1,6 @@
 /**
  * 數字、英文、中文，排序
- * @param {array} data
+ * @param {array} data List
  * @returns
  */
 export function sortNumEngZhtw(data) {
diff --git a/src/module/timeLabel.js b/src/module/timeLabel.js
index b6b7ca0..251c9a3 100644
--- a/src/module/timeLabel.js
+++ b/src/module/timeLabel.js
@@ -2,7 +2,7 @@ import moment from 'moment';
 
 /**
  * 將秒數轉換成帶有時間單位的格式
- * @param   {number} second
+ * @param   {number} second 總秒數
  * @param   {number} fixedNumber 小數點後幾位
  * @returns {string}        轉換完的格式(ex: 1 day, 6.8 hrs)
  */
@@ -30,7 +30,7 @@ export function getTimeLabel(second, fixedNumber = 0) {
 }
 /**
  * 將秒數轉換成帶有縮寫時間單位的格式
- * @param   {number} second
+ * @param   {number} second 總秒數
  * @param   {number} fixedNumber 小數點後幾位
  * @returns {string}        轉換完的格式(ex: 1 d, 6.8 h)
  */
diff --git a/src/router/index.js b/src/router/index.js
index a668522..85511e4 100644
--- a/src/router/index.js
+++ b/src/router/index.js
@@ -57,28 +57,28 @@ const routes = [
         name: "Discover",
         children: [
           {
-            // type: log | filter
-            // fileId: log_id | filter_id
+            // type: log | filter，參數會有以上任一。
+            // fileId: log_id | filter_id，參數會有以上任一。
             path: "/discover/:type/:fileId/map",
             name: "Map",
             component: Map,
           },
           {
-            // type: log | filter
-            // fileId: log_id | filter_id
+            // type: log | filter，參數會有以上任一。
+            // fileId: log_id | filter_id，參數會有以上任一。
             path: "/discover/:type/:fileId/conformance",
             name: "Conformance",
             component: Conformance,
           },
           {
-            // type: log | filter
-            // fileId: log_id | filter_id
+            // type: log | filter，參數會有以上任一。
+            // fileId: log_id | filter_id，參數會有以上任一。
             path: "/discover/:type/:fileId/performance",
             name: "Performance",
             component: Performance,
           },
           {
-            // type: log | filter
+            // type: log | filter，參數會有以上任一。
             // fileId: check_id，透過 `/log-checks/{check_id}` 取得 parent data
             path: "/discover/conformance/:type/:fileId/map",
             name: "CheckMap",
@@ -88,7 +88,7 @@ const routes = [
             }
           },
           {
-            // type: log | filter
+            // type: log | filter，參數會有以上任一。
             // fileId: check_id，透過 `/log-checks/{check_id}` 取得 parent data
             path: "/discover/conformance/:type/:fileId/conformance",
             name: "CheckConformance",
@@ -98,7 +98,7 @@ const routes = [
             }
           },
           {
-            // type: log | filter
+            // type: log | filter，參數會有以上任一。
             // fileId: check_id，透過 `/log-checks/{check_id}` 取得 parent data
             path: "/discover/conformance/:type/:fileId/performance",
             name: "CheckPerformance",
diff --git a/src/stores/allMapData.js b/src/stores/allMapData.js
index 669e0da..d78a447 100644
--- a/src/stores/allMapData.js
+++ b/src/stores/allMapData.js
@@ -306,6 +306,7 @@ export default defineStore('allMapDataStore', {
     },
     /**
      * Add a New Filter
+     * @param {string} value file's name
      */
     async addFilterId(value) {
       let logId = this.logId;
@@ -325,6 +326,7 @@ export default defineStore('allMapDataStore', {
     },
     /**
      * Get Filter Detail
+     * @param {namber} createfilterId filter type ID
      */
     async fetchFunnel(createfilterId) {
       const api = `/api/filters/${createfilterId}`;
diff --git a/src/stores/compare.js b/src/stores/compare.js
index 8c0e4ca..087d8c8 100644
--- a/src/stores/compare.js
+++ b/src/stores/compare.js
@@ -29,6 +29,8 @@ export default defineStore('compareStore', {
     },
     /**
      * fetch discover api, get stats.
+     * @param {string} type 'log' | 'filter'，可傳入 'log' 或 'filter'
+     * @param {number} id log or filter ID
      */
     async getStateData(type, id) {
       let api = '';
@@ -51,6 +53,7 @@ export default defineStore('compareStore', {
     },
     /**
      * Get file's name
+     * @param {number} id log or filter ID
      */
     async getFileName(id) {
       id = Number(id)
diff --git a/src/stores/conformance.js b/src/stores/conformance.js
index 58a5c2e..6247add 100644
--- a/src/stores/conformance.js
+++ b/src/stores/conformance.js
@@ -210,6 +210,7 @@ export default defineStore('conformanceStore', {
     },
     /**
      * Creates a new temporary check for a log.
+     * @param {object} data 送給後端的 data
      */
     async addConformanceCheckId(data) {
       let logId = this.conformanceLogId;
@@ -254,6 +255,7 @@ export default defineStore('conformanceStore', {
     },
     /**
      * Get the detail of a temporary log conformance issue.
+     * @param {number} issueNo Issues 編號
      */
     async getConformanceIssue(issueNo) {
       let logTempCheckId = this.conformanceLogTempCheckId;
@@ -277,6 +279,9 @@ export default defineStore('conformanceStore', {
     },
     /**
      * Get the Trace Details of a Temporary Log Conformance lssue.
+     * @param {number} issueNo Issues 編號
+     * @param {number} traceId, Trace 編號
+     * @param {number} start Trace 要從哪個編號開始載入
      */
     async getConformanceTraceDetail(issueNo, traceId, start) {
       let logTempCheckId = this.conformanceLogTempCheckId;
@@ -303,6 +308,7 @@ export default defineStore('conformanceStore', {
     },
     /**
      * Get the Details of a Temporary Log Conformance Loop.
+     * @param {number} loopNo loop 編號
      */
     async getConformanceLoop(loopNo) {
       let logTempCheckId = this.conformanceLogTempCheckId;
@@ -326,6 +332,9 @@ export default defineStore('conformanceStore', {
     },
     /**
      * Get the Trace Details of a Temporary Log Conformance Loops.
+     * @param {number} loopNo loop 編號
+     * @param {number} traceId, Trace 編號
+     * @param {number} start Trace 要從哪個編號開始載入
      */
     async getConformanceLoopsTraceDetail(loopNo, traceId, start) {
       let logTempCheckId = this.conformanceLogTempCheckId;
@@ -352,6 +361,7 @@ export default defineStore('conformanceStore', {
     },
     /**
      * Add a New Log Conformance Check, Save the log file.
+     * @param {string} value file's name
      */
     async addConformanceCreateCheckId(value) {
       let logId = this.conformanceLogId;
diff --git a/src/stores/files.js b/src/stores/files.js
index 3b4fdce..45e73a6 100644
--- a/src/stores/files.js
+++ b/src/stores/files.js
@@ -109,7 +109,7 @@ export default defineStore('filesStore', {
     },
     /**
      * Uploads a CSV log file. 第一階段上傳
-     * @param {Object} fromData
+     * @param {Object} fromData 傳給後端的 Data
      */
     async upload(fromData) {
       const api = '/api/logs/csv-uploads';
@@ -156,7 +156,7 @@ export default defineStore('filesStore', {
     },
     /**
      * Add a Log from an Uploaded CSV Log File. 第二階段上傳
-     * @param {Object} data
+     * @param {Object} data 傳給後端的 Data
      */
     async uploadLog(data) {
       const uploadId = this.uploadId;
@@ -184,9 +184,9 @@ export default defineStore('filesStore', {
     },
     /**
      * Rename a Log
-     * @param { string } type log | filter | log-check | filter-check
-     * @param { number } id
-     * @param { string } name
+     * @param { string } type log | filter | log-check | filter-check，傳入以上任一個。
+     * @param { number } id 檔案 ID
+     * @param { string } name file's name
      */
     async rename(type, id, fileName) {
       // 先判斷有沒有 uploadLogId，有就設定 id 和 type；再判斷檔案型別。
@@ -224,7 +224,7 @@ export default defineStore('filesStore', {
     /**
      * Get the Dependents of the files
      * @param { string } type log | filter | log-check | filter-check
-     * @param { number } id
+     * @param { number } id 檔案 ID
      */
     async getDependents(type, id) {
       let api;
@@ -253,7 +253,7 @@ export default defineStore('filesStore', {
     /**
      * Delete file
      * @param { string } type log | filter | log-check | filter-check
-     * @param { number } id
+     * @param { number } id 檔案 ID
      */
     async deleteFile(type, id) {
       let api;
@@ -288,6 +288,7 @@ export default defineStore('filesStore', {
     },
     /**
      * Remove a Deletion Record，真刪除被 Admin 或被其他帳號刪除的檔案
+     * @param {number} id 檔案 ID
      */
     async deletionRecord(id) {
       let api = '';
@@ -305,8 +306,8 @@ export default defineStore('filesStore', {
     /**
      * Download file as CSV
      * @param { string } type log | filter | log-check | filter-check
-     * @param { number } id
-     * @param { string } fileName
+     * @param { number } id 檔案 ID
+     * @param { string } fileName file's name
      */
     async downloadFileCSV(type, id, fileName) {
       let api;
diff --git a/src/stores/login.js b/src/stores/login.js
index 6f945ed..713289c 100644
--- a/src/stores/login.js
+++ b/src/stores/login.js
@@ -44,7 +44,7 @@ export default defineStore('loginStore', {
       };
     },
     /**
-     * Refresh Token
+     * Refresh Token (暫時沒做)
      */
     async refreshTokenLogin() {
       const api = '/api/oauth/token';
diff --git a/src/stores/performance.js b/src/stores/performance.js
index a3913f9..d3c34a0 100644
--- a/src/stores/performance.js
+++ b/src/stores/performance.js
@@ -13,6 +13,8 @@ export default defineStore('performanceStore', {
   actions: {
     /**
      * Get Performance
+     * @param {string} type 'log' | 'filter'，可傳入以上任一。
+     * @param {*} id 檔案 ID
      */
     async getPerformance(type, id) {
       let api = '';
diff --git a/src/views/Compare/Dashboard/index.vue b/src/views/Compare/Dashboard/index.vue
index 1f002da..199ad59 100644
--- a/src/views/Compare/Dashboard/index.vue
+++ b/src/views/Compare/Dashboard/index.vue
@@ -216,8 +216,8 @@ export default {
     /**
      * 建立折線圖
      * @param { object } chartData chart data
-     * @param { object } content titels
-     * @param { string } yUnit y 軸單位 date | count
+     * @param { object } content titels 標題文字
+     * @param { string } yUnit y 軸單位 'date' | 'count'，可傳入以上任一。
      */
     getLineChart(chartData, content, yUnit) {
       let datasetsPrimary;
@@ -391,7 +391,7 @@ export default {
     /**
      * 建立長條圖
      * @param { object } chartData chart data
-     * @param { object } content titels
+     * @param { object } content titels 文字標題
      */
     getBarChart(chartData, content) {
       const maxX = chartData.x_axis.max;
@@ -540,9 +540,9 @@ export default {
     /**
      * 建立水平長條圖
      * @param { object } chartData chart data
-     * @param { object } content titels
+     * @param { object } content titels 標題的文字
      * @param { boolean } isSingle 單個或雙數 activity
-     * @param { string } xUnit x 軸單位 date | count
+     * @param { string } xUnit x 軸單位 'date' | 'count'，可傳入以上任一。
      */
     getHorizontalBarChart(chartData, content, isSingle, xUnit) {
       const maxY = chartData.y_axis.max;
diff --git a/src/views/Discover/Map/index.vue b/src/views/Discover/Map/index.vue
index 4d079b4..8646055 100644
--- a/src/views/Discover/Map/index.vue
+++ b/src/views/Discover/Map/index.vue
@@ -176,7 +176,7 @@ export default {
   methods: {
     /**
      * switch map type
-     * @param {string} type processMap | bpmn
+     * @param {string} type 'processMap' | 'bpmn'，可傳入以上任一。
      */
     switchMapType(type) {
       this.mapType = type;
@@ -184,7 +184,7 @@ export default {
     },
     /**
      * switch curve style
-     * @param {string} style 直角 unbundled-bezier | taxi
+     * @param {string} style 直角 'unbundled-bezier' | 'taxi'，可傳入以上任一。
      */
     switchCurveStyles(style) {
       this.curveStyle = style;
@@ -192,7 +192,7 @@ export default {
     },
     /**
      * switch rank
-     * @param {string} rank 直向 TB | 橫向 LR
+     * @param {string} rank 直向 'TB' | 橫向 'LR'，可傳入以上任一。
      */
     switchRank(rank) {
       this.rank = rank;
@@ -200,8 +200,8 @@ export default {
     },
     /**
      * switch Data Layoer Type or Option.
-     * @param {string} e
      * @param {string} type freq | duration
+     * @param {string} option 下拉選單中的選項
      */
     switchDataLayerType(type, option){
       this.dataLayerType = type;
@@ -210,7 +210,7 @@ export default {
     },
     /**
      * switch trace id and data
-     * @param {string} id
+     * @param {event} e input 傳入的事件
      */
     async switchTraceId(e) {
       if(e.id == this.traceId) return;
@@ -223,7 +223,7 @@ export default {
     },
     /**
      * 將 element nodes 資料彙整
-     * @param {object} type processMapData | bpmnData
+     * @param {object} type 'processMapData' | 'bpmnData'，可傳入以上任一。
      */
      setNodesData(mapData) {
        let mapType = this.mapType;
@@ -315,7 +315,7 @@ export default {
      },
     /**
      * 將 element edges 資料彙整
-     * @param {object} type processMapData | bpmnData
+     * @param {object} type 'processMapData' | 'bpmnData'，可傳入以上任一。
      */
     setEdgesData(mapData) {
       let mapType = this.mapType;
@@ -346,7 +346,7 @@ export default {
      },
     /**
      * create cytoscape's map
-     * @param {string} type this.mapType processMap | bpmn
+     * @param {string} type this.mapType 'processMap' | 'bpmn'，可傳入以上任一。
      */
     createCy(type) {
       let graphId = document.getElementById('cy');
diff --git a/src/views/Discover/Performance/index.vue b/src/views/Discover/Performance/index.vue
index 13c3f56..baa4208 100644
--- a/src/views/Discover/Performance/index.vue
+++ b/src/views/Discover/Performance/index.vue
@@ -213,8 +213,8 @@ export default {
     /**
      * 建立折線圖
      * @param { object } chartData chart data
-     * @param { object } content titels
-     * @param { string } yUnit y 軸單位 date | count
+     * @param { object } content titels 標題文字
+     * @param { string } yUnit y 軸單位 'date' | 'count'
      */
     getLineChart(chartData, content, yUnit) {
       let datasets;
@@ -357,7 +357,7 @@ export default {
     /**
      * 建立長條圖
      * @param { object } chartData chart data
-     * @param { object } content titels
+     * @param { object } content titels 標題文字
      */
     getBarChart(chartData, content) {
       const maxX = chartData.x_axis.max;
@@ -471,9 +471,9 @@ export default {
     /**
      * 建立水平長條圖
      * @param { object } chartData chart data
-     * @param { object } content titels
+     * @param { object } content titels 標題文字
      * @param { boolean } isSingle 單個或雙數 activity
-     * @param { string } xUnit x 軸單位 date | count
+     * @param { string } xUnit x 軸單位 'date' | 'count'，可傳入以上任一。
      */
     getHorizontalBarChart(chartData, content, isSingle, xUnit) {
       const maxY = chartData.y_axis.max;
diff --git a/src/views/Files/index.vue b/src/views/Files/index.vue
index 19fc4e6..f21bece 100644
--- a/src/views/Files/index.vue
+++ b/src/views/Files/index.vue
@@ -369,7 +369,7 @@
       },
       /**
        * 選擇該 files 進入 Discover/Compare/Design 頁面
-       * @param {object} file
+       * @param {object} file 該 file 的詳細資料
        */
       enterDiscover(file){
         let type;
@@ -409,8 +409,8 @@
       },
       /**
        * Right Click DOM Event
-       * @param {event} event
-       * @param {string} file
+       * @param {event} event 該 file 的詳細資料
+       * @param {string} file file's name
        */
       onRightClick(event, file) {
         this.selectedType = file.type;
@@ -420,7 +420,7 @@
       },
       /**
        * Right Click Table DOM Event
-       * @param {event} event
+       * @param {event} event 該 file 的詳細資料
        */
       onRightClickTable(event) {
         this.selectedType = event.data.type;
@@ -430,8 +430,8 @@
       },
       /**
        * Right Click Gride Card DOM Event
-       * @param {event} event
-       * @param {number} index
+       * @param {event} event 該 file 的詳細資料
+       * @param {number} index 該 file 的 index
        */
       onGridCardClick(file, index) {
         this.selectedType = file.type;
@@ -441,10 +441,10 @@
       },
       /**
        * File's Rename
-       * @param {string} type
-       * @param {number} id
-       * @param {string} source hover icon
-       * @param {string} fileName
+       * @param {string} type 該檔案的 type
+       * @param {number} id 該檔案的 id
+       * @param {string} source hover icon 該檔案的 icon
+       * @param {string} fileName file's name
        */
       rename(type, id, source, fileName) {
         if(type && id && source === 'list-hover') {
@@ -456,9 +456,9 @@
       },
       /**
        * Delete file
-       * @param {string} type
-       * @param {number} id
-       * @param {string} source hover icon
+       * @param {string} type 該檔案的 type
+       * @param {number} id 該檔案的 id
+       * @param {string} source hover icon 該檔案的 icon
        */
       async deleteFile(type, id, name, source) {
         let srt = '';
@@ -516,9 +516,9 @@
       },
       /**
        * Download file as CSV
-       * @param {string} type
-       * @param {number} id
-       * @param {string} source hover icon
+       * @param {string} type 該檔案的 type
+       * @param {number} id 該檔案的 id
+       * @param {string} source hover icon 該檔案的 icon
        */
       download(type, id, source, name) {
         if(type && id && source === 'list-hover' && name) {
@@ -555,7 +555,7 @@
         this.$router.push({name: 'CompareDashboard', params: params});
       },
       /**
-       *
+       * Grid 模板時的篩選器
        * @param {event} event choose columnType item
        */
       getGridSortData(event) {
diff --git a/src/views/Login/index.vue b/src/views/Login/index.vue
index 9e0a698..02d46f6 100644
--- a/src/views/Login/index.vue
+++ b/src/views/Login/index.vue
@@ -85,6 +85,7 @@ export default {
   methods: {
     /**
      * when input onChange value , isInvalid === false.
+     * @param {event} event input 傳入的事件
      */
     changeHandler(event) {
       let inputValue = event.target.value;
diff --git a/src/views/MemberArea/index.vue b/src/views/MemberArea/index.vue
index 4fbcf4c..079706e 100644
--- a/src/views/MemberArea/index.vue
+++ b/src/views/MemberArea/index.vue
@@ -25,8 +25,6 @@ export default {
       getUserData,
     }
   },
-  methods: {
-  },
   mounted() {
     this.getUserData();
   }
diff --git a/src/views/Upload/index.vue b/src/views/Upload/index.vue
index 8ef5be1..21ec78e 100644
--- a/src/views/Upload/index.vue
+++ b/src/views/Upload/index.vue
@@ -143,7 +143,7 @@ export default {
     uploadConfirm,
     /**
      * Rename 離開 input 的行為
-     * @param {Event} e
+     * @param {Event} e input 傳入的事件
      */
     onBlur(e) {
       const baseWidth = 20;
@@ -160,7 +160,7 @@ export default {
     },
     /**
      * Rename 輸入 input 的行為
-     * @param {Event} e
+     * @param {Event} e input 傳入的事件
      */
     onInput(e) {
       const baseWidth = 20;
@@ -170,8 +170,8 @@ export default {
     },
     /**
      * input 寬度隨著 value 響應式改變
-     * @param {String} text
-     * @param {Event} e
+     * @param {String} text file's name
+     * @param {Event} e input 傳入的事件
      */
     getTextWidth(text, e) {
       // 替換空格為不斷行的空格
@@ -190,7 +190,7 @@ export default {
     },
     /**
      * 驗證，根據新的 selectedColumns 更新 informData 和 repeatedData
-     * @param {Array} data
+     * @param {Array} data 已選擇的 type 的 data
      */
     updateValidationData(data) {
       const nameOccurrences = {};