TM Knowledge Hub — VirtualMeetings

Hub local Toastmasters pentru proiectul VirtualMeetings + uz personal Pavel ca rol activ la TM Sibiu. Versiune: Iteration 1 (P0 pentru ședința 2026-05-20). Iteration 2 + 3 planificate post-test. Sursă autoritativă pentru viziune produs: docs/PLATFORM_TM_FEASIBILITY.md.

Cuprins

1. Tabel rapid — cele 22 roluri TM
2. Agenda standard ședință TM
3. Quick reference filler-e RO + EN
4. Threshold-uri și praguri
5. Status implementare per rol în VirtualMeetings
6. Surse oficiale verificate
7. Glosar termeni TM
8. Evoluție platformă — Zoom Apps SDK

1. Tabel rapid — cele 22 roluri TM

Ordine cronologică ședință (din state.py:MEETING_ROLE_ORDER). Status cod: ✅ implementat / 🟡 parțial / ❌ neimplementat.

Notă Gramatician: nu apare separat în MEETING_ROLE_ORDER standard de 22 — e parte din echipa de evaluare, alăturea cu Numărător› & Cronometror. În cod este integrat ca rol principal (vezi state.py ROLE_ALIASES și meeting_roles).

Total status: - ✅ 2 roluri complet implementate (Gramatician, Numărător) - 🟡 1 rol parțial (Toastmaster — agenda UI) - ❌ 19 roluri neimplementate (în roadmap Faza 2)

2. Agenda standard TM

Ședința Toastmasters Sibiu durează 60-90 min, hibrid (fizic + Zoom).

Total estimat: ~80-100 min depending on # vorbitori și TT.

3. Quick reference filler-e

Vezi linguistics_ro/filler_words_ro.md pentru detalii.

Top RO (cele mai comune)

Top EN (referință internațional)

• um, uh, er, ah — vocal pauses
• and, but, so, you know, well, like — discourse markers
• basically, literally, actually — overused intensifiers

NU se contabilizează (oficial cluj.toastmasters.ro)

• Pauze tăcute între propoziții — legitime, recomandate
• Variații regionale acceptate
• Alegere stilistică intenționată (repetiție retorică)

4. Threshold-uri și praguri

Praguri standard TM International + Sibiu specific.

Durata intervenții (Cronometror)

Filler density (Numărător, recomandare practică)

NU există threshold oficial TM (sursa: Ah-Counter official page). Pragurile de mai jos sunt convenții VirtualMeetings + practică TM Sibiu.

Scoring rubric (vezi evaluation_framework/ — Iteration 2)

• Speech: 1-5 pe dimensiuni (content, structure, language, voice, body, audience engagement)
• Pathway level progression: Level› 1-5 cu competențe specifice

5. Status implementare per rol în VirtualMeetings

Roadmap Faza 2.C (post-2026-05-20): Cronometror (prim modul nou) → Maestrul Jobenului → Numărător hands raised (CV) → Evaluator General.

Roadmap Faza 2.D (2026-05-22+): Zoom Apps SDK POC — înlocuiește OCR speaker detection cu onActiveSpeakerChange event nativ, sidebar UI în Zoom client. Plan complet: docs/zoom-apps-sdk-integration.md.

6. Surse oficiale

Vezi OFFICIAL_SOURCES.md pentru lista completă cu data verificării și freshness checklist.

Oficial Toastmasters International

• toastmasters.org/membership/club-meeting-roles — hub roluri
• toastmasters.org/magazine — articole best-practice
• toastmasters.org/resources — scripts + logs oficiale

Cluburi District 95 (Eastern Europe — Pavel context)

• cluj.toastmasters.ro — PDF-uri roluri RO
• siriustoastmasters.org — articole evaluare
• TM Sibiu — material intern (vezi rădăcina docs/toastmasters/)

Local arhivat

