親愛的同仁您好：
前一版已經讓學生能在作業頁面查看提交紀錄與教師評分，也讓老師可以匯出 Word 或成績資料。這一輪再把散落於系統中的作答、語音、AI 回饋、心得與批改結果整理成一份可以完整保存的學習成果包。
這次更新的重點很直接：學生在作業完成且老師批改後，可以自行下載自己的完整成果；老師也可以依作業一次替所有符合資格的學生產生成果包，寄到學生的主要信箱與備用信箱。
42889e4 的程式版本，並已同步整理至 Oral 原始碼工作樹；正式環境仍須完成資料庫結構、物件儲存、公開網址與寄信設定後再部署。本次更新的核心方向
一、讓學生能把一整次練習的文字、語音、回饋、心得與教師批改完整帶走，不必分散下載或自行整理。
二、讓老師可以依作業批次寄送成果，並清楚看見符合資格、尚未完成及尚未批改的人數。
三、讓成果檔案有明確的存取期限、下載權限、清理機制與操作紀錄，避免把私人學習資料長期放在不受控的公開網址。
一、學生可以下載自己的完整成果
學生完成作業且老師完成批改後，作業頁面會提供「下載完整成果」入口。系統會即時建立 ZIP 壓縮檔；若作業尚未完成、尚未批改，或不是該名學生自己的提交紀錄，後端會直接拒絕匯出。
學生下載與教師寄送使用同一套成果包產生邏輯，因此不會出現學生自行下載一種格式、老師寄出的又是另一種內容。
學習成果報告
整理職位設定、寫作草稿與定稿、AI 回饋、跟讀、角色扮演逐輪內容、心得學習單，以及最新教師評分與評語。
依用途分類保存
收錄四題跟讀示範、學生跟讀錄音、面試官語音與學生面試錄音，並使用固定資料夾與題號／回合命名。
可以核對完整性
成果包內附檔案清單與各類音檔數量，方便學生與老師確認應有內容是否齊全。
不默默混用舊格式
若必要資料、題號或音檔回合不完整，系統會明確回報失敗，不會產生一份看似成功但內容缺漏的成果包。
二、老師可以依作業批次寄送
管理端的學習成果頁面新增「寄給學生」功能。開啟後，系統會先顯示符合資格、尚未完成及尚未批改的人數；寄送範圍以老師可管理的學生與該作業最新一次已完成、已批改的提交為準，不受畫面上的搜尋、勾選或篩選條件影響。
確認後，系統會在背景逐一建立成果包並寄送。老師可以在畫面上查看處理進度、成功與失敗項目；若部分信箱寄送失敗，也可以只重試失敗項目，不必重新寄給全部學生。
主要信箱與備用信箱分開記錄
每位學生的主要信箱與備用信箱會分別記錄寄送結果。只要其中一個信箱寄送失敗，畫面就會保留對應狀態，讓老師知道需要重寄或另行聯絡；系統不會因另一個信箱成功就把失敗紀錄蓋掉。
三、下載連結與檔案保存範圍
教師寄出的成果包預設保存 14 天。學生點開信件連結時，不需要再次登入系統；因此連結本身等同短期下載憑證，不應轉寄、公開張貼或交給無關人士。
每一套資料庫會使用各自的檔案空間識別碼。正式環境若重建資料庫，必須產生新的識別碼，避免新資料誤用或覆寫舊資料庫仍留在雲端檔案空間中的學生檔案。
四、既有匯出與資料處理一併整理
這次也將 Word 與音檔產生功能集中到同一套共用程式，讓學生下載、教師個別匯出與批次寄送使用相同規則。檔名會移除不適合出現在路徑中的字元，音檔也必須屬於目前的檔案空間與允許類別。
心得、角色扮演與評分資料也改用目前統一的資料格式產生報告。若遇到舊格式或資料不一致，系統會停止該份匯出並留下錯誤資訊，方便後續查明原因。
五、正式部署前需要完成的設定
- 資料庫需具備新版寄送工作欄位與
result_packages資料表；不能只更新程式而沿用未調整的舊結構。 - 必須設定新的檔案空間識別碼
OBJECT_STORAGE_NAMESPACE，並確認私有雲端檔案空間可正常建立、讀取及刪除成果包。 PUBLIC_BASE_URL必須是正式 HTTPS 網址，寄出的下載連結才會回到正確系統。- 必須實際驗證電子郵件服務（SMTP）的寄件者、主要信箱、備用信箱、失敗重試與退信處理。
- 預設成果包保存 14 天、轉址下載網址有效 300 秒；若要調整，應先確認課程需求與資料保存政策。
六、使用者需要注意什麼
- 只有已完成且已有教師批改的作業，才會出現完整成果下載。
- 學生自行下載只限本人提交；老師批次寄送只限其可管理的作業與學生。
- 寄送連結預設 14 天後失效，收到後請在期限內下載並妥善保存。
- 成果包包含作答、錄音、AI 回饋、心得與教師評分，請勿任意轉寄或公開。
- 這次更新不會刪除既有作答、錄音、AI 回饋、心得或教師評分；正式部署仍須以實際資料庫更新與驗證結果為準。
學生投入時間完成寫作、跟讀、角色扮演與心得後，這些成果不應只留在系統畫面裡。這次更新希望讓學生能保留一份完整、可閱讀也可回聽的學習紀錄，也讓老師在課程結束前，可以用比較清楚且可追蹤的方式把成果交還給每一位學生。
謹此說明
統計範圍：版本 1ee2c8b5c441d0aa08f480d548d51a9b017ee069 之後至 42889e44ca8aacf279e353eca79e7deef4641850，共 1 次提交；差異統計為 45 個檔案、約新增 3,558 行及刪除 432 行。
日日有好事
洪名琮 敬上
|
||
|
