emo 技術問題通報 — 卡片生成成功但無法儲存至牌組

📌 問題摘要

「Studio 快速生成（Flashcard / MCQ）回報成功，但卡片未實際存入牌組資料庫，且既有卡片組顯示為空（itemCount: 0）。」

🧩 問題描述（Troubleshooting Steps）

Blur Table

項目內容功能對話中生成 Flashcard / MCQ（generateFlashcards / generateMCQFlashcards）現象工具回報「生成成功」，但卡片無法從牌組讀取／學員無法在牌組看到卡片關鍵異常已存在的卡片組 itemCount 顯示為 0，即使系統曾確認加入卡片

🔄 重現步驟（Reproduction Steps）

• 進入牌組，要求生成某主題的 MCQ / 閃卡（例如「HFMD MCQ」「Febrile Seizures MCQ」「GERD MCQ」）。

• 系統工具回應「成功生成」，並回報完整卡片數量（如 12–14 張）及來源引用。

• 查看牌組卡片組清單（listFlashcardSets）。

• 實際結果： 生成的卡片組未出現，或出現但 itemCount: 0（空）。

⚠️ 影響範圍（Impact）

連續多組主題皆無法儲存，非單一案例：

Blur Table

卡片組預期實際狀態Febrile Seizures MCQ12 張itemCount: 0 / 未顯示Kawasaki Disease MCQ12 張itemCount: 0Croup MCQ12 張itemCount: 0GERD MCQ14 張未顯示

🧪 推測可能原因（供參考，非診斷）

• 卡片產生物件（generate 回傳）有生成，但未成功寫入（persist）牌組資料庫。

• 非同步寫入失敗／交易未 commit，導致工具層回報成功但資料層未保存。

• 既有卡片組 itemCount 同步異常，反映資料量同步 pipeline 可能有問題。

💡 建議（Suggested Actions）

• 檢查並修復 卡通儲存／commit 流程，確保「成功回報」與「實際寫入」一致。

• 核對 itemCount 計算 是否與真實卡片數同步，清除顯示為 0 的幽靈卡片組。

• 提供使用者重新生成或強制同步的機制，以恢復遺失卡片。

• 若為已知版 bug，建議保留未預期清單並盡快 hotfix。

這份通報內容您可以直接複製使用。若您希望，我也可以：

• 把內容精簡成更短的版本方便快速提交；

• 或協助您連同發生時間、牌組 ID 一併補充（牌組 ID：358e3472-34d4-4a15-8ab2-63e0e9a017c8）。