Skip to content

About

תרגול מתמטיקה מבוסס קצב לחינוך מיוחד, כולל סוניפיקציה של גרפי פונקציות

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

734 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What: two separate browser products in one repo — (1) elementary math practice tagged to the Israeli curriculum, (2) Hebrew function-graph sonification. Not a school product, not a Gafn listing, not a funded study.

For whom: a student, parent, or מחנכת שילוב who opens a URL. There is no paying buyer today.

How: open the live demo — no install, no account.

MelodyMath

דמו דפדפן בעברית (RTL), בלי התקנה ובלי שרת. הריפו מכיל שני מוצרים נפרדים.

תרגול יסודי · כיסוי תוכנית · שומעים פונקציה · גדילה ודעיכה · 807 · דף נחיתה · הזמן ניסוי כיתתי

README.md הזה הוא מקור האמת. מסמכי האקתון, אימות ישן והערות רכש ישנות יושבים ב־docs/archive/.

שני המוצרים

1. תרגול יסודי — index.html + curriculum.html

למי: כיתות א׳–ו׳, הורה, או מחנכת שילוב שפותחת קישור בכיתה קטנה.

בנק נפרד לכל כיתה. כל פריט נושא {כיתה, תחום, סעיף}. פריט בלי תג לא נכנס.

  • א׳ — מנייה עד 100 (גם אחורה, דילוגי 2 מ־50, דילוגי 5, קיבוץ ל־10); חיבור/חיסור עם פירוקי 10, = משמאל, יותר משני מחוברים, עשרות שלמות; ישר מספרים אינטראקטיבי
  • ב׳ — כפל 2/4/5/10; חילוק לחלקים ולהכלה על אותם מספרים. 3/6/7/8/9 חסומים עד שיש שליטה בליבה
  • ג׳ — לוח 3/6/7/8/9 נפתח אחרי השער
  • ד׳ — שבר כחלק משלם מול תיבה 4/4: רק (\frac{1}{2}), (\frac{1}{4}), (\frac{1}{8}). תשובה כמו «חצי מ־8 = 4» אינה שבר
  • ה׳ — שברים: הרחבה, צמצום והשוואה; חיבור/חיסור במכנים שונים; מספרים מעורבים (7/4 ⇄ 1 ו־3/4, השוואה וחיבור/חיסור בניסוח מילולי); שבר מכמות. שברים עשרוניים: ערך מקום, השוואה, חיבור/חיסור
  • ו׳ — כפל וחילוק שברים; כפל וחילוק עשרוניים וב־10/100; אחוזים — משמעות האחוז (1% = 1/100), 10%/25%/50% מכמות, שבר לאחוז, שינוי באחוזים

דף הכיסוי מציג לפי כיתה ותחום מה מכוסה ומה לא. גאומטריה — חלקית (מיון מצולעים וזווית ישרה בא׳–ב׳, סוגי זוויות ומשולשים בג׳, מקבילים/מאונכים/מרובעים/תיבה בד׳; אין פירוק והרכבה ואין שטח פנים). מדידה — חלקית (סרגל ושעון בא׳, חצאי שעות והיקף בב׳, דקות ושטח מלבן בג׳, המרת יחידות ולוח לועזי בד׳; אין נפח תיבות ואין לוח עברי). חקר נתונים — לא מכוסה בא׳–ד׳. זה גל 2. בה׳–ו׳ מכוסים השברים, העשרוניים והאחוזים; גאומטריה של ה׳ (שטח משולש ומקבילית), שטח עיגול, נפח, סדר פעולות ובניית דיאגרמות — אין בבנק.

