返回任務地圖

讓保存狀態說真話

第 22 堂 · 第 2/3 關 · 觀念 18 分鐘+實作 42 分鐘

查看本堂完整六步
先接任務,準備開始

讓保存狀態說真話,每一步都有依據。

輸入改變就未保存;請求進行中不能假成功;失敗保留文字,後端重讀一致後才是已保存。

這關帶走:四狀態依實際請求變化,未保存不假成功。

步驟 3/6 · 觀念 18 分鐘

先學一招:四種回饋要配合實際階段

四狀態依實際請求變化,未保存不假成功。

帶上你的裝備

  • 自己的service-site/frontend/admin-login.html、admin-cases.html、admin.js、config.js與styles.css
  • 隨包API_CONTRACT.html與真實教學後端;只用虛構案件,不把密碼或Cookie貼給AI
  • 四狀態預期與normal/update-error回應

輸入改變就未保存;請求進行中不能假成功;失敗保留文字,後端重讀一致後才是已保存。

一起拆解:保存舊版本時又繼續打字

本關18分鐘觀念:3分鐘看輸入、6分鐘逐步推演、5分鐘正常與錯誤對照、4分鐘先預測再說明。

這次的輸入

按保存A文字v1後,回應尚未到就把目前文字改v2。

送出v1 → 保存中
目前輸入v2 → 保留v2
後端確認v1 → 提示v1已存、目前v2未存

這段是觀念縮圖,完整可操作檔案在本關參考成果;請依當前階段判讀,不把片段直接貼到任意位置。

一步一步推演

  1. 先分送出版本、目前輸入及後端重讀值三個位置。
  2. 保存成功只能確認送出版本;不可用舊回應覆蓋較新的頁內草稿。
  3. 另測503失敗保留文字、401清私密暫存,提示配合實際階段。

正常應看到

新輸入不遺失,保存回饋不把v2誤標已保存。

常見錯誤對照

每次成功都重畫textarea為v1,會吞掉使用者剛打的v2。

先預測,再說明原因

重讀v1正確時,為何仍不能把目前v2標示為已保存?

跟著觀察

  1. 先讀「保存舊版本時又繼續打字」的輸入,指出本關實際檔案或資料。
  2. 重讀v1正確時,為何仍不能把目前v2標示為已保存?
  3. 依例子逐步說明正常結果與錯誤差別,再記下自己的預測;參考結果不是已完成的實測。
何時可以顯示已保存?

選一個試試看,答錯也可以再試。

這是你的實際操作確認,小測不會替你勾選。

步驟 4/6 · 實作 42 分鐘

動手挑戰:讓保存狀態說真話

四狀態依實際請求變化,未保存不假成功。

先準備

  • 自己的service-site/frontend/admin-login.html、admin-cases.html、admin.js、config.js與styles.css
  • 隨包API_CONTRACT.html與真實教學後端;只用虛構案件,不把密碼或Cookie貼給AI
  • 四狀態預期與normal/update-error回應

親手走一次改字、保存與503,分別記四種狀態。

照這個順序開始

  1. 在正常備註版記目前提示與真實請求。
  2. 請AI只補四狀態回饋,不改API或加自動保存。
  3. 503保留文字,恢復後手動存並重讀,401清私密內容。

補齊備註四種保存回饋

主要使用 Cursor 內建 AI;先附資料,再送出指令。

1.附上這些檔案與資料
  • 自己的service-site/frontend/admin-login.html、admin-cases.html、admin.js、config.js與styles.css
  • 隨包API_CONTRACT.html與真實教學後端;只用虛構案件,不把密碼或Cookie貼給AI
  • 四狀態預期與normal/update-error回應
2.貼到哪裡
  1. 在 Cursor 開啟自己的本關練習副本,進入內建 AI 對話;正常版與故障副本分開。
  2. 用 @ 附上本關指定檔案,核對完整路徑;補實際觀察、輸入與結果,再貼下方 Prompt。
  3. 先讀回覆與差異,只保存指定範圍;回到瀏覽器實際檢查。版本保存由自己操作,不讓 AI 代替驗收或提交。
3.預期回覆與操作
  • 請AI只補四狀態回饋,不改API或加自動保存。
  • 失敗保留文字,恢復手動保存後同案一致。
4.自己檢查結果
  • 四狀態依實際請求變化,未保存不假成功。
  • 失敗保留文字,恢復手動保存後同案一致。
補齊備註四種保存回饋 Prompt(可收合)

你是協助零基礎學員的網站開發助手。我使用 Cursor 免費版編輯原生 HTML、CSS、JavaScript;必要時把你提供的內容手動貼入檔案。

情境與本次輸入:沿用提供的Node教學後端與HttpOnly session cookie,前端fetch credentials:include,不把認證存在localStorage。POST /api/auth/login、GET /api/auth/me、POST /api/auth/logout;受保護GET /api/admin/cases回cases摘要,GET /api/admin/cases/:id回case明細,PATCH同路徑只接受status及/或internalNote。未登入401、找不到404、欄位422、教學更新失敗503。案件使用實際穩定id,從第18堂同案延續,不以不同預置案假串接。 備註PATCH同id,internalNote最多2000字,成功後GET同id核對;只在目前頁面記憶體暫存未保存文字,不用localStorage或公開欄位。公開GET /api/services白名單只有services,詢問成功receipt只有id/status/createdAt。獨立故障後端在services回應洩漏debugNotes,只能在本機隔離測試,不公開部署。

本次任務:只改善備註未保存、保存中、已保存、保存失敗四種回饋:input改變標未保存,請求中禁用保存,收到成功並GET同id一致才已保存;失敗保留文字並可手動再試。保留記憶體暫存、401/登出清理、不用localStorage、不自動保存。不要改後端、進度與篩選,列四狀態與重載驗收,未實測不填成功。

請先閱讀我附上的相關檔案或資料,資訊缺漏時精確列出需要補充的項目,不猜檔名、API 或測試結果。說明以繁體中文撰寫,指出檔案與修改位置;檢查結果區分已知、待驗與未完成。只處理學生自己的練習副本,不改現有展示網站,不要求付費訂閱。
Cursor AI 無法使用?改用 ChatGPT 備援

把上方指定的檔案內容、清單與補充資料,連同同一份 Prompt 貼入 ChatGPT 對話。只貼電腦上的路徑,無法讓它讀取你的檔案。

收到程式碼時,先核對檔名與修改位置,再手動存回自己的練習副本;若收到檢查表或補檔步驟,就逐項操作。不要把 Prompt 或程式碼框的反引號貼進 HTML/CSS。

兩邊都受限時,可先看既有參考成果、檢查差異與手動修改;未做過的 AI 生成或公開發布仍記待完成。不要貼入帳密、金鑰或真實個資。

複製只取得 Prompt 文字,檔案需自行在 Cursor 附上;本頁不會呼叫 AI 或自動完成關卡。

卡住時,APPA 給你一點線索

線索 1|先找現象與證據

先標保存中,不要在fetch前寫成功。

線索 2|再縮小修改範圍

失敗別rerender把目前textarea清掉。

回到自己的作品,逐項檢查

  • 四狀態依實際請求變化,未保存不假成功。
  • 失敗保留文字,恢復手動保存後同案一致。
  • 未實際完成的AI、發布或裝置驗收記待完成。
需要對照?看這一關的參考成果

先檢查自己的作品,再對照差異。開啟參考不會算完成。

查看前端參考畫面(完整操作請下載參考包)(另開分頁)

線上只看前端畫面;完整操作請下載。本頁不提供案件API。把參考包解壓到新的資料夾,先讀 OPEN_REFERENCE.html,再啟動隨包後端;不要覆蓋自己的作品或案件。

下載本關可啟動參考包

看參考包啟動與資料保留步驟

尚未完成可以先往下看,之後再回來補做。

保留依據與結果,再帶著作品往下走。

保留自己的修改差異與檢查結果。完成兩項操作確認再往下一關;也可以先閱讀,稍後補做。

關卡紀錄由你自行確認;本頁不會讀取 Cursor 檔案或自動驗收作品。

留下自己的檢查紀錄

這是第 22 堂共用筆記,換關卡仍會保留。未實際做過的操作寫「待完成」。

重設會清除第 22 堂六步勾選,筆記、另一堂進度與網站檔案保留。