WEEK 02 / READ, VALIDATE, DEBUG

讓資料問題，
變成看得懂的報告。

接著第一週工具，練習必要欄位、空值、數值與重複檢查。用 JSON 回報，再親自修一個錯誤、加一條新規則。

零工程經驗17 個小步驟分五天完成建議保留 15 小時

選擇電腦，開始操作 ↓

讀得懂、改得動，用證據說明結果。

先知道這三件事

① 哪裡輸入？

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

② 什麼算成功？

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

③ 卡住找誰？

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

先確認第一週已完成第二週起點

在同一台電腦，第一週驗收已達 5/5，程式與文件已保存為 Git 版本。
沿用 fde-week01 資料夾；不用重新安裝 Python、Git 或 Claude。
公司帳號與個人電腦的使用依公司核准方式；資料全為教學合成資料。
另一台若沒有第一週成果，請導師安排公司核准的同步；不搬移 .venv，不用私人雲端搬公司資料。
本週只用 Python 內建功能，不需要 API、GCP 或新的套件。

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

DAY 1分支、資料、JSON · 01–04

DAY 2規格與計畫 · 05–07

DAY 3實作與報告 · 08–10

DAY 4驗收與除錯 · 11–14

DAY 5新增規則與交付 · 15–17

先選你現在使用的電腦

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

換電腦時，要注意什麼？兩台的使用方式＋

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

FINISH WITH EVIDENCE

把結果帶來，一起驗收。

帶給導師的四樣東西

練習資料夾：程式、README、CLAUDE.md、合成資料與驗收腳本。
六類情境與 BOM、負數挑戰的 JSON 報告；保留一份 reports/normal.json。
第一週5/5、第二週含新規則8/8、除錯2/2的輸出與最新 commit。
五分鐘 demo：從新窗口啟動，解釋讀檔 → 驗證 → JSON，並說明一份根因紀錄。

導師現場小挑戰

新增「金額不可為負數」規則，指出修改位置；導師再提供一個未預告的小需求，先說明影響與驗收，再指揮 Claude 修改。

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

回第二週課程驗收 ↗

我可以把這段貼給導師交付範本＋

第二週成果
1. 我的專案路徑：~/Developer/fde-week01
2. python3、git、claude 的版本：［填入實際結果］
3. 五項驗收腳本結果：［貼實際輸出］
4. 最新 commit：［貼 git log -1 --oneline］
5. 我能解釋的流程：讀檔 → 讀取欄位 → 統計 → 印出結果
6. 我卡過的問題與處理：［填入］
7. 下一步需要導師協助：［填入，沒有則寫無］

官方參考與畫面說明

JSON、CSV 與 Git 指令依官方文件查核於 2026-10-12。所有預期畫面為教學示意，實際版本、路徑與排版可能不同。Windows 公司實機及帳號需導師／IT 現場確認。

Python JSON ↗Python CSV ↗Git 分支切換 ↗第一週操作手冊 ↗接著第三週操作手冊 ↗接著第三週操作手冊 ↗

讓資料問題，變成看得懂的報告。