feat: add deployment metadata display for teacher panel with versioning and commit info

.env.example

@@ -27,3 +27,10 @@ SUPABASE_SECRET_KEY=
 # right and the system scored wrong. A flag is kept in the Supabase table `flags` with its recording (see the README),
 # so it needs SUPABASE_SECRET_KEY. These accounts may sign in without being in a class.
 TUTORS_EMAIL=
+
+# Optional deployment metadata shown to teachers at the bottom of the management panel.
+# Without these, the app uses a content hash, the newest source-file time, and the local git commit when available.
+APP_VERSION=
+BUILD_DATE=
+GIT_COMMIT=
+GIT_COMMIT_MESSAGE=

app/main.py

@@ -14,6 +14,7 @@ import hashlib
 import logging
 import os
 import re
+import subprocess
 import time
 import urllib.parse
 import uuid
@@ -248,6 +249,38 @@ def build_version() -> str:
     return f"{h.hexdigest()[:7]} · {time.strftime('%Y-%m-%d %H:%M', time.gmtime(newest))} UTC"
 
 
+def build_metadata() -> dict[str, str]:
+    """Deployment details for the teacher panel, with useful local-development fallbacks."""
+    files = sorted(Path(__file__).resolve().parent.glob("*.py")) + [STATIC / "index.html"]
+    h = hashlib.sha1()
+    for f in files:
+        h.update(f.read_bytes())
+    newest = max(f.stat().st_mtime for f in files)
+    commit = next((os.environ.get(name, "").strip() for name in
+                   ("GIT_COMMIT", "COMMIT_SHA", "SOURCE_VERSION", "SPACE_REVISION")
+                   if os.environ.get(name, "").strip()), "")
+    message = os.environ.get("GIT_COMMIT_MESSAGE", "").strip()
+    if not commit or not message:
+        try:
+            git = subprocess.run(
+                ["git", "log", "-1", "--format=%H%n%s"], cwd=STATIC.parent, check=True,
+                capture_output=True, text=True, timeout=2,
+            ).stdout.splitlines()
+            if not commit and git:
+                commit = git[0].strip()
+            if not message and len(git) > 1:
+                message = git[1].strip()
+        except (OSError, subprocess.SubprocessError):
+            pass
+    return {
+        "version": os.environ.get("APP_VERSION", "").strip() or h.hexdigest()[:7],
+        "updated_at": os.environ.get("BUILD_DATE", "").strip()
+        or datetime.fromtimestamp(newest, timezone.utc).isoformat(timespec="seconds"),
+        "commit": commit or "unknown",
+        "commit_message": message,
+    }
+
+
 def utc(stamp: str) -> datetime:
     """A Supabase timestamp. The seconds part only: the fraction's length varies, which Python 3.10 does not parse."""
     return datetime.strptime(stamp[:19], "%Y-%m-%dT%H:%M:%S").replace(tzinfo=timezone.utc)
