Add week03 branching mystery template

classroom_data/course.json

@@ -1,7 +1,7 @@
 {"course_id":"2026Fall","title":"2026 Fall 進階專題","demo_class":"2026Fall進階專題","weeks":[
 {"id":"week01","week":1,"title":"任務管理器開發挑戰","project":"能力診斷","output":"文字版任務管理器","template":true},
 {"id":"week02","week":2,"title":"消失的校徽","project":"校園謎案調查局","output":"探索地點與收集線索的文字案件","template":true},
-{"id":"week03","week":3,"title":"線索會改變世界","project":"校園謎案調查局","output":"條件解鎖與多分支案件","template":false},
+{"id":"week03","week":3,"title":"線索會改變世界","project":"校園謎案調查局","output":"條件解鎖、變化證詞與多結局案件","template":true},
 {"id":"week04","week":4,"title":"把文字案件變成可點的現場","project":"校園謎案調查局","output":"Pygame 互動現場","template":false},
 {"id":"week05","week":5,"title":"案件發布日","project":"校園謎案調查局","output":"原創短案件與線上展示","template":false},
 {"id":"week06","week":6,"title":"領養一顆神祕蛋","project":"電子寵物進化實驗室","output":"可餵食、玩耍、休息的寵物原型","template":false},

classroom_data/templates/week03/case_data.json

@@ -0,0 +1,42 @@
+{
+  "title": "午夜廣播室",
+  "intro": "放學後，校內廣播突然播放一段求救訊息，卻沒有人承認進過廣播室。",
+  "actions": {
+    "1": {
+      "name": "搜索導師桌",
+      "before": "抽屜裡有一張被塗改的廣播值日表。",
+      "after": "抽屜已經檢查過了。",
+      "changes_after": "duty_list",
+      "gives": {"id": "duty_list", "name": "被塗改的廣播值日表"}
+    },
+    "2": {
+      "name": "詢問工友",
+      "before": "工友搖搖頭：我只看到有人往舊校舍走。",
+      "after": "看到值日表後，工友改口：我撿到一張紙條，上面寫著門禁碼 0426。",
+      "changes_after": "duty_list",
+      "gives_requires": ["duty_list"],
+      "gives": {"id": "door_code", "name": "廣播室門禁碼 0426"}
+    },
+    "3": {
+      "name": "進入廣播室",
+      "requires": ["door_code"],
+      "locked_text": "門鎖需要四位數密碼。也許有人知道密碼的下落。",
+      "before": "控制台旁有一台仍在播放的錄音機。",
+      "after": "錄音機已經檢查過了。",
+      "changes_after": "recording",
+      "gives": {"id": "recording", "name": "剪接過的求救錄音"}
+    }
+  },
+  "endings": {
+    "1": {
+      "label": "指控值日生惡作劇",
+      "requires": ["recording"],
+      "text": "【誤判結局】錄音雖然是剪接的，但值日表被塗改，不能證明值日生真的進過廣播室。"
+    },
+    "2": {
+      "label": "判斷這是預演錄音誤播",
+      "requires": ["duty_list", "door_code", "recording"],
+      "text": "【真相結局】求救聲是校慶戲劇預演錄音；工友誤觸了排程播放，怕被責怪才隱瞞紙條。案件破解！"
+    }
+  }
+}

classroom_data/templates/week03/main.py

@@ -0,0 +1,98 @@
+"""Week 3：線索會改變世界 Starter。
+
+先完成 TODO 1～4。你會讓線索解鎖行動、改變證詞，並產生不同結局。
+"""
+
+import json
+from pathlib import Path
+
+CASE_FILE = Path(__file__).with_name("case_data.json")
+
+
+def load_case():
+    with CASE_FILE.open("r", encoding="utf-8") as file:
+        return json.load(file)
+
+
+def requirements_met(required_ids, clues):
+    """所有 required_ids 都已取得時回傳 True。"""
+    # TODO 1：可使用 all(required_id in clues for required_id in required_ids)
+    return True
+
+
+def choose_text(action, clues):
+    """依目前線索，選擇行動前或行動後的文字。"""
+    # TODO 2：若 changes_after 已在 clues，回傳 after；否則回傳 before。
+    return action["before"]
+
+
+def perform_action(action, clues):
+    """檢查前置條件、顯示內容並加入新線索。"""
+    required_ids = action.get("requires", [])
+    # TODO 3：條件不足時顯示 locked_text 並直接 return。
+
+    print(f"\n{choose_text(action, clues)}")
+    clue = action.get("gives")
+    can_give = requirements_met(action.get("gives_requires", []), clues)
+    # TODO 4：clue 存在、can_give 且尚未取得時，加入 clue["id"] 並顯示名稱。
+
+
+def show_clues(clues, case):
+    print("\n【調查狀態】")
+    if not clues:
+        print("尚未取得任何線索。")
+        return
+    names = {
+        action["gives"]["id"]: action["gives"]["name"]
+        for action in case["actions"].values()
+        if action.get("gives")
+    }
+    for number, clue_id in enumerate(clues, start=1):
+        print(f"{number}. {names.get(clue_id, clue_id)}")
+
+
+def choose_ending(case, clues):
+    print("\n【結案判斷】")
+    for ending_id, ending in case["endings"].items():
+        print(f"{ending_id}. {ending['label']}")
+    choice = input("你的判斷：").strip()
+    ending = case["endings"].get(choice)
+    if ending is None:
+        print("沒有這個結局選項。")
+        return False
+    if not requirements_met(ending.get("requires", []), clues):
+        print("目前的線索還不足以支持這個判斷。")
+        return False
+    print(ending["text"])
+    return True
+
+
+def main():
+    case = load_case()
+    clues = []
+    print(f"=== {case['title']} ===")
+    print(case["intro"])
+    while True:
+        print("\n你要做什麼？")
+        for action_id, action in case["actions"].items():
+            print(f"{action_id}. {action['name']}")
+        print("4. 查看調查狀態")
+        print("5. 提出結案判斷")
+        print("6. 暫停案件")
+        choice = input("請選擇：").strip()
+        if choice in case["actions"]:
+            perform_action(case["actions"][choice], clues)
+        elif choice == "4":
+            show_clues(clues, case)
+        elif choice == "5":
+            if choose_ending(case, clues):
+                break
+        elif choice == "6":
+            print("案件已暫停。")
+            break
+        else:
+            print("請輸入畫面上的選項。")
+
+
+if __name__ == "__main__":
+    main()

tests/test_classroom.py

@@ -64,6 +64,7 @@ class ClassroomServiceTests(unittest.TestCase):
         course = json.loads((classroom.DATA / "course.json").read_text(encoding="utf-8"))
         self.assertEqual(len(course["weeks"]), 18)
         self.assertEqual(set(classroom.template_files("week02")), {"main.py", "case_data.json"})
+        self.assertEqual(set(classroom.template_files("week03")), {"main.py", "case_data.json"})
 
     def test_catalog_lists_courses_and_existing_students(self):
         state = classroom.empty("L6A", "student-1", "Alex", "week02")