# 辦訓系統修改需求條目與實作方案 ## 1. 文件目的 本文件整合以下四份修改需求文件，整理本次辦訓系統的完整需求、版本增量、驗收條件及建議實作方案： - `辦訓系統修改項目_1150719.xlsx` - `辦訓系統修改項目_1150722(更新V2).xlsx` - `辦訓系統修改項目_1150727.xlsx` - `辦訓系統修改項目_1150730.xlsx` 另參考 `0730系統規劃圖.png` 及各 Excel 工作表中的畫面示意圖。圖片中的畫面配置、流程與模組關係視為需求的一部分。 ## 2. 版本基準與合併規則 ### 2.1 版本角色 | 版本 | 角色 | 處理方式 | |---|---|---| | 1150719 | 原始需求基準 | 全部納入 | | 1150722 更新 V2 | 第一次追加及修改 | 未刪除的原需求保留；明確修改項目覆蓋原規格 | | 1150727 | 第二次修改 | 依新版畫面調整欄位與排列 | | 1150730 | 最新修改 | 覆蓋教學日誌的前一版畫面與欄位內容 | ### 2.2 合併原則 1. 後續文件未明確刪除的原始需求仍然有效。 2. 後續文件明確修改同一功能時，以日期較新的文件為準。 3. `1150730` 的 8 項課程執行觀察取代 `1150727` 的簡化版教學日誌畫面。 4. `1150722` 的「處理結果追蹤獨立簽核」取代 `1150719` 所描述的三份文件單一關卡簽核方式。 5. Excel 內嵌圖片與獨立系統規劃圖均納入畫面與流程判讀，不以文字內容為唯一依據。 ## 3. 需求條目 ### R-01 課程企劃書增加教材遴選 **來源：** 1150719 **功能要求：** - 路徑：辦訓系統 > 開課作業 > 課程企劃書。 - 增加「教材遴選」按鈕。 - 遴選項目如下，採 1 至 10 分評分： - 教材設計符合訓練目標。 - 教材設計整體架構規劃完整性。 - 教材設計符合課程規劃時數。 - 教學方法能引起學員的學習興趣。 - 教材設計可做為學員未來工作參考或運用。 - 增加教材評選綜合評估：不符合目標、符合目標、符合目標且能引起學習興趣。 - 增加訓練單位回饋與建議。 **驗收條件：** - 課程企劃書可以開啟教材遴選畫面。 - 每個指標可輸入 1 至 10 分。 - 系統保存、重新載入及簽核檢視時資料一致。 - 教材遴選內容可在相關檢視及報表中顯示。 ### R-02 專案類型改為職能類型 **來源：** 1150719 **功能要求：** - 欄位名稱由「專案類型」改為「職能類型」。 - 選項固定為：核心職能、專業職能、管理職能。 - 新增、修改、查詢、檢視及報表的欄位名稱與選項需一致。 **驗收條件：** - 所有相關畫面均顯示「職能類型」。 - 舊資料可正常顯示，不因欄位名稱調整而遺失。 ### R-03 講師及場地遴選允許手動輸入 **來源：** 1150719 **功能要求：** - 講師不在講師資料庫時，仍可填寫講師姓名及必要資訊。 - 場地不在場地資料庫時，仍可填寫場地名稱及必要資訊。 - 已存在於資料庫的講師或場地仍可使用原有選取功能。 - 手動輸入資料需隨課程企劃保存，不能因重新載入而消失。 **驗收條件：** - 資料庫有資料與無資料兩種情境均可完成遴選。 - 簽核、檢視及後續報表能正確顯示手動輸入內容。 ### R-04 滿意度問卷手機填寫及逾期提醒 **來源：** 1150719 **功能要求：** - 建立專用滿意度問卷填寫網址。 - 支援手機版面。 - 使用者開啟網址後可直接登入並填寫問卷。 - 增加問卷填寫期限日期。 - 超過期限仍未填寫者，由系統主動寄送提醒通知。 **驗收條件：** - 手機瀏覽器可登入、填寫及送出問卷。 - 填寫期限前不重複寄送提醒。 - 超過期限且未填寫者會進入提醒名單。 - 寄信失敗需有錯誤記錄，不得中斷其他收件者處理。 ### R-05 教學日誌改為最新課程執行觀察表單 **來源：** 1150719、1150727、1150730 **最新規格：** 1150730 教學日誌需包含以下資料： #### 課程基本資料 - 課程內容下拉選單。 - 課程企劃編號。 - 節次。 - 講師。 - 應到人數。 - 實到人數。 - 缺席人數。 #### 課程執行觀察 | 編號 | 觀察項目 | 選項 | |---|---|---| | 1 | 課程是否依原訂計畫執行 | 符合原訂計畫、部分調整、未依原訂計畫執行 | | 2 | 課程進度 | 超前、符合規劃、略有落後、未完成 | | 3 | 講師授課情形 | 優良、良好、普通、待改善 | | 4 | 學員參與互動 | 非常踴躍、踴躍、普通、不佳 | | 5 | 學員學習投入 | 積極投入、大多投入、部分投入、投入度不足 | | 6 | 學員課堂回應情形 | 主動分享工作經驗或案例、回應提問並連結工作情境、經引導後連結工作情境、未觀察到相關回應、不適用 | | 7 | 實作／活動完成情形 | 全數完成、大部分完成、部分完成、未完成、不適用 | | 8 | 教學設備及場地 | 正常、輕微異常、影響授課、無法使用 | 若第 1、2、3、4、5、7、8 項選擇代表異常或待改善的選項，畫面需提示填寫說明。 #### 課程觀察紀錄 - 本次課程值得保留或表現良好之處。 - 本次課程可改善事項及建議。 #### 異常及追蹤資料 - 異常情形：有／無。 - 處理過程及建議。 - 是否需後續追蹤：否，異常狀況順利解決，本案已結案；是，並填寫追蹤事項。 - 處理結果追蹤。 - 填表人員。 - 填表日期。 **驗收條件：** - 新增、修改、檢視畫面欄位與 1150730 示意圖一致。 - 8 項觀察選項的值可保存、修改、檢視。 - 選擇「無」時，不要求填寫異常相關欄位。 - 需要說明的觀察選項未填說明時，系統可提示使用者。 - 舊有教學日誌資料仍可正常開啟。 ### R-06 異常情形增加片語功能 **來源：** 1150722、1150730 **功能要求：** - 異常情形輸入欄位提供「片語」按鈕。 - 片語由負責同仁透過既有片語設定功能維護。 - 點選片語後，可將內容帶入異常情形文字框。 - 支援既有文字後追加片語，不覆蓋使用者已輸入內容。 - 年度課程執行狀況的異常情形顯示使用教學日誌保存的內容。 **驗收條件：** - 片語清單可正常載入。 - 點選片語可帶入文字框。 - 新增、修改、檢視及年度彙整內容一致。 - 沒有片語資料時，畫面仍可手動輸入。 ### R-07 處理結果追蹤獨立簽核 **來源：** 1150722 **功能要求：** - 「處理經過與結果」改名為「處理結果追蹤」的需求，依 1150730 最新畫面拆分為： - 處理過程及建議。 - 是否需後續追蹤。 - 追蹤事項。 - 處理結果追蹤。 - 教學日誌主表單完成簽核後，若有異常且需要追蹤，才可填寫處理結果追蹤。 - 處理結果追蹤填寫完成後，需使用獨立簽核流程送簽。 - 主表單與追蹤表單的簽核狀態需分開顯示。 - 追蹤簽核完成後，不得任意修改已簽核內容。 **驗收條件：** - 主表單未完成簽核時，不可填寫或送出追蹤結果。 - 無異常或不需追蹤時，不顯示不必要的追蹤操作。 - 追蹤內容可送簽、簽核、撤簽及檢視歷程。 ### R-08 教學日誌增加講師評鑑入口 **來源：** 1150722、1150727、1150730 **功能要求：** - 教學日誌畫面增加「講師評鑑」按鈕。 - 按鈕連結至講師評鑑功能頁面。 - 至少需傳遞講師編號。 - 若評鑑屬於單堂課程，應一併識別課程企劃編號及課程序號。 - 已有該堂評鑑資料時，入口應開啟修改或檢視模式，而不是重複新增。 **驗收條件：** - 從教學日誌可直接開啟正確講師的評鑑畫面。 - 評鑑資料可回到年度課程執行狀況查詢。 - 同一課程、節次及講師不得產生重複評鑑資料。 ### R-09 年度課程執行狀況增加教學日誌及講師評鑑 **來源：** 1150722、1150727、1150730 **功能要求：** - 主表格的「異常情形」欄位放在「教學方法」之後。 - 異常情形內容從教學日誌帶入，必要時以片語內容顯示。 - 課程明細分頁增加： - 教學日誌暨異常。 - 講師評鑑。 - 教學日誌分頁顯示 8 項課程執行觀察、觀察紀錄、異常及追蹤資料。 - 講師評鑑分頁顯示該課程及講師對應的評鑑資料。 **驗收條件：** - 選取年度課程後，兩個分頁均可正常載入。 - 沒有資料時顯示明確的空資料訊息。 - 課程切換、分頁切換及重新查詢不會顯示上一筆課程資料。 - 年度主表的異常內容與教學日誌一致。 ### R-10 訓練檢討報告增加改善措施 **來源：** 1150719 工作表及相關圖片 **功能要求：** 改善措施分為六個面向： - 學員。 - 講師。 - 教材及教具。 - 教學方法。 - 場地及設備。 - 行政流程。 每個面向包含： - 改善內容，可複選並以逗號分隔。 - 改善內容其他說明。 - 改善作法，單選。 - 改善作法其他說明。 - 補充說明。 當改善內容或改善作法選擇「其他」時，對應的其他說明欄位必填。 **驗收條件：** - 六個面向的欄位排列符合示意圖。 - 複選值可正確保存及重新勾選。 - 「其他」欄位有條件式必填檢核。 - 檢視、列印及匯出內容可正確顯示中文名稱。 ### R-11 教學日誌及訓練檢討報告匯出 **來源：** 1150719 **功能要求：** - 支援匯出單堂課程資料。 - 支援匯出全年度資料。 - 匯出格式參考滿意度調查匯出功能及 Excel 示意圖。 - 匯出內容需包含最新版本的教學日誌欄位與訓練檢討報告改善措施。 - 匯出檔需保留圖片示意的欄位順序、標題及版面結構。 **驗收條件：** - 單堂匯出內容與畫面資料一致。 - 年度匯出只包含指定年度資料。 - 無資料時不產生空白或錯誤檔案，並提供明確提示。 - 多筆資料的欄位不錯位，中文、換行及複選內容可正常顯示。 ### R-12 簽核流程整合 **來源：** 1150719、1150722 **最新處理方式：** - 原始需求的課程企劃書、教學日誌、訓練檢討報告一關簽核，保留作為整體流程背景。 - 後續新增的教學日誌「處理結果追蹤」採獨立簽核，不與主教學日誌共用同一張簽核單。 - 實際簽核關數依既有簽核設定及後續確認結果決定，不在程式中硬編碼。 ## 4. 目前程式現況 ### 4.1 已具備或已有基礎 | 項目 | 目前程式位置 | 現況 | |---|---|---| | 教材遴選 | `Forms/課程企劃/PickupMaterial.aspx`、`DAC/課程企劃/DAC_教材遴選*.cs` | 已有資料表、輸入及檢視基礎 | | 職能類型 | `DAC/基本資料/DAC_計畫別.cs` | 已有核心、專業、管理職能選項 | | 手動講師 | `Forms/課程企劃/PickupTeacher.aspx` | 已有手動姓名及相關欄位基礎 | | 手動場地 | `Forms/課程企劃/PickupPlace.aspx` | 已有手動場地名稱基礎 | | 手機問卷 | `MobileSurvey`、`Common/FollowService.cs` | 已有手機問卷及催填郵件基礎 | | 教學日誌資料欄位 | `DAC/辦訓狀況/DAC_教學日誌1.cs` | 已有 8 項觀察、觀察紀錄、異常及追蹤欄位 | | 教學日誌選項 | `DAC/辦訓狀況/DAC_教學日誌選項.cs` | 已有 8 組選項及名稱轉換 | | 教學日誌畫面 | `Forms/辦訓狀況/教學日誌處理.aspx` | 已有最新 8 項觀察及追蹤欄位畫面 | | 主教學日誌簽核 | `Forms/辦訓狀況/教學日誌處理.aspx.cs` | 已有主表單簽核流程 | | 追蹤結果簽核 | `Forms/辦訓狀況/教學日誌處理.aspx.cs` | 已有獨立追蹤簽核基礎 | | 年度異常欄位 | `Forms/辦訓狀況/年度課程執行狀況.aspx` | 已有主表及教學日誌明細異常欄位 | | 講師評鑑頁面 | `Forms/辦訓狀況/講師評鑑.aspx` | 已有獨立新增、修改及刪除功能 | | 檢討報告改善措施 | `DAC/辦訓狀況/DAC_訓練檢討報告1.cs` | 已有六面向欄位與資料存取基礎 | ### 4.2 明確待補或需確認 | 項目 | 現況問題 | 建議處理 | |---|---|---| | 異常片語 | `btn片語_Click` 目前為空方法，異常輸入區缺少完整片語操作 | 比照既有片語元件，接入 `DAC_片語` | | 教學日誌講師評鑑按鈕 | 教學日誌畫面尚未提供入口 | 增加按鈕並傳遞講師及課程識別資料 | | 年度講師評鑑分頁 | 年度頁面目前只有教學日誌分頁 | 增加 View、資料來源、分頁按鈕及重新綁定流程 | | 講師評鑑課程關聯 | 現有 `講師外訓滿意度` 主要以講師編號識別 | 確認是否新增課程企劃編號及課程序號關聯 | | 單堂匯出 | 目前未找到教學日誌及檢討報告單堂匯出入口 | 新增 Report 類別及頁面按鈕 | | 年度匯出 | 現有年度報表主要為課程摘要，未包含完整教學日誌及評鑑 | 擴充年度報表資料查詢及 Excel 版面 | | 提醒期限 | 已有問卷催填基礎，但需確認填寫期限與重複寄送規則 | 補齊期限欄位、排程條件及發送紀錄 | | 三份文件一關簽核 | 原始需求與後續獨立追蹤簽核存在版本差異 | 以後續獨立追蹤簽核為優先，確認主流程關卡設定 | ## 5. 建議實作方案 ### 5.1 第一階段：需求及資料模型確認 1. 將四份 Excel 的欄位、圖片畫面及流程整理成正式欄位對照表。 2. 確認資料庫現有欄位與長度，尤其是教學日誌 8 項觀察及講師評鑑關聯。 3. 確認講師評鑑是否以「講師」為單位，或以「課程企劃編號 + 課程序號 + 講師」為單位。 4. 確認問卷填寫期限的資料來源、排程執行方式及提醒寄送紀錄。 5. 確認簽核設定：主教學日誌、處理結果追蹤、訓練檢討報告各自的簽核關卡。 ### 5.2 第二階段：資料存取及服務層 1. 保留既有 `DAC_教學日誌` 欄位，僅補不足的資料庫欄位或索引。 2. 在 `DAC_教學日誌2.cs` 增加需要的驗證、片語查詢及年度彙整方法。 3. 擴充講師評鑑資料存取方法，支援依課程企劃及節次查詢。 4. 擴充年度課程查詢，一次取得課程、教學日誌及講師評鑑資料，避免畫面逐筆查詢造成效能問題。 5. 增加匯出專用資料模型，避免直接把畫面物件當作報表資料來源。 6. 補充問卷期限及提醒發送紀錄的資料存取方法。 ### 5.3 第三階段：教學日誌功能 1. 在 `教學日誌處理.aspx` 的異常情形輸入區加入片語按鈕及片語清單。 2. 使用既有 `DAC_片語` 查詢適用於異常情形的片語。 3. 保留 1150730 的 8 項觀察、觀察說明、兩項課程觀察紀錄及追蹤欄位。 4. 加入條件式驗證：選擇異常或待改善選項時提示填寫說明。 5. 加入「講師評鑑」按鈕，使用 PopupForm 開啟既有 `講師評鑑.aspx`。 6. 由教學日誌取得講師編號、課程企劃編號及課程序號，避免使用者重新選擇錯誤對象。 7. 保留主表單及處理結果追蹤的分離簽核流程。 ### 5.4 第四階段：年度課程執行狀況 1. 在 `年度課程執行狀況.aspx` 增加「講師評鑑」分頁及對應 `View`。 2. 增加講師評鑑 ObjectDataSource 或由後端一次載入課程關聯資料。 3. 修正課程切換、分頁切換及重新查詢時的資料綁定流程。 4. 保留主表格「教學方法」後的異常情形欄位。 5. 依示意圖調整教學日誌分頁欄位順序與顯示格式。 6. 無資料時顯示空資料訊息，不顯示上一課程殘留內容。 ### 5.5 第五階段：單堂及年度匯出 1. 新增教學日誌單堂匯出 Report。 2. 新增訓練檢討報告單堂匯出 Report。 3. 新增教學日誌及訓練檢討報告年度匯出 Report。 4. 依 Excel 圖片示意保留標題、欄位順序、合併儲存格、換行及欄寬。 5. 複選改善內容以中文名稱輸出，必要時以換行顯示，而不是直接輸出代碼。 6. 報表資料查詢使用單次批次查詢，避免每一列各自查詢資料庫。 7. 下載檔名包含課程或年度及產生時間，避免瀏覽器覆蓋既有檔案。 ### 5.6 第六階段：簽核及提醒流程 1. 檢查 `表單簽核主檔` 對教學日誌、追蹤結果及訓練檢討報告的關卡設定。 2. 以後續版本要求為準，讓處理結果追蹤保持獨立簽核。 3. 確認簽核完成後的欄位唯讀規則。 4. 補齊問卷填寫期限判斷、未填寫名單及提醒寄送紀錄。 5. 單一收件者寄送失敗時，繼續處理其餘收件者並記錄失敗原因。 ## 6. 建議修改檔案 ### 教材及課程企劃 - `Forms/課程企劃/訓練課程企劃書.aspx` - `Forms/課程企劃/PickupTeacher.aspx` - `Forms/課程企劃/PickupPlace.aspx` - `Forms/課程企劃/PickupMaterial.aspx` - `Forms/檢視UC/教材遴選View.ascx` - `DAC/課程企劃/DAC_教材遴選2.cs` ### 教學日誌及講師評鑑 - `Forms/辦訓狀況/教學日誌處理.aspx` - `Forms/辦訓狀況/教學日誌處理.aspx.cs` - `Forms/辦訓狀況/講師評鑑.aspx` - `Forms/辦訓狀況/講師評鑑.aspx.cs` - `DAC/辦訓狀況/DAC_教學日誌2.cs` - `DAC/辦訓狀況/DAC_教學日誌選項.cs` - `DAC/辦訓狀況/DAC_講師外訓滿意度2.cs` - `DAC/辦訓狀況/DAC_片語*.cs` ### 年度課程執行狀況 - `Forms/辦訓狀況/年度課程執行狀況.aspx` - `Forms/辦訓狀況/年度課程執行狀況.aspx.cs` - `Forms/檢視UC/教學日誌暨異常狀況View.ascx` - `Forms/檢視UC/教學日誌暨異常狀況View.ascx.cs` ### 訓練檢討報告及匯出 - `Forms/辦訓狀況/訓練檢討報告處理.aspx` - `Forms/辦訓狀況/訓練檢討報告處理.aspx.cs` - `DAC/辦訓狀況/DAC_訓練檢討報告2.cs` - `Report/年度課程執行狀況報表.cs` - 新增教學日誌及訓練檢討報告匯出 Report 類別 ### 問卷提醒 - `MobileSurvey/*` - `Common/FollowService.cs` - `SendMail/發送郵件.cs` - 問卷期限及發送紀錄相關 DAC ## 7. 測試計畫 ### 功能測試 - 教材遴選評分、綜合評估及手動講師／場地。 - 職能類型新增、修改、查詢及檢視。 - 手機問卷登入、填寫、期限及提醒郵件。 - 教學日誌 8 項觀察及條件式說明。 - 異常片語帶入、手動輸入及年度彙整。 - 主教學日誌簽核及處理結果追蹤獨立簽核。 - 從教學日誌開啟講師評鑑及回到年度頁面查詢。 - 年度課程執行狀況兩個新增分頁的資料正確性。 - 單堂及年度 Excel 匯出。 ### 相容性測試 - 已有舊教學日誌資料的檢視及修改。 - 沒有講師評鑑資料的課程。 - 沒有教學日誌資料的課程。 - 沒有異常、沒有追蹤事項的課程。 - 手動講師及手動場地資料。 - 多節次課程及同一講師多筆評鑑資料。 ### 安全及權限測試 - 未授權使用者不可修改已簽核資料。 - 追蹤結果只能由符合權限的使用者填寫及送簽。 - 匯出資料需遵守公司別及使用者權限。 - 郵件收件者及內容需進行輸入清理，避免標頭注入。 ## 8. 開放確認事項 1. 講師評鑑資料是否要以「課程企劃編號 + 課程序號 + 講師編號」作為唯一關聯？ 2. 1150719 的「三份文件一關簽核」是否確定由 1150722 的「處理結果追蹤獨立簽核」取代？ 3. 單堂及年度匯出是否需要完全依照 Excel 示意圖製作固定版型，或可使用欄位式 Excel 報表？ 4. 問卷填寫期限由課程企劃設定，還是由滿意度調查功能另外設定？ 5. 「課程內容」下拉選單是否只列出目前課程企劃的節次，或需可跨課程搜尋？ 6. 觀察項目的異常說明是否只在畫面提示，還是必須設定為資料庫必填？ ## 9. 建議交付順序 1. 先完成需求與資料庫欄位確認。 2. 完成教學日誌欄位、片語及獨立簽核驗證。 3. 完成講師評鑑課程關聯及教學日誌入口。 4. 完成年度課程執行狀況兩個分頁。 5. 完成單堂及年度匯出。 6. 完成教材遴選、問卷期限及提醒功能的差異補強。 7. 執行完整回歸測試、編譯及使用者驗收。 ## 10. 目前結論 目前程式已具備不少後續版本的資料欄位與教學日誌畫面基礎，但仍不能視為本次需求全部完成。最明確的缺口是： - 異常片語 UI 尚未完成。 - 教學日誌到講師評鑑的入口尚未完成。 - 年度課程執行狀況的講師評鑑分頁尚未完成。 - 教學日誌及訓練檢討報告的單堂、年度匯出尚未完成。 - 講師評鑑與課程節次的資料關聯仍需確認。 - 原始需求與追加需求的簽核規則需依最新決策固定下來。 ## 11. 程式碼比對結果與批示 本方案已與現有程式碼完成初步比對，完整差異請參考： `辦訓系統修改需求比對結果_1150730.md` ### 11.1 批示前現況摘要 | 條目 | 目前狀態 | 主要缺口 | 批示 | | ------------------- | -------- | ---------------------------- | ---- | | R-01 教材遴選 | 部分完成 | 主課程企劃入口及報表需確認 | | | R-02 職能類型 | 部分完成 | 仍有舊選項及舊報表文字 | | | R-03 手動講師／場地 | 部分完成 | 送簽檢核強制要求編號 | | | R-04 問卷期限提醒 | 需確認 | 目前為固定天數提醒 | | | R-05 最新教學日誌 | 部分完成 | 缺少條件式說明驗證 | | | R-06 異常片語 | 未完成 | 片語按鈕及帶入流程未完成 | | | R-07 追蹤獨立簽核 | 部分完成 | 條件判斷及簽核鎖定不足 | | | R-08 講師評鑑入口 | 需確認 | 無入口及課程節次關聯 | | | R-09 年度課程分頁 | 部分完成 | 缺講師評鑑分頁及完整日誌內容 | | | R-10 改善措施 | 部分完成 | 「其他」顯示及必填驗證不足 | | | R-11 單堂／年度匯出 | 未完成 | 尚無完整日誌及檢討報告匯出 | | | R-12 簽核整合 | 需確認 | 關數及簽核人員有硬編碼 | | ### 11.2 批示結果 | 條目 | 批示結果 | 批示說明 | 預計版本／日期 | | ---- | ---------------------------------------------------- | -------- | -------------- | | R-01 | 教材遴選的入口在課程內容畫面，所以已完成 | | | | R-02 | 移除舊選項，但要保持舊報表文字 | | | | R-03 | 改成送簽前要檢核編號與名稱要有其一 | | | | R-04 | 維持固定天數提醒 | | | | R-05 | 做 | | | | R-06 | 做 | | | | R-07 | 做 | | | | R-08 | 不做 | | | | R-09 | 不做講師評鑑分頁，需保留或完成「教學日誌暨異常」分頁 | | | | R-10 | 做 | | | | R-11 | 不做 | | | | R-12 | 維持硬編碼，客戶要求的 | | | **批示結果建議填寫：** 做、部分做、不做、待確認。