@@ -1114,7 +1147,7 @@ def create_app(scorer: Scorer | None = None, tts: SawtakTTS | None = None,
     @app.get("/api/health")
     def health():
         s: Scorer = app.state.scorer
-        return {"version": build_version(), "model": MODEL_ID, "tts": app.state.tts is not None,
+        return {"version": build_version(), "build": build_metadata(), "model": MODEL_ID, "tts": app.state.tts is not None,
                 "references": app.state.refs is not None, "sign_in": app.state.auth is not None,
                 "phoneme_fallbacks": s.vocab.downgraded}
 

static/index.html

@@ -308,6 +308,16 @@ body:not(.manage) #manage,body.manage #wrap>header,body.manage #path,body.manage
 .mtitle{font:400 24px/1 var(--f-display);margin:0}
 #mState.setup{padding:10px 12px;border:1px solid var(--sumac);border-radius:10px;color:var(--ink)}
 #mState.setup code{display:block;margin-top:6px;font-size:12px;overflow-wrap:anywhere;user-select:all}
+.build-info{padding:14px 16px;margin-top:4px;font-variant-numeric:tabular-nums}
+.build-info h2{margin:0;font:400 20px/1.2 var(--f-display)}
+.build-info>p{margin:3px 0 12px;color:var(--muted);font-size:13px}
+.build-info dl{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin:0}
+.build-info dl>div{min-width:0;padding:9px 10px;border-radius:9px;background:var(--bg)}
+.build-info dt{margin-bottom:3px;color:var(--muted);font-size:12px;font-weight:600}
+.build-info dd{margin:0;color:var(--ink);font-size:14px;overflow-wrap:anywhere}
+.build-info code{direction:ltr;unicode-bidi:isolate;user-select:all}
+#manage:not(.flags) #mBuild{display:none}
+@media(max-width:560px){.build-info dl{grid-template-columns:1fr}}
 .hard>.note{margin:0;padding:4px 16px 8px;color:var(--muted);font-size:14px}
 /* inside a student, each part (the best sentences, the weakest, every lesson) opens and closes on its heading */
 .sec>summary{cursor:pointer;list-style:none;display:grid;grid-template-columns:1fr auto 3em;gap:4px 10px;align-items:center;padding:8px 16px;border-top:1px solid var(--line);font:700 15px/1.4 var(--f-body)}
@@ -839,6 +849,7 @@ body.quiet :is(#mic,#playMine,#driveBtn,.phone-btn),body.driving :is(#quietBtn,#
     <div class="card hard" id="mLessons" hidden></div>
     <div class="card hard roster" id="mRoster" hidden></div>
     <div id="mStudent"></div>
+    <section class="build-info card" id="mBuild" aria-labelledby="mBuildTitle" hidden></section>
   </section>
 </div>
 <dialog id="listDlg" aria-labelledby="listTitle">
@@ -2634,7 +2645,8 @@ async function loadManage(){
   const state=$("mState");
   state.textContent="טוען…"; state.classList.remove("setup");
   try{
-    const res=await api("/api/class"); await ready;
+    const [res,healthRes]=await Promise.all([api("/api/class"),fetch("/api/health").catch(()=>null)]); await ready;
+    if(healthRes?.ok) drawBuild((await healthRes.json()).build);
     if(!res.ok){
       const detail=(await res.json().catch(()=>({}))).detail||res.status;
       state.textContent=res.status===403?"הפאנל פתוח למורים בלבד.":`נתוני התלמידים לא זמינים כרגע (${detail}).`; return;
@@ -2648,6 +2660,18 @@ async function loadManage(){
     const code=mark("",x.sql,"code"); code.dir="ltr"; state.append(mark("",x.what,"b"),mark(""," הריצו ב-SQL Editor של Supabase:"),code); }
   drawManage();
 }
+function drawBuild(info){
+  const box=$("mBuild");
+  if(!info) return;
+  const updated=new Date(info.updated_at), date=Number.isNaN(updated.valueOf())?info.updated_at:
+    new Intl.DateTimeFormat("he-IL",{dateStyle:"short",timeStyle:"short"}).format(updated);
+  const list=document.createElement("dl");
+  const item=(label,value,code=false)=>{ const row=document.createElement("div"), dt=document.createElement("dt"), dd=document.createElement("dd"), val=document.createElement(code?"code":"span"); dt.textContent=label; val.textContent=value||"לא זמין"; dd.append(val); row.append(dt,dd); return row; };
+  list.append(item("מספר גרסה",info.version),item("עדכון אחרון",date),item("Commit ID",info.commit,true),item("הודעת commit",info.commit_message));
+  const title=mark("","פרטי המערכת","h2"); title.id="mBuildTitle";
+  box.replaceChildren(title,mark("","מידע טכני לזיהוי הגרסה שפועלת כעת.","p"),list);
+  box.hidden=false;
+}
 function drawManage(){
   const classes=CLASS.classes||[];
   if(shownClass!=="*"&&!classes.some(c=>c.name===shownClass)) shownClass="*";