• raw_html/ — 9 pagini HTML scraped 2026-05-16
• raw_html/cluj-numarator.pdf — PDF original Cluj
• roles/*.md — fișe extrase și îmbogățite

7. Glosar termeni TM

8. Cum se folosește acest hub

Pavel în timpul ședinței: - Răspuns rapid „ce face X?”: tabel din §1 → click pe fișa rolului (dacă completă) - Întrebare la filler-e: §3 quick reference - Întrebare la timing: §4

Iteration viitoare (Pavel / contribuitori): - Completează fișele rămase folosind _template_role.md - Adaugă material în meeting/, administrative/, pathways/, evaluation_framework/, contests/ - Actualizează acest hub când implementezi noi role modules în cod (Faza 2.B/2.C)

Lansare externă (Iteration 3): - Acest hub devine resursă publishable pentru alte cluburi RO sau pentru produsul Faza 3 - Verifică OFFICIAL_SOURCES.md freshness înainte de lansare

8. Evoluție platformă — Zoom Apps SDK

Plan complet detaliat: docs/zoom-apps-sdk-integration.md. Status: plan complet, cod zero. Implementare POST 2026-05-20.

Ce câștigăm față de starea curentă

Ce nu schimbăm

• Audio rămâne pe Mac (audio mic + speakers, validat empiric: 0 halucinații vs 40% pentru Zoom tap)
• Whisper rămâne local (mlx-whisper large-v3 pe ANE)
• Claude rămâne local (CLI Pro/Max OAuth)
• Backend ai-service la 127.0.0.1:8000 neschimbat — Zoom App e un client nou al /ws/live existent

API-uri Zoom folosite

// Speaker detection — înlocuiește TextRecognizer OCR
zoomSdk.addEventListener('onActiveSpeakerChange', (event) => {
  fetch('http://127.0.0.1:8000/set_speaker', {
    method: 'POST',
    body: JSON.stringify({ speaker: event.participants[0].screenName })
  });
});

// Lista participanți — înlocuiește comenzile "rol v1 Maria"
const { participants } = await zoomSdk.getMeetingParticipants();
// → dropdown în sidebar cu asignare role la click

RTMS — pentru ce e util (neprofesionist)

Ce e: Zoom poate „deschide un robinet” din care curge audio-ul live al meeting-ului spre serverul tău.

3 scenarii concrete: 1. Gramatician pe iPad (fără Process Tap Mac-only): audio curge prin cloud Zoom → server nostru → Whisper 2. Multi-stream per vorbitor: Zoom poate livra un stream separat per participant activ → Whisper pe Cornel separat de Diana → calitate mai bună la overlap 3. Livrare garantată: dacă Process Tap pierde conexiunea 5s, RTMS notifică explicit (nu mai stai cu chunks: 0 și nu știi de ce)

Decizie: RTMS = fallback multi-platform, NU default. audio mic + Process Tap rămân primary (audio nu pleacă în cloud).

Recordings API — ședințe istorice TM Sibiu

Zoom păstrează înregistrările cloud. Putem descărca retroactiv toate ședințele TM Sibiu cu 3 endpoint-uri REST:

GET /v2/users/{userId}/recordings?from=2026-01-01&to=2026-05-31
→ lista meeting-urilor înregistrate cu UUID, durată, linkuri

GET /v2/meetings/{meetingId}/recordings
→ fișiere per meeting: MP4 video, M4A audio-only, VTT transcript Zoom

4 use case-uri imediate: 1. Re-procesare cu Whisper local → fișe gramatician retroactive pentru tot istoricul TM Sibiu 2. Indexare FTS5 SQLite → „când a vorbit cineva despre altruism?” → timestamp + link recording 3. AI summarize post-meeting → email automat cu rezumat la participanți 4. Comparație Whisper local vs transcript Zoom oficial (calibrare confidence thresholds)

Cost: gratuit (API calls) + bandwidth descărcare (m4a ≈ 30MB/oră).

UI sidebar — soluție pentru 320px

Zoom App rulează într-un sidebar de 320px (față de 4 coloane × 480px în browser UI actual). Soluție: 3 tab-uri comutabile:

TAB LIVE (default în ședință):

⏱ 19:42:30  🟢 -32dB         ← header sticky
Speaker activ: ▶ Cornel  [✏]
Agenda: Vorbitor 2 (4:32/7:00) ██░░

⚠ ERORI (3)              [▼]   ← accordion colapsabil
  • „ăă" filler tic
  • propoziție incompletă
  • „path" anglicism

✨ CREATIVE (1)          [▼]
📝 NOTIȚELE MELE  [+ ADD]
  [12:34] a clipit nervos
  [12:42] încheiat tare

TAB FIȘE: tab-uri orizontale per vorbitor + timeline TOOL/PAVEL/AMBELE per speaker.

TAB RAPORT: preview + export + sync recording Zoom.

Toggle [⤢] → trece în Main view (înlocuiește tile-urile video, layout 2 coloane exact ca browser UI azi).

Timeline implementare (post 2026-05-20)

Faza 3 — Platformă proprie TM (LiveKit, post 6+ luni validare)

Plan tehnic complet: docs/PLATFORM_TM_FEASIBILITY.md Status: decizie strategică luată 2026-05-16, cod zero. Implementare DOAR după pre-condiții.

Dacă 5+ role modules ajung mature și TM Sibiu vrea activ să iasă din Zoom, construim propria platformă de meeting — nu pentru a concura Zoom global, ci pentru a fi mai bun specific pentru TM: timer integrat, roluri native, per-speaker recording automat, link de participare, zero Process Tap fragility.

De ce LiveKit (și nu altele)

Ce câștigăm față de Zoom companion

Pre-condiții ne-negociabile (confirmate 2026-05-16)

1. 5+ role modules mature și folosite live min 3 luni
2. TM Sibiu vrea activ să iasă din Zoom (semnal real, nu speculativ)
3. Cel puțin 1 alt club interesat (validare externă)
4. Pavel are 3-6 luni bandwidth production (confirmat)

Server: self-hosted pe ce-dev-01 (4 vCPU, Infomaniak, deja există). NU LiveKit Cloud ($50/mo).

• ✅ Iteration 1 (2026-05-16): _template_role + Ah-Counter + Grammarian + Timer + filler_words_ro + hub
• ✅ Iteration 1.5 (2026-05-16 noaptea): General Evaluator + Toastmaster + meeting/agenda_standard + build_html.py (generare site HTML standalone din markdown, 123 KB / 10 pagini)
• ✅ Iteration 1.6 (2026-05-16 seara): Secțiunea §8 Evoluție platformă — plan complet Zoom Apps SDK + RTMS + Recordings API + UI sidebar 320px
• ✅ Iteration 1.7 (2026-05-16): §8 extins cu Faza 3 — platformă proprie LiveKit: analiză 4 opțiuni (Java respins explicit), pre-condiții, câștiguri vs companion pattern, referință PLATFORM_TM_FEASIBILITY.md
• 🟡 Iteration 2 (post 2026-05-20): 17 fișe rol rest + administrative/ + evaluation_framework/ + pathways/ parțial + Zoom Apps SDK POC (speaker detection, sidebar)
• ⚪ Iteration 3 (înainte lansare): contests/ + polish + cross-links + publicare