WEEK 03 / REQUEST, RESPOND, VERIFY

讓你的工具,
成為可以呼叫的服務。

接著第二週 CSV 檢核器,用 Claude Code 建立本機 API。從兩個窗口、第一次請求,到親自驗證 200、422、415、413,一步一步完成。

零工程經驗17 個小步驟分五天完成建議保留 15 小時
選擇電腦,開始操作 ↓
從筆電逐步通往雲端的金色工程階梯讀得懂、改得動,用證據說明結果。
先知道這三件事
① 哪裡輸入?

終端機指令 依選擇貼到 Mac 終端機或 Windows PowerShell。
Claude 對話 貼到啟動後的 Claude Code。
兩種輸入位置,每一步都會標示。

② 什麼算成功?

每步先對照右邊的「預期畫面」,再完成下方驗收。畫面是教學示意,版本號、姓名與提示文字可能不同。

③ 卡住找誰?

同一問題試兩次還失敗,就把步驟、指令與錯誤訊息給導師。公司帳號、安裝、權限問題交給導師或 IT。

先確認前兩週已完成 第三週起點
  • 在同一台電腦,第一週 5/5、第二週含挑戰 8/8、除錯 2/2,程式與文件已保存為 Git 版本。
  • 沿用 fde-week01 資料夾;不用重新安裝 Python、Git 或 Claude。
  • 公司帳號與個人電腦的使用依公司核准方式;資料全為教學合成資料。
  • 另一台若沒有第一週成果,請導師安排公司核准的同步;不搬移 .venv,不用私人雲端搬公司資料。
  • 本週需 IT 核准在專案 .venv 安裝三個套件;只跑本機 API,不部署 GCP。

還沒完成第一週?先回操作手冊 ↗

DAY 1準備、套件、契約 · 01–04
DAY 2Claude 實作、舊驗收 · 05–07
DAY 3雙窗口、文件、上傳 · 08–11
DAY 4狀態碼、完整驗收 · 12–14
DAY 5根因、回歸、交付 · 15–17
先選你現在使用的電腦

同一份作業,兩條操作路線。

換電腦時,要注意什麼?兩台的使用方式 +
  • 安裝與 Python 虛擬環境要在各台電腦各自準備,不搬移 .venv。
  • 先在已完成前兩週的那台操作;另一台待核准同步後再重建自己的環境。
  • 本週練習包只有合成資料,兩台使用同一套 JSON 規格及驗收標準。
  • 導師確認核准的程式庫與允許範圍後再安排同步;本手冊不提供虛構 repo 網址,也不執行 push。
  • 網站進度只保存在各自瀏覽器,切換路線分別記錄,不會跨電腦同步。
FINISH WITH EVIDENCE

把結果帶來,一起驗收。

帶給導師的四樣東西

  1. api_app.py、共用檢核器與雙路線 README。
  2. 本機 /health、/docs 和四種 HTTP 回應證據。
  3. 第一週 5/5、第二週 8/8、除錯 2/2、API 13/13 的輸出與最新 commit。
  4. 五分鐘 demo:新開 A/B 窗口,展示上傳與解釋請求流向。

導師現場小挑戰

導師提供未預告的合成 CSV,先預測 HTTP 與報告,再實際上傳。解釋資料 422 和程式 500 的差異,指出共用驗證函式。

可以使用 Claude Code。導師確認成果與理解後,再回首頁勾選第三週「已驗收通過」。

回第三週課程驗收 ↗
我可以把這段貼給導師 交付範本 +
第三週成果
1. 我的專案路徑:~/Developer/fde-week01
2. python3、git、claude 的版本:[填入實際結果]
3. 五項驗收腳本結果:[貼實際輸出]
4. 最新 commit:[貼 git log -1 --oneline]
5. 我能解釋的流程:讀檔 → 讀取欄位 → 統計 → 印出結果
6. 我卡過的問題與處理:[填入]
7. 下一步需要導師協助:[填入,沒有則寫無]

官方參考與畫面說明

所有預期畫面為教學示意;Windows 公司實機與帳號需導師/IT 確認。套件版本為本教學驗證版本,不代表最新版本。

FastAPI 檔案上傳 ↗FastAPI 啟動與互動文件 ↗第二週操作手冊 ↗接著第四週操作手冊 ↗