後段實作：用 Firebase Console 建立 Firestore

實作 repo 的資料模式

講師與全班統一使用的設定

A. 建立自己的 Firebase 課程專案

1. 1開啟 https://console.firebase.google.com/，以自己的課程 Google 帳號登入，按「建立專案／Create a project」。
2. 2專案名稱輸入 wca-schedule-你的GitHub帳號。不要放診所名稱、真實人名、病歷號或其他敏感資訊。
3. 3看到 Project ID 時先核對。這個識別碼建立後不能更改；本課不需要刻意手動改成複雜名稱。
4. 4Google Analytics 對本課不是必要功能；若畫面詢問，可以關閉後繼續。Gemini 或其他加值功能也先略過。
5. 5按「建立專案」，等畫面顯示完成，再進入專案總覽。

B. 註冊 Web App，先保留設定畫面

1. 1在 Project overview 按 Web 圖示「</>」；若找不到，進入齒輪 Project settings → General → Your apps，再選 Web。
2. 2App nickname 輸入 wca-schedule-web。這個名稱只用來辨識，不是公開網站網址。
3. 3不要勾選 Firebase Hosting；上一課已使用 Vercel 建立網站，本課只加入 Firestore。
4. 4按 Register app。畫面出現 firebaseConfig 物件後先不要關閉；稍後只需要其中六個欄位。

C. 建立 (default) Firestore 資料庫

1. 1從左側選單進入 Databases & Storage → Firestore Database，按 Create database。
2. 2若畫面詢問 edition 或 mode，選 Standard edition／Native mode；Database ID 保持 (default)。
3. 3Location 選 asia-east1 (Taiwan)。資料庫位置建立後不能更換，按下一步前請再讀一次畫面。
4. 4起始規則選 Production mode，不選 Test mode；接著按 Create 建立資料庫。
5. 5資料頁暫時是空的完全正常。現在不要按 Start collection；courseScheduleEntries 會在教材第一次成功寫入時自動建立。

為什麼不選 Test mode？

D. 用教材完整規則取代起始規則

1. 1在 Firestore Database 頁切到 Rules／規則分頁，先核對左上角仍是自己的專案與 (default) 資料庫。
2. 2在編輯器內全選並刪除原本的起始規則。不要只把新規則貼在舊規則下方。
3. 3按下方複製按鈕，將整份規則原樣貼入。確認集合名稱是 courseScheduleEntries，最後一段是 allow read, write: if false。
4. 4按 Publish／發布。發布後先等候約一分鐘，再進行教材驗收；不要因短暫 permissions 錯誤改成全面開放。

直接複製：本課唯一允許的 Firestore Rules

必須整份取代 Firebase Console 裡的起始內容並發布。不要省略註解以外的任何一行，也不要把 false 改成 true。

rules_version = '2';

service cloud.firestore {
  match /databases/{database}/documents {
    // 課程 Demo 沒有登入，因此這不是正式的使用者存取控制。
    // 規則只限制可寫入的集合、欄位與資料形狀；專案只准放合成資料。
    match /courseScheduleEntries/{entryId} {
      allow read: if true;
      allow create, update: if validEntry(entryId);
      allow delete: if true;
    }

    match /{document=**} {
      allow read, write: if false;
    }

    function validEntry(entryId) {
      let data = request.resource.data;
      return data.keys().hasOnly([
          'id', 'date', 'personId', 'state', 'shiftId', 'note', 'updatedAt'
        ])
        && data.keys().hasAll(['id', 'date', 'personId', 'state', 'updatedAt'])
        && data.id == entryId
        && data.id is string
        && data.date is string
        && data.date.matches('^\\d{4}-\\d{2}-\\d{2}$')
        && data.personId is string
        && data.personId.size() > 0
        && data.personId.size() <= 80
        && data.state in ['shift', 'leave']
        && data.updatedAt is int
        && (!data.keys().hasAny(['note']) || (data.note is string && data.note.size() <= 200))
        && (
          (data.state == 'shift'
            && data.keys().hasAll(['shiftId'])
            && data.shiftId in ['morning', 'afternoon', 'evening'])
          ||
          (data.state == 'leave' && !data.keys().hasAny(['shiftId']))
        );
    }
  }
}

這份規則實際允許與阻擋什麼

E. 找到 Web config 的六個欄位

1. 1按 Firebase Console 左上角齒輪 → Project settings → General。
2. 2往下找到 Your apps，選剛才建立的 wca-schedule-web。
3. 3在 SDK setup and configuration 選 Config，不選 npm 或 CDN 教學指令。
4. 4準備把 apiKey、authDomain、projectId、storageBucket、messagingSenderId、appId 六個值提供給 Claude。不要提供 service account、私鑰、密碼、token 或驗證碼。

六個欄位要一一對應

請 Claude App 只填 Firebase Web config

請只修改 `src/course/firebase.config.ts`，把我接下來提供的 Firebase Web config 六個欄位填入對應位置：apiKey、authDomain、projectId、storageBucket、messagingSenderId、appId。請保留欄位名稱與其他檔案不變，不要安裝套件、不要修改 firestore.rules、不要 commit、不要 push。這些值只能來自我自己的 Firebase Web App；不要要求 service account JSON、私鑰、密碼、token 或驗證碼。完成後請列出實際修改的檔案與六個欄位名稱，不要重貼完整值。

F. 用 /course-check 與 Firebase Data 頁完成驗收

1. 1Claude 修改完成後先看 Review changes：只能有 src/course/firebase.config.ts，而且六個 PASTE_YOUR_ 佔位文字都已被取代。
2. 2在 Claude App 重新啟動 Preview，打開 Preview 網址後在網址最後加上 /course-check。不要另外開 Terminal。
3. 3確認 Firebase Web config 檢查通過，資料模式顯示 Firestore cloud mode，連線狀態顯示 synced。若仍是 localStorage，先看下方排錯表。
4. 4回到排班頁，用「王醫師（虛構）」等合成資料建立一筆班別，重新整理頁面，確認資料仍存在。
5. 5回 Firebase Console → Firestore Database → Data，應看到自動建立的 courseScheduleEntries 集合與一筆文件。不要手動建立其他集合。
6. 6截圖驗收前，確認畫面沒有真實姓名、診所資料、帳號 email、token 或其他敏感內容。

卡住時依錯誤訊息處理