steveyehtw commited on
Commit
6737361
·
1 Parent(s): 21c192a

Add course and roster management

Browse files
README.md CHANGED
@@ -17,6 +17,13 @@ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-
17
 
18
  內建 2026 Fall 18 週課程,Week 1、2 已有套版。支援多個 Python 檔、ZIP 匯入匯出、即時監看、每週只保留最後正式版與整班發布。
19
 
 
 
 
 
 
 
 
20
  Space Secrets:
21
 
22
  ```text
 
17
 
18
  內建 2026 Fall 18 週課程,Week 1、2 已有套版。支援多個 Python 檔、ZIP 匯入匯出、即時監看、每週只保留最後正式版與整班發布。
19
 
20
+ 課程與名單管理:
21
+
22
+ - 學生先選現有課程,再從該課程名單選名字;新生可自行輸入新名字加入。
23
+ - 教師可選現有課程,也可用教師密碼建立新課程代碼。新課程會寫回此 Space,因此建立時會觸發一次重新建置。
24
+ - 教師可從課程刪除學生及其教室內進度;已經發布到首頁 Demo 的作品不會連帶刪除。
25
+ - 學生名單與尚未發布的草稿保存在 Space 執行期間;每週正式提交發布後才會成為此 repository 內的長期作品。
26
+
27
  Space Secrets:
28
 
29
  ```text
classroom_data/classes.json ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ [
2
+ {"code": "L6A", "name": "2026 Fall 進階專題"}
3
+ ]
classroom_service.py CHANGED
@@ -14,7 +14,10 @@ ALLOWED={".py",".json",".txt",".csv",".md",".toml",".yaml",".yml"}; ID_RE=re.com
14
  router=APIRouter(); lock=threading.Lock(); students={}; teachers={}; live={}
15
 
16
  class TeacherRequest(BaseModel): class_code:str; week_id:str; password:str
 
 
17
  def clean(v,fallback="item",limit=48): return ID_RE.sub("",str(v).strip())[:limit] or fallback
 
18
  def safe_path(v):
19
  v=str(v).replace("\\","/").strip("/"); p=PurePosixPath(v)
20
  return p.as_posix() if v and not p.is_absolute() and ".." not in p.parts and p.suffix.lower() in ALLOWED and len(v)<161 else None
@@ -28,7 +31,13 @@ def norm_files(value):
28
  def now(): return int(time.time()*1000)
29
  def init_db():
30
  RUNTIME.mkdir(parents=True,exist_ok=True)
31
- with lock,sqlite3.connect(DB) as c:c.execute("""CREATE TABLE IF NOT EXISTS classroom_projects(class_code TEXT,student_id TEXT,display_name TEXT,week_id TEXT,project_name TEXT,draft_files TEXT,final_files TEXT,active_file TEXT,output TEXT,status TEXT,needs_help INTEGER,updated_at INTEGER,submitted_at INTEGER,PRIMARY KEY(class_code,student_id,week_id))""")
 
 
 
 
 
 
32
  def empty(c,s,n,w): return {"class_code":c,"student_id":s,"display_name":n,"week_id":w,"project_name":"Python專案","files":{"main.py":"# 在這裡寫 Python\n"},"final_files":None,"active_file":"main.py","output":"","status":"idle","needs_help":False,"updated_at":now(),"submitted_at":None,"connected":True}
33
  def from_row(r,connected=False): return {"class_code":r[0],"student_id":r[1],"display_name":r[2],"week_id":r[3],"project_name":r[4],"files":json.loads(r[5]),"final_files":json.loads(r[6]) if r[6] else None,"active_file":r[7],"output":r[8],"status":r[9],"needs_help":bool(r[10]),"updated_at":r[11],"submitted_at":r[12],"connected":connected}
34
  SELECT="SELECT class_code,student_id,display_name,week_id,project_name,draft_files,final_files,active_file,output,status,needs_help,updated_at,submitted_at FROM classroom_projects"
@@ -37,10 +46,22 @@ def load(c,s,n,w):
37
  state=from_row(r,True) if r else empty(c,s,n,w); state["display_name"]=n; return state
38
  def save(x):
39
  values=(x["class_code"],x["student_id"],x["display_name"],x["week_id"],x["project_name"],json.dumps(x["files"],ensure_ascii=False),json.dumps(x["final_files"],ensure_ascii=False) if x["final_files"] else None,x["active_file"],x["output"][-40000:],x["status"],int(x["needs_help"]),x["updated_at"],x["submitted_at"])
40
- with lock,sqlite3.connect(DB) as db:db.execute("""INSERT INTO classroom_projects VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?) ON CONFLICT(class_code,student_id,week_id) DO UPDATE SET display_name=excluded.display_name,project_name=excluded.project_name,draft_files=excluded.draft_files,final_files=excluded.final_files,active_file=excluded.active_file,output=excluded.output,status=excluded.status,needs_help=excluded.needs_help,updated_at=excluded.updated_at,submitted_at=excluded.submitted_at""",values)
 
 
 
 
 
 
 
 
 
 
41
  def snapshot(c,w):
42
  with lock,sqlite3.connect(DB) as db:rows=db.execute(SELECT+" WHERE class_code=? AND week_id=?",(c,w)).fetchall()
43
  found={r[1]:from_row(r) for r in rows}
 
 
44
  for (cc,s,ww),state in live.items():
45
  if cc==c and ww==w:found[s]=state.copy()
46
  return sorted(found.values(),key=lambda x:(not x["needs_help"],x["display_name"]))
@@ -80,6 +101,35 @@ def student_page():return FileResponse(STATIC/"student.html")
80
  def teacher_page():return FileResponse(STATIC/"teacher.html")
81
  @router.get("/api/classroom/course")
82
  def course():return JSONResponse(json.loads((DATA/"course.json").read_text(encoding="utf-8")))
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
83
  @router.get("/api/classroom/template/{week_id}")
84
  def template(week_id):return {"week_id":week_id,"files":template_files(week_id)}
85
  @router.get("/api/classroom/progress")
 
14
  router=APIRouter(); lock=threading.Lock(); students={}; teachers={}; live={}
15
 
16
  class TeacherRequest(BaseModel): class_code:str; week_id:str; password:str
17
+ class CourseCreate(BaseModel): class_code:str; course_name:str=""; password:str
18
+ class StudentDelete(BaseModel): class_code:str; student_id:str; password:str
19
  def clean(v,fallback="item",limit=48): return ID_RE.sub("",str(v).strip())[:limit] or fallback
20
+ def clean_label(v,fallback="",limit=80): return re.sub(r"[\x00-\x1f\x7f]", "", str(v).strip())[:limit] or fallback
21
  def safe_path(v):
22
  v=str(v).replace("\\","/").strip("/"); p=PurePosixPath(v)
23
  return p.as_posix() if v and not p.is_absolute() and ".." not in p.parts and p.suffix.lower() in ALLOWED and len(v)<161 else None
 
31
  def now(): return int(time.time()*1000)
32
  def init_db():
33
  RUNTIME.mkdir(parents=True,exist_ok=True)
34
+ with lock,sqlite3.connect(DB) as c:
35
+ c.execute("""CREATE TABLE IF NOT EXISTS classroom_projects(class_code TEXT,student_id TEXT,display_name TEXT,week_id TEXT,project_name TEXT,draft_files TEXT,final_files TEXT,active_file TEXT,output TEXT,status TEXT,needs_help INTEGER,updated_at INTEGER,submitted_at INTEGER,PRIMARY KEY(class_code,student_id,week_id))""")
36
+ c.execute("""CREATE TABLE IF NOT EXISTS classroom_courses(class_code TEXT PRIMARY KEY,course_name TEXT,created_at INTEGER)""")
37
+ c.execute("""CREATE TABLE IF NOT EXISTS classroom_members(class_code TEXT,student_id TEXT,display_name TEXT,created_at INTEGER,PRIMARY KEY(class_code,student_id))""")
38
+ for item in json.loads((DATA/"classes.json").read_text(encoding="utf-8")):
39
+ code=clean(item.get("code"),"L6A")
40
+ c.execute("""INSERT INTO classroom_courses VALUES(?,?,?) ON CONFLICT(class_code) DO UPDATE SET course_name=excluded.course_name""",(code,clean_label(item.get("name"),code),now()))
41
  def empty(c,s,n,w): return {"class_code":c,"student_id":s,"display_name":n,"week_id":w,"project_name":"Python專案","files":{"main.py":"# 在這裡寫 Python\n"},"final_files":None,"active_file":"main.py","output":"","status":"idle","needs_help":False,"updated_at":now(),"submitted_at":None,"connected":True}
42
  def from_row(r,connected=False): return {"class_code":r[0],"student_id":r[1],"display_name":r[2],"week_id":r[3],"project_name":r[4],"files":json.loads(r[5]),"final_files":json.loads(r[6]) if r[6] else None,"active_file":r[7],"output":r[8],"status":r[9],"needs_help":bool(r[10]),"updated_at":r[11],"submitted_at":r[12],"connected":connected}
43
  SELECT="SELECT class_code,student_id,display_name,week_id,project_name,draft_files,final_files,active_file,output,status,needs_help,updated_at,submitted_at FROM classroom_projects"
 
46
  state=from_row(r,True) if r else empty(c,s,n,w); state["display_name"]=n; return state
47
  def save(x):
48
  values=(x["class_code"],x["student_id"],x["display_name"],x["week_id"],x["project_name"],json.dumps(x["files"],ensure_ascii=False),json.dumps(x["final_files"],ensure_ascii=False) if x["final_files"] else None,x["active_file"],x["output"][-40000:],x["status"],int(x["needs_help"]),x["updated_at"],x["submitted_at"])
49
+ with lock,sqlite3.connect(DB) as db:
50
+ db.execute("INSERT OR IGNORE INTO classroom_courses VALUES(?,?,?)",(x["class_code"],x["class_code"],now()))
51
+ db.execute("""INSERT INTO classroom_members VALUES(?,?,?,?) ON CONFLICT(class_code,student_id) DO UPDATE SET display_name=excluded.display_name""",(x["class_code"],x["student_id"],x["display_name"],now()))
52
+ db.execute("""INSERT INTO classroom_projects VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?) ON CONFLICT(class_code,student_id,week_id) DO UPDATE SET display_name=excluded.display_name,project_name=excluded.project_name,draft_files=excluded.draft_files,final_files=excluded.final_files,active_file=excluded.active_file,output=excluded.output,status=excluded.status,needs_help=excluded.needs_help,updated_at=excluded.updated_at,submitted_at=excluded.submitted_at""",values)
53
+ def catalog():
54
+ with lock,sqlite3.connect(DB) as db:
55
+ courses=db.execute("SELECT class_code,course_name FROM classroom_courses ORDER BY course_name,class_code").fetchall()
56
+ members=db.execute("SELECT class_code,student_id,display_name FROM classroom_members ORDER BY display_name").fetchall()
57
+ by_class={code:[] for code,_ in courses}
58
+ for code,student_id,name in members:by_class.setdefault(code,[]).append({"student_id":student_id,"display_name":name})
59
+ return {"courses":[{"class_code":code,"course_name":name,"students":by_class.get(code,[])} for code,name in courses]}
60
  def snapshot(c,w):
61
  with lock,sqlite3.connect(DB) as db:rows=db.execute(SELECT+" WHERE class_code=? AND week_id=?",(c,w)).fetchall()
62
  found={r[1]:from_row(r) for r in rows}
63
+ with lock,sqlite3.connect(DB) as db:members=db.execute("SELECT student_id,display_name FROM classroom_members WHERE class_code=?",(c,)).fetchall()
64
+ for student_id,name in members:found.setdefault(student_id,empty(c,student_id,name,w)|{"connected":False})
65
  for (cc,s,ww),state in live.items():
66
  if cc==c and ww==w:found[s]=state.copy()
67
  return sorted(found.values(),key=lambda x:(not x["needs_help"],x["display_name"]))
 
101
  def teacher_page():return FileResponse(STATIC/"teacher.html")
102
  @router.get("/api/classroom/course")
103
  def course():return JSONResponse(json.loads((DATA/"course.json").read_text(encoding="utf-8")))
