🎛️ דשבורד אדמין ראשי
ליבהמסך הבית של המנהל — מרכז בקרה עם התראות על בקשות פתוחות, סיכום נוכחות היום, רשימת הצוות הרשום, סיכום כיתות, וקיצורי דרך לכל כלי הניהול.
פתחו את דשבורד הניהוללפרטים נוספים ▾
🔔 התראות פעילות (למעלה)
- בקשות גישה חדשות — עם אנימציית פעימה להדגשה.
- הדפסות ממתינות לאישור — מונה + קישור לתור.
קיצורי דרך (15+ מודולים)
- העלאת קבצים · ייצוא תלמידים · דוחות · אקסל.
- נוכחות צוות · שיעורים פרטניים · אילוצי חירום · סקרים.
- חופשות · הרשאות · בקשות גישה · הדפסות · מדפסות.
- ערוצי צ׳אט · חשבונות מייל · דרייב · לוגים · עלויות AI · חתימות · תבניות מכתבים · חיבור Google.
📊 נוכחות תלמידים (טבלה מתקפלת)
- סיכום לפי כיתה: שכבה, סה״כ, מולאו בבוקר/צהריים, בכיתה, מרחוק, נעדרים.
- לחיצה על שורה → דף הכיתה.
👥 צוות רשום (טבלה מתקפלת)
- שם, ת.ז., טלפון, תג אדמין, תגים מיוחדים, כניסה אחרונה.
- לחיצה על מורה → מודאל עריכה עם:
- עריכת תגים (דינמי).
- קוד מדפסת Konica.
- הרשאת הדפסה בצבע (כן/לא).
- Scope — אילו כיתות/שכבות שייכות אליו.
🏫 סיכום כיתות
- כל כיתה עם: שכבה, אות, מספר תלמידים, שם מחנך.
➕ הוספה ידנית
- תלמיד — שם, שכבה, כיתה, טלפון.
- איש צוות — שם, ת.ז., טלפון, מייל, אם מנהל.
📊 דשבורד הנהלה מרוכז (KPI)
חדשתמונת מצב במבט אחד של כל הנתונים החיוניים — נוכחות, רישום, בקשות גישה, הדפסות, קריאות מזגנים, היעדרויות צוות, משימות הנה״ח, צ׳קים, טיולים, עלויות AI, מעקב תקלות ומיזוגים אחרונים. כל KPI לחיץ ומוביל ישירות לדף המלא של המודול.
פתחו את דשבורד ה-KPIלפרטים נוספים ▾
קטגוריות ה-KPI
- נוכחות — אחוז נוכחות יומי לתלמידים ולצוות.
- רישום ובקשות גישה — מועמדים פתוחים ומורים שמחכים לאישור.
- תור הדפסות — כמה ממתינות לאישור.
- קריאות שירות — מזגנים פתוחים שעוד לא נסגרו.
- היעדרויות צוות — מי לא בעבודה היום + שעות גפ״ן.
- כספים — משימות הנה״ח פתוחות, צ׳קים בהכנה.
- טיולים — טיולים מתוכננים בקרוב.
- AI — עלות חודשית של ה-AI הפנימי (Gemini).
- מעקב תקלות — דיווחים פתוחים מהציבור.
- מיזוגים אחרונים — 5 ה-PRs האחרונים שעלו לפרודקשן.
גישה
- אדמין בלבד (
require_admin) — הכפתור מופיע ב-/school/admin. - אם מודול מסוים לא זמין/קורס — מציג ״—״ במקום לסכן את כל הדף.
שאלות נפוצות
- מתי הנתונים מתעדכנים? בכל טעינה של הדף.
- אפשר לפלטר/לסנן? לא — לחץ על KPI לקבלת הדף המלא של המודול עם כל הפילטרים שלו.
📺 מסכי תצוגה ציבוריים (קיוסק)
חדש4 מסכי קיוסק שמוצגים על טלוויזיות / Raspberry Pi בנקודות שונות בבית הספר — אולם תלמידים, חדר מורים, משרד מזכירות, ואב הבית. מציגים שעון + זמני יום, הודעות הנהלה, ימי הולדת, חידות חב״ד, קבצים מסונכרנים, סרטונים, ופתגם יומי בסיבוב אוטומטי. דף ניהול מאפשר לערוך הודעות וחידות בלי לגעת בקוד.
פתחו את ניהול המסכיםלפרטים נוספים ▾
4 מסכי הקיוסק
- אולם תלמידים (
/school/screen/students) — שעון, הודעות, ימי הולדת, חידות, סרטונים, פתגם. - חדר מורים (
/school/screen/teachers_room) — שעון, הודעות, ימי הולדת, קבצים מסונכרנים, פתגם. - משרד מזכירות (
/school/screen/secretariat) — שעון, הודעות, ימי הולדת, קבצים מסונכרנים. - אב הבית (
/school/screen/caretaker) — שעון, הודעות, קבצים מסונכרנים.
אבטחה — טוקנים סודיים ב-URL
- כל מסך מוגן ב-token ב-URL (כמו סיסמה). בלי הטוקן הנכון →
403 Forbidden. - ערכי הטוקנים האמיתיים נשמרים במנהל המוסד (לא נחשפים בתוך המדריך).
- לסיבוב טוקן בלי commit ל-git: הגדר את ה-env var המתאים ב-Railway —
SCREEN_TOKEN_STUDENTS/SCREEN_TOKEN_TEACHERS_ROOM/SCREEN_TOKEN_SECRETARIAT/SCREEN_TOKEN_CARETAKER. env var תמיד גובר על הערך ב-JSON.
ניהול תוכן (`/school/admin/screens`)
- הודעות הנהלה — כותרת + גוף + עדיפות + חלון תאריכים + סינון לפי מסך/ים.
- חידות חב״ד — שאלה + תשובה. הכפתור ״+ הוסף עם AI״ פותח את Gemini ומציע חידה חדשה.
- סרטונים — YouTube embed או URL ב-
screens_config.json. - קבצים מסונכרנים — קישור לתיקיית Drive ב-
synced_files_folder. - heartbeat — כל מסך פעיל מתעדכן ב-
last_pingכדי שתדע אם הקיוסק חי.
מתי להשתמש?
- הודעות זמניות (״מחר אין לימודים״, ״טיול באוטובוס״) — דרך הדף הזה, לא ברטיין הקוד.
- שינויי מבנה (סוג widget, סדר הסיבוב) — דרך עריכת
screens_config.jsonב-git.
🐞 מעקב תקלות ובקשות פיצ׳ר
ליבה
דף /school/admin/bug_tracker מציג ב-3 עמודות את כל הדיווחים
שמשתמשים שלחו דרך /school/bug_report. הסטטוס של כל דיווח
מתעדכן אוטומטית לפי מיקום הקובץ ב-GitHub.
לפרטים נוספים ▾
3 עמודות סטטוס
- 🟡 ממתין לטיפול — דיווח חדש שעוד לא נגעו בו.
- 🔴 דורש אישור בעלים — התיקון מוכן אבל עלול לפגוע בפיצ׳ר אחר; PR בסטטוס draft מחכה לכך שתאשר ידנית.
- 🟢 טופל ומוזג — תוקן, מוזג ל-main, ועלה לפרודקשן. קישור ישיר ל-PR שמימש את התיקון.
איך זה עובד מאחורי הקלעים
- כל דיווח שמוגש דרך
/school/bug_reportנדחף כקובץ markdown לענףclaude/runtime-reportsב-GitHub תחתdocs/bug_reports/. - Claude (סשן הפיתוח) מקבל את הדיווח, מבצע את התיקון, פותח PR ומזג
ל-main — ואז מעביר את ה-md לתיקיית-משנה (
fixed/אוneeds_approval/) שמשנה את הסטטוס בעמוד. - קישור ל-PR שמימש כל תיקון מופיע בכרטיסייה (קישור
#NN).
כפתורים
- 🔄 רענן מ-GitHub עכשיו — מאלץ קריאה חדשה ל-API (אחרת יש cache של 60 שניות).
- 📂 פתיחה ב-GitHub — קישור ישיר לתיקיית
docs/bug_reports/ב-GitHub לעיון מורחב.
🚀 מיזוגים אחרונים — מה עלה לפרודקשן
ליבה
בדף /school/admin/institutions נוסף סעיף "מיזוגים אחרונים ל-main"
שמציג את 15 ה-PRs האחרונים שעלו לפרודקשן — עם כותרת, תאריך, מספר וקישור
ל-GitHub. כך רואים במבט אחד מה התחדש, בלי להיכנס ל-GitHub.
לפרטים נוספים ▾
מה רואים
- כל שורה = PR שמוזג ל-main עם: מספר (קישור ל-GitHub), כותרת, שם המשתמש שמיזג, תאריך + שעה.
- הרשימה מתעדכנת אוטומטית. cache של 2 דקות כדי לא להעמיס על GitHub API.
- Railway מבצע redeploy אוטומטי תוך כ-2 דקות מכל מיזוג ל-main — אז שורה חדשה ברשימה ⇐ פיצ'ר חדש בפרודקשן בקרוב.
קישורי קיצור באותו דף
- 🐞 מעקב תקלות — קופץ ל-bug_tracker.
- 📜 יומן שינויים — קופץ ל-CHANGELOG המלא.
- 🆕 מה חדש — קופץ לפיד העדכונים שמשתמשים רואים.
GITHUB_TOKEN ו-GITHUB_REPO מוגדרים ב-Railway.🔑 הרשאות ותפקידים
ליבההמערכת המרכזית לניהול כל ההרשאות באתר. עובדת במבנה "תגים" — כל איש צוות מקבל תגים, וכל תג פותח גישה למסכים. מטריצה ברורה של תגים × מסכים × (צפייה/עריכה).
פתחו את ניהול ההרשאותלפרטים נוספים ▾
לשונית 1: תפקידים / תגים
- יצירת תג חדש — שם + תיאור.
- רשימת כל התגים — מערכתיים (נעולים) ומותאמים אישית.
- מחיקת תג מותאם (מערכתיים אי אפשר למחוק).
לשונית 2: שיוך לצוות
- בחירת מורה → רשימת checkboxes של כל התגים.
- כל שינוי נשמר אוטומטית (AJAX).
- מורים רבים — נגישים ע״י חיפוש/סינון.
לשונית 3: מטריצת הרשאות
- שורות = דפים באתר · עמודות = תגים × (צפייה/עריכה).
- כל checkbox — שמירה מיידית.
- תג "אדמין" קבוע כמלא — לא ניתן לבטל.
- פידבק — הודעת "✓ נשמר" לכל שינוי.
דפים שמנוהלים במטריצה
- דשבורד, צוות, סקרים, צ׳אט, רישומים, מערכת, למידה, אילוצים, מסמכים, רופאים, ועדה, admin_absence (פאנל היעדרויות)...
תגים חדשים — תשפ"ו
- רכז אקלים — תג חדש עם scope ברמת שכבה (כמו רכז שכבה). נותן גישה לתיקי תלמידים + RTI לכל השכבה.
- ניתן לשייך במודאל המורה עם בורר שכבות — בדיוק כמו רכז שכבה.
🎓 Seed תפקידים שנתי (תשפ"ו)
תשתית
קובץ school/data/teacher_roles_2026.json מגדיר את שיוכי המחנכים, רכזי השכבה
ורכזי האקלים לשנת תשפ"ו. הקובץ נטען אוטומטית בכל עליית שרת על-ידי
school/teacher_roles_seed.py — רק מוסיף/מעדכן; לא דורס תגים קיימים.
לפרטים נוספים ▾
מה נטען
- 16 מחנכים — אחד לכל כיתה: א|1 עד ח|2.
- 3 רכזי שכבה — וינר / גלייזר / טברדוביץ (כל אחד עם כיתותיו).
- 3 רכזי אקלים — נגר / אוזן / פרבר (scope ברמת שכבה).
התאמה חכמה
- השמות בקובץ חלקיים — המערכת מחפשת LIKE (שם פרטי או שם משפחה).
- שמות דו-משמעיים / לא נמצאו → נרשמים ל-log.warning — לא מפילים את השרת.
- ריצה חוזרת בטוחה — אם התג כבר קיים, רק ה-
scope_valuesמתעדכן אם השתנה.
עדכון שנתי
- בסוף כל שנה: עריכה של
teacher_roles_2026.json(או יצירה שלteacher_roles_2027.jsonחדש + החלפה ב-teacher_roles_seed.py). - בדיקות: לבחון לוגים של
apply_roles_seedבעליית שרת הבאה — אזהרות יופיעו מיד. - תגים שהוסרו מהקובץ לא מוסרים מהמורים אוטומטית — מחיקה ידנית במידת הצורך.
/school/admin/permissions → לשונית שיוך, בחירת המורה, צפייה בתגים שלו.🗂️ ניהול היעדרויות (admin_absence)
מזכירות / שכר
הטאב "ניהול ומזכירות" ב-/school/absence מציג את כל דיווחי המורים לטיפול.
תיעוד מלא נמצא במדריך המזכירות;
כאן רק מה שרלוונטי לניהול המערכת.
לפרטים נוספים ▾
הרשאה
- דף
admin_absenceב-מטריצת ההרשאות. - Seed ברירת מחדל: תגים מזכירה, מנהל, ניהול — עריכה.
- לחסום גישה זמנית? לבטל את ה-checkbox בעריכה; להחזיר → checkbox חזרה. אין צורך לערוך קוד.
מבנה DB
staff_absences— הדיווח עצמו (teacher_id, type, dates, status, budget_source, needs_sub).staff_absence_files— קבצים מצורפים (אישורים רפואיים / צבא), כולל סיכום AI.staff_moe_sync— היסטוריית סנכרון עם XLSX של משרד החינוך.- חתימות:
user_signatures— אותה טבלה של מכתבים (שיתוף בין מודולים).
Endpoints
POST /school/absence/api/submit— דיווח חדש (כל מורה).POST /school/absence/api/<id>/approve·/reject·/assign-sub— רק admin_absence.POST /school/absence/api/ai-summary— הפעלת Gemini Flash על קובץ מצורף.POST /school/absence/api/moe-sync— העלאת XLSX משרד חינוך.GET /school/absence/api/export.xlsx— ייצוא 3-גיליונות לשכר.
💬 ערוצי צ׳אט — ניהול מלא
ליבהיצירה, עריכה וארכוב של ערוצי הצ׳אט. כל ערוץ יכול להיות ציבורי/פרטי/מערכת, נדרש תגים מסוימים, AI שעונה אוטומטית, והרשאות override פרטיות.
פתחו את ניהול הערוציםלפרטים נוספים ▾
טבלת ערוצים
- שם · תיאור · סוג (ציבורי/פרטי/מערכת) · תגים נדרשים · מספר overrides · AI פעיל · סטטוס.
- לחצן הצג פעילים/כולל מוארכבים.
יצירת ערוץ חדש
- שם (חובה) + תיאור קצר.
- סוג:
- ציבורי — כל מורה רואה.
- פרטי — רק למי שיש את התגים הנדרשים.
- מערכת — התראות אוטומטיות בלבד.
- תגים לגישה — multiselect.
- AI detection — האם המודל יענה על שאלות בערוץ.
עורך ערוץ (מסך נפרד)
- עריכת כל השדות + ניהול הרשאות ידני.
- Overrides פרטיים: הוספה/הסרה של מורה ספציפי לגישה אישית (בהתעלם מתגים).
ארכוב
- ערוץ מוארכב — לא נעלם, אך לא מופיע ברשימה הראשית.
- ניתן לשחזר בכל שלב.
🖨️ מערכת הדפסות — ניהול מלא
ליבהניהול התור, המדפסות, הלוגים והסטטיסטיקות של מערכת ההדפסה. כולל אישור ידני של כל עבודה, שליטה בהדפסה צבעונית, ומעקב שימוש למניעת בזבוז.
פתחו את תור ההדפסות4א. תור הדפסות (/school/admin/print) ▾
עבודות ממתינות
- כרטיסים מונפשים עם: כותרת, מורה, מספר עמודים, זמן יצירה.
- Chips הגדרות: עותקים · דופלקס · צבע · הידוק · חוברת · קיפול · פריסה · גווני אפור · גודל נייר · מגש · משקל · מטרה (כיתה/אישי/תלמיד/מנהלה) · טווח עמודים.
פעולות לעבודה
- 👁️ צפייה ב-PDF — לפני אישור.
- ✓ אשר והדפס — פותח מודאל.
- ✗ דחייה — עם סיבה.
מודאל אישור
- סיכום העבודה — מורה, מדפסת שתיבחר, הגדרות.
- Override צבעוני — המנהל יכול לכפות אפור אם לא אישר צבע.
- חתימה אוטומטית "אושר ע״י" עם שם המנהל.
אזהרות
- ⚠️ אם למורה אין קוד Konica — לא ניתן לשייך לו.
- ⚠️ אם אין אף מדפסת פעילה — חסימה.
4ב. מדפסות (/school/admin/printers) ▾
טבלת מדפסות
- שם · IP · דגם · סטטוס (online/offline/מעולם לא נראתה) · נראתה לאחרונה · פעילה · תומכת בצבע.
פעולות
- הפעלה/כיבוי מדפסת.
- הפעלה/כיבוי תמיכת צבע.
- הוספה: שם · IP · דגם · האם פעילה.
4ג. לוגים (/school/admin/print/logs) ▾
- כל עבודת הדפסה — מזהה, מורה, סטטוס, שם קובץ, עמודים, מדפסת, זמן, שגיאה.
- סינון לפי תאריך, מורה, סטטוס.
4ד. סטטיסטיקות (/school/admin/print/stats) ▾
- כרטיסי סיכום: סה״כ, ממתין, אושר, הודפס, נדחה, נכשל.
- חתכים: לפי מורה · לפי מדפסת · לפי זמן ביום.
👥 נוכחות צוות — תצוגת ניהול
יומיומימסך למנהל לראות מי דיווח מה היום — פרונטלי / מהבית / מחלה / חריג — וגם מי לא דיווח בכלל.
פתחו את ניהול הצוותלפרטים נוספים ▾
בוחר תאריך
- GET — ניתן לבחור גם ימים קודמים.
כרטיסי סיכום
- פרונטליים · מהבית · חופשת מחלה · חריג · לא דיווחו.
טבלת דיווחים
- שם · סטטוס (צבעוני) · הערה חופשית.
טבלת "לא דיווחו"
- רשימה מודגשת של צוות שחסרה דיווח — למנהל ליצור קשר.
📚 שיעורים פרטניים — תצוגת ניהול
יומיומיסיכום יומי של כל השיעורים הפרטניים והקבוצתיים שדיווחו המורים — כולל מצב (פרונטלי/טלפוני), תלמידים, ונושא השיעור.
פתחו את ניהול הלמידהלפרטים נוספים ▾
- בחירת תאריך.
- כרטיסי סיכום: פרונטלי · טלפוני · סה״כ תלמידים.
- טבלה: מורה · מצב · מספר תלמידים · שמות (מקוצרים) · נושא (מקוצר).
⚠️ אילוצי חירום — תצוגת ניהול
מצבי חירוםסיכום מרוכז של כל דיווחי האילוצים למצבי חירום — עם הדגשה של מי לא יוכל להגיע מחר ומי יציע אשתו כתחליף.
פתחו את ניהול האילוציםלפרטים נוספים ▾
- בחירת תאריך.
- כרטיסי סיכום: לא יוכל לבוא (🔴) · אשתו תבוא (🟡) · יבוא (🟢).
- "לא יכולים לבוא מחר" — טבלה עם מסגרת אדומה: שם, מסגרות ילדים (עם badges), הערות.
- "אשתי תבוא במקומי" — טבלה צהובה, מבנה דומה.
- "כל הדיווחים" — מטריצת סטטוס של כל הצוות.
🔓 בקשות גישה — מורים חדשים
חשובמורים חדשים שניסו להתחבר ועדיין לא קיימים במערכת מגיעים לתור בקשות גישה. המנהל מאשר — או מקשר למורה קיים, או יוצר רשומה חדשה.
פתחו את בקשות הגישהלפרטים נוספים ▾
בקשות ממתינות
- כרטיסי אזהרה עם: שם, תפקיד, דוא״ל, זמן בקשה.
- כפתורי "אשר" / "דחה".
מודאל אישור
- סיכום הבקשה.
- בחירה:
- קשר למורה קיים ברשימה (למשל הוא שינה דוא״ל).
- צור מורה חדש — מזינים שם, דוא״ל, אם מנהל.
היסטוריה
- בקשות שטופלו (מתקפל) — עם שם המורה שנוצר/קושר.
📧 חשבונות מייל משותפים
ליבהניהול חשבונות Google/Gmail שבית הספר משתמש בהם לשליחת מיילים רשמיים (רישום, מכתבים, דוחות). OAuth מוצפן; ניתן להתנתק בכל שלב.
פתחו את חשבונות המייללפרטים נוספים ▾
איך זה עובד
- 1. מתחברים לחשבון הגוגל דרך OAuth (מסך גוגל הרשמי).
- 2. הטוקן נשמר מוצפן (עם SCHOOL_TOKEN_ENCRYPTION_KEY).
- 3. אדמינים/מזכירות יכולים לשלוח מיילים "מטעם" החשבון.
- 4. ניתן לנתק בכל רגע — הטוקן נמחק.
כרטיסי חשבון
- שם תצוגה · דוא״ל · תיאור · סטטוס חיבור.
- כשמחובר: זמן חיבור · תוקף טוקן.
- כפתורי "חבר" (פותח OAuth) או "נתק" (אישור).
📊 סקרים — יצירה וניתוח
תקופתייצירה של סקרים פנימיים (לצוות) או חיצוניים (להורים), עם שדות מותאמים, צפייה בתשובות, וייצוא ל-CSV לניתוח.
פתחו את מסך הסקריםלפרטים נוספים ▾
יצירת סקר
- כותרת · תיאור/הוראות · שדות מותאמים (רשימה מופרדת בפסיקים).
טבלת סקרים
- כותרת · מספר תגובות · סטטוס (פעיל/סגור) · URL להעתקה · פעולות.
- צפייה · עריכה · פתיחה/סגירה.
עורך סקר
- עריכת שדות, סידור מחדש (drag&drop), מחיקת שדות.
צפייה בתשובות
- טבלה עם כיתה, שדות מותאמים, זמן שליחה.
- סינון לפי כיתה.
- ייצוא CSV.
📄 תבניות מכתבים
ליבה
ניהול תבניות DOCX (Word) לכל סוגי המכתבים שהאתר מייצר. התבנית חייבת לכלול placeholder
{{CONTENT}} שיוחלף בתוכן המכתב בזמן ההפקה. ההפקה הסופית היא PDF נעול.
לפרטים נוספים ▾
מבנה תבנית
- קובץ DOCX רגיל מ-Word.
- כותרת עליונה עם לוגו בית הספר.
- Placeholder —
{{CONTENT}}— יוחלף בתוכן. - חתימת מנהל או שורה לחותמת.
העלאה (פאנל שמאלי)
- סוג מכתב — dropdown (קבלה, דחייה, הודעה להורים, אחר).
- שם תצוגה (אופציונלי).
- קובץ DOCX (עד 5MB).
- צ׳קבוקס "ברירת מחדל לסוג זה".
רשימת תבניות (פאנל ימני)
- שם + באדג׳ "ברירת מחדל" · באדג׳ סוג · גודל ב-KB.
- הורדה · הפוך לברירת מחדל · מחיקה.
📬 יומן שליחת מכתבים
מעקבהיסטוריה מלאה של כל מכתב שנשלח דרך האתר — מי שלח, למי, איזה סוג, סטטוס המסירה, ותאריך.
פתחו את יומן המכתביםלפרטים נוספים ▾
סינונים
- טווח תאריכים · מורה · סוג תבנית · סטטוס.
שורות בטבלה
- זמן · מורה · נמען · סוג מכתב · דוא״ל נמען · סטטוס (נשלח/נכשל/ממתין) · זמן מסירה.
- כפתור "צפה בדוא״ל" · כפתור "שלח שוב" (אם נכשל).
🖋️ חתימות דיגיטליות
ליבההעלאה ועריכה של חתימות דיגיטליות (PNG) לכל מורה. החתימה משולבת אוטומטית בכל מכתב שהמורה שולח, ובדפי חתימה להדפסה.
פתחו את ניהול החתימותלפרטים נוספים ▾
העלאה (פאנל שמאל)
- Dropdown בחירת מורה.
- העלאת קובץ PNG (מומלץ רקע שקוף).
רשימת מורים (פאנל ימין)
- חיפוש/סינון לפי שם.
- כל שורה: שם + badges (אדמין / יש חתימה).
- תצוגה מקדימה של החתימה.
- החלפה / מחיקה.
📜 לוגי מערכת ואבחון
אבחוןחלון לוגים חי — מציג את כל פעילות השרת בזמן אמת. כולל סינון לפי רמה, מודול, טקסט, רענון אוטומטי, וכפתור "שלח ל-Claude" לפענוח שגיאות.
פתחו את מסך הלוגיםלפרטים נוספים ▾
סינונים
- רמה — DEBUG · INFO · WARNING+ · ERROR · CRITICAL.
- מודול — drive · print · chat · auth · finance · schedule וכו׳.
- טקסט חופשי.
- רענון אוטומטי — כל 3 שניות.
פעולות
- 🔄 רענן עכשיו.
- 📋 העתק ללוח (כל הלוגים המוצגים).
- 🤖 שלח ל-Claude — פתיחת AI עם הלוגים לפענוח.
- 🗑️ נקה — אישור חובה.
תצוגה
- רקע כהה, מונוספייס.
- כל שורה: זמן · רמה (צבעונית) · מודול · הודעה.
- עד 1000 שורות — scrollable.
מטא-דאטה
- מונה רשומות · זמן רענון אחרון.
💸 שימוש AI ועלויות
מעקבניטור שימוש בכל מודלי ה-AI (Gemini, Claude) — כמה שיחות, כמה טוקנים, כמה זה עלה. חתכים לפי מודל, פיצ׳ר, ויום.
פתחו את מסך עלויות AIלפרטים נוספים ▾
טווח תאריכים
- כפתורים מהירים: 1 יום · 7 ימים · 30 יום · 90 יום.
- או טווח מותאם.
כרטיסי סיכום
- סך עלות (בתקופה) · מספר קריאות.
- טוקני Input · טוקני Output.
- ממוצע יומי.
חתך לפי מודל
- שם מודל · קריאות · input · output · עלות.
חתך לפי פיצ׳ר
- פיצ׳ר (למשל "ניסוח מכתב", "ניתוח יומן") · מודל · קריאות · עלות.
חתך יומי
- תאריך · קריאות · input · output · עלות.
⏰ ניהול מערכת שעות
ליבה · מורכבהמערכת המקיפה ביותר באתר — ניהול כיתות, מקצועות, שיבוצים, תורנויות, העלאת מערכת מקובץ Excel, וגם סריקה אוטומטית (OCR) של דפי תורנויות מודפסים בעזרת Gemini Vision.
פתחו את ניהול המערכת16א. ניהול כיתות ומקצועות ▾
לשונית כיתות
- הוספה: שם, שכבה, מחנך (dropdown).
- טבלה עריכה inline — שם, שכבה, מחנך, ארכוב.
- כפתורי שמור/מחק.
לשונית מקצועות
- הוספה: שם, בוחר צבע.
- טבלה: שם, דגימת צבע, מחיקה.
לשונית משבצות (סלוטים)
- יצירת טווחי זמן (התחלה/סיום, יום).
- שיוך משבצת לכיתה.
16ב. תורנויות (/school/schedule/admin/duties) ▾
- טבלה: ימים × שעות עם תורנויות.
- עריכה/מחיקה לכל תורנות.
- סטטוס סנכרון ל-Google Calendar.
- הוספה: תאריך, שעות, מיקום, מורה.
- ייבוא מקיף מ-Excel/PDF.
16ג. החלפות תורנויות (/school/schedule/admin/sub) ▾
- רשימת בקשות החלפה: תאריך, מורה מקורי, מחליף, סיבה, סטטוס.
- אישור/דחייה ידני.
- יצירת החלפה חדשה: תאריך, ממי, למי, סיבה.
16ד. העלאת מערכת מ-Excel (/school/schedule/upload) ▾
- העלאת קובץ XLSX עם המערכת.
- תצוגה מקדימה של הנתונים המזוהים.
- כפתור "אשר וייבא".
16ה. OCR דפי תורנויות (/school/schedule/ocr) — מתקדם ▾
תהליך
- העלאה של עד 3 קבצי PDF של דפי תורנויות מודפסים.
- לחצן "הפעל OCR" — Gemini Vision סורק.
- פלט גולמי (מתקפל) לצפייה בתוצאות המלאות.
טבלת מועמדים
- שם מורה מזוהה (dropdown לתיקון), יום, טווח שעות, מיקום.
- Checkbox לכל שורה — לבחירה אילו תורנויות לשמור.
- "בחר הכל" / "נקה" / "שמור".
🎓 הרשאות ייעוץ והכלה
ליבההרשאות ייעודיות למערכת הייעוץ — שונות ומורכבות יותר מ"הרשאות רגילות" כי יש scope של כיתות (מחנך רק לכיתתו, רכז שכבה לשכבה שלו).
פתחו את הרשאות הייעוץלפרטים נוספים ▾
סוגי תגים
- יועץ/פסיכולוג — גישה מלאה לכל התיקים.
- מחנך — RTI של הכיתה שלו בלבד.
- רכז שכבה — RTI של השכבה שלו בלבד.
- אדמין ייעוץ — כמו יועץ + ניהול תגים.
טבלת מורים
- שם + דגל אדמין.
- תגים לחיצים — לחיצה מחליפה בין שיוך/הסרה.
- מידע על scope (לאילו כיתות/שכבות קשור).
🏥 ייעוץ — ועדות, רפואי, ומסמכי ידע
ליבה · רגישניהול של שלוש מערכות מרכזיות: ועדת ייעוץ (תיקים ומפגשים), תיק רפואי לכל תלמיד, ומסמכי ידע פנימיים ליועצים (אינטרוונציות, משאבי בריאות הנפש).
ועדת ייעוץ (/school/counseling/committee) ▾
- טבלה: שם תלמיד, סוג תיק, תאריך פתיחה, יועץ אחראי, סטטוס, תאריך סקירה הבא.
- מודאל פרטי תיק: היסטוריה מלאה, צירופים, פרוטוקולים, החלטות.
- יצירת תיק חדש: בחירת תלמיד, סוג, תיאור, יועץ.
תיק רפואי (/school/counseling/medical/<student_id>) ▾
פרטי רפואה (כרטיסים מתקפלים)
- סוג מצב (מדרופדאון — אלרגיות, אסתמה וכו׳).
- פרטים · תאריך תוקף מסמך (בעל badge צבעוני לתוקף).
- מיקום EpiPen · רשימת צוות מאושר.
- אנשי קשר לחירום.
- סקלת מצב רוח (1-5 עם אימוג׳י).
פעולות
- הוספת רשומה חדשה · עריכה · מחיקה · ארכוב.
- העלאת קבצים (אבחונים רפואיים).
מסמכי ידע (/school/counseling/docs) ▾
- בסיס ידע פנימי ליועצים — intervention מדעי, משאבי בריאות הנפש, מסגרות משפטיות.
- קטגוריות מתקפלות.
- העלאת מסמך: כותרת, קטגוריה, קובץ.
- חיפוש לפי סוג.
📤 ייצוא והדפסת תלמידים
שימושישני מסכים להפקת רשימות תלמידים — ייצוא (Excel/CSV/PDF) להעברת מידע, והדפסה (תוויות, רשימות כיתה, ברזל) עם תבניות מוכנות.
ייצוא (/school/admin/students/export) ▾
- פורמט: Excel · CSV · PDF.
- בחירת עמודות: שם · ת.ז. · כיתה · קשר · איש קשר לחירום.
- מסננים: שכבה · כיתה · סטטוס (פעיל/לא פעיל).
- הורדה אוטומטית.
הדפסה (/school/admin/students/print) ▾
- מסנני סינון (שכבה/כיתה/סטטוס).
- תבניות מוכנות: רשימת כיתה · רשימת קשר · תוויות ת.ז. · כרטיסי שכבה.
- תצוגה מקדימה.
- PDF או שליחה ישירה למדפסת.
🎯 מעקב מועמדים (תצוגת אדמין)
רישוםתצוגת אדמין מתקדמת של מסך המועמדים — עם יכולות נוספות של ייבוא בכמות, חתכי סטטיסטיקה, ושיוך לגנים.
פתחו את מעקב המועמדיםלפרטים נוספים ▾
- 6 כרטיסי סטטוס עליונים.
- פילוח לפי גן.
- טבלה עם עריכת סטטוס inline.
- מסננים: סטטוס, גן.
- ייבוא בכמות מאקסל (דרך מסך הרישומים).
⚙️ הגדרות לכל דף (פר-דף)
מתקדםכפתור צף "⚙ הגדרות הדף" בפינת כל דף (נגיש רק לאדמינים). מאפשר להגדיר באנר, מצב תחזוקה, והרשאות ברמת הדף — ללא מעבר לפאנל ניהול.
לפרטים נוספים ▾
לשונית הגדרות דף
- שם תצוגה — לדרוס את שם הדף (מוצג בתפריט).
- הודעת באנר — מוצגת בראש הדף לכל המשתמשים.
- מצב תחזוקה — רק אדמינים רואים את הדף; אחרים רואים "🛠 בשיפוצים".
לשונית הרשאות רכיבים
- מטריצה מצומצמת של הרשאות — תגים × (צפייה/עריכה) רק לדף הזה.
- קיצור דרך בלי מעבר לפאנל ההרשאות הראשי.
🗄️ גיבויים — PostgreSQL + GitHub
תשתיתהאתר מגבה אוטומטית את בסיס הנתונים ל-PostgreSQL כל 10 דקות, ויש גם שחזור משני מ-GitHub (רעיונות בלבד). אין צורך בהתערבות ידנית — אך טוב לדעת מה קורה מאחורי הקלעים.
לפרטים נוספים ▾
גיבוי ראשי — PostgreSQL
- thread ברקע שרץ כל 10 דקות.
- מעתיק את school.db לטבלה ב-PG.
- משותף עם מערכת הבוט — שני השירותים כותבים לאותו טבלה.
- שחזור אוטומטי בעת הפעלת שרת חדש (דיפלוי).
גיבוי משני — GitHub (ideas.json)
- רעיונות שהצטברו נכתבים גם ל-GitHub (תיקייה נפרדת).
- אם PG לא זמין — שחזור מתבצע מ-GitHub.
- שימוש INSERT OR IGNORE — בטוח לריצה כפולה.
מה לא מגובה
- קבצים שהועלו (PDFs, תמונות) — חיים ב-Railway volumes.
- ההנחה: רוב הקבצים משוחזרים מ-Google Drive אם נחוץ.
💡 פאנל רעיונות (FAB) — ניהול backlog
אדמין
כפתור צף 💡 בפינת-התחתית של כל דף פותח פאנל Google-Keep-like לאיסוף רעיונות, בקשות
שיפור ובאגים מכל בעלי התפקידים. כל רשומה שמורה ב-DB, מגובה ב-PostgreSQL ומסונכרנת
ל-GitHub (docs/ideas.json + docs/FUTURE_IDEAS.md).
לפרטים נוספים ▾
הוספת רעיון
- כותרת קצרה + גוף מפורט (אחד מהם חובה).
- עדיפות: 🔥 גבוהה · 🟡 רגילה · 🔵 נמוכה.
- קטגוריה: כללי / עיצוב-UI / פיצ׳ר חדש / באג / תוכן.
- מודול קשור (חדש) — dropdown עם 17 מודולים (משימות / יומן / מכתבים וכו׳) או URL מותאם.
קישור למודול בכל כרטיס
- רשומה שמוגדר לה מודול מציגה צ׳יפ סגול-כחול "🔗 <שם מודול>" שמקפיץ ישר למסך הרלוונטי.
- כפתור 🔗 קשר למודול / 🔗 שנה קישור בכרטיס מאפשר לערוך את הקישור גם אחרי שמירה.
מילוי רטרואקטיבי
- בעליית השרת, רשומות ישנות בלי מודול מקבלות קישור אוטומטי לפי זיהוי מילות מפתח בכותרת/גוף (למשל "משימות" →
/school/tasks, "יומן" →/school/calendar, "הצעת מחיר" →/school/finance). - הסריקה בטוחה לריצה חוזרת — לא דורסת ערכים קיימים.
סטטוסים ופעולות
- ✅ בוצע — סוגר רשומה (נשארת גלויה עם border ירוק).
- ↩ פתח מחדש — חוזרת למצב open.
- 📦 לארכיון — עמומה, לא בולטת.
- 🗑 מחיקה — רק חשבון המאסטר יכול למחוק לצמיתות.
📣 "מה חדש" — פיד עדכונים למשתמשים
תוכן
דף ציבורי ב-/school/whats_new שמציג עדכונים לפי תאריך, עם סינון לפי תגית-תפקיד.
מנוהל כקובץ JSON פשוט ב-school/data/whats_new.json — כל שינוי במערכת שמצדיק
עדכון מצוות נוסף כאן לפני מיזוג (ראה CLAUDE.md §2).
לפרטים נוספים ▾
מבנה רשומה (whats_new.json)
date— YYYY-MM-DD, חדשה ראשונה.module— שם המודול בעברית (למשל "משימות", "הרשמה", "כלכלה").icon— אימוג'י אחד.title,body— Hebrew; body תומך ב-Markdown קל.for— מערך תגיות תפקיד (מנהל, מזכירה, מורה, הורה, מנהל כספים). אם חסר — גלוי לכולם.
קישור למודול אוטומטי
- צ׳יפ המודול הופך לקישור לחיץ לפי מפה פנימית (17+ מודולים).
- רשומות ישנות בלי
module_urlמקבלות את הקישור אוטומטית — אין צורך לערוך את ה-JSON.
סינון לפי תגיות המורה
- אדמין מקבל אוטומטית את התגית "מנהל"; תגיות אחרות נשלפות מ-
teacher_tags. - רשומה מוצגת רק אם לצופה יש לפחות אחת מהתגיות בשדה
for.
כשמשחררים פיצ׳ר חדש
- Prepend entry ל-
entriesב-whats_new.json. - ב-CHANGELOG.md מעתיקים את אותו עדכון (בלשון טכנית יותר).
- ה-PR יוצא ל-main → Railway דופלה → משתמשים רואים ב-
/school/whats_newבריענון הבא.