wk16-0610-1114405042: digit root

.gitignore

@@ -0,0 +1,33 @@
+# macOS
+.DS_Store
+
+# Python bytecode and caches
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Test and coverage artifacts
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Type checker / linter caches
+.mypy_cache/
+.ruff_cache/
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Logs
+*.log
+CLAUDE.md

ENROLLMENT.md

@@ -0,0 +1,56 @@
+學號
+1114405001
+1114405002
+1114405003
+1114405004
+1114405005
+1114405006
+1114405007
+1114405008
+1114405009
+1114405010
+1114405011
+1114405012
+1114405013
+1114405014
+1114405015
+1114405016
+1114405017
+1114405018
+1114405019
+1114405020
+1114405021
+1114405022
+1114405023
+1114405025
+1114405027
+1114405028
+1114405029
+1114405030
+1114405032
+1114405033
+1114405034
+1114405035
+1114405036
+1114405037
+1114405040
+1114405041
+1114405042
+1114405045
+1114405048
+1114405050
+1114405051
+1114405052
+1114405054
+1114405055
+1114405056
+1113405020
+1112405041
+1112405053
+1112405062
+1110405010
+1111405012
+1111405034
+1111405038
+1111405040
+1111405059

weeks/week-02/GITHUB_WORKFLOW.md → GITHUB_WORKFLOW.md

@@ -1,15 +1,10 @@
-# Week 02：Visual Studio Code GitHub 操作流程
+# Visual Studio Code GitHub 操作流程
 
-> 本課程採 **不使用 GitHub Classroom** 的流程：
-> `Template repo + upstream 同步 + 固定作業路徑 + 每週 branch + PR`
-
----
-
-## A. 本週目標（Week 02）
+## A. 每週目標（Week #）
 
 1. 在 VS Code 完成教材同步
-2. 建立 `submit/week-02-<student-id>` 分支
-3. 只在 `weeks/week-02/solutions/<student-id>/` 放作業
+2. 建立 `submit/week-#-<student-id>` 分支
+3. 只在 `weeks/week-#/solutions/<student-id>/` 放作業
 4. 由 VS Code 或 GitHub 建立 PR
 
 ---
@@ -48,7 +43,7 @@ git remote -v
 
 ---
 
-## D. Week 02 實作流程（VS Code 版）
+## D. Week # 實作流程（VS Code 版）
 
 ### Step 1：同步教材到 `main`
 
@@ -69,20 +64,20 @@ git push origin main
 
 - 點底部左下角分支名稱
 - `Create new branch...`
-- 輸入：`submit/week-02-<student-id>`
+- 輸入：`submit/week-#-<student-id>`
 
 方式二（Terminal）：
 
 ```bash
-git checkout -b submit/week-02-<student-id>
+git checkout -b submit/week-#-<student-id>
 ```
 
 ### Step 3：建立本週作業目錄
 
 在 Explorer 建立資料夾：
 
 ```text
-weeks/week-02/solutions/<student-id>/
+weeks/week-#/solutions/<student-id>/
 ```
 
 建議最少兩個檔案：
@@ -93,8 +88,8 @@ weeks/week-02/solutions/<student-id>/
 ### Step 4：在 Source Control 提交
 
 1. 到 `Source Control` 檢查變更檔案
-2. 確認只有 `weeks/week-02/solutions/<student-id>/...`
-3. 在訊息欄輸入：`Submit week-02`
+2. 確認只有 `weeks/week-#/solutions/<student-id>/...`
+3. 在訊息欄輸入：`Submit week-#`
 4. 按 `Commit`
 5. 按 `Publish Branch` 或 `Push`
 
@@ -115,18 +110,18 @@ git push -u origin submit/week-02-<student-id>
 方式二（GitHub 網站）：
 
 - base：`main`
-- compare：`submit/week-02-<student-id>`
+- compare：`submit/week-#-<student-id>`
 
 PR 標題格式：
 
 ```text
-Week 02 - <student-id> - <name>
+Week # - <student-id> - <name>
 ```
 
 範例：
 
 ```text
-Week 02 - 411234001 - 王小明
+Week # - 411234001 - 王小明
 ```
 
 ---
@@ -169,9 +164,9 @@ weeks/week-02/solutions/<student-id>/
 ## G. 提交前檢查清單
 
 - [ ] 已同步 `upstream/main`
-- [ ] 當前分支是 `submit/week-02-<student-id>`
-- [ ] 只改到 `weeks/week-02/solutions/<student-id>/`
-- [ ] PR 標題符合格式
+- [ ] 當前分支是 `submit/week-#-<student-id>`
+- [ ] 只改到 `weeks/week-#/solutions/<student-id>/`
+- [ ] PR 標題符合格式 -> :star: 回家作業請加上 "-HW-" 以示別
 - [ ] PR 描述已填完整
 
 ---

HOMEWORK.md

@@ -0,0 +1,111 @@
+# 作業繳交情況總覽
+
+> 每週作業 PR 繳交紀錄，依 `ENROLLMENT.md` 全班 55 人為基準。  
+> 判斷依據：branch 含 `submit/week-XX` 或標題符合 `Week XX - <id>` 作業格式。  
+> PR 連結：`[#N](../../pull/N)`（相對 repo root）
+
+### Week 02 檢核欄位說明
+
+每格格式：`PR連結 task tests docs`
+
+- **task**：`task1/2/3_*.py` 三支主程式是否齊全
+- **tests**：`tests/test_task1/2/3.py` 三支測試是否齊全
+- **docs**：`README.md` + `TEST_CASES.md` + `TEST_LOG.md` + `AI_USAGE.md` 是否齊全
+
+---
+
+## 繳交情況總表
+
+| 學號 | Week 02 作業 | Week 03 作業 |
+|------|-------------|-------------|
+| 1114405001 | ❌ | ❌ |
+| 1114405002 | ❌ | ❌ |
+| 1114405003 | [#46](../../pull/46) ✅task ✅tests ✅docs | ✅ [#56](../../pull/56) |
+| 1114405004 | ❌ | ❌ |
+| 1114405005 | ❌ | ❌ |
+| 1114405006 | [#37](../../pull/37) ❌task ❌tests ❌docs | ❌ |
+| 1114405007 | [#36](../../pull/36) ✅task ✅tests ✅docs | ❌ |
+| 1114405008 | ❌ | ❌ |
+| 1114405009 | ❌ | ❌ |
+| 1114405010 | ❌ | ✅ [#53](../../pull/53) |
+| 1114405011 | [#43](../../pull/43) ✅task ✅tests ✅docs | ❌ |
+| 1114405012 | ❌ | ❌ |
+| 1114405013 | ❌ | ❌ |
+| 1114405014 | ❌ | ❌ |
+| 1114405015 | ❌ | ❌ |
+| 1114405016 | ❌ | ❌ |
+| 1114405017 | ❌ | ❌ |
+| 1114405018 | ❌ | ❌ |
+| 1114405019 | ❌ | ❌ |
+| 1114405020 | [#45](../../pull/45) ✅task ✅tests ✅docs | ❌ |
+| 1114405021 | [#44](../../pull/44) ✅task ✅tests ✅docs | ❌ |
+| 1114405022 | ❌ | ❌ |
+| 1114405023 | ❌ | ✅ [#68](../../pull/68) |
+| 1114405025 | ❌ | ❌ |
+| 1114405027 | ❌ | ❌ |
+| 1114405028 | [#47](../../pull/47) ✅task ✅tests ✅docs | ❌ |
+| 1114405029 | [#42](../../pull/42) ✅task ✅tests ✅docs | ❌ |
+| 1114405030 | ❌ | ❌ |
+| 1114405032 | ❌ | ❌ |
+| 1114405033 | [#48](../../pull/48) ✅task ✅tests ✅docs | ❌ |
+| 1114405034 | ❌ | ❌ |
+| 1114405035 | ❌ | ✅ [#57](../../pull/57) |
+| 1114405036 | ❌ | ❌ |
+| 1114405037 | ❌ | ❌ |
+| 1114405040 | ❌ | ❌ |
+| 1114405041 | ❌ | ❌ |
+| 1114405042 | [#39](../../pull/39) ✅task ✅tests ✅docs | ❌ |
+| 1114405045 | ❌ | ❌ |
+| 1114405048 | [#72](../../pull/72) ✅task ✅tests ✅docs | ❌ |
+| 1114405050 | ❌ | ❌ |
+| 1114405051 | ❌ | ❌ |
+| 1114405052 | ❌ | ❌ |
+| 1114405054 | [#38](../../pull/38) ✅task ✅tests ✅docs | ✅ [#66](../../pull/66) |
+| 1114405055 | ❌ | ❌ |
+| 1114405056 | ❌ | ✅ [#54](../../pull/54) |
+| 1113405020 | ❌ | ❌ |
+| 1112405041 | ❌ | ❌ |
+| 1112405053 | [#41](../../pull/41) ❌task ✅tests ✅docs | ❌ |
+| 1112405062 | ❌ | ❌ |
+| 1110405010 | ❌ | ❌ |
+| 1111405012 | [#50](../../pull/50) ✅task ✅tests ✅docs | ❌ |
+| 1111405034 | ❌ | ❌ |
+| 1111405038 | ❌ | ❌ |
+| 1111405040 | [#3](../../pull/3) ✅task ✅tests ✅docs | ✅ [#67](../../pull/67) |
+| 1111405040 | ⚠️ 學號重複，待確認 | ⚠️ 學號重複，待確認 |
+| 1111405059 | ❌ | ❌ |
+
+**Week 02 統計：✅ 完整 11 人 ／ ⚠️ 部分缺失 2 人 ／ ❌ 未繳 42 人**  
+**Week 03 統計：✅ 7 人 ／ ❌ 48 人**（Week 03 內容檢核待辦）
+
+---
+
+## 2. Log
+
+- **2026-03-12**：初版建立。整理 Week 02、Week 03 作業繳交狀況。
+- **2026-03-12**：Week 02 加入內容檢核（task / tests / docs），逐一查驗 15 筆 PR 檔案清單。
+
+---
+
+## 3. 整理方式
+
+### 資料來源
+
+1. **`ENROLLMENT.md`**：全班 55 位學生學號名單。
+2. **`gh pr list --limit 100`**：抓取 repo 內所有 open PR。
+3. **`gh api repos/.../pulls/{PR}/files --paginate`**：逐一取得 PR 檔案清單，比對 `weeks/week-02/HOMEWORK.md` 需求。
+
+### 篩選邏輯
+
+**作業 PR 的判斷條件（符合其一）：**
+- branch 名稱含 `submit/week-XX`
+- 標題符合 `Week XX - <student-id>` 格式
+
+**內容檢核標準（Week 02）：**
+- **task**：`task1_sequence_clean.py` + `task2_student_ranking.py` + `task3_log_summary.py` 全齊
+- **tests**：`tests/test_task1.py` + `tests/test_task2.py` + `tests/test_task3.py` 全齊
+- **docs**：`README.md` + `TEST_CASES.md` + `TEST_LOG.md` + `AI_USAGE.md` 全齊
+
+**例外處理：**
+- branch 或標題含學號但格式不符規範者仍列入，依檔案內容判斷
+- 學號 1111405040 出現兩個不同帳號（circledog / Allenyeh0408），保留兩筆並標記待確認