WEEK 04 / SAVE, QUERY, PERSIST

讓每次檢核，
成為找得回的紀錄。

接著第三週 API，用 SQLite 保存檢核紀錄。親手做 SQL 篩選與彙總，完成十組查詢，再關掉服務重開，確認資料仍在。

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

選擇電腦，開始操作 ↓

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

先知道這三件事

① 哪裡輸入？

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

② 什麼算成功？

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

③ 卡住找誰？

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

先確認前三週已完成第四週起點

在同一台電腦，第一週 5/5、第二週 8/8、除錯 2/2、第三週 API 13/13，程式與文件已保存為 Git 版本。
沿用 fde-week01 資料夾；不用重新安裝 Python、Git 或 Claude。
公司帳號與個人電腦的使用依公司核准方式；資料全為教學合成資料。
另一台若沒有第一週成果，請導師安排公司核准的同步；不搬移 .venv，不用私人雲端搬公司資料。
本週沿用第三週套件；SQLite 使用 Python 內建模組。本機新建合成資料 DB，不碰公司資料庫。

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

看懂資料怎麼留下來

① check_records

一次檢核，一筆紀錄
id · 時間 · 檔名 · 狀態 · 筆數

② check_errors

一個原因，一筆明細
record_id 指回檢核紀錄
第幾筆 · 欄位 · 原因

③ 查詢與彙總

日期／檔名／狀態 → 找紀錄
JOIN 兩表 → GROUP BY 原因
重啟服務 → 讀回同一SQLite檔

DAY 1準備、模型、十筆資料 · 01–04

DAY 2規劃、實作、初始化 · 05–07

DAY 3歷史清單、親手SQL · 08–11

DAY 4十組查詢、保存、重啟 · 12–14

DAY 5回歸、文件、月末驗收 · 15–17

先選你現在使用的電腦

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

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

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

FINISH WITH EVIDENCE

把結果帶來，一起驗收。

帶給導師的四樣東西

API、repository.py、兩表資料模型圖與雙路線README。
親手操作的篩選、JOIN與GROUP BY SQL及解釋。
十組10/10、before/after與前週回歸的實際輸出。
新副本從上傳、檢核、保存到重啟查詢的五分鐘demo。

第一個月驗收關卡

導師指定日期，查出所有失敗紀錄，再統計各錯誤原因。說明主鍵、UTC日期、參數綁定、寫入失敗的500，以及SQL集中模組的好處。

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

回第四週課程驗收 ↗

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

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

官方參考與畫面說明

所有畫面為教學示意；Windows公司實機與帳號需導師／IT確認。資料全為合成，日期查詢使用UTC。SQLite與查詢參數依官方文件核對。

Python SQLite與參數綁定 ↗SQLite SELECT ↗FastAPI查詢參數 ↗第三週操作手冊 ↗

讓每次檢核，成為找得回的紀錄。