Spaces:
Running
Running
Commit ·
6737361
1
Parent(s): 21c192a
Add course and roster management
Browse files- README.md +7 -0
- classroom_data/classes.json +3 -0
- classroom_service.py +52 -2
- classroom_static/classroom.css +32 -25
- classroom_static/student.html +3 -3
- classroom_static/student.js +8 -5
- classroom_static/teacher.html +3 -3
- classroom_static/teacher.js +253 -12
- tests/test_classroom.py +34 -0
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:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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 {
|
| 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:
|
|
|
|
|
|
|
| 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:
|
| 149 |
-
.editor-panel { grid-area: editor;
|
| 150 |
-
.console-panel { grid-area: console; border-left:
|
| 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 |
-
|
|
|
|
|
|
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 270 |
-
.roster-panel { border-right:
|
| 271 |
-
.teacher-detail { min-width:
|
| 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:
|
| 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 {
|
| 292 |
-
.detail-view { height:
|
| 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:
|
| 316 |
-
.mobile-tabs { display:
|
| 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:
|
| 320 |
-
.student-layout .panel.mobile-active { display:
|
| 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:
|
| 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-
|
| 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>
|
| 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-
|
|
|
|
| 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 |
-
|
| 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=
|
| 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 |
-
|
|
|
|
|
|
|
|
|
|
| 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";
|
|
|
|
| 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-
|
| 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>選
|
|
|
|
| 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)
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
(
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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("&", "&").replaceAll("<", "<").replaceAll(">", ">");
|
| 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:
|