באותו דף, למחנכת בפיילוט:

  • מצב כיתה — מפגש 8 דקות מבנק א׳, גופן גדול, בלי הקלדה. כברירת מחדל אין שעון עוצר על המסך של הילד; המורה יכולה להציג אותו
  • דוח מורה + לוח כיתה — רישום מקומי לפי שם/קוד
  • מכתב להורה ותעודת תרגול — ספירה. בלי «שולט» ובלי טענת יעילות
  • נגישות על הטאבלט — ניגודיות, אות גדולה, הקראה בעברית, המתנה ארוכה, מצב שקט. זה המוצר, לא תוספת
  • דף עבודה להדפסה ועבודה בלי רשת אחרי ביקור אחד
  • מקצב אופציונלי — BPM ידני. נקישה לקצב, לא טענת יעילות

הכל ב־localStorage במכשיר. אותו קוד כיתה בטאבלט אחר לא מסנכרן.

הניווט בדפי המוצר הזה (תרגול, כיסוי, הצעה, אודות) לא מקשר לסוניפיקציה, ולשונית «מעבדה» (תדר ומחולל מקצב) הוצאה מהדף הראשי ב־28.9.2026. הקוד של הסוניפיקציה לא השתנה.

2. סוניפיקציה של גרפים — functions.html + 807.html

למי: חטיבה / תיכון. זה לא אותו קהל, ולא חלק מתוכנית א׳–ד׳.

סריקת (f(x)) כגובה צליל, נקישה לשורש, שקט מחוץ לתחום, סינוס במצב טון-אמיתי, ומשחק "נחש את הפונקציה". 807.html מתרגל (M(t)=M_0\cdot q^t).

פנייה לפרויקט

ערכי הקשר נמצאים רק ב־CONTACT ב־src/lib/contact.js. CONTACT.form הוא ערוץ הפנייה הציבורי: טופס Google «משוב על האפליקציות» של הבעלים, עם MelodyMath ממולא מראש (החלטת הבעלים 28.9). אם מרוקנים אותו, הדפים מציגים במקומו טופס פנייה ציבורי בגיטהאב (.github/ISSUE_TEMPLATE/pilot.yml). CONTACT.email ריק = קישור הדוא״ל מוסתר. בדף ההצעה, עותק לפרויקט יוצא רק אם המחנכת מסמנת «שלחו עותק לפרויקט».

מה אין כאן

אין backend, אין חשבון, אין תשלום, אין רישום במאגר משרד החינוך, ואין נתוני פיילוט. אין ולו משתמש אחד שאומת (VALIDATION.md בארכיון, 3.8.2026).

מה המחקר מצא

מחקר שוק מ־13.8.2026 — RESEARCH.md — פסק דין PARK. אין כאן טענת מוכנות להגשת מימון.

  1. הנוף כבר תפוס, במחיר אפס או במוצר בשל. Desmos Audio Trace נותן סוניפיקציה של גרפים בחינם. תרגול כפל/חשבון עם מוזיקה נמכר כבר על ידי Times Tables Rock Stars ו־Calcularis.

  2. הראיות על «קצב → מתמטיקה» דלילות ומעורבות — אסור לצטט אותן כהוכחה שהדמו עובד. מטא־אנליזה של Sala & Gobet, 2020 מצאה אפקט אפס לאימון מוזיקה על קוגניציה כששולטים באיכות המחקר. Ahokas et al. לא מצאו הבדל מובהק באוריינות מול ביקורת.

  3. אין קונה משלם היום. MONETIZATION.md לא מצא נתיב תשלום. נתיב האימות היחיד: מחנכת שילוב אחת, קבוצה קטנה, 4 שבועות, חינם, בלי טענת יעילות. דף הניסוי.

הפעלה מקומית

פותחים את index.html בדפדפן. זהו. כל הדפים טוענים את אותה ליבה (src/lib/core.js + המודולים שהוא צריך) — בלי CDN ובלי bundler. .github/workflows/test.yml מריץ npm ci && npm test על pull request ועל דחיפה ל־master.

npm test

או ישירות node --test. רץ על הליבה: נרמול תשובות, מיפוי מקצב, תיוג בנקים, שער שליטה בכפל, ישר מספרים, תיבה 4/4, כיסוי תוכנית, נגישות, ויושרת דפים.

הדגמת הפיילוט (MM-600)

