開啟教學前端

啟動自己的教學後端

這是第二作品service-site的起始後端,學生學理解與串接,不需要從零寫認證。只在自己的教學副本操作;三個既有正式網站不修改、不部署。

  1. 安裝Node.js 22以上,開啟終端輸入node --version核對。這份專案沒有第三方套件,不需npm install。
  2. 解壓到自己的student-work/service-site,確認frontend與backend為同層,契約及指南的HTML也在service-site根目錄。
  3. 用Cursor開啟這個service-site資料夾,在終端切到service-site。請自行設定至少12字元的練習管理密碼,只放終端/後端環境,不寫進前端或貼給AI。

macOS/Linux範例(請換自己的練習密碼):

ADMIN_PASSWORD='請改為自己至少12字元的練習密碼' TEACHING_MODE=1 node backend/server.mjs

Windows PowerShell範例:

$env:ADMIN_PASSWORD='請改為自己至少12字元的練習密碼'
$env:TEACHING_MODE='1'
node backend/server.mjs
  1. 看到ready後開http://127.0.0.1:8780/inquiry.html。伺服器執行中要保留終端;Ctrl+C停止,重新同樣啟動後案件仍在。
  2. 第17堂先讀/api/services,尚不送詢問;第18堂才接POST;管理頁從第19堂開始加入。後端先提供完整契約,不代表每堂前端都已完成。
  3. 預設只監聽127.0.0.1,不是公開部署。資料在backend/.data,不能搬進frontend,也不能把ADMIN_PASSWORD加入發布包。
  4. 需要其他測試位置時,用PORT、FRONTEND_DIR、DATA_DIR與PUBLIC_ORIGIN明確指定;資料位置需在frontend外。教學測試來源預設只允許127.0.0.1:8774及後端本身。
  5. 教材瀏覽器中的參考前端若未啟動後端,應顯示讀取失敗與重試,不用假選項或localStorage案件掩蓋。file://不在共同驗收範圍。

不要把伺服器ready當成API或案件驗收成功;依各關實際請求、回應與同案重讀留證據。公開部署、免費帳號與另一裝置需要學生另行實測。

未做的公開部署、帳號與裝置驗收保持待測。