⚙️

מדריך ניהול האתר

הסבר מלא ומפורט לכל יכולות הניהול — הרשאות, ערוצים, הדפסות, לוגים, תבניות מכתבים, מערכת שעות, ועוד. לכל מודול יש תתי-סעיפים עם פירוט של כל כפתור, טאב ופעולה.

לא נמצאו תוצאות. נסו מילת חיפוש אחרת.

🎛️ דשבורד אדמין ראשי

ליבה

מסך הבית של המנהל — מרכז בקרה עם התראות על בקשות פתוחות, סיכום נוכחות היום, רשימת הצוות הרשום, סיכום כיתות, וקיצורי דרך לכל כלי הניהול.

פתחו את דשבורד הניהול
לפרטים נוספים ▾

🔔 התראות פעילות (למעלה)

  • בקשות גישה חדשות — עם אנימציית פעימה להדגשה.
  • הדפסות ממתינות לאישור — מונה + קישור לתור.

קיצורי דרך (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 לעיון מורחב.
💡 המעקב הזה הוא הכלי המרכזי שלך לראות מה כבר טופל ומה עוד מחכה — בלי להיכנס ל-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-גיליונות לשכר.
⚠️ קבצים מצורפים נשמרים על disk של Railway. לא מגובים ל-PostgreSQL. עבור מוסדות עם חשש אמיתי — לשקול s3/GCS.

💬 ערוצי צ׳אט — ניהול מלא

ליבה

יצירה, עריכה וארכוב של ערוצי הצ׳אט. כל ערוץ יכול להיות ציבורי/פרטי/מערכת, נדרש תגים מסוימים, AI שעונה אוטומטית, והרשאות override פרטיות.

פתחו את ניהול הערוצים
לפרטים נוספים ▾

טבלת ערוצים

  • שם · תיאור · סוג (ציבורי/פרטי/מערכת) · תגים נדרשים · מספר overrides · AI פעיל · סטטוס.
  • לחצן הצג פעילים/כולל מוארכבים.

יצירת ערוץ חדש

  • שם (חובה) + תיאור קצר.
  • סוג:
    • ציבורי — כל מורה רואה.
    • פרטי — רק למי שיש את התגים הנדרשים.
    • מערכת — התראות אוטומטיות בלבד.
  • תגים לגישה — multiselect.
  • AI detection — האם המודל יענה על שאלות בערוץ.

עורך ערוץ (מסך נפרד)

  • עריכת כל השדות + ניהול הרשאות ידני.
  • Overrides פרטיים: הוספה/הסרה של מורה ספציפי לגישה אישית (בהתעלם מתגים).

ארכוב

  • ערוץ מוארכב — לא נעלם, אך לא מופיע ברשימה הראשית.
  • ניתן לשחזר בכל שלב.

👥 נוכחות צוות — תצוגת ניהול

יומיומי

מסך למנהל לראות מי דיווח מה היום — פרונטלי / מהבית / מחלה / חריג — וגם מי לא דיווח בכלל.

פתחו את ניהול הצוות
לפרטים נוספים ▾

בוחר תאריך

  • GET — ניתן לבחור גם ימים קודמים.

כרטיסי סיכום

  • פרונטליים · מהבית · חופשת מחלה · חריג · לא דיווחו.

טבלת דיווחים

  • שם · סטטוס (צבעוני) · הערה חופשית.

טבלת "לא דיווחו"

  • רשימה מודגשת של צוות שחסרה דיווח — למנהל ליצור קשר.

📚 שיעורים פרטניים — תצוגת ניהול

יומיומי

סיכום יומי של כל השיעורים הפרטניים והקבוצתיים שדיווחו המורים — כולל מצב (פרונטלי/טלפוני), תלמידים, ונושא השיעור.

פתחו את ניהול הלמידה
לפרטים נוספים ▾
  • בחירת תאריך.
  • כרטיסי סיכום: פרונטלי · טלפוני · סה״כ תלמידים.
  • טבלה: מורה · מצב · מספר תלמידים · שמות (מקוצרים) · נושא (מקוצר).

⚠️ אילוצי חירום — תצוגת ניהול

מצבי חירום

סיכום מרוכז של כל דיווחי האילוצים למצבי חירום — עם הדגשה של מי לא יוכל להגיע מחר ומי יציע אשתו כתחליף.

פתחו את ניהול האילוצים
לפרטים נוספים ▾
  • בחירת תאריך.
  • כרטיסי סיכום: לא יוכל לבוא (🔴) · אשתו תבוא (🟡) · יבוא (🟢).
  • "לא יכולים לבוא מחר" — טבלה עם מסגרת אדומה: שם, מסגרות ילדים (עם badges), הערות.
  • "אשתי תבוא במקומי" — טבלה צהובה, מבנה דומה.
  • "כל הדיווחים" — מטריצת סטטוס של כל הצוות.

🔓 בקשות גישה — מורים חדשים

חשוב

מורים חדשים שניסו להתחבר ועדיין לא קיימים במערכת מגיעים לתור בקשות גישה. המנהל מאשר — או מקשר למורה קיים, או יוצר רשומה חדשה.

פתחו את בקשות הגישה
לפרטים נוספים ▾

בקשות ממתינות

  • כרטיסי אזהרה עם: שם, תפקיד, דוא״ל, זמן בקשה.
  • כפתורי "אשר" / "דחה".

מודאל אישור

  • סיכום הבקשה.
  • בחירה:
    • קשר למורה קיים ברשימה (למשל הוא שינה דוא״ל).
    • צור מורה חדש — מזינים שם, דוא״ל, אם מנהל.

היסטוריה

  • בקשות שטופלו (מתקפל) — עם שם המורה שנוצר/קושר.

📧 חשבונות מייל משותפים

ליבה

ניהול חשבונות Google/Gmail שבית הספר משתמש בהם לשליחת מיילים רשמיים (רישום, מכתבים, דוחות). OAuth מוצפן; ניתן להתנתק בכל שלב.

פתחו את חשבונות המייל
לפרטים נוספים ▾

איך זה עובד

  • 1. מתחברים לחשבון הגוגל דרך OAuth (מסך גוגל הרשמי).
  • 2. הטוקן נשמר מוצפן (עם SCHOOL_TOKEN_ENCRYPTION_KEY).
  • 3. אדמינים/מזכירות יכולים לשלוח מיילים "מטעם" החשבון.
  • 4. ניתן לנתק בכל רגע — הטוקן נמחק.

כרטיסי חשבון

  • שם תצוגה · דוא״ל · תיאור · סטטוס חיבור.
  • כשמחובר: זמן חיבור · תוקף טוקן.
  • כפתורי "חבר" (פותח OAuth) או "נתק" (אישור).
⚠️ אם OAuth לא מוגדר בכלל — באנר אזהרה. יש לקבוע Client ID ב-Railway env vars.

📊 סקרים — יצירה וניתוח

תקופתי

יצירה של סקרים פנימיים (לצוות) או חיצוניים (להורים), עם שדות מותאמים, צפייה בתשובות, וייצוא ל-CSV לניתוח.

פתחו את מסך הסקרים
לפרטים נוספים ▾

יצירת סקר

  • כותרת · תיאור/הוראות · שדות מותאמים (רשימה מופרדת בפסיקים).

טבלת סקרים

  • כותרת · מספר תגובות · סטטוס (פעיל/סגור) · URL להעתקה · פעולות.
  • צפייה · עריכה · פתיחה/סגירה.

עורך סקר

  • עריכת שדות, סידור מחדש (drag&drop), מחיקת שדות.

צפייה בתשובות

  • טבלה עם כיתה, שדות מותאמים, זמן שליחה.
  • סינון לפי כיתה.
  • ייצוא CSV.

📄 תבניות מכתבים

ליבה

ניהול תבניות DOCX (Word) לכל סוגי המכתבים שהאתר מייצר. התבנית חייבת לכלול placeholder {{CONTENT}} שיוחלף בתוכן המכתב בזמן ההפקה. ההפקה הסופית היא PDF נעול.

פתחו את תבניות המכתבים
לפרטים נוספים ▾

מבנה תבנית

  • קובץ DOCX רגיל מ-Word.
  • כותרת עליונה עם לוגו בית הספר.
  • Placeholder — {{CONTENT}} — יוחלף בתוכן.
  • חתימת מנהל או שורה לחותמת.

העלאה (פאנל שמאלי)

  • סוג מכתב — dropdown (קבלה, דחייה, הודעה להורים, אחר).
  • שם תצוגה (אופציונלי).
  • קובץ DOCX (עד 5MB).
  • צ׳קבוקס "ברירת מחדל לסוג זה".

רשימת תבניות (פאנל ימני)

  • שם + באדג׳ "ברירת מחדל" · באדג׳ סוג · גודל ב-KB.
  • הורדה · הפוך לברירת מחדל · מחיקה.
💡 הפקת המכתב הסופית בפורמט PDF (נעול מעריכה) כדי למנוע שינויים אחרי החתימה.

📬 יומן שליחת מכתבים

מעקב

היסטוריה מלאה של כל מכתב שנשלח דרך האתר — מי שלח, למי, איזה סוג, סטטוס המסירה, ותאריך.

פתחו את יומן המכתבים
לפרטים נוספים ▾

סינונים

  • טווח תאריכים · מורה · סוג תבנית · סטטוס.

שורות בטבלה

  • זמן · מורה · נמען · סוג מכתב · דוא״ל נמען · סטטוס (נשלח/נכשל/ממתין) · זמן מסירה.
  • כפתור "צפה בדוא״ל" · כפתור "שלח שוב" (אם נכשל).

🖋️ חתימות דיגיטליות

ליבה

העלאה ועריכה של חתימות דיגיטליות (PNG) לכל מורה. החתימה משולבת אוטומטית בכל מכתב שהמורה שולח, ובדפי חתימה להדפסה.

פתחו את ניהול החתימות
לפרטים נוספים ▾

העלאה (פאנל שמאל)

  • Dropdown בחירת מורה.
  • העלאת קובץ PNG (מומלץ רקע שקוף).

רשימת מורים (פאנל ימין)

  • חיפוש/סינון לפי שם.
  • כל שורה: שם + badges (אדמין / יש חתימה).
  • תצוגה מקדימה של החתימה.
  • החלפה / מחיקה.
💡 מומלץ סריקה ברקע שקוף ופורמט PNG לאיכות מיטבית.

📜 לוגי מערכת ואבחון

אבחון

חלון לוגים חי — מציג את כל פעילות השרת בזמן אמת. כולל סינון לפי רמה, מודול, טקסט, רענון אוטומטי, וכפתור "שלח ל-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 לכל שורה — לבחירה אילו תורנויות לשמור.
  • "בחר הכל" / "נקה" / "שמור".
💡 הפיצ׳ר מתאים במיוחד כשמקבלים דפי תורנויות מודפסים ואין גרסת Excel.

🎓 הרשאות ייעוץ והכלה

ליבה

הרשאות ייעודיות למערכת הייעוץ — שונות ומורכבות יותר מ"הרשאות רגילות" כי יש 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 אם נחוץ.
⚠️ אם חושדים באובדן נתונים — פנו למנהל המערכת הטכני לבדיקת ה-PG.

💡 פאנל רעיונות (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 בריענון הבא.
💡 מדיניות — רק שינויים גלויים למשתמש נכנסים ל-whats_new. רפקטור פנימי לא נכנס (נכנס רק ל-CHANGELOG.md).