pilot/index.html — הדגמה לתלמיד ולמורה במכשיר אחד, עם כניסת הדגמה (לא אבטחה אמיתית). מקושרת מ«ערכת פיילוט» בדוח המורה בדף הבית («הדגמת פיילוט למורים»), ונשמרת ב־sw.js לעבודה בלי רשת אחרי הביקור הראשון. מדריך למורה: docs/MM-600-teacher-guide.md.

בדיקות ה־E2E שלה (Playwright) נפרדות מ־npm test ויש להן package.json משלהן ב־pilot/. הכנה חד־פעמית, ואז הרצה משורש הריפו:

cd pilot && npm ci && npx playwright install chromium && cd ..
npm run test:pilot

רץ ב־1280px וב־360px. ה־CI לא מריץ אותן — רק npm test.

אין בדיקת WCAG מול NVDA/VoiceOver בכיתה אמיתית. בדיקת ה־CI היחידה בריפו היא npm test (ו־CodeQL בנפרד).

Sentry ו־Codecov

אין DSN ואין טוקן בקוד. ב־index.html הערך הוא __SENTRY_DSN__. בלי החלפה בזמן פריסה, Sentry לא נטען ואין שגיאה בקונסול, והטאבלט לא שולח דבר. סוד המאגר SENTRY_DSN מוחלף במקום הזה רק בפריסה; אז נטען ה־SDK עם sendDefaultPii: false.

node tools/codecov.js (או npm run coverage) מריץ את הבדיקות וכותב coverage/lcov.info. אם CODECOV_TOKEN חסר, ההעלאה ל־Codecov מדולגת והפקודה מצליחה. הריפו לא מוסיף workflow של GitHub Actions.

Doppler

הסודות נקראים רק מהסביבה ש־Doppler מזריק (doppler run -- node tools/codecov.js). אין ערכים בקוד וב־doppler.yaml.

שמות נדרשים: SENTRY_DSN, CODECOV_TOKEN.

בלי הזרקה נשאר __SENTRY_DSN__ בעמוד, ו־Codecov מדלג. בדיקות הריפו רצות מקומית עם npm test.

כמה תלמידים בו־זמנית

אין שרת, ולכן «כמה משתמשים» עובד כך:

  • טאבלט אחד, כמה ילדים — קוד כיתה קבוע + שם או קוד לכל ילד, ושמירה במכשיר. מעבר בלחיצה על השם בלוח הכיתה. לכל ילד שורה משלו לפי קוד כיתה + שם; שתי כיתות באותו טאבלט לא מתערבבות, גם כשיש בהן שם זהה.
  • טאבלט לכל ילד — אותו קוד כיתה בכל טאבלט. בסוף שיעור: «ייצוא גיבוי JSON» בכל טאבלט, ובטאבלט של המורה «ייבוא». מפגשים, הערות ומשימות מתמזגים; ייבוא כפול של אותו קובץ לא מוסיף דבר.
  • מה לא קיים: סנכרון אוטומטי בין מכשירים, חשבונות, וגיבוי בענן.

test/concurrentClass.test.js מריץ 20 תלמידים בשתי כיתות: שש תשובות לכל אחד, בסדר משתנה, על אותו אחסון, ואחר כך 20 טאבלטים שמיובאים למורה. הבדיקה מוודאת שאין תשובה בשורה של ילד אחר ושאין רשומה שאבדה. היא רצה ב־npm test.

פרטיות ונתוני ילדים — מה נשמר, איפה, ואיך מוחקים. test/privacy.test.js בודק ששום דף לא טוען קוד מאתר אחר ולא שולח נתונים.

GitHub Pages מפורסם מענף main. אחרי שינוי ב־master צריך לעדכן גם את main כדי שהדמו החי ישתנה.


פרויקט פתוח · Swissystem7

Note: draft PRs may also be produced by the Muse Code queue on Dell (muse-task).

About

תרגול מתמטיקה מבוסס קצב לחינוך מיוחד, כולל סוניפיקציה של גרפי פונקציות

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages