PuzzleRoster
1. אודות PuzzleRoster
מערכת PuzzleRoster פותחה עבור מרכזים מדעיים-חינוכיים המציעים לימוד מעמיק של מקצועות ספציפיים (פיזיקה ו/או כימיה) לתלמידים מבתי ספר שונים. למרכזים כאלה יש דרישות ייחודיות לבניית מערכת לוח זמנים — יש לתאם ימים ושעות לימוד מול כל בתי הספר שמהם מגיעים התלמידים לקבוצות הלימוד. האפליקציה מקלה על קטגוריות שונות של עובדים — מנהלים, מורים, עוזרי מעבדה — לנהל עשרות תהליכי עבודה: מתיאום מול בתי ספר שותפים ועד הקצאת מעבדות וכיתות לימוד בהתאם לציוד שהוזמן על ידי המורים. המערכת מאפשרת להנהלת המרכז לנהל את עומס העבודה של המורים (סך שעות עבודה, שעות הוראה, מספר תלמידים בקבוצות) ולקבל החלטות ניהוליות שונות. המערכת גם אוספת, מעבדת ומנתחת את כל הנתונים הסטטיסטיים הקשורים לפעילות המרכז.
- ללא הגבלהעל מספר בתי הספר השותפים
- קיבוץ גמישתלמידים מבתי ספר שונים
- הקצאה חכמהשל מעבדות לפי פרמטרים מוגדרים
- חיפוש מובנהשל מורה מחליף
- לוח אישילכל מורה
- מסכי מסדרוןלמורים ולתלמידים
2. מי עובד במערכת
במערכת שמונה תפקידים. לעובד אחד ניתן להקצות מספר תפקידים בו-זמנית.
| תפקיד | מי זה | מה עושה במערכת |
|---|---|---|
| סופר-אדמין | מנהל טכני | גישה מלאה. ניהול טבלאות עזר, עובדים והגדרות כלליות. |
| אדמין | כל עובד עם הרשאות ניהול — כולל כתפקיד נוסף | בוחן בקשות נכנסות לשינויים בלוח הזמנים, מבהיר פרטים ומאשר אותן. התפקיד היחיד שמבצע בפועל שינויים בנתונים — אישור או דחייה. |
| מורה | מורה מקצועי | יוזם שינויים בלוח הזמנים: דחיות, ביטולים, החלפות, הזמנת ציוד. הכל מנוסח כבקשה למנהל — המורה אינו משנה דבר ישירות. |
| מעבדן/ית | עובד/ת מעבדה | רואה רשימת שיעורים קרובים עם ציוד שהוזמן. מכין ומספק ערכות. לא יוצר ולא משנה הזמנות — רק מבצע. |
| מנהל | מנהל המרכז החינוכי | צפייה מלאה בלוח הזמנים ובדוחות לכל תקופה. מנהל את עומס העבודה של המורים וקובע החלפות. יכול גם ללמד שיעורים (אם משויך כמורה). |
| רכז/ת | רכז/ת מקצוע | צפייה בלוח הזמנים ובדוחות עבור מורי המקצוע שלו. מנהל עומס עבודה וקובע החלפות. יכול גם ללמד שיעורים (אם משויך כמורה). |
| מזכיר/ה | מזכיר/ת משרד | קריאה בלבד: לוח זמנים מלא, כל הדוחות, כל תקופה. אינו יכול לבצע שינויים. |
| מתאם/ת | מתאם/ת עבודה מול בתי ספר | מנהל את התקשורת מול בתי הספר מטעם המרכז. מלווה בתי ספר שותפים, מתאם עניינים לוגיסטיים. |
3. תהליכים עיקריים
3.1 תבנית שנתית והפצת שינויים
לוח הזמנים בנוי בשתי רמות. הרמה העליונה — תבנית שבועית שנתית: העומס הסטנדרטי של כל מורה וקבוצה. הרמה התחתונה — לוח הזמנים בפועל שבוע אחר שבוע לאורך כל השנה, הנבנה מתוך התבנית הזו.
archived: נעלם לגמרי מכל לוחות הזמנים והתצוגות, כך שעד סוף השנה
לא מצטברים "שיעורי רפאים", אך נשאר פיזית בטבלה — מפתחות זרים מהיסטוריית הבקשות והביקורת אינם
מאפשרים למחוק אותו.
3.2 שינויים בלוח הזמנים
לוח הזמנים נבנה לשנת הלימודים, אך התאמות יומיומיות מתעוררות כל הזמן. המערכת מנתבת אותן במסלול ברור:
3.3 הכנת ציוד
3.4 החלפת מורה
אם מורה אינו יכול ללמד שיעור, האדמין, המנהל או סגן המנהל בוחרים מחליף מתוך רשימת המורים הזמינים באותו זמן עם פרופיל מקצוע מתאים. השיעור מוצג מיד כהחלפה בכל מקום — בלוח הזמנים ובתצוגות המסדרון.
3.5 אכלוס המערכת בנתונים (תהליך עבודה)
הנתונים מוזנים בסדר מחייב — כל שלב תלוי בקודם.
- 11 טבלאות — אכלוס ראשוני של המערכת (bootstrap)
- 2 טבלאות — קטלוגי ניסויים (פיזיקה וכימיה)
- 2 טבלאות — בקשות ותכתובת
- 4 טבלאות — נעילות וצילומי מצב של יום
- 2 טבלאות — היסטוריה ויומנים
- 1 טבלה — הרשאות גישה
- 4 טבלאות — תור מיילים, כללים, כתובות שולחים, סטטוס משלוח
- 1 טבלה — הגדרות מערכת
- 2 טבלאות — לוח שנה אקדמי
- 2 טבלאות — נתוני צוות
4. ממה מורכבת המערכת
המערכת בנויה ממספר רכיבים עצמאיים, כל אחד אחראי על חלקו:
| רכיב | מה עושה |
|---|---|
| בסיס נתונים | שומר את כל הנתונים ואוכף את כל הכללים: בדיקות, נעילות, היסטוריית שינויים |
| שרת API | מקבל בקשות, בודק מי רשאי לעשות מה, מעביר פקודות לבסיס הנתונים |
| ממשק web | PuzzleRoster כולו בעברית (RTL) |
| תצוגות מסדרון | מסכים ייעודיים לאולמות המרכז — לוח הזמנים העדכני של היום עבור מורים, וגרסה פשוטה עבור תלמידים, ללא כניסה אישית (באמצעות מפתח מכשיר סטטי) |
| התראות | צינור מבוסס אירועים: כל פעולה (בקשה הוגשה/אושרה/נדחתה, הזמנת ציוד, חילוף מורה, תחזוקת שרת) רושמת אירוע לתור בתוך אותה טרנזקציה — כשל ברישום לעולם לא חוסם את הפעולה עצמה. תהליך רקע קובע את הנמענים לפי תפקיד, מקצוע ומשתתפי האירוע מתוך טבלת כללים, בונה את ההודעה ושולח אותה דרך ספק דוא"ל טרנזקציוני — עם ניסיונות חוזרים אוטומטיים ומתג כיבוי לאדמין. ערוצי מסרים (Telegram, WhatsApp) נותרים כיוון פיתוח אפשרי. |
| תשתית | פרוסה בקונטיינרים של Docker על שרת AWS, עם גיבוי אוטומטי יומי של בסיס הנתונים |
5. אמינות ואבטחה
- כל משתמש מקבל token גישה לאחר כניסה. ה-token תקף למשך שעתיים (יציאה אוטומטית לאחר 30 דקות של חוסר פעילות) ומכיל מידע על תפקידו. ללא token תקף — אין גישה כלל.
- כל הכללים נאכפים ברמת בסיס הנתונים — אין דרך לעקוף אותם דרך הממשק.
- ה-backend מתחבר לבסיס הנתונים תחת תפקיד נפרד ומצומצם: ממנו נשללו בפועל הרשאות
INSERT/DELETEישירות על טבלאות השיעורים, היומנים וסשני העריכה — כל שינוי בלוח הזמנים אפשרי רק דרך פונקציות מאוחסנות עם הרשאות מוגברות במפורש (SECURITY DEFINER). - היסטוריית השינויים אינה ניתנת לשינוי או מחיקה — על ידי אף משתמש, בשום תפקיד. כך מובטחת שקיפות מלאה לכל פעולה במערכת.
- המערכת חוסמת אוטומטית התנגשויות בלוח הזמנים.
- הגישה לאינטרנט מבוססת על עקרון Zero Trust — דרך Cloudflare Tunnel.
- 391 בדיקות רגרסיה אוטומטיות (ברמת ה-API ובסיס הנתונים) שרצות לפני כל דיפלוי — בודקות את תהליכי אישור הבקשות, חילופי מורים, מנגנון הקפאה/שחזור של יום, מניעת התנגשויות בלוח הזמנים (EXCLUDE USING GIST), הזמנות ציוד, ומטריצת כללי ההתראות.