返回任務地圖

取得真正的案件編號

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

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

取得真正的案件編號,每一步都有依據。

送出會改變持久資料,必須依201與case.id判斷。這堂保留公開回應白名單,不能為了查核開放所有案件。

這關帶走:實際201與伺服器id才成功,沒有前端編號。

步驟 1/6 · 觀念 18 分鐘

先學一招:成功依後端格式,不依畫面猜測

實際201與伺服器id才成功,沒有前端編號。

帶上你的裝備

  • 自己的service-site/frontend/inquiry.html、inquiry.js、config.js與完整styles.css
  • 隨起始包提供的API_CONTRACT.html、START_HERE.html與實際Network紀錄;不附管理密碼
  • 實際POST欄位與201成功格式、自己的唯一主旨與同案檢查表

送出會改變持久資料,必須依201與case.id判斷。這堂保留公開回應白名單,不能為了查核開放所有案件。

先分清自己的作品、線上畫面與可啟動參考包;線上參考不提供API,請在本機閱讀隨包OPEN_REFERENCE.html後操作。

一起拆解:用回傳id追同一筆詢問

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

這次的輸入

五欄填虛構資料及唯一主旨;後端成功回201與QH-UUID。

POST /api/inquiries
Idempotency-Key: 同次詢問的隨機識別
201 {case:{id:"QH-…",status:"pending",createdAt:"…"}}

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

一步一步推演

  1. 先核對body只有五欄,識別放header,不貼密碼給AI。
  2. 只有201且id格式有效才說已保存;同頁同內容重試沿用同key。
  3. 記實際id,以manage inspect及重啟後讀同id核對;範例QH-…不能抄成證據。

正常應看到

畫面編號與真正持久案件相同,重送相同識別不增加第二案。

常見錯誤對照

用Date.now在前端編一個號碼,不能證明後端保存。

先預測,再說明原因

如果重整頁面才重送,為何仍要先核對是否已有同主旨案件?

跟著觀察

  1. 先讀「用回傳id追同一筆詢問」的輸入,指出本關實際檔案或資料。
  2. 如果重整頁面才重送,為何仍要先核對是否已有同主旨案件?
  3. 依例子逐步說明正常結果與錯誤差別,再記下自己的預測;參考結果不是已完成的實測。
哪個能證明真正保存?

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

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

步驟 2/6 · 實作 42 分鐘

動手挑戰:取得真正的案件編號

實際201與伺服器id才成功,沒有前端編號。

先準備

  • 自己的service-site/frontend/inquiry.html、inquiry.js、config.js與完整styles.css
  • 隨起始包提供的API_CONTRACT.html、START_HERE.html與實際Network紀錄;不附管理密碼
  • 實際POST欄位與201成功格式、自己的唯一主旨與同案檢查表

親手寫唯一主旨,送出後記實際id與Network。

照這個順序開始

  1. 用虛構五欄與唯一主旨,核對契約成功格式。
  2. 請AI接POST與201/id判斷,不用localStorage案件模擬。
  3. 用受控manage工具讀同id,停止重啟後再核對主旨與服務。

串接詢問建立與真實保存

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

1.附上這些檔案與資料
  • 自己的service-site/frontend/inquiry.html、inquiry.js、config.js與完整styles.css
  • 隨起始包提供的API_CONTRACT.html、START_HERE.html與實際Network紀錄;不附管理密碼
  • 實際POST欄位與201成功格式、自己的唯一主旨與同案檢查表
2.貼到哪裡
  1. 在 Cursor 開啟自己的本關練習副本,進入內建 AI 對話;正常版與故障副本分開。
  2. 用 @ 附上本關指定檔案,核對完整路徑;補實際觀察、輸入與結果,再貼下方 Prompt。
  3. 先讀回覆與差異,只保存指定範圍;回到瀏覽器實際檢查。版本保存由自己操作,不讓 AI 代替驗收或提交。
3.預期回覆與操作
  • 請AI接POST與201/id判斷,不用localStorage案件模擬。
  • 重啟後由受控工具核對同案,原輸入保留。
4.自己檢查結果
  • 實際201與伺服器id才成功,沒有前端編號。
  • 重啟後由受控工具核對同案,原輸入保留。
串接詢問建立與真實保存 Prompt(可收合)

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

情境與本次輸入:承接第17堂已讀取服務的真實教學後端。POST /api/inquiries JSON只含name/email/serviceId/subject/message;201 {case:{id,status,createdAt}}且id為QH-UUID才成功。422為欄位錯誤、503 save_failed尚未保存;其他斷線逾時或格式不明先核對不自動重送。管理登入前端下堂才做,受控保存核對用backend/manage.mjs inspect --id,不公開全部案件。資料在backend/.data,重啟仍在;身份session重啟失效與資料保存不同。 詢問POST須附Idempotency-Key header,由前端crypto.randomUUID產生;同頁同五欄重試沿用key,改內容才換新key。後端持久去重,同key不同內容409,管理與公開回應不含內部key/摘要。

本次任務:依隨包契約POST /api/inquiries,只送trim後name/email/serviceId/subject/message,credentials:include與JSON Content-Type。只有response.status=201且case.id是QH-開頭的伺服器編號才顯示已保存;錯誤、非JSON、缺id不編假號。保留五欄與草稿,資料不清空,不公開管理列表。更新送出按鈕與階段說明,分清真正保存與本機草稿。提供同主旨/id以manage inspect及重啟後核對的步驟,不替我假填成功。本關先接基本POST,下關再加pending、逾時與欄位對應。 另依契約加Idempotency-Key header:同頁相同JSON資料重試沿用crypto.randomUUID產生的key,修改資料才換新key。由講師後端做持久防重複,不自行造第二個案件;body仍只五欄。

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

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

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

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

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

卡住時,APPA 給你一點線索

線索 1|先找現象與證據

先記錄實際id,不用預置DEMO案串接。

線索 2|再縮小修改範圍

核對inspect的資料來源與啟動時DATA_DIR相同。

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

  • 實際201與伺服器id才成功,沒有前端編號。
  • 重啟後由受控工具核對同案,原輸入保留。
  • 未實際完成的AI、發布或裝置驗收記待完成。
需要對照?看這一關的參考成果

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

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

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

下載本關可啟動參考包

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

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

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

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

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

留下自己的檢查紀錄

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

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