peipei-backend/media-migration-to-test.md

媒資/相簿相容性：手動驗證清單

1. WeChat 店員端 - 個資頁預覽

   • 登入店員帳號進入「我的資料」，確認相簿縮圖顯示為合併後的 mediaList + album，不應出現重覆 URL。
   • 點擊「照片」進入管理介面，確認 legacy album 中的圖片仍存在；上傳新媒資後應立即出現於列表。

2. 媒資上傳與排序

   • 上傳圖片與影片各一，測試格式/大小超限的錯誤提示與成功上傳後的狀態。
   • 排序、刪除媒資並提交審核，確認前端列表與預覽更新，且不會重複顯示相同 URL。

3. 後台店員列表

   • 在管理端店員列表中，確認每位店員的照片區塊都展示合併後的媒資清單（舊 album + 新媒資）。
   • 點擊圖片預覽，確認輪播順序正確、無重覆 URL。

4. 後台店員審核詳情

   • 查看一筆含多張舊相簿照片的申請，確認圖片區塊已改用 mediaGallery，兼容新舊媒資。
   • 點擊照片預覽，確認圖片來源為合併後的清單。

5. API 回應驗證

   • 呼叫 /clerk/user/list 或 WeChat 前端使用的 API，檢查 album 欄位仍保留原值，mediaList 會包含新媒資並附帶 legacy URL（無重複）。
   • 若資料仍未遷移，確保 mediaList 仍會帶上舊 album 的 URL。

6. 媒資審核流程

   • 走一次「上傳 → 排序 → 提交 → 審核」流程，確認審核通過後 mediaList 只保留 Approved 的媒資，但 album 不會被清除，舊客端仍能看到舊資料。