AI 商用網站開發跟著步驟，做出自己的作品
返回任務地圖

替同一筆案件留下處理紀錄

第 22 堂 · 第 1／3 關 · 觀念 18 分鐘＋實作 42 分鐘

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

替同一筆案件留下處理紀錄，每一步都有依據。

textarea有字不代表已保存。PATCH成功後GET同id，重新整理仍一致，才是這堂的保存證據。

這關帶走：同id保存重讀一致、他案備註不變。

步驟 1／6 · 觀念 18 分鐘

先學一招：備註保存要有後端重讀

同id保存重讀一致、他案備註不變。

帶上你的裝備

  • 自己的service-site/frontend/admin-login.html、admin-cases.html、admin.js、config.js與styles.css
  • 隨包API_CONTRACT.html與真實教學後端；只用虛構案件，不把密碼或Cookie貼給AI
  • 同id案件、internalNote契約、自己的虛構備註與前後資料
取得本堂起始檔看本堂操作指南

textarea有字不代表已保存。PATCH成功後GET同id，重新整理仍一致，才是這堂的保存證據。

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

一起拆解：看見備註，不代表保存

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

這次的輸入

A案textarea輸入「已確認素材」，尚未按保存。

輸入 → 未保存（只在此頁記憶體）
PATCH → 保存中
GET同id核對 → 已保存

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

一步一步推演

  1. 先編輯A，再切B回A，區分頁內暫存與後端資料。
  2. 按保存後等待PATCH，再GET同id核對internalNote；不存localStorage。
  3. 重整或重啟後重新登入讀A，檢查真實保存值。

正常應看到

已保存文字能由後端同案重讀；未保存文字清楚標示限制。

常見錯誤對照

textarea.value存在不能證明資料已寫入持久檔。

先預測，再說明原因

按保存後立刻斷線，應顯示已保存還是尚未確認？

跟著觀察

  1. 先讀「看見備註，不代表保存」的輸入，指出本關實際檔案或資料。
  2. 按保存後立刻斷線，應顯示已保存還是尚未確認？
  3. 依例子逐步說明正常結果與錯誤差別，再記下自己的預測；參考結果不是已完成的實測。
textarea看得到文字，代表已保存嗎？

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

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

步驟 2／6 · 實作 42 分鐘

動手挑戰：替同一筆案件留下處理紀錄

同id保存重讀一致、他案備註不變。

先準備

  • 自己的service-site/frontend/admin-login.html、admin-cases.html、admin.js、config.js與styles.css
  • 隨包API_CONTRACT.html與真實教學後端；只用虛構案件，不把密碼或Cookie貼給AI
  • 同id案件、internalNote契約、自己的虛構備註與前後資料

親手寫虛構處理紀錄，記同id，保存後重載。

照這個順序開始

  1. 先核對同案id與另一案原備註。
  2. 請AI加internalNote保存、重讀與安全文字，不寫localStorage。
  3. 實際保存、重載、換案及標籤字串，核對他案不變。

建立同案內部備註保存

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

1．附上這些檔案與資料
  • 自己的service-site/frontend/admin-login.html、admin-cases.html、admin.js、config.js與styles.css
  • 隨包API_CONTRACT.html與真實教學後端；只用虛構案件，不把密碼或Cookie貼給AI
  • 同id案件、internalNote契約、自己的虛構備註與前後資料
2．貼到哪裡
  1. 在 Cursor 開啟自己的本關練習副本，進入內建 AI 對話；正常版與故障副本分開。
  2. 用 @ 附上本關指定檔案，核對完整路徑；補實際觀察、輸入與結果，再貼下方 Prompt。
  3. 先讀回覆與差異，只保存指定範圍；回到瀏覽器實際檢查。版本保存由自己操作，不讓 AI 代替驗收或提交。
3．預期回覆與操作
  • 請AI加internalNote保存、重讀與安全文字，不寫localStorage。
  • 標籤呈普通文字，不存localStorage且失效清暫存。
4．自己檢查結果
  • 同id保存重讀一致、他案備註不變。
  • 標籤呈普通文字，不存localStorage且失效清暫存。
建立同案內部備註保存 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，只能在本機隔離測試，不公開部署。

本次任務：在現有案件明細加入internalNote textarea最多2000字及手動保存button，只PATCH /api/admin/cases/:id的internalNote，成功GET同id核對完全相同才標保存。保留進度、篩選、身份及其他案件，資料以value/textContent顯示，<strong>測試</strong>不執行HTML。不用localStorage；未保存內容只在此頁記憶體按id暫存，401/登出清掉。失敗保留目前文字，公開回應不應有備註；後端缺項列需講師修，不以藏畫面通過。列重載、他案不變、匿名拒絕與公開欄位驗收。

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

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

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

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

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

卡住時，APPA 給你一點線索

線索 1｜先找現象與證據

PATCH與GET都使用當前穩定id。

線索 2｜再縮小修改範圍

不要把備註放到公開草稿的key。

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

  • 同id保存重讀一致、他案備註不變。
  • 標籤呈普通文字，不存localStorage且失效清暫存。
  • 未實際完成的AI、發布或裝置驗收記待完成。
需要對照？看這一關的參考成果

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

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

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

下載本關可啟動參考包

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

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

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

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

前往下一關：讓保存狀態說真話返回上一關：排序後，也不能改錯案件

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

留下自己的檢查紀錄

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

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