thinkyu/報到系統/DOC/活動管理.md

活動管理

畫面檔：

~/Forms/ClassesList.aspx

資料存取類別

~/Models/DAC_Classes1.cs（自動產生，勿修改） ~/Models/DAC_Classes2.cs（自訂擴充）

• DAC_Classes：資料處理類別
• ClassesList：資料集類別
• ClassesItem：資料項目類別

畫面排列：

上方：搜尋列

• 使用 CourseCode、CourseName、CourseDate_1（CourseDate 起）、CourseDate_2（CourseDate 迄）、CourseLocation 為查詢條件 下方：搜尋結果列表
• 顯示欄位為 CourseCode、CourseName、CourseDate、CourseLocation、操作
• 新增按鈕放置在表頭的操作欄
• 更正、刪除按鈕放置在操作欄
• CourseCode、CourseDate 向中對齊，其餘向左對齊

UI 規範：

• 小窗尺寸：700x500px
• 搜尋結果每頁顯示 20 筆
• 操作按鈕使用 Bootstrap 樣式

錯誤處理：

• 使用系統共用的 $message 來顯示

新增更正：

• 新增更正時彈出小窗
• 新增有兩個存檔按鈕 存檔：存檔後關閉小窗 存檔後繼續新增：存檔後清除輸入內容重新進入新增模式
• 更正存檔後關閉小窗

刪除：

• 彈 confirm 確認後刪除

資料輸入：

• CourseCode 不可輸入，不可修改，自動編號（BeforeInsertOne 處理）
• CourseName 必填，可輸入，可修改，單行文字框，最長 100 Unicode 字元
• CourseDate 必填，可輸入，可修改，日期輸入框，YYYY-MM-DD 格式，不必驗證是否晚於今天
• CourseLocation 非必填，可輸入，可修改，單行文字框
• NotificationTitle 非必填，可輸入，可修改，單行文字框，最長 100 Unicode 字元
• NotificationTemplate 非必填，可輸入，可修改，多行文字框，最長 500 Unicode 字元 NotificationTemplate 插入規則：
  • 插入格式：{活動日期}、{活動名稱}、{活動地點}
  • 插入位置：游標當前位置
  • 範例：「提醒您，{活動名稱}將於{活動日期}在{活動地點}舉行」
• AgreedTerms 非必填

前端程式碼：

• 使用 Vue.js 實現動態資料綁定與操作。
• 不使用 Server control

後端程式碼：

• 使用 WebService 實現非同步資料交換。

WebService 端點：

Services/ClassesService.asmx

• EnableSession(True)

• SearchClasses(int pageIndex, int pageSize, string courseCode, string courseName, DateTime? courseDate1, DateTime? courseDate2, string courseLocation, bool? closed, string projectID)：搜尋活動

  • pageIndex 從 1 開始
  • 查詢 function 用 DAC_Classes.SelectPage(bool noInputReturnAll, int startRowIndex, int maximumRows, string CourseCode, string CourseName, DateTime? CourseDate_1, DateTime? CourseDate_2, string CourseLocation, bool? Closed, string ProjectID, string orderBy = "")
  • 筆數 function 用 DAC_Classes.SelectCount(bool noInputReturnAll, string CourseCode, string CourseName, DateTime? CourseDate_1, DateTime? CourseDate_2, string CourseLocation, bool? Closed, string ProjectID, string orderBy = "")
  • 查詢條件為 AND 關係
  • 空白條件視為不限制（noInputReturnAll = true）
  • CourseDate 為範圍查詢
  • 每筆結果補填 ProjectName（由 DAC_BPAA.SelectProjectName 查詢）
  • 回傳：BaseResponse（Success, Message, Data: ClassesList.ToDict(), TotalCount: 總筆數）

• SaveClasses(bool isNew, ClassesItem item)：存檔

  • isNew：是否為新增
  • item：新增或更正的活動資料（型別 ClassesItem）
  • 回傳：BaseResponse（Success, Message, Data: 儲存後的 ClassesItem）

• DeleteClasses(int id, int dbAppNo)：刪除活動

  • 呼叫 DAC_Classes.DeleteOne(int ID, int DB_APPNO)
  • 回傳：BaseResponse（Success, Message）

• SearchProjects(string keyword)：搜尋計畫（用於自動完成）

  • 呼叫 DAC_BPAA.Select(keyword)
  • 回傳：BaseResponse（Success, Message, Data: NameValueList）

• ExportClassesReport(int classesID, string timeFormat = "datetime")：匯出學員簽到表

  • 輸入參數：classesID（課程 ID）、timeFormat（時間格式，"datetime" 或 "time"）
  • 查詢課程及參加人員資料，使用 NPOI 產生 Excel
  • 回傳：BaseResponse（Success, Message, Data: { FileName, FileBase64, FileSize, DataCount }）

• ExportClassesList(DateTime? courseDate1, DateTime? courseDate2, string projectID)：匯出課程清單

  • 輸入參數：courseDate1（課程日期起）、courseDate2（課程日期迄）、projectID（計畫代號）
  • 查詢課程清單及各課程的參加人員統計，使用 NPOI 產生 Excel
  • 回傳：BaseResponse（Success, Message, Data: { FileName, FileBase64, FileSize }）