104
+ @router.get("/api/classroom/classes")
105
+ def classes():return catalog()
106
+ @router.post("/api/classroom/classes")
107
+ def create_class(req:CourseCreate):
108
+ check_password(req.password); code=clean(req.class_code,""); name=clean_label(req.course_name,code)
109
+ if not code:raise HTTPException(400,"請輸入課程代碼")
110
+ with lock,sqlite3.connect(DB) as db:
111
+ if db.execute("SELECT 1 FROM classroom_courses WHERE class_code=?",(code,)).fetchone():raise HTTPException(409,"這個課程代碼已存在")
112
+ rows=db.execute("SELECT class_code,course_name FROM classroom_courses ORDER BY course_name,class_code").fetchall()
113
+ if not TOKEN:raise HTTPException(503,"請先在 Space Secrets 設定 HF_TOKEN")
114
+ from huggingface_hub import CommitOperationAdd,HfApi
115
+ payload=json.dumps([{"code":c,"name":n} for c,n in rows]+[{"code":code,"name":name}],ensure_ascii=False,indent=2)+"\n"
116
+ HfApi(token=TOKEN).create_commit(repo_id=REPO,repo_type="space",operations=[CommitOperationAdd(path_in_repo="classroom_data/classes.json",path_or_fileobj=payload.encode())],commit_message=f"Add classroom course {code}")
117
+ with lock,sqlite3.connect(DB) as db:db.execute("INSERT INTO classroom_courses VALUES(?,?,?)",(code,name,now()))
118
+ return {"ok":True,"class_code":code,"course_name":name}
119
+ @router.delete("/api/classroom/students")
120
+ async def delete_student(req:StudentDelete):
121
+ check_password(req.password); code=clean(req.class_code,"L6A"); student_id=clean(req.student_id,"student")
122
+ targets=[(key,ws) for key,ws in students.items() if key[0]==code and key[1]==student_id]
123
+ for key,ws in targets:
124
+ students.pop(key,None);live.pop(key,None)
125
+ try:await ws.close(code=4004,reason="removed")
126
+ except Exception:pass
127
+ with lock,sqlite3.connect(DB) as db:
128
+ db.execute("DELETE FROM classroom_projects WHERE class_code=? AND student_id=?",(code,student_id))
129
+ db.execute("DELETE FROM classroom_members WHERE class_code=? AND student_id=?",(code,student_id))
130
+ for class_code,week_id in list(teachers):
131
+ if class_code==code:await broadcast(code,week_id)
132
+ return {"ok":True}
133
  @router.get("/api/classroom/template/{week_id}")
134
  def template(week_id):return {"week_id":week_id,"files":template_files(week_id)}
135
  @router.get("/api/classroom/progress")
classroom_static/classroom.css CHANGED
@@ -39,9 +39,9 @@
39
 
40
  * { box-sizing: border-box; }
41
  [hidden] { display: none !important; }
42
- html, body { min-height: 100%; }
43
- body { margin: 0; background: var(--shell); color: var(--ink); }
44
- button, input, textarea { font: inherit; }
45
  button { cursor: pointer; }
46
  button:disabled { cursor: not-allowed; opacity: .48; }
47
 
@@ -63,6 +63,7 @@ button:disabled { cursor: not-allowed; opacity: .48; }
63
 
64
  .app-header {
65
  min-height: 60px;
 
66
  display: flex;
67
  align-items: center;
68
  justify-content: space-between;
@@ -132,22 +133,24 @@ button:disabled { cursor: not-allowed; opacity: .48; }
132
  .btn.help.active { background: oklch(0.65 0.17 68); }
133
  .btn.compact { min-height: 36px; padding: 0 var(--space-md); font-size: .875rem; }
134
 
135
- .project-bar { min-height:58px;display:flex;align-items:center;justify-content:space-between;gap:var(--space-lg);padding:var(--space-sm) var(--space-xl);border-bottom:1px solid var(--line);background:var(--surface); }
136
  .project-context,.project-actions { display:flex;align-items:center;gap:var(--space-sm);flex-wrap:wrap; }
137
  .project-context label { color:var(--muted);font-size:.75rem;font-weight:800; }
138
  .project-context select,.project-context input { min-height:36px;max-width:280px;padding:0 var(--space-md);border:1px solid var(--line);border-radius:var(--radius-sm);background:var(--surface);color:var(--ink);font-weight:700; }
139
  .submission-summary { padding:var(--space-sm) var(--space-md);border-radius:999px;background:var(--success-soft);color:oklch(.37 .12 150);font-size:.8rem;font-weight:800; }
140
  .student-layout {
141
- min-height: calc(100dvh - 118px);
 
 
142
  display: grid;
143
  grid-template-columns: minmax(230px, 280px) minmax(420px, 1fr) minmax(280px, 360px);
144
  grid-template-areas: "reference editor console";
145
  }
146
 
147
- .panel { min-width: 0; background: var(--surface); }
148
- .reference-panel { grid-area: reference; border-right: 1px solid var(--line); }
149
- .editor-panel { grid-area: editor; background: var(--editor); }
150
- .console-panel { grid-area: console; border-left: 1px solid var(--line); }
151
 
152
  .panel-heading {
153
  min-height: 52px;
@@ -163,7 +166,9 @@ button:disabled { cursor: not-allowed; opacity: .48; }
163
  .side-tabs { height:44px;display:flex;border-bottom:1px solid var(--line); }
164
  .side-tab { flex:1;border:0;background:var(--surface);color:var(--muted);font-size:.8rem;font-weight:800; }
165
  .side-tab.active { color:var(--navy);box-shadow:inset 0 -3px 0 var(--action); }
166
- .file-list { height:calc(100dvh - 270px);overflow:auto;padding:var(--space-sm); }
 
 
167
  .file-row { display:flex;align-items:center;border-radius:var(--radius-sm); }
168
  .file-row:hover { background:var(--surface-subtle); }.file-row.selected{background:var(--action-soft);color:var(--navy)}
169
  .file-row>button:first-child { min-width:0;min-height:40px;flex:1;padding:0 var(--space-md);border:0;background:transparent;color:inherit;text-align:left;font:650 .82rem/1.2 "SFMono-Regular",Consolas,monospace;overflow:hidden;text-overflow:ellipsis; }
@@ -180,6 +185,7 @@ button:disabled { cursor: not-allowed; opacity: .48; }
180
  color: var(--ink);
181
  }
182
  .text-field { min-height: 44px; padding: 0 var(--space-md); }
 
183
  .text-field::placeholder, .stdin-field::placeholder { color: oklch(0.46 0.025 255); opacity: 1; }
184
  .text-field:focus, .stdin-field:focus { border-color: var(--action); }
185
 
@@ -197,7 +203,7 @@ button:disabled { cursor: not-allowed; opacity: .48; }
197
  }
198
  .chip[aria-pressed="true"] { border-color: var(--action); background: var(--action-soft); color: var(--navy); }
199
 
200
- .snippet-list { height: calc(100dvh - 276px); overflow: auto; padding: var(--space-sm) var(--space-lg) var(--space-xl); }
201
  .snippet-empty { padding: var(--space-xl) 0; color: var(--muted); line-height: 1.55; }
202
  .snippet-item { padding: var(--space-lg) 0; border-bottom: 1px solid var(--line); }
203
  .snippet-item:last-child { border-bottom: 0; }
@@ -229,11 +235,11 @@ button:disabled { cursor: not-allowed; opacity: .48; }
229
 
230
  .editor-toolbar { display: flex; align-items: center; gap: var(--space-sm); }
231
  .file-name { font: 700 .875rem/1 "SFMono-Regular", Consolas, monospace; color: oklch(0.82 0.025 255); }
232
- .editor-host { height: calc(100dvh - 170px); }
233
  .CodeMirror { height: 100%; font: 500 1rem/1.7 "SFMono-Regular", Consolas, monospace; background: var(--editor); }
234
  .CodeMirror-gutters { background: var(--editor); border-right: 1px solid var(--editor-line); }
235
 
236
- .console-body { height: calc(100dvh - 170px); display: grid; grid-template-rows: auto minmax(180px, 1fr) auto; }
237
  .stdin-section { padding: var(--space-lg); border-bottom: 1px solid var(--line); }
238
  .stdin-field { min-height: 96px; resize: vertical; padding: var(--space-md); font: 500 .875rem/1.5 "SFMono-Regular", Consolas, monospace; }
239
  .field-help { margin: var(--space-sm) 0 0; color: var(--muted); font-size: .75rem; line-height: 1.45; }
@@ -266,11 +272,11 @@ dialog::backdrop { background: oklch(0.16 0.04 255 / .72); }
266
  .form-stack { display: grid; gap: var(--space-lg); }
267
  .form-error { min-height: 1.25rem; margin: 0; color: var(--danger); font-size: .875rem; }
268
 
269
- .teacher-layout { min-height: calc(100dvh - 118px); display: grid; grid-template-columns: minmax(360px, 43%) minmax(480px, 57%); }
270
- .roster-panel { border-right: 1px solid var(--line); background: var(--surface); }
271
- .teacher-detail { min-width: 0; background: var(--shell); }
272
  .filter-bar { display: flex; gap: var(--space-sm); padding: var(--space-md) var(--space-lg); border-bottom: 1px solid var(--line); overflow-x: auto; }
273
- .roster-list { height: calc(100dvh - 219px); overflow: auto; }
274
  .roster-header, .student-row {
275
  display: grid;
276
  grid-template-columns: minmax(110px, 1.15fr) 90px minmax(92px, .9fr) 76px;
@@ -288,8 +294,8 @@ dialog::backdrop { background: oklch(0.16 0.04 255 / .72); }
288
  .help-label { color: oklch(0.45 0.13 70); font-size: .78rem; font-weight: 850; }
289
  .empty-roster { padding: var(--space-2xl); color: var(--muted); line-height: 1.55; }
290
 
291
- .detail-empty { min-height:calc(100dvh - 118px);display:grid;place-items:center;padding:var(--space-2xl);color:var(--muted);text-align:center; }
292
- .detail-view { height:calc(100dvh - 118px);display:grid;grid-template-rows:auto minmax(0,1fr); }
293
  .detail-header { min-height: 76px; display: flex; align-items: center; justify-content: space-between; gap: var(--space-lg); padding: var(--space-lg) var(--space-xl); background: var(--surface); border-bottom: 1px solid var(--line); }
294
  .detail-header h1 { margin: 0; font-size: 1.2rem; }
295
  .detail-meta { margin-top: 4px; color: var(--muted); font-size: .8rem; }
@@ -299,6 +305,8 @@ dialog::backdrop { background: oklch(0.16 0.04 255 / .72); }
299
  .teacher-file-tabs { display:flex;gap:2px;padding:var(--space-xs) var(--space-md);overflow-x:auto;background:var(--editor-raised);border-bottom:1px solid var(--editor-line); }
300
  .teacher-file-tab { flex:none;min-height:32px;padding:0 var(--space-md);border:0;border-radius:var(--radius-sm);background:transparent;color:oklch(.72 .02 255);font:650 .78rem/1 "SFMono-Regular",Consolas,monospace; }
301
  .teacher-file-tab:hover,.teacher-file-tab.active { background:var(--editor-line);color:white; }
 
 
302
  .progress-list { display:grid;gap:var(--space-sm);max-height:50vh;overflow:auto;margin-bottom:var(--space-lg); }
303
  .progress-item { display:flex;justify-content:space-between;gap:var(--space-md);padding:var(--space-md);border:1px solid var(--line);border-radius:var(--radius-sm);background:var(--surface);color:var(--ink);text-align:left; }
304
  .progress-item:hover{background:var(--action-soft)}.progress-item span{color:var(--muted);font-size:.75rem}.publish-actions{display:flex;justify-content:flex-end;gap:var(--space-sm)}
@@ -312,13 +320,12 @@ dialog::backdrop { background: oklch(0.16 0.04 255 / .72); }
312
 
313
  @media (max-width: 980px) {
314
  .project-bar{align-items:stretch;flex-direction:column;padding:var(--space-md)}.project-actions{overflow-x:auto;flex-wrap:nowrap}.project-actions>*{flex:none}
315
- .student-layout { display: block; min-height: auto; }
316
- .mobile-tabs { display: flex; position: sticky; top: 60px; z-index: 15; background: var(--surface); border-bottom: 1px solid var(--line); }
317
  .mobile-tab { flex: 1; min-height: 46px; border: 0; background: var(--surface); color: var(--muted); font-weight: 800; }
318
  .mobile-tab[aria-selected="true"] { color: var(--navy); box-shadow: inset 0 -3px 0 var(--action); }
319
- .student-layout .panel { display: none; min-height: calc(100dvh - 106px); }
320
- .student-layout .panel.mobile-active { display: block; }
321
- .editor-host,.console-body{height:calc(100dvh - 250px)}.snippet-list,.file-list{height:calc(100dvh - 340px)}
322
  .teacher-layout { grid-template-columns: minmax(320px, 42%) minmax(420px, 58%); }
323
  }
324
 
@@ -327,7 +334,7 @@ dialog::backdrop { background: oklch(0.16 0.04 255 / .72); }
327
  .app-header { padding-inline: var(--space-md); }
328
  .btn { padding-inline: var(--space-md); }
329
  .teacher-layout { display: block; }
330
- .roster-panel { min-height: calc(100dvh - 60px); border-right: 0; }
331
  .teacher-detail { position: fixed; inset: 60px 0 0; z-index: 18; display: none; }
332
  .teacher-detail.mobile-open { display: block; }
333
  .roster-header, .student-row { grid-template-columns: minmax(120px, 1fr) 90px 70px; }
 
39
 
40
  * { box-sizing: border-box; }
41
  [hidden] { display: none !important; }
42
+ html, body { width: 100%; height: 100%; overflow: hidden; }
43
+ body { min-height: 0; margin: 0; display: flex; flex-direction: column; background: var(--shell); color: var(--ink); }
44
+ button, input, textarea, select { font: inherit; }
45
  button { cursor: pointer; }
46
  button:disabled { cursor: not-allowed; opacity: .48; }
47
 
 
63
 
64
  .app-header {
65
  min-height: 60px;
66
+ flex: none;
67
  display: flex;
68
  align-items: center;
69
  justify-content: space-between;
 
133
  .btn.help.active { background: oklch(0.65 0.17 68); }
134
  .btn.compact { min-height: 36px; padding: 0 var(--space-md); font-size: .875rem; }
135
 
136
+ .project-bar { min-height:58px;flex:none;display:flex;align-items:center;justify-content:space-between;gap:var(--space-lg);padding:var(--space-sm) var(--space-xl);border-bottom:1px solid var(--line);background:var(--surface); }
137
  .project-context,.project-actions { display:flex;align-items:center;gap:var(--space-sm);flex-wrap:wrap; }
138
  .project-context label { color:var(--muted);font-size:.75rem;font-weight:800; }
139
  .project-context select,.project-context input { min-height:36px;max-width:280px;padding:0 var(--space-md);border:1px solid var(--line);border-radius:var(--radius-sm);background:var(--surface);color:var(--ink);font-weight:700; }
140
  .submission-summary { padding:var(--space-sm) var(--space-md);border-radius:999px;background:var(--success-soft);color:oklch(.37 .12 150);font-size:.8rem;font-weight:800; }
141
  .student-layout {
142
+ min-height: 0;
143
+ flex: 1;
144
+ overflow: hidden;
145
  display: grid;
146
  grid-template-columns: minmax(230px, 280px) minmax(420px, 1fr) minmax(280px, 360px);
147
  grid-template-areas: "reference editor console";
148
  }
149
 
150
+ .panel { min-width: 0; min-height: 0; overflow: hidden; background: var(--surface); }
151
+ .reference-panel { grid-area: reference; display:grid;grid-template-rows:44px minmax(0,1fr);border-right:1px solid var(--line); }
152
+ .editor-panel { grid-area: editor; display:grid;grid-template-rows:52px minmax(0,1fr);background:var(--editor); }
153
+ .console-panel { grid-area: console; display:grid;grid-template-rows:52px minmax(0,1fr);border-left:1px solid var(--line); }
154
 
155
  .panel-heading {
156
  min-height: 52px;
 
166
  .side-tabs { height:44px;display:flex;border-bottom:1px solid var(--line); }
167
  .side-tab { flex:1;border:0;background:var(--surface);color:var(--muted);font-size:.8rem;font-weight:800; }
168
  .side-tab.active { color:var(--navy);box-shadow:inset 0 -3px 0 var(--action); }
169
+ #filesView { min-height:0;display:grid;grid-template-rows:52px minmax(0,1fr) auto; }
170
+ #syntaxView { min-height:0;display:grid;grid-template-rows:52px auto minmax(0,1fr); }
171
+ .file-list { min-height:0;overflow:auto;padding:var(--space-sm); }
172
  .file-row { display:flex;align-items:center;border-radius:var(--radius-sm); }
173
  .file-row:hover { background:var(--surface-subtle); }.file-row.selected{background:var(--action-soft);color:var(--navy)}
174
  .file-row>button:first-child { min-width:0;min-height:40px;flex:1;padding:0 var(--space-md);border:0;background:transparent;color:inherit;text-align:left;font:650 .82rem/1.2 "SFMono-Regular",Consolas,monospace;overflow:hidden;text-overflow:ellipsis; }
 
185
  color: var(--ink);
186
  }
187
  .text-field { min-height: 44px; padding: 0 var(--space-md); }
188
+ .secondary-label { margin-top: var(--space-lg); }
189
  .text-field::placeholder, .stdin-field::placeholder { color: oklch(0.46 0.025 255); opacity: 1; }
190
  .text-field:focus, .stdin-field:focus { border-color: var(--action); }
191
 
 
203
  }
204
  .chip[aria-pressed="true"] { border-color: var(--action); background: var(--action-soft); color: var(--navy); }
205
 
206
+ .snippet-list { min-height:0;overflow:auto;padding:var(--space-sm) var(--space-lg) var(--space-xl); }
207
  .snippet-empty { padding: var(--space-xl) 0; color: var(--muted); line-height: 1.55; }
208
  .snippet-item { padding: var(--space-lg) 0; border-bottom: 1px solid var(--line); }
209
  .snippet-item:last-child { border-bottom: 0; }
 
235
 
236
  .editor-toolbar { display: flex; align-items: center; gap: var(--space-sm); }
237
  .file-name { font: 700 .875rem/1 "SFMono-Regular", Consolas, monospace; color: oklch(0.82 0.025 255); }
238
+ .editor-host { min-height:0; }
239
  .CodeMirror { height: 100%; font: 500 1rem/1.7 "SFMono-Regular", Consolas, monospace; background: var(--editor); }
240
  .CodeMirror-gutters { background: var(--editor); border-right: 1px solid var(--editor-line); }
241
 
242
+ .console-body { min-height:0;display:grid;grid-template-rows:auto minmax(120px,1fr) auto; }
243
  .stdin-section { padding: var(--space-lg); border-bottom: 1px solid var(--line); }
244
  .stdin-field { min-height: 96px; resize: vertical; padding: var(--space-md); font: 500 .875rem/1.5 "SFMono-Regular", Consolas, monospace; }
245
  .field-help { margin: var(--space-sm) 0 0; color: var(--muted); font-size: .75rem; line-height: 1.45; }
 
272
  .form-stack { display: grid; gap: var(--space-lg); }
273
  .form-error { min-height: 1.25rem; margin: 0; color: var(--danger); font-size: .875rem; }
274
 
275
+ .teacher-layout { min-height:0;flex:1;overflow:hidden;display:grid;grid-template-columns:minmax(360px,43%) minmax(480px,57%); }
276
+ .roster-panel { min-height:0;display:grid;grid-template-rows:52px auto 42px minmax(0,1fr);overflow:hidden;border-right:1px solid var(--line);background:var(--surface); }
277
+ .teacher-detail { min-width:0;min-height:0;overflow:hidden;background:var(--shell); }
278
  .filter-bar { display: flex; gap: var(--space-sm); padding: var(--space-md) var(--space-lg); border-bottom: 1px solid var(--line); overflow-x: auto; }
279
+ .roster-list { min-height:0;overflow:auto; }
280
  .roster-header, .student-row {
281
  display: grid;
282
  grid-template-columns: minmax(110px, 1.15fr) 90px minmax(92px, .9fr) 76px;
 
294
  .help-label { color: oklch(0.45 0.13 70); font-size: .78rem; font-weight: 850; }
295
  .empty-roster { padding: var(--space-2xl); color: var(--muted); line-height: 1.55; }
296
 
297
+ .detail-empty { height:100%;display:grid;place-items:center;padding:var(--space-2xl);color:var(--muted);text-align:center; }
298
+ .detail-view { height:100%;display:grid;grid-template-rows:auto minmax(0,1fr); }
299
  .detail-header { min-height: 76px; display: flex; align-items: center; justify-content: space-between; gap: var(--space-lg); padding: var(--space-lg) var(--space-xl); background: var(--surface); border-bottom: 1px solid var(--line); }
300
  .detail-header h1 { margin: 0; font-size: 1.2rem; }
301
  .detail-meta { margin-top: 4px; color: var(--muted); font-size: .8rem; }
 
305
  .teacher-file-tabs { display:flex;gap:2px;padding:var(--space-xs) var(--space-md);overflow-x:auto;background:var(--editor-raised);border-bottom:1px solid var(--editor-line); }
306
  .teacher-file-tab { flex:none;min-height:32px;padding:0 var(--space-md);border:0;border-radius:var(--radius-sm);background:transparent;color:oklch(.72 .02 255);font:650 .78rem/1 "SFMono-Regular",Consolas,monospace; }
307
  .teacher-file-tab:hover,.teacher-file-tab.active { background:var(--editor-line);color:white; }
308
+ .danger-action { border-color:oklch(.82 .08 25);color:var(--danger); }
309
+ .danger-action:hover { background:var(--danger-soft); }
310
  .progress-list { display:grid;gap:var(--space-sm);max-height:50vh;overflow:auto;margin-bottom:var(--space-lg); }
311
  .progress-item { display:flex;justify-content:space-between;gap:var(--space-md);padding:var(--space-md);border:1px solid var(--line);border-radius:var(--radius-sm);background:var(--surface);color:var(--ink);text-align:left; }
312
  .progress-item:hover{background:var(--action-soft)}.progress-item span{color:var(--muted);font-size:.75rem}.publish-actions{display:flex;justify-content:flex-end;gap:var(--space-sm)}
 
320
 
321
  @media (max-width: 980px) {
322
  .project-bar{align-items:stretch;flex-direction:column;padding:var(--space-md)}.project-actions{overflow-x:auto;flex-wrap:nowrap}.project-actions>*{flex:none}
323
+ .student-layout { display:block;min-height:0; }
324
+ .mobile-tabs { display:flex;flex:none;background:var(--surface);border-bottom:1px solid var(--line); }
325
  .mobile-tab { flex: 1; min-height: 46px; border: 0; background: var(--surface); color: var(--muted); font-weight: 800; }
326
  .mobile-tab[aria-selected="true"] { color: var(--navy); box-shadow: inset 0 -3px 0 var(--action); }
327
+ .student-layout .panel { display:none;height:100%;min-height:0; }
328
+ .student-layout .panel.mobile-active { display:grid; }
 
329
  .teacher-layout { grid-template-columns: minmax(320px, 42%) minmax(420px, 58%); }
330
  }
331
 
 
334
  .app-header { padding-inline: var(--space-md); }
335
  .btn { padding-inline: var(--space-md); }
336
  .teacher-layout { display: block; }
337
+ .roster-panel { height:100%;min-height:0;border-right:0; }
338
  .teacher-detail { position: fixed; inset: 60px 0 0; z-index: 18; display: none; }
339
  .teacher-detail.mobile-open { display: block; }
340
  .roster-header, .student-row { grid-template-columns: minmax(120px, 1fr) 90px 70px; }
classroom_static/student.html CHANGED
@@ -1,10 +1,10 @@
1
- <!doctype html><html lang="zh-Hant"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light"><title>Python 專案教室|學生工作區</title><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.css"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/theme/material-darker.min.css"><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-1"></head><body>
2
  <header class="app-header"><div class="brand"><div class="brand-mark">Py</div><div class="brand-copy"><strong>Python 專案教室</strong><span id="studentIdentity">尚未進入教室</span></div></div><div class="header-actions"><div class="connection-state"><i class="status-dot" id="connectionDot"></i><span id="connectionText">未連線</span></div><button class="btn help compact" id="helpButton">請老師協助</button><button class="btn secondary compact" id="identityButton">更換身分</button></div></header>
3
  <section class="project-bar"><div class="project-context"><label for="weekSelect">週次</label><select id="weekSelect"></select><label for="projectName">專案</label><input id="projectName" maxlength="36" value="Python專案"></div><div class="project-actions"><button class="copy-button" id="templateButton">匯入本週套版</button><button class="copy-button" id="progressButton">選擇舊進度</button><button class="copy-button" id="importButton">匯入 .py / ZIP</button><button class="copy-button" id="exportButton">匯出專案</button><button class="btn compact" id="submitButton">提交本週版本</button><input id="fileImport" type="file" accept=".py,.zip" hidden></div></section>
4
  <nav class="mobile-tabs" role="tablist"><button class="mobile-tab" data-panel="referencePanel">專案/語法</button><button class="mobile-tab" data-panel="editorPanel" aria-selected="true">程式</button><button class="mobile-tab" data-panel="consolePanel">執行結果</button></nav>
5
  <main class="student-layout"><aside class="panel reference-panel" id="referencePanel"><div class="side-tabs"><button class="side-tab active" data-side="filesView">專案檔案</button><button class="side-tab" data-side="syntaxView">語法查詢</button></div><section class="side-view" id="filesView"><div class="panel-heading"><h1>檔案夾</h1><button class="copy-button" id="newFileButton">+新增</button></div><div class="file-list" id="fileList"></div><p class="side-note">入口固定為 <code>main.py</code>,可用 <code>import</code> 引入其他 Python 檔。</p></section><section class="side-view" id="syntaxView" hidden><div class="panel-heading"><h1>Python 語法查詢</h1><span id="snippetCount">0 項</span></div><div class="search-wrap"><label class="field-label" for="syntaxSearch">輸入語法或用途</label><input class="text-field" id="syntaxSearch" type="search" placeholder="迴圈、字典、JSON"><div class="chip-row" id="categoryFilters"></div></div><div class="snippet-list" id="snippetList"></div></section></aside>
6
  <section class="panel editor-panel mobile-active" id="editorPanel"><div class="panel-heading dark"><span class="file-name" id="activeFileLabel">main.py</span><div class="editor-toolbar"><button class="btn stop compact" id="stopButton" disabled>停止</button><button class="btn compact" id="runButton" disabled>載入 Python…</button></div></div><div class="editor-host"><textarea id="codeEditor" aria-label="程式碼"></textarea></div></section>
7
  <aside class="panel console-panel" id="consolePanel"><div class="panel-heading"><h2>執行與輸出</h2><button class="copy-button" id="clearOutputButton">清除</button></div><div class="console-body"><section class="stdin-section"><label class="field-label" for="stdinInput">程式輸入</label><textarea class="stdin-field" id="stdinInput" placeholder="input() 每行一筆"></textarea><p class="field-help">執行 <code>main.py</code>,同專案的文字檔會一起載入。</p></section><pre class="console-output" id="consoleOutput">Python 執行環境載入中…</pre><div class="console-status"><i class="status-dot" id="runStatusDot"></i><span id="runStatusText">準備環境</span><span>·</span><span id="saveStatus">尚未同步</span><span>·</span><span id="submitStatus">本週尚未提交</span></div></div></aside></main>
8
- <dialog id="identityDialog"><form class="dialog-content form-stack" id="identityForm"><div><h1>進入程式教室</h1><p>顯示名稱建議使用座號與英文名。</p></div><div><label class="field-label" for="classCode">班級代碼</label><input class="text-field" id="classCode" value="L6A" required></div><div><label class="field-label" for="displayName">顯示名稱</label><input class="text-field" id="displayName" placeholder="12_Alex" required></div><p class="form-error" id="identityError"></p><button class="btn" type="submit">進入教室</button></form></dialog>
9
  <dialog id="progressDialog"><div class="dialog-content"><h2>選擇正式進度</h2><p>匯入後會成為目前週次的工作副本。</p><div class="progress-list" id="progressList"></div><button class="btn secondary dialog-close">關閉</button></div></dialog><div class="toast" id="toast"></div>
10
- <script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/mode/python/python.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/jszip/3.10.1/jszip.min.js"></script><script src="/classroom-assets/student.js?v=2026fall-2"></script></body></html>
 
1
+ <!doctype html><html lang="zh-Hant"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light"><title>Python 專案教室|學生工作區</title><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.css"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/theme/material-darker.min.css"><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-3"></head><body>
2
  <header class="app-header"><div class="brand"><div class="brand-mark">Py</div><div class="brand-copy"><strong>Python 專案教室</strong><span id="studentIdentity">尚未進入教室</span></div></div><div class="header-actions"><div class="connection-state"><i class="status-dot" id="connectionDot"></i><span id="connectionText">未連線</span></div><button class="btn help compact" id="helpButton">請老師協助</button><button class="btn secondary compact" id="identityButton">更換身分</button></div></header>
3
  <section class="project-bar"><div class="project-context"><label for="weekSelect">週次</label><select id="weekSelect"></select><label for="projectName">專案</label><input id="projectName" maxlength="36" value="Python專案"></div><div class="project-actions"><button class="copy-button" id="templateButton">匯入本週套版</button><button class="copy-button" id="progressButton">選擇舊進度</button><button class="copy-button" id="importButton">匯入 .py / ZIP</button><button class="copy-button" id="exportButton">匯出專案</button><button class="btn compact" id="submitButton">提交本週版本</button><input id="fileImport" type="file" accept=".py,.zip" hidden></div></section>
4
  <nav class="mobile-tabs" role="tablist"><button class="mobile-tab" data-panel="referencePanel">專案/語法</button><button class="mobile-tab" data-panel="editorPanel" aria-selected="true">程式</button><button class="mobile-tab" data-panel="consolePanel">執行結果</button></nav>
5
  <main class="student-layout"><aside class="panel reference-panel" id="referencePanel"><div class="side-tabs"><button class="side-tab active" data-side="filesView">專案檔案</button><button class="side-tab" data-side="syntaxView">語法查詢</button></div><section class="side-view" id="filesView"><div class="panel-heading"><h1>檔案夾</h1><button class="copy-button" id="newFileButton">+新增</button></div><div class="file-list" id="fileList"></div><p class="side-note">入口固定為 <code>main.py</code>,可用 <code>import</code> 引入其他 Python 檔。</p></section><section class="side-view" id="syntaxView" hidden><div class="panel-heading"><h1>Python 語法查詢</h1><span id="snippetCount">0 項</span></div><div class="search-wrap"><label class="field-label" for="syntaxSearch">輸入語法或用途</label><input class="text-field" id="syntaxSearch" type="search" placeholder="迴圈、字典、JSON"><div class="chip-row" id="categoryFilters"></div></div><div class="snippet-list" id="snippetList"></div></section></aside>
6
  <section class="panel editor-panel mobile-active" id="editorPanel"><div class="panel-heading dark"><span class="file-name" id="activeFileLabel">main.py</span><div class="editor-toolbar"><button class="btn stop compact" id="stopButton" disabled>停止</button><button class="btn compact" id="runButton" disabled>載入 Python…</button></div></div><div class="editor-host"><textarea id="codeEditor" aria-label="程式碼"></textarea></div></section>
7
  <aside class="panel console-panel" id="consolePanel"><div class="panel-heading"><h2>執行與輸出</h2><button class="copy-button" id="clearOutputButton">清除</button></div><div class="console-body"><section class="stdin-section"><label class="field-label" for="stdinInput">程式輸入</label><textarea class="stdin-field" id="stdinInput" placeholder="input() 每行一筆"></textarea><p class="field-help">執行 <code>main.py</code>,同專案的文字檔會一起載入。</p></section><pre class="console-output" id="consoleOutput">Python 執行環境載入中…</pre><div class="console-status"><i class="status-dot" id="runStatusDot"></i><span id="runStatusText">準備環境</span><span>·</span><span id="saveStatus">尚未同步</span><span>·</span><span id="submitStatus">本週尚未提交</span></div></div></aside></main>
8
+ <dialog id="identityDialog"><form class="dialog-content form-stack" id="identityForm"><div><h1>進入程式教室</h1><p>先選課程,再選自己的名字。名單上沒有時可新增。</p></div><div><label class="field-label" for="classCode">課程</label><select class="text-field" id="classCode" required></select></div><div><label class="field-label" for="studentChoice">學生</label><select class="text-field" id="studentChoice" required></select></div><div id="newStudentFields" hidden><label class="field-label" for="displayName">新學生名稱</label><input class="text-field" id="displayName" placeholder="12_Alex"><p class="field-help">建議使用座號與英文名,方便老師辨識。</p></div><p class="form-error" id="identityError"></p><button class="btn" type="submit">進入教室</button></form></dialog>
9
  <dialog id="progressDialog"><div class="dialog-content"><h2>選擇正式進度</h2><p>匯入後會成為目前週次的工作副本。</p><div class="progress-list" id="progressList"></div><button class="btn secondary dialog-close">關閉</button></div></dialog><div class="toast" id="toast"></div>
10
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/mode/python/python.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/jszip/3.10.1/jszip.min.js"></script><script src="/classroom-assets/student.js?v=2026fall-3"></script></body></html>
classroom_static/student.js CHANGED
@@ -1,7 +1,7 @@
1
  const SNIPPETS=[["基礎","輸入與輸出",'name = input("名字:")\nprint("你好", name)'],["判斷","if / elif / else",'if score >= 90:\n print("A")\nelse:\n print("繼續加油")'],["迴圈","for 與 range",'for number in range(1, 6):\n print(number)'],["迴圈","while",'while True:\n choice = input("選擇:")\n if choice == "q":\n break'],["資料","list",'items = []\nitems.append("線索")\nfor item in items:\n print(item)'],["資料","dict",'student = {"name": "Alex"}\nprint(student.get("team", "未分組"))'],["函式","def / return",'def add(a, b):\n return a + b'],["檔案","引入自己的模組",'from clues import find_clue'],["檔案","讀取 JSON",'import json\nwith open("data.json", encoding="utf-8") as file:\n data = json.load(file)'],["錯誤","try / except",'try:\n age = int(input("年齡:"))\nexcept ValueError:\n print("請輸入整數")']].map(([category,title,code])=>({category,title,code}));
2
- const $=id=>document.getElementById(id),E={};["identityDialog","identityForm","identityError","classCode","displayName","studentIdentity","identityButton","connectionDot","connectionText","helpButton","weekSelect","projectName","templateButton","progressButton","importButton","exportButton","submitButton","fileImport","fileList","newFileButton","activeFileLabel","syntaxSearch","categoryFilters","snippetList","snippetCount","runButton","stopButton","stdinInput","consoleOutput","clearOutputButton","runStatusDot","runStatusText","saveStatus","submitStatus","toast","progressDialog","progressList"].forEach(id=>E[id]=$(id));
3
  const editor=CodeMirror.fromTextArea($("codeEditor"),{mode:"python",theme:"material-darker",lineNumbers:true,indentUnit:4,tabSize:4,extraKeys:{Tab:cm=>cm.replaceSelection(" ")}});
4
- const studentId=localStorage.getItem("classroom_student_id")||crypto.randomUUID();localStorage.setItem("classroom_student_id",studentId);
5
  let course,files={"main.py":"# 在這裡寫 Python\n"},activeFile="main.py",socket,worker,workerReady=false,running=false,needsHelp=false,submittedAt=null,output="",suppress=false,timer,reconnect,category="全部";
6
  const clean=v=>String(v||"").trim().replace(/[^0-9A-Za-z_\-一-鿿]/g,"").slice(0,48),week=()=>E.weekSelect.value||"week02",key=()=>`classroom_project_${localStorage.getItem("classroom_code")}_${week()}`;
7
  function toast(t){E.toast.textContent=t;E.toast.classList.add("visible");setTimeout(()=>E.toast.classList.remove("visible"),1900)}
@@ -12,13 +12,16 @@ function sync(){saveLocal();E.saveStatus.textContent="同步中";clearTimeout(ti
12
  function openFile(path){if(!(path in files))return;if(activeFile in files&&!suppress)files[activeFile]=editor.getValue();activeFile=path;suppress=true;editor.setValue(files[path]);suppress=false;E.activeFileLabel.textContent=path;editor.setOption("mode",path.endsWith(".py")?"python":"text");renderFiles()}
13
  function setProject(next,name,preferred="main.py"){files=Object.fromEntries(Object.entries(next||{}).filter(([p,v])=>typeof v==="string"&&!p.includes("..")));files["main.py"]??="# 專案入口\n";E.projectName.value=name||"Python專案";const firstFile=files[preferred]?preferred:"main.py";activeFile="";openFile(firstFile);sync()}
14
  function renderFiles(){E.fileList.innerHTML=Object.keys(files).sort((a,b)=>a==="main.py"?-1:b==="main.py"?1:a.localeCompare(b)).map(p=>`<div class="file-row ${p===activeFile?"selected":""}"><button data-open="${esc(p)}">◇ ${esc(p)}</button>${p!=="main.py"?`<button class="file-remove" data-remove="${esc(p)}">×</button>`:""}</div>`).join("");E.fileList.querySelectorAll("[data-open]").forEach(b=>b.onclick=()=>openFile(b.dataset.open));E.fileList.querySelectorAll("[data-remove]").forEach(b=>b.onclick=()=>{if(confirm(`刪除 ${b.dataset.remove}?`)){delete files[b.dataset.remove];if(activeFile===b.dataset.remove)activeFile="main.py";openFile(activeFile);sync()}})}
15
- function connect(){clearTimeout(reconnect);const previous=socket;if(previous){previous.onclose=null;previous.close()}const c=clean(localStorage.getItem("classroom_code")),n=clean(localStorage.getItem("classroom_name"));if(!c||!n){E.identityDialog.showModal();return}E.studentIdentity.textContent=`${c} · ${n}`;E.connectionText.textContent="連線中";const scheme=location.protocol==="https:"?"wss":"ws",q=new URLSearchParams({class_code:c,student_id:studentId,display_name:n,week_id:week()}),current=new WebSocket(`${scheme}://${location.host}/ws/classroom/student?${q}`);socket=current;current.onopen=()=>{E.connectionDot.className="status-dot online";E.connectionText.textContent="已連線"};current.onmessage=e=>{const m=JSON.parse(e.data);if(m.type==="restore"){const local=JSON.parse(localStorage.getItem(key())||"null"),s=m.state,src=local||{files:s.files,activeFile:s.active_file,projectName:s.project_name,output:s.output};output=src.output||"";E.consoleOutput.textContent=output||"尚無執行結果。";submittedAt=s.submitted_at;needsHelp=!!s.needs_help;renderState();setProject(src.files,src.projectName,src.activeFile);send({type:"output",output})}if(m.type==="help_ack"){needsHelp=false;renderState();toast("老師已看到你的協助請求")}if(["ack","pong"].includes(m.type)){if(typeof m.needs_help==="boolean"){const seen=needsHelp&&!m.needs_help;needsHelp=m.needs_help;if(seen)toast("老師已看到你的協助請求")}if(m.submitted_at)submittedAt=m.submitted_at;renderState();if(m.type==="ack")E.saveStatus.textContent="已同步"}};current.onclose=()=>{if(socket!==current)return;E.connectionDot.className="status-dot error";E.connectionText.textContent="已離線";E.saveStatus.textContent="保存在此裝置";reconnect=setTimeout(connect,2500)}}
16
  function renderState(){E.helpButton.classList.toggle("active",needsHelp);E.helpButton.textContent=needsHelp?"取消請求協助":"請老師協助";E.submitStatus.textContent=submittedAt?`已提交 ${new Date(submittedAt).toLocaleTimeString("zh-TW",{hour:"2-digit",minute:"2-digit"})}`:"本週尚未提交"}
17
  function initWorker(){worker?.terminate();workerReady=false;E.runButton.disabled=true;worker=new Worker("/classroom-assets/py-worker.js?v=2026fall-1");worker.onmessage=e=>{const m=e.data;if(m.type==="ready"){workerReady=true;E.runButton.disabled=false;E.runButton.textContent="執行";runState("online","準備完成")}else if(m.type==="stdout"||m.type==="stderr")append(`${m.text}\n`);else if(m.type==="done")runState("success","執行成功");else if(m.type==="python_error"){append(`${m.text}\n`);runState("error","程式錯誤")}else if(m.type==="load_error")runState("error","載入失敗")}}
18
  function runState(s,t){running=s==="running";E.runStatusDot.className=`status-dot ${s}`;E.runStatusText.textContent=t;E.runButton.disabled=!workerReady||running;E.stopButton.disabled=!running;send({type:"status",status:s==="online"?"idle":s})}
19
  function append(t){output=(output+t).slice(-40000);E.consoleOutput.textContent=output;saveLocal();send({type:"output",output})}
20
  function renderSyntax(){const cats=["全部",...new Set(SNIPPETS.map(s=>s.category))];E.categoryFilters.innerHTML=cats.map(c=>`<button class="chip" data-cat="${c}" aria-pressed="${c===category}">${c}</button>`).join("");E.categoryFilters.querySelectorAll("button").forEach(b=>b.onclick=()=>{category=b.dataset.cat;renderSyntax()});const q=E.syntaxSearch.value.toLowerCase(),list=SNIPPETS.filter(s=>(category==="全部"||s.category===category)&&(`${s.title} ${s.code}`.toLowerCase().includes(q)));E.snippetCount.textContent=`${list.length} 項`;E.snippetList.innerHTML=list.map(s=>`<article class="snippet-item"><div class="snippet-title"><strong>${s.title}</strong><span>${s.category}</span></div><pre>${esc(s.code)}</pre><button class="copy-button" data-copy="${SNIPPETS.indexOf(s)}">複製範例</button></article>`).join("")||'<div class="snippet-empty">找不到符合的語法。</div>';E.snippetList.querySelectorAll("[data-copy]").forEach(b=>b.onclick=async()=>{const s=SNIPPETS[+b.dataset.copy];await navigator.clipboard.writeText(s.code);toast(`已複製:${s.title}`)})}
21
- E.identityForm.onsubmit=e=>{e.preventDefault();const c=clean(E.classCode.value),n=clean(E.displayName.value);if(!c||!n)return;localStorage.setItem("classroom_code",c);localStorage.setItem("classroom_name",n);E.identityDialog.close();connect()};E.identityButton.onclick=()=>E.identityDialog.showModal();E.weekSelect.onchange=()=>{localStorage.setItem("classroom_week",week());submittedAt=null;connect()};E.projectName.oninput=sync;
 
 
 
22
  E.newFileButton.onclick=()=>{const p=(prompt("新檔名(例如 clues.py):")||"").trim();if(!/^[\w\-\u4e00-\u9fff/]+\.(py|json|txt|csv|md)$/.test(p)||p.includes(".."))return toast("檔名不合規格");if(p in files)return toast("檔案已存在");files[p]=p.endsWith(".py")?"# 新的 Python 模組\n":"";openFile(p);sync()};
23
  E.templateButton.onclick=async()=>{if(!confirm("匯入套版會取代目前內容,繼續?"))return;const r=await fetch(`/api/classroom/template/${week()}`);if(!r.ok)return toast("這週尚未發布套版");const d=await r.json(),w=course.weeks.find(x=>x.id===week());setProject(d.files,w?.project);toast("已匯入本週套版")};
24
  E.progressButton.onclick=async()=>{const q=new URLSearchParams({class_code:localStorage.getItem("classroom_code")||"",student_id:studentId,display_name:localStorage.getItem("classroom_name")||""}),r=await fetch(`/api/classroom/progress?${q}`),d=await r.json();E.progressList.innerHTML=d.progress.length?d.progress.map((p,i)=>`<button class="progress-item" data-i="${i}"><strong>${esc(p.week_id)}|${esc(p.project_name)}</strong><span>${p.source==="published"?"已發布 ":""}${new Date(p.submitted_at).toLocaleString("zh-TW")}</span></button>`).join(""):'<p>還沒有正式版本。</p>';E.progressList.querySelectorAll("[data-i]").forEach(b=>b.onclick=()=>{const p=d.progress[+b.dataset.i];setProject(p.files,p.project_name);E.progressDialog.close()});E.progressDialog.showModal()};document.querySelectorAll(".dialog-close").forEach(b=>b.onclick=()=>b.closest("dialog").close());
@@ -27,4 +30,4 @@ E.exportButton.onclick=async()=>{files[activeFile]=editor.getValue();const z=new
27
  E.submitButton.onclick=()=>{files[activeFile]=editor.getValue();if(!files["main.py"].trim())return toast("main.py 不能為空");if(!confirm("設為本週最後正式版本?重新提交會覆蓋前一版。"))return;send({type:"submit",files});submittedAt=Date.now();renderState();toast("本週正式版本已提���")};E.helpButton.onclick=()=>{needsHelp=!needsHelp;renderState();send({type:"help",needs_help:needsHelp})};
28
  E.runButton.onclick=()=>{if(!workerReady||running)return;files[activeFile]=editor.getValue();output="";E.consoleOutput.textContent="";runState("running","執行中");worker.postMessage({type:"run",files,entry:"main.py",inputs:E.stdinInput.value.replace(/\r/g,"").split("\n")})};E.stopButton.onclick=()=>{append("\n[已停止]\n");runState("idle","已停止");initWorker()};E.clearOutputButton.onclick=()=>{output="";E.consoleOutput.textContent="尚無執行結果。";send({type:"output",output:""})};E.syntaxSearch.oninput=renderSyntax;editor.on("change",()=>{if(!suppress){files[activeFile]=editor.getValue();sync()}});
29
  document.querySelectorAll(".side-tab").forEach(b=>b.onclick=()=>{document.querySelectorAll(".side-tab").forEach(x=>x.classList.toggle("active",x===b));document.querySelectorAll(".side-view").forEach(v=>v.hidden=v.id!==b.dataset.side)});document.querySelectorAll(".mobile-tab").forEach(b=>b.onclick=()=>{document.querySelectorAll(".mobile-tab").forEach(x=>x.setAttribute("aria-selected",String(x===b)));document.querySelectorAll(".student-layout>.panel").forEach(p=>p.classList.toggle("mobile-active",p.id===b.dataset.panel));if(b.dataset.panel==="editorPanel")setTimeout(()=>editor.refresh(),0)});setInterval(()=>send({type:"ping"}),4000);
30
- (async()=>{course=await(await fetch("/api/classroom/course")).json();E.weekSelect.innerHTML=course.weeks.map(w=>`<option value="${w.id}">第 ${w.week} 週|${esc(w.title)}${w.template?"":"(規劃)"}</option>`).join("");E.weekSelect.value=localStorage.getItem("classroom_week")||"week02";E.classCode.value=localStorage.getItem("classroom_code")||"L6A";E.displayName.value=localStorage.getItem("classroom_name")||"";renderFiles();renderSyntax();initWorker();connect()})();
 
1
  const SNIPPETS=[["基礎","輸入與輸出",'name = input("名字:")\nprint("你好", name)'],["判斷","if / elif / else",'if score >= 90:\n print("A")\nelse:\n print("繼續加油")'],["迴圈","for 與 range",'for number in range(1, 6):\n print(number)'],["迴圈","while",'while True:\n choice = input("選擇:")\n if choice == "q":\n break'],["資料","list",'items = []\nitems.append("線索")\nfor item in items:\n print(item)'],["資料","dict",'student = {"name": "Alex"}\nprint(student.get("team", "未分組"))'],["函式","def / return",'def add(a, b):\n return a + b'],["檔案","引入自己的模組",'from clues import find_clue'],["檔案","讀取 JSON",'import json\nwith open("data.json", encoding="utf-8") as file:\n data = json.load(file)'],["錯誤","try / except",'try:\n age = int(input("年齡:"))\nexcept ValueError:\n print("請輸入整數")']].map(([category,title,code])=>({category,title,code}));
2
+ const $=id=>document.getElementById(id),E={};["identityDialog","identityForm","identityError","classCode","studentChoice","newStudentFields","displayName","studentIdentity","identityButton","connectionDot","connectionText","helpButton","weekSelect","projectName","templateButton","progressButton","importButton","exportButton","submitButton","fileImport","fileList","newFileButton","activeFileLabel","syntaxSearch","categoryFilters","snippetList","snippetCount","runButton","stopButton","stdinInput","consoleOutput","clearOutputButton","runStatusDot","runStatusText","saveStatus","submitStatus","toast","progressDialog","progressList"].forEach(id=>E[id]=$(id));
3
  const editor=CodeMirror.fromTextArea($("codeEditor"),{mode:"python",theme:"material-darker",lineNumbers:true,indentUnit:4,tabSize:4,extraKeys:{Tab:cm=>cm.replaceSelection(" ")}});
4
+ let studentId=localStorage.getItem("classroom_student_id")||crypto.randomUUID(),catalog={courses:[]};localStorage.setItem("classroom_student_id",studentId);
5
  let course,files={"main.py":"# 在這裡寫 Python\n"},activeFile="main.py",socket,worker,workerReady=false,running=false,needsHelp=false,submittedAt=null,output="",suppress=false,timer,reconnect,category="全部";
6
  const clean=v=>String(v||"").trim().replace(/[^0-9A-Za-z_\-一-鿿]/g,"").slice(0,48),week=()=>E.weekSelect.value||"week02",key=()=>`classroom_project_${localStorage.getItem("classroom_code")}_${week()}`;
7
  function toast(t){E.toast.textContent=t;E.toast.classList.add("visible");setTimeout(()=>E.toast.classList.remove("visible"),1900)}
 
12
  function openFile(path){if(!(path in files))return;if(activeFile in files&&!suppress)files[activeFile]=editor.getValue();activeFile=path;suppress=true;editor.setValue(files[path]);suppress=false;E.activeFileLabel.textContent=path;editor.setOption("mode",path.endsWith(".py")?"python":"text");renderFiles()}
13
  function setProject(next,name,preferred="main.py"){files=Object.fromEntries(Object.entries(next||{}).filter(([p,v])=>typeof v==="string"&&!p.includes("..")));files["main.py"]??="# 專案入口\n";E.projectName.value=name||"Python專案";const firstFile=files[preferred]?preferred:"main.py";activeFile="";openFile(firstFile);sync()}
14
  function renderFiles(){E.fileList.innerHTML=Object.keys(files).sort((a,b)=>a==="main.py"?-1:b==="main.py"?1:a.localeCompare(b)).map(p=>`<div class="file-row ${p===activeFile?"selected":""}"><button data-open="${esc(p)}">◇ ${esc(p)}</button>${p!=="main.py"?`<button class="file-remove" data-remove="${esc(p)}">×</button>`:""}</div>`).join("");E.fileList.querySelectorAll("[data-open]").forEach(b=>b.onclick=()=>openFile(b.dataset.open));E.fileList.querySelectorAll("[data-remove]").forEach(b=>b.onclick=()=>{if(confirm(`刪除 ${b.dataset.remove}?`)){delete files[b.dataset.remove];if(activeFile===b.dataset.remove)activeFile="main.py";openFile(activeFile);sync()}})}
15
+ function connect(){clearTimeout(reconnect);const previous=socket;if(previous){previous.onclose=null;previous.close()}const c=clean(localStorage.getItem("classroom_code")),n=clean(localStorage.getItem("classroom_name"));if(!c||!n){E.identityDialog.showModal();return}E.studentIdentity.textContent=`${c} · ${n}`;E.connectionText.textContent="連線中";const scheme=location.protocol==="https:"?"wss":"ws",q=new URLSearchParams({class_code:c,student_id:studentId,display_name:n,week_id:week()}),current=new WebSocket(`${scheme}://${location.host}/ws/classroom/student?${q}`);socket=current;current.onopen=()=>{E.connectionDot.className="status-dot online";E.connectionText.textContent="已連線"};current.onmessage=e=>{const m=JSON.parse(e.data);if(m.type==="restore"){const local=JSON.parse(localStorage.getItem(key())||"null"),s=m.state,src=local||{files:s.files,activeFile:s.active_file,projectName:s.project_name,output:s.output};output=src.output||"";E.consoleOutput.textContent=output||"尚無執行結果。";submittedAt=s.submitted_at;needsHelp=!!s.needs_help;renderState();setProject(src.files,src.projectName,src.activeFile);send({type:"output",output})}if(m.type==="help_ack"){needsHelp=false;renderState();toast("老師已看到你的協助請求")}if(["ack","pong"].includes(m.type)){if(typeof m.needs_help==="boolean"){const seen=needsHelp&&!m.needs_help;needsHelp=m.needs_help;if(seen)toast("老師已看到你的協助請求")}if(m.submitted_at)submittedAt=m.submitted_at;renderState();if(m.type==="ack")E.saveStatus.textContent="已同步"}};current.onclose=async e=>{if(socket!==current)return;E.connectionDot.className="status-dot error";E.connectionText.textContent="已離線";E.saveStatus.textContent="保存在此裝置";if(e.code===4004){localStorage.removeItem("classroom_student_id");localStorage.removeItem("classroom_name");studentId=crypto.randomUUID();localStorage.setItem("classroom_student_id",studentId);await loadCatalog();toast("老師已將這個學生從名單移除");E.identityDialog.showModal();return}reconnect=setTimeout(connect,2500)}}
16
  function renderState(){E.helpButton.classList.toggle("active",needsHelp);E.helpButton.textContent=needsHelp?"取消請求協助":"請老師協助";E.submitStatus.textContent=submittedAt?`已提交 ${new Date(submittedAt).toLocaleTimeString("zh-TW",{hour:"2-digit",minute:"2-digit"})}`:"本週尚未提交"}
17
  function initWorker(){worker?.terminate();workerReady=false;E.runButton.disabled=true;worker=new Worker("/classroom-assets/py-worker.js?v=2026fall-1");worker.onmessage=e=>{const m=e.data;if(m.type==="ready"){workerReady=true;E.runButton.disabled=false;E.runButton.textContent="執行";runState("online","準備完成")}else if(m.type==="stdout"||m.type==="stderr")append(`${m.text}\n`);else if(m.type==="done")runState("success","執行成功");else if(m.type==="python_error"){append(`${m.text}\n`);runState("error","程式錯誤")}else if(m.type==="load_error")runState("error","載入失敗")}}
18
  function runState(s,t){running=s==="running";E.runStatusDot.className=`status-dot ${s}`;E.runStatusText.textContent=t;E.runButton.disabled=!workerReady||running;E.stopButton.disabled=!running;send({type:"status",status:s==="online"?"idle":s})}
19
  function append(t){output=(output+t).slice(-40000);E.consoleOutput.textContent=output;saveLocal();send({type:"output",output})}
20
  function renderSyntax(){const cats=["全部",...new Set(SNIPPETS.map(s=>s.category))];E.categoryFilters.innerHTML=cats.map(c=>`<button class="chip" data-cat="${c}" aria-pressed="${c===category}">${c}</button>`).join("");E.categoryFilters.querySelectorAll("button").forEach(b=>b.onclick=()=>{category=b.dataset.cat;renderSyntax()});const q=E.syntaxSearch.value.toLowerCase(),list=SNIPPETS.filter(s=>(category==="全部"||s.category===category)&&(`${s.title} ${s.code}`.toLowerCase().includes(q)));E.snippetCount.textContent=`${list.length} 項`;E.snippetList.innerHTML=list.map(s=>`<article class="snippet-item"><div class="snippet-title"><strong>${s.title}</strong><span>${s.category}</span></div><pre>${esc(s.code)}</pre><button class="copy-button" data-copy="${SNIPPETS.indexOf(s)}">複製範例</button></article>`).join("")||'<div class="snippet-empty">找不到符合的語法。</div>';E.snippetList.querySelectorAll("[data-copy]").forEach(b=>b.onclick=async()=>{const s=SNIPPETS[+b.dataset.copy];await navigator.clipboard.writeText(s.code);toast(`已複製:${s.title}`)})}
21
+ async function loadCatalog(){catalog=await(await fetch("/api/classroom/classes")).json();const saved=localStorage.getItem("classroom_code");E.classCode.innerHTML=catalog.courses.map(c=>`<option value="${esc(c.class_code)}">${esc(c.course_name)}|${esc(c.class_code)}</option>`).join("");E.classCode.value=catalog.courses.some(c=>c.class_code===saved)?saved:(catalog.courses[0]?.class_code||"");renderStudentChoices()}
22
+ function renderStudentChoices(){const selectedCourse=catalog.courses.find(c=>c.class_code===E.classCode.value),members=selectedCourse?.students||[],savedId=localStorage.getItem("classroom_student_id");E.studentChoice.innerHTML=members.map(s=>`<option value="${esc(s.student_id)}" data-name="${esc(s.display_name)}">${esc(s.display_name)}</option>`).join("")+`<option value="__new__">+ 輸入新名字</option>`;E.studentChoice.value=members.some(s=>s.student_id===savedId)?savedId:"__new__";toggleNewStudent()}
23
+ function toggleNewStudent(){const adding=E.studentChoice.value==="__new__";E.newStudentFields.hidden=!adding;E.displayName.required=adding;if(adding)E.displayName.value=localStorage.getItem("classroom_name")||""}
24
+ E.classCode.onchange=renderStudentChoices;E.studentChoice.onchange=toggleNewStudent;E.identityForm.onsubmit=e=>{e.preventDefault();const c=clean(E.classCode.value),adding=E.studentChoice.value==="__new__",option=E.studentChoice.selectedOptions[0],n=clean(adding?E.displayName.value:option?.dataset.name);if(!c||!n){E.identityError.textContent="請選擇學生或輸入新名字";return}studentId=adding?crypto.randomUUID():E.studentChoice.value;localStorage.setItem("classroom_student_id",studentId);localStorage.setItem("classroom_code",c);localStorage.setItem("classroom_name",n);E.identityError.textContent="";E.identityDialog.close();connect()};E.identityButton.onclick=async()=>{await loadCatalog();E.identityDialog.showModal()};E.weekSelect.onchange=()=>{localStorage.setItem("classroom_week",week());submittedAt=null;connect()};E.projectName.oninput=sync;
25
  E.newFileButton.onclick=()=>{const p=(prompt("新檔名(例如 clues.py):")||"").trim();if(!/^[\w\-\u4e00-\u9fff/]+\.(py|json|txt|csv|md)$/.test(p)||p.includes(".."))return toast("檔名不合規格");if(p in files)return toast("檔案已存在");files[p]=p.endsWith(".py")?"# 新的 Python 模組\n":"";openFile(p);sync()};
26
  E.templateButton.onclick=async()=>{if(!confirm("匯入套版會取代目前內容,繼續?"))return;const r=await fetch(`/api/classroom/template/${week()}`);if(!r.ok)return toast("這週尚未發布套版");const d=await r.json(),w=course.weeks.find(x=>x.id===week());setProject(d.files,w?.project);toast("已匯入本週套版")};
27
  E.progressButton.onclick=async()=>{const q=new URLSearchParams({class_code:localStorage.getItem("classroom_code")||"",student_id:studentId,display_name:localStorage.getItem("classroom_name")||""}),r=await fetch(`/api/classroom/progress?${q}`),d=await r.json();E.progressList.innerHTML=d.progress.length?d.progress.map((p,i)=>`<button class="progress-item" data-i="${i}"><strong>${esc(p.week_id)}|${esc(p.project_name)}</strong><span>${p.source==="published"?"已發布 ":""}${new Date(p.submitted_at).toLocaleString("zh-TW")}</span></button>`).join(""):'<p>還沒有正式版本。</p>';E.progressList.querySelectorAll("[data-i]").forEach(b=>b.onclick=()=>{const p=d.progress[+b.dataset.i];setProject(p.files,p.project_name);E.progressDialog.close()});E.progressDialog.showModal()};document.querySelectorAll(".dialog-close").forEach(b=>b.onclick=()=>b.closest("dialog").close());
 
30
  E.submitButton.onclick=()=>{files[activeFile]=editor.getValue();if(!files["main.py"].trim())return toast("main.py 不能為空");if(!confirm("設為本週最後正式版本?重新提交會覆蓋前一版。"))return;send({type:"submit",files});submittedAt=Date.now();renderState();toast("本週正式版本已提���")};E.helpButton.onclick=()=>{needsHelp=!needsHelp;renderState();send({type:"help",needs_help:needsHelp})};
31
  E.runButton.onclick=()=>{if(!workerReady||running)return;files[activeFile]=editor.getValue();output="";E.consoleOutput.textContent="";runState("running","執行中");worker.postMessage({type:"run",files,entry:"main.py",inputs:E.stdinInput.value.replace(/\r/g,"").split("\n")})};E.stopButton.onclick=()=>{append("\n[已停止]\n");runState("idle","已停止");initWorker()};E.clearOutputButton.onclick=()=>{output="";E.consoleOutput.textContent="尚無執行結果。";send({type:"output",output:""})};E.syntaxSearch.oninput=renderSyntax;editor.on("change",()=>{if(!suppress){files[activeFile]=editor.getValue();sync()}});
32
  document.querySelectorAll(".side-tab").forEach(b=>b.onclick=()=>{document.querySelectorAll(".side-tab").forEach(x=>x.classList.toggle("active",x===b));document.querySelectorAll(".side-view").forEach(v=>v.hidden=v.id!==b.dataset.side)});document.querySelectorAll(".mobile-tab").forEach(b=>b.onclick=()=>{document.querySelectorAll(".mobile-tab").forEach(x=>x.setAttribute("aria-selected",String(x===b)));document.querySelectorAll(".student-layout>.panel").forEach(p=>p.classList.toggle("mobile-active",p.id===b.dataset.panel));if(b.dataset.panel==="editorPanel")setTimeout(()=>editor.refresh(),0)});setInterval(()=>send({type:"ping"}),4000);
33
+ (async()=>{[course]=await Promise.all([(await fetch("/api/classroom/course")).json(),loadCatalog()]);E.weekSelect.innerHTML=course.weeks.map(w=>`<option value="${w.id}">第 ${w.week} 週|${esc(w.title)}${w.template?"":"(規劃)"}</option>`).join("");E.weekSelect.value=localStorage.getItem("classroom_week")||"week02";renderFiles();renderSyntax();initWorker();connect()})();
classroom_static/teacher.html CHANGED
@@ -1,6 +1,6 @@
1
- <!doctype html><html lang="zh-Hant"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Python 專案教室|教師控制台</title><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-1"></head><body>
2
  <header class="app-header"><div class="brand"><div class="brand-mark">Py</div><div class="brand-copy"><strong>全班專案控制台</strong><span id="classLabel">尚未進入班級</span></div></div><div class="header-actions"><div class="connection-state"><i id="connectionDot" class="status-dot"></i><span id="connectionText">未連線</span></div><button class="btn secondary compact" id="loginButton">切換班級</button></div></header>
3
  <section class="project-bar"><div class="project-context"><label for="teacherWeek">週次</label><select id="teacherWeek"></select><span id="submissionSummary" class="submission-summary">等待學生</span></div><div class="project-actions"><button class="copy-button" id="downloadButton">下載全班 ZIP</button><button class="btn compact" id="publishButton">結算並發布 Demo</button></div></section>
4
  <main class="teacher-layout"><section class="roster-panel"><div class="panel-heading"><h1>學生狀態</h1><span id="studentTotal">0 人</span></div><div class="filter-bar" id="teacherFilters"><button class="chip" data-filter="all" aria-pressed="true">全部</button><button class="chip" data-filter="submitted">已提交</button><button class="chip" data-filter="help">需要協助</button><button class="chip" data-filter="error">錯誤</button></div><div class="roster-header"><span>學生</span><span>狀態</span><span>檔案</span><span>提交</span></div><div class="roster-list" id="rosterList"></div></section>
5
- <section class="teacher-detail" id="teacherDetail"><div class="detail-empty" id="detailEmpty">選擇一位學生查看多檔案專案。</div><div class="detail-view" id="detailView" hidden><header class="detail-header"><div><h1 id="selectedStudentName"></h1><p class="detail-meta" id="selectedStudentMeta"></p></div><div class="detail-actions"><button class="copy-button" id="ackHelpButton" hidden>標記已查看</button><button class="copy-button" id="copyCodeButton">複製檔案</button></div></header><div class="teacher-project"><nav class="teacher-file-tabs" id="teacherFiles"></nav><div class="detail-split"><section class="read-only-pane"><div class="pane-label"><span id="teacherActiveFile">main.py</span><span id="lineCount">0 行</span></div><pre class="code-readonly" id="studentCode"></pre></section><section class="read-only-pane"><div class="pane-label"><span>Console</span><span id="outputState"></span></div><pre class="output-readonly" id="studentOutput"></pre></section></div></div></div></section></main>
6
- <dialog id="loginDialog"><form class="dialog-content form-stack" id="loginForm"><div><h1>進入教師控制台</h1><p>選擇班級後即時查看。</p></div><div><label class="field-label" for="classCode">班級代碼</label><input class="text-field" id="classCode" value="L6A" required></div><div><label class="field-label" for="teacherPassword">教師密碼</label><input class="text-field" id="teacherPassword" type="password" required></div><p class="form-error" id="loginError"></p><button class="btn" type="submit">開始監看</button></form></dialog><dialog id="publishDialog"><div class="dialog-content"><h2>結算並發布</h2><p id="publishMessage"></p><div class="publish-actions"><button class="btn secondary" id="cancelPublish">取消</button><button class="btn" id="confirmPublish">確認發布</button></div></div></dialog><div class="toast" id="toast"></div><script src="/classroom-assets/teacher.js?v=2026fall-2"></script></body></html>
 
1
+ <!doctype html><html lang="zh-Hant"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Python 專案教室|教師控制台</title><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-3"></head><body>
2
  <header class="app-header"><div class="brand"><div class="brand-mark">Py</div><div class="brand-copy"><strong>全班專案控制台</strong><span id="classLabel">尚未進入班級</span></div></div><div class="header-actions"><div class="connection-state"><i id="connectionDot" class="status-dot"></i><span id="connectionText">未連線</span></div><button class="btn secondary compact" id="loginButton">切換班級</button></div></header>
3
  <section class="project-bar"><div class="project-context"><label for="teacherWeek">週次</label><select id="teacherWeek"></select><span id="submissionSummary" class="submission-summary">等待學生</span></div><div class="project-actions"><button class="copy-button" id="downloadButton">下載全班 ZIP</button><button class="btn compact" id="publishButton">結算並發布 Demo</button></div></section>
4
  <main class="teacher-layout"><section class="roster-panel"><div class="panel-heading"><h1>學生狀態</h1><span id="studentTotal">0 人</span></div><div class="filter-bar" id="teacherFilters"><button class="chip" data-filter="all" aria-pressed="true">全部</button><button class="chip" data-filter="submitted">已提交</button><button class="chip" data-filter="help">需要協助</button><button class="chip" data-filter="error">錯誤</button></div><div class="roster-header"><span>學生</span><span>狀態</span><span>檔案</span><span>提交</span></div><div class="roster-list" id="rosterList"></div></section>
5
+ <section class="teacher-detail" id="teacherDetail"><div class="detail-empty" id="detailEmpty">選擇一位學生查看多檔案專案。</div><div class="detail-view" id="detailView" hidden><header class="detail-header"><div><h1 id="selectedStudentName"></h1><p class="detail-meta" id="selectedStudentMeta"></p></div><div class="detail-actions"><button class="copy-button" id="ackHelpButton" hidden>標記已查看</button><button class="copy-button" id="copyCodeButton">複製檔案</button><button class="copy-button danger-action" id="deleteStudentButton">刪除學生</button></div></header><div class="teacher-project"><nav class="teacher-file-tabs" id="teacherFiles"></nav><div class="detail-split"><section class="read-only-pane"><div class="pane-label"><span id="teacherActiveFile">main.py</span><span id="lineCount">0 行</span></div><pre class="code-readonly" id="studentCode"></pre></section><section class="read-only-pane"><div class="pane-label"><span>Console</span><span id="outputState"></span></div><pre class="output-readonly" id="studentOutput"></pre></section></div></div></div></section></main>
6
+ <dialog id="loginDialog"><form class="dialog-content form-stack" id="loginForm"><div><h1>進入教師控制台</h1><p>選取現有課程,或建立新的課程代碼。</p></div><div><label class="field-label" for="classCode">課程</label><select class="text-field" id="classCode" required></select></div><div id="newClassFields" hidden><label class="field-label" for="newClassCode">新課程代碼</label><input class="text-field" id="newClassCode" placeholder="L6B"><label class="field-label secondary-label" for="newClassName">課程名稱</label><input class="text-field" id="newClassName" placeholder="進階專題 B 班"></div><div><label class="field-label" for="teacherPassword">教師密碼</label><input class="text-field" id="teacherPassword" type="password" required></div><p class="form-error" id="loginError"></p><button class="btn" type="submit">開始監看</button></form></dialog><dialog id="publishDialog"><div class="dialog-content"><h2>結算並發布</h2><p id="publishMessage"></p><div class="publish-actions"><button class="btn secondary" id="cancelPublish">取消</button><button class="btn" id="confirmPublish">確認發布</button></div></div></dialog><div class="toast" id="toast"></div><script src="/classroom-assets/teacher.js?v=2026fall-3"></script></body></html>
classroom_static/teacher.js CHANGED
@@ -1,12 +1,253 @@
1
- const $=id=>document.getElementById(id),E={};["classLabel","connectionDot","connectionText","loginButton","teacherWeek","submissionSummary","downloadButton","publishButton","studentTotal","teacherFilters","rosterList","detailEmpty","detailView","selectedStudentName","selectedStudentMeta","teacherFiles","teacherActiveFile","lineCount","studentCode","studentOutput","outputState","ackHelpButton","copyCodeButton","loginDialog","loginForm","classCode","teacherPassword","loginError","publishDialog","publishMessage","cancelPublish","confirmPublish","toast"].forEach(id=>E[id]=$(id));
2
- let socket,students=[],selected=null,file="main.py",filter="all",credentials,reconnect;
3
- const clean=v=>String(v||"").trim().replace(/[^0-9A-Za-z_\-一-鿿]/g,"").slice(0,48),esc=v=>String(v).replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;");
4
- function toast(t){E.toast.textContent=t;E.toast.classList.add("visible");setTimeout(()=>E.toast.classList.remove("visible"),2000)}
5
- function status(s){if(!s.connected)return["error","離線"];if(s.needs_help)return["help","求助"];if(s.status==="running")return["running","執行中"];if(s.status==="error")return["error","錯誤"];return["online","在線"]}
6
- function show(){const submitted=students.filter(s=>s.submitted_at).length;E.studentTotal.textContent=`${students.length} 人`;E.submissionSummary.textContent=`${submitted}/${students.length} 已提交`;const list=students.filter(s=>filter==="all"||(filter==="submitted"?s.submitted_at:filter==="help"?s.needs_help:s.status===filter));E.rosterList.innerHTML=list.length?list.map(s=>{const [dot,label]=status(s);return`<button class="student-row ${s.student_id===selected?"selected":""}" data-id="${s.student_id}"><span class="student-name">${esc(s.display_name)}</span><span class="status-label"><i class="status-dot ${dot}"></i>${label}</span><span class="time-label">${Object.keys(s.files||{}).length} 檔</span><span class="help-label">${s.submitted_at?"已交":"—"}</span></button>`}).join(""):'<div class="empty-roster">等待學生進入這個週次。</div>';E.rosterList.querySelectorAll("[data-id]").forEach(b=>b.onclick=()=>{selected=b.dataset.id;file="main.py";show()});detail()}
7
- function detail(){const s=students.find(x=>x.student_id===selected);if(!s){E.detailEmpty.hidden=false;E.detailView.hidden=true;return}E.detailEmpty.hidden=true;E.detailView.hidden=false;const [,label]=status(s),paths=Object.keys(s.files||{}).sort((a,b)=>a==="main.py"?-1:b==="main.py"?1:a.localeCompare(b));if(!(file in s.files))file=paths[0];E.selectedStudentName.textContent=`${s.display_name} · ${s.project_name}`;E.selectedStudentMeta.textContent=`${label} · ${s.submitted_at?"已提交本週版本":"本週尚未提交"}`;E.ackHelpButton.hidden=!s.needs_help;E.teacherFiles.innerHTML=paths.map(p=>`<button class="teacher-file-tab ${p===file?"active":""}" data-file="${esc(p)}">${esc(p)}</button>`).join("");E.teacherFiles.querySelectorAll("[data-file]").forEach(b=>b.onclick=()=>{file=b.dataset.file;detail()});const code=s.files[file]||"";E.teacherActiveFile.textContent=file;E.lineCount.textContent=`${Math.max(1,code.split("\n").length)} 行`;E.studentCode.textContent=code||"# 空檔案";E.studentOutput.textContent=s.output||"尚無執行結果。";E.outputState.textContent=label}
8
- function connect(){clearTimeout(reconnect);const previous=socket;if(previous){previous.onclose=null;previous.close()}if(!credentials)return;const q=new URLSearchParams({class_code:credentials.classCode,week_id:E.teacherWeek.value}),scheme=location.protocol==="https:"?"wss":"ws";E.classLabel.textContent=`${credentials.classCode} · ${E.teacherWeek.value}`;E.connectionText.textContent="連線中";const current=new WebSocket(`${scheme}://${location.host}/ws/classroom/teacher?${q}`);socket=current;current.onopen=()=>current.send(JSON.stringify({type:"auth",password:credentials.password}));current.onmessage=e=>{const m=JSON.parse(e.data);if(m.type==="snapshot"){E.connectionDot.className="status-dot online";E.connectionText.textContent="即時監看";students=m.students;if(selected&&!students.some(s=>s.student_id===selected))selected=null;show()}};current.onclose=e=>{if(socket!==current)return;E.connectionDot.className="status-dot error";E.connectionText.textContent="連線中斷";if(e.code===4403){credentials=null;E.loginError.textContent="教師密碼不正確";E.loginDialog.showModal()}else if(credentials)reconnect=setTimeout(connect,2500)}}
9
- async function post(path){const r=await fetch(path,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({class_code:credentials.classCode,week_id:E.teacherWeek.value,password:credentials.password})});if(!r.ok){let d="操作失敗";try{d=(await r.json()).detail||d}catch{}throw Error(d)}return r}
10
- E.loginForm.onsubmit=e=>{e.preventDefault();credentials={classCode:clean(E.classCode.value),password:E.teacherPassword.value};sessionStorage.setItem("teacher_class",credentials.classCode);E.loginDialog.close();connect()};E.loginButton.onclick=()=>E.loginDialog.showModal();E.teacherWeek.onchange=()=>{selected=null;connect()};E.teacherFilters.querySelectorAll("[data-filter]").forEach(b=>b.onclick=()=>{filter=b.dataset.filter;E.teacherFilters.querySelectorAll("button").forEach(x=>x.setAttribute("aria-pressed",String(x===b)));show()});E.ackHelpButton.onclick=()=>{if(selected)socket.send(JSON.stringify({type:"ack_help",student_id:selected}))};E.copyCodeButton.onclick=async()=>{const s=students.find(x=>x.student_id===selected);if(s){await navigator.clipboard.writeText(s.files[file]||"");toast("已複製檔案")}};
11
- E.downloadButton.onclick=async()=>{try{const r=await post("/api/classroom/export"),blob=await r.blob(),a=document.createElement("a");a.href=URL.createObjectURL(blob);a.download=`${credentials.classCode}_${E.teacherWeek.value}_final.zip`;a.click();URL.revokeObjectURL(a.href);toast("已產生全班 ZIP")}catch(e){toast(e.message)}};E.publishButton.onclick=()=>{const n=students.filter(s=>s.submitted_at).length;E.publishMessage.textContent=`將 ${n} 份 ${E.teacherWeek.value} 最後版本發布到 Project_Demo。Space 會重新建置。`;E.publishDialog.showModal()};E.cancelPublish.onclick=()=>E.publishDialog.close();E.confirmPublish.onclick=async()=>{E.confirmPublish.disabled=true;E.confirmPublish.textContent="發布中…";try{const d=await(await post("/api/classroom/publish")).json();E.publishDialog.close();toast(`已發布 ${d.count} 份作品`)}catch(e){E.publishMessage.textContent=e.message}finally{E.confirmPublish.disabled=false;E.confirmPublish.textContent="確認發布"}};setInterval(()=>{if(socket?.readyState===WebSocket.OPEN)socket.send(JSON.stringify({type:"ping"}))},5000);
12
- (async()=>{const course=await(await fetch("/api/classroom/course")).json();E.teacherWeek.innerHTML=course.weeks.map(w=>`<option value="${w.id}">第 ${w.week} 週|${esc(w.title)}</option>`).join("");E.teacherWeek.value="week02";E.classCode.value=sessionStorage.getItem("teacher_class")||"L6A";E.loginDialog.showModal()})();
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ const $ = id => document.getElementById(id);
2
+ const E = {};
3
+ [
4
+ "classLabel", "connectionDot", "connectionText", "loginButton", "teacherWeek",
5
+ "submissionSummary", "downloadButton", "publishButton", "studentTotal",
6
+ "teacherFilters", "rosterList", "detailEmpty", "detailView", "selectedStudentName",
7
+ "selectedStudentMeta", "teacherFiles", "teacherActiveFile", "lineCount", "studentCode",
8
+ "studentOutput", "outputState", "ackHelpButton", "copyCodeButton", "deleteStudentButton",
9
+ "loginDialog", "loginForm", "classCode", "newClassFields", "newClassCode", "newClassName",
10
+ "teacherPassword", "loginError", "publishDialog", "publishMessage", "cancelPublish",
11
+ "confirmPublish", "toast"
12
+ ].forEach(id => E[id] = $(id));
13
+
14
+ let socket;
15
+ let students = [];
16
+ let selected = null;
17
+ let file = "main.py";
18
+ let filter = "all";
19
+ let credentials;
20
+ let reconnect;
21
+ let catalog = { courses: [] };
22
+
23
+ const clean = value => String(value || "").trim().replace(/[^0-9A-Za-z_\-一-鿿]/g, "").slice(0, 48);
24
+ const esc = value => String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
25
+
26
+ function toast(text) {
27
+ E.toast.textContent = text;
28
+ E.toast.classList.add("visible");
29
+ setTimeout(() => E.toast.classList.remove("visible"), 2000);
30
+ }
31
+
32
+ function status(student) {
33
+ if (!student.connected) return ["error", "離線"];
34
+ if (student.needs_help) return ["help", "求助"];
35
+ if (student.status === "running") return ["running", "執行中"];
36
+ if (student.status === "error") return ["error", "錯誤"];
37
+ return ["online", "在線"];
38
+ }
39
+
40
+ function show() {
41
+ const submitted = students.filter(student => student.submitted_at).length;
42
+ E.studentTotal.textContent = `${students.length} 人`;
43
+ E.submissionSummary.textContent = `${submitted}/${students.length} 已提交`;
44
+ const list = students.filter(student => filter === "all" || (
45
+ filter === "submitted" ? student.submitted_at :
46
+ filter === "help" ? student.needs_help : student.status === filter
47
+ ));
48
+ E.rosterList.innerHTML = list.length ? list.map(student => {
49
+ const [dot, label] = status(student);
50
+ return `<button class="student-row ${student.student_id === selected ? "selected" : ""}" data-id="${student.student_id}"><span class="student-name">${esc(student.display_name)}</span><span class="status-label"><i class="status-dot ${dot}"></i>${label}</span><span class="time-label">${Object.keys(student.files || {}).length} 檔</span><span class="help-label">${student.submitted_at ? "已交" : "—"}</span></button>`;
51
+ }).join("") : '<div class="empty-roster">這個課程尚無學生。</div>';
52
+ E.rosterList.querySelectorAll("[data-id]").forEach(button => button.onclick = () => {
53
+ selected = button.dataset.id;
54
+ file = "main.py";
55
+ show();
56
+ });
57
+ detail();
58
+ }
59
+
60
+ function detail() {
61
+ const student = students.find(item => item.student_id === selected);
62
+ if (!student) {
63
+ E.detailEmpty.hidden = false;
64
+ E.detailView.hidden = true;
65
+ return;
66
+ }
67
+ E.detailEmpty.hidden = true;
68
+ E.detailView.hidden = false;
69
+ const [, label] = status(student);
70
+ const paths = Object.keys(student.files || {}).sort((a, b) => a === "main.py" ? -1 : b === "main.py" ? 1 : a.localeCompare(b));
71
+ if (!(file in student.files)) file = paths[0];
72
+ E.selectedStudentName.textContent = `${student.display_name} · ${student.project_name}`;
73
+ E.selectedStudentMeta.textContent = `${label} · ${student.submitted_at ? "已提交本週版本" : "本週尚未提交"}`;
74
+ E.ackHelpButton.hidden = !student.needs_help;
75
+ E.teacherFiles.innerHTML = paths.map(path => `<button class="teacher-file-tab ${path === file ? "active" : ""}" data-file="${esc(path)}">${esc(path)}</button>`).join("");
76
+ E.teacherFiles.querySelectorAll("[data-file]").forEach(button => button.onclick = () => {
77
+ file = button.dataset.file;
78
+ detail();
79
+ });
80
+ const code = student.files[file] || "";
81
+ E.teacherActiveFile.textContent = file;
82
+ E.lineCount.textContent = `${Math.max(1, code.split("\n").length)} 行`;
83
+ E.studentCode.textContent = code || "# 空檔案";
84
+ E.studentOutput.textContent = student.output || "尚無執行結果。";
85
+ E.outputState.textContent = label;
86
+ }
87
+
88
+ function connect() {
89
+ clearTimeout(reconnect);
90
+ const previous = socket;
91
+ if (previous) {
92
+ previous.onclose = null;
93
+ previous.close();
94
+ }
95
+ if (!credentials) return;
96
+ const query = new URLSearchParams({ class_code: credentials.classCode, week_id: E.teacherWeek.value });
97
+ const scheme = location.protocol === "https:" ? "wss" : "ws";
98
+ E.classLabel.textContent = `${credentials.classCode} · ${E.teacherWeek.value}`;
99
+ E.connectionText.textContent = "連線中";
100
+ const current = new WebSocket(`${scheme}://${location.host}/ws/classroom/teacher?${query}`);
101
+ socket = current;
102
+ current.onopen = () => current.send(JSON.stringify({ type: "auth", password: credentials.password }));
103
+ current.onmessage = event => {
104
+ const message = JSON.parse(event.data);
105
+ if (message.type !== "snapshot") return;
106
+ E.connectionDot.className = "status-dot online";
107
+ E.connectionText.textContent = "即時監看";
108
+ students = message.students;
109
+ if (selected && !students.some(student => student.student_id === selected)) selected = null;
110
+ show();
111
+ };
112
+ current.onclose = event => {
113
+ if (socket !== current) return;
114
+ E.connectionDot.className = "status-dot error";
115
+ E.connectionText.textContent = "連線中斷";
116
+ if (event.code === 4403) {
117
+ credentials = null;
118
+ E.loginError.textContent = "教師密碼不正確";
119
+ E.loginDialog.showModal();
120
+ } else if (credentials) {
121
+ reconnect = setTimeout(connect, 2500);
122
+ }
123
+ };
124
+ }
125
+
126
+ async function request(path, method = "POST", extra = {}) {
127
+ const base = credentials ? {
128
+ class_code: credentials.classCode,
129
+ week_id: E.teacherWeek.value,
130
+ password: credentials.password
131
+ } : {};
132
+ const response = await fetch(path, {
133
+ method,
134
+ headers: { "Content-Type": "application/json" },
135
+ body: JSON.stringify({ ...base, ...extra })
136
+ });
137
+ if (!response.ok) {
138
+ let message = "操作失敗";
139
+ try { message = (await response.json()).detail || message; } catch (_) {}
140
+ throw Error(message);
141
+ }
142
+ return response;
143
+ }
144
+
145
+ async function loadCatalog() {
146
+ catalog = await (await fetch("/api/classroom/classes")).json();
147
+ const saved = sessionStorage.getItem("teacher_class");
148
+ E.classCode.innerHTML = catalog.courses.map(item => `<option value="${esc(item.class_code)}">${esc(item.course_name)}|${esc(item.class_code)}</option>`).join("") + '<option value="__new__">+ 建立新課程代碼</option>';
149
+ E.classCode.value = catalog.courses.some(item => item.class_code === saved) ? saved : (catalog.courses[0]?.class_code || "__new__");
150
+ toggleNewClass();
151
+ }
152
+
153
+ function toggleNewClass() {
154
+ const adding = E.classCode.value === "__new__";
155
+ E.newClassFields.hidden = !adding;
156
+ E.newClassCode.required = adding;
157
+ }
158
+
159
+ E.classCode.onchange = toggleNewClass;
160
+ E.loginForm.onsubmit = async event => {
161
+ event.preventDefault();
162
+ const button = E.loginForm.querySelector("button[type=submit]");
163
+ const password = E.teacherPassword.value;
164
+ button.disabled = true;
165
+ E.loginError.textContent = "";
166
+ try {
167
+ let classCode = clean(E.classCode.value);
168
+ if (E.classCode.value === "__new__") {
169
+ classCode = clean(E.newClassCode.value);
170
+ if (!classCode) throw Error("請輸入新課程代碼");
171
+ button.textContent = "建立課程中…";
172
+ credentials = { classCode, password };
173
+ await request("/api/classroom/classes", "POST", {
174
+ class_code: classCode,
175
+ course_name: E.newClassName.value.trim() || classCode
176
+ });
177
+ }
178
+ credentials = { classCode, password };
179
+ sessionStorage.setItem("teacher_class", classCode);
180
+ E.loginDialog.close();
181
+ connect();
182
+ } catch (error) {
183
+ credentials = null;
184
+ E.loginError.textContent = error.message;
185
+ } finally {
186
+ button.disabled = false;
187
+ button.textContent = "開始監看";
188
+ }
189
+ };
190
+
191
+ E.loginButton.onclick = async () => { await loadCatalog(); E.loginDialog.showModal(); };
192
+ E.teacherWeek.onchange = () => { selected = null; connect(); };
193
+ E.teacherFilters.querySelectorAll("[data-filter]").forEach(button => button.onclick = () => {
194
+ filter = button.dataset.filter;
195
+ E.teacherFilters.querySelectorAll("button").forEach(item => item.setAttribute("aria-pressed", String(item === button)));
196
+ show();
197
+ });
198
+ E.ackHelpButton.onclick = () => { if (selected) socket.send(JSON.stringify({ type: "ack_help", student_id: selected })); };
199
+ E.copyCodeButton.onclick = async () => {
200
+ const student = students.find(item => item.student_id === selected);
201
+ if (student) { await navigator.clipboard.writeText(student.files[file] || ""); toast("已複製檔案"); }
202
+ };
203
+ E.deleteStudentButton.onclick = async () => {
204
+ const student = students.find(item => item.student_id === selected);
205
+ if (!student || !confirm(`從 ${credentials.classCode} 刪除學生「${student.display_name}」與其教室進度?\n\n已發布到 Demo 的作品不會被刪除。`)) return;
206
+ try {
207
+ await request("/api/classroom/students", "DELETE", { student_id: student.student_id });
208
+ students = students.filter(item => item.student_id !== student.student_id);
209
+ selected = null;
210
+ show();
211
+ toast("已從課程名單刪除學生");
212
+ } catch (error) { toast(error.message); }
213
+ };
214
+ E.downloadButton.onclick = async () => {
215
+ try {
216
+ const response = await request("/api/classroom/export");
217
+ const blob = await response.blob();
218
+ const anchor = document.createElement("a");
219
+ anchor.href = URL.createObjectURL(blob);
220
+ anchor.download = `${credentials.classCode}_${E.teacherWeek.value}_final.zip`;
221
+ anchor.click();
222
+ URL.revokeObjectURL(anchor.href);
223
+ toast("已產生全班 ZIP");
224
+ } catch (error) { toast(error.message); }
225
+ };
226
+ E.publishButton.onclick = () => {
227
+ const count = students.filter(student => student.submitted_at).length;
228
+ E.publishMessage.textContent = `將 ${count} 份 ${E.teacherWeek.value} 最後版本發布到 Project_Demo。Space 會重新建置。`;
229
+ E.publishDialog.showModal();
230
+ };
231
+ E.cancelPublish.onclick = () => E.publishDialog.close();
232
+ E.confirmPublish.onclick = async () => {
233
+ E.confirmPublish.disabled = true;
234
+ E.confirmPublish.textContent = "發布中…";
235
+ try {
236
+ const data = await (await request("/api/classroom/publish")).json();
237
+ E.publishDialog.close();
238
+ toast(`已發布 ${data.count} 份作品`);
239
+ } catch (error) { E.publishMessage.textContent = error.message; }
240
+ finally { E.confirmPublish.disabled = false; E.confirmPublish.textContent = "確認發布"; }
241
+ };
242
+
243
+ setInterval(() => {
244
+ if (socket?.readyState === WebSocket.OPEN) socket.send(JSON.stringify({ type: "ping" }));
245
+ }, 5000);
246
+
247
+ (async () => {
248
+ const course = await (await fetch("/api/classroom/course")).json();
249
+ E.teacherWeek.innerHTML = course.weeks.map(item => `<option value="${item.id}">第 ${item.week} 週|${esc(item.title)}</option>`).join("");
250
+ E.teacherWeek.value = "week02";
251
+ await loadCatalog();
252
+ E.loginDialog.showModal();
253
+ })();
tests/test_classroom.py CHANGED
@@ -1,3 +1,4 @@
 
1
  import io
2
  import json
3
  import tempfile
@@ -63,6 +64,39 @@ class ClassroomServiceTests(unittest.TestCase):
63
  self.assertEqual(len(course["weeks"]), 18)
64
  self.assertEqual(set(classroom.template_files("week02")), {"main.py", "case_data.json"})
65
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
66
  def test_published_final_can_be_loaded_after_runtime_restart(self):
67
  old_published = classroom.PUBLISHED
68
  try:
 
1
+ import asyncio
2
  import io
3
  import json
4
  import tempfile
 
64
  self.assertEqual(len(course["weeks"]), 18)
65
  self.assertEqual(set(classroom.template_files("week02")), {"main.py", "case_data.json"})
66
 
67
+ def test_catalog_lists_courses_and_existing_students(self):
68
+ state = classroom.empty("L6A", "student-1", "Alex", "week02")
69
+ classroom.save(state)
70
+ catalog = classroom.catalog()
71
+ course = next(item for item in catalog["courses"] if item["class_code"] == "L6A")
72
+ self.assertEqual(course["course_name"], "2026 Fall 進階專題")
73
+ self.assertEqual(course["students"], [{"student_id": "student-1", "display_name": "Alex"}])
74
+
75
+ def test_snapshot_includes_member_without_current_week_project(self):
76
+ state = classroom.empty("L6A", "student-1", "Alex", "week01")
77
+ classroom.save(state)
78
+ students = classroom.snapshot("L6A", "week02")
79
+ self.assertEqual(len(students), 1)
80
+ self.assertEqual(students[0]["display_name"], "Alex")
81
+ self.assertFalse(students[0]["connected"])
82
+
83
+ def test_teacher_can_delete_student_and_all_classroom_progress(self):
84
+ old_password = classroom.PASSWORD
85
+ try:
86
+ classroom.PASSWORD = "teacher-test"
87
+ for week in ("week01", "week02"):
88
+ classroom.save(classroom.empty("L6A", "student-1", "Alex", week))
89
+ request = classroom.StudentDelete(
90
+ class_code="L6A", student_id="student-1", password="teacher-test"
91
+ )
92
+ self.assertEqual(asyncio.run(classroom.delete_student(request)), {"ok": True})
93
+ finally:
94
+ classroom.PASSWORD = old_password
95
+ course = next(item for item in classroom.catalog()["courses"] if item["class_code"] == "L6A")
96
+ self.assertEqual(course["students"], [])
97
+ self.assertEqual(classroom.snapshot("L6A", "week01"), [])
98
+ self.assertEqual(classroom.snapshot("L6A", "week02"), [])
99
+
100
  def test_published_final_can_be_loaded_after_runtime_restart(self):
101
  old_published = classroom.PUBLISHED
102
  try: