Add JSDoc documentation and file headers to all source files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/components/File/UploadModal.vue

@@ -15,6 +15,17 @@
   </Dialog>
 </template>
 <script setup>
+// The Lucia project.
+// Copyright 2023-2026 DSP, inc.  All rights reserved.
+// Authors:
+//   chiayin.kuo@dsp.im (chiayin), 2023/1/31
+//   cindy.chang@dsp.im (Cindy Chang), 2024/5/30
+//   imacat.yang@dsp.im (imacat), 2023/9/23
+/**
+ * @module components/File/UploadModal File upload modal dialog
+ *   with drag-and-drop support for CSV files (max 90 MB).
+ */
+
 import { onBeforeUnmount, } from 'vue';
 import { storeToRefs } from 'pinia';
 import IconUploarding from '../icons/IconUploarding.vue';
@@ -30,8 +41,8 @@ const { uploadFileName } = storeToRefs(filesStore);
 const contentClass = 'h-full';
 
 /**
- * 上傳的行為
- * @param {event} event input 傳入的事件
+ * Handles CSV file upload: validates size, sends to API, extracts filename.
+ * @param {Event} event - The file input change event.
  */
 async function upload(event) {
   const fileInput = document.getElementById('uploadFiles');