diff --git a/server/src/migrations/1792348261458-RefreshPagesContent.ts b/server/src/migrations/1792348261458-RefreshPagesContent.ts new file mode 100644 index 00000000..4ffc747d --- /dev/null +++ b/server/src/migrations/1792348261458-RefreshPagesContent.ts @@ -0,0 +1,121 @@ +import { MigrationInterface, QueryRunner } from "typeorm"; + +const pages = [ + { + "order": 1, + "description": "היכרות עם המערכת ומבנה התפריט", + "value": "

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

\n

התפריט בצד המסך מחולק לקבוצות:

\n\n

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

\n

שנת לימודים: כל הנתונים נשמרים לפי שנה עברית. בבורר השנה אפשר לעבור בין שנים ולראות נתונים של שנים קודמות. שנה חדשה מתחילה ב-1 בספטמבר.

\n

מסך הבית: מציג תמונת מצב של נתונים מרכזיים. אפשר לבחור מה יוצג בו במסך הגדרות משתמש.

" + }, + { + "order": 2, + "description": "פתיחת שנת לימודים: סדר עבודה מומלץ", + "value": "

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

\n
    \n
  1. שיוך כיתות: סוגי הכיתות במוסד, למשל כיתת אם, מסלול או התמחות. הסוג קובע איך הכיתה תופיע בדוחות ובתעודה.
  2. \n
  3. כיתות: לכל כיתה מפתח (מספר), שם ושיוך כיתה. אפשר להוסיף שם לתעודה, סדר הצגה ומספר טלפון של הכיתה לדיווח טלפוני.
  4. \n
  5. מורות: תעודת זהות, שם, מספר מורה (משמש כקוד בדיווח טלפוני), טלפון ומייל (לשליחת קבצי דיווח).
  6. \n
  7. שיעורים: לכל שיעור מפתח, שם, כיתה אחת או יותר ומורה. אפשר להגדיר תאריכי התחלה וסיום ושם לתעודה.
  8. \n
  9. תלמידות: תעודת זהות ושם, ואם רוצים גם מספר תלמידה, טלפון וכתובת.
  10. \n
  11. שיוך תלמידות לכיתות: באיזו כיתה לומדת כל תלמידה. תלמידה יכולה להיות משויכת לכמה כיתות, למשל כיתת אם ומסלול.
  12. \n
  13. תקופות דיווח: חלוקת השנה לתקופות (בדרך כלל חודשים) ולמחציות. לפיהן נבנים קבצי הדיווח למורות והדוחות.
  14. \n
  15. ציונים והשפעת נוכחות (לא חובה): שמות ציונים, שמות נוכחות וקשר נוכחות ציון.
  16. \n
  17. הגדרות משתמש: שווי איחור, הגדרות תעודה, פרטי שולח למיילים וזמני שיעורים.
  18. \n
\n

טיפ: אין צורך להקליד שורה אחרי שורה. כל הטבלאות האלה אפשר לייבא מקובץ אקסל, כמוסבר בדף \"ייבוא נתונים מאקסל\".

" + }, + { + "order": 3, + "description": "ייבוא נתונים מאקסל", + "value": "

כמעט בכל טבלה במערכת יש כפתור ייבא שמאפשר להעלות קובץ אקסל במקום להקליד את הנתונים.

\n
    \n
  1. היכנסו לטבלה הרצויה, למשל נתונים › תלמידות.
  2. \n
  3. לחצו על סימן המידע ליד כפתור הייבוא כדי לראות אילו עמודות הקובץ צריך לכלול ובאיזה סדר. משם אפשר גם להוריד קובץ לדוגמה עם הכותרות הנכונות.
  4. \n
  5. מלאו את הקובץ ולחצו ייבא. לפני השמירה תוצג תצוגה מקדימה של השורות.
  6. \n
  7. אשרו את השמירה. בסיום תופיע הודעה כמה שורות נשמרו ואם היו שגיאות.
  8. \n
\n

חשוב לדעת:

\n" + }, + { + "order": 4, + "description": "ייבוא אוטומטי במייל", + "value": "

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

\n
    \n
  1. היכנסו להגדרות › כתובות מייל והוסיפו כתובת לטבלה הרצויה, למשל לנוכחות או לציונים. לכל טבלה כתובת נפרדת משלה.
  2. \n
  3. שלחו לכתובת הזו מייל עם קובץ האקסל המצורף.
  4. \n
  5. המערכת מייבאת את הקובץ ומחזירה מייל תשובה עם התוצאה. קבצים שנכשלו מודגשים בתשובה, ושגיאות מסומנות באדום.
  6. \n
\n

כל קובץ שהתקבל במייל מופיע גם במסך קבצים שיובאו, בדיוק כמו ייבוא מהאתר.

\n

במסך הגדרות משתמש אפשר לקבוע את שם השולח ואת כתובת השולח שיופיעו במיילים שהמערכת שולחת.

" + }, + { + "order": 5, + "description": "קבצי דיווח למורות: שליחה, מילוי וקליטה", + "value": "

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

\n

שליחת הקבצים

\n
    \n
  1. היכנסו לדוחות › דיווחים למורה. לכל מורה ותקופת דיווח מוצגים השיעורים שכבר דווחו והשיעורים שעדיין לא.
  2. \n
  3. סמנו את המורות הרצויות ובחרו הורדת אקסל למורה כדי להוריד את הקבצים, או שליחת אקסל למורה כדי לשלוח אותם ישירות למייל של המורה. בשליחה אפשר לכתוב נושא ותוכן למייל ולבחור שיעור מסוים.
  4. \n
  5. הקובץ נבנה רק לשיעורים שעוד לא דווחו בתקופה, ושם החודש מופיע בו.
  6. \n
\n

מילוי הקובץ

\n

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

\n

קליטת הקובץ

\n\n

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

" + }, + { + "order": 6, + "description": "דיווח נוכחות וציונים בזמן השיעור", + "value": "

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

\n
    \n
  1. בוחרים מורה מתוך רשימה או לפי תעודת זהות.
  2. \n
  3. בוחרים שיעור מתוך רשימה או לפי מספר השיעור, ולוחצים הצג שיעור.
  4. \n
  5. מופיעה רשימת התלמידות בכיתה. לכל תלמידה מסמנים חיסורים ואיחורים (או ציון בטופס הציונים) ואפשר להוסיף הערה.
  6. \n
  7. מגדירים את מספר השיעורים ואת תאריך הדיווח. אפשר להוסיף כמה תאריכים באותו טופס.
  8. \n
  9. שומרים. הדיווח נכנס מיד לטבלת הנוכחות ולכל הדוחות.
  10. \n
\n

תלמידה שסומנה כ\"לא פעילה\" לא מופיעה בטופס.

\n

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

" + }, + { + "order": 7, + "description": "דיווח נוכחות בטלפון", + "value": "

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

\n

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

\n

מהלך השיחה

\n
    \n
  1. אם השיחה מגיעה ממספר הטלפון שהוגדר לכיתה, הכיתה מזוהה אוטומטית. אחרת המערכת מבקשת להקיש את מספר הכיתה.
  2. \n
  3. המורה מקישה את מספר המורה שלה. אפשר להקיש כוכבית כדי לחזור ולבחור כיתה אחרת.
  4. \n
  5. המערכת בוחרת את השיעור לפי מערכת השעות של היום ולפי השעה. אם אין התאמה, היא מבקשת להקיש את מספר השיעור.
  6. \n
  7. המורה מקישה את מספרי התלמידות שחסרו, אחת אחרי השנייה. המערכת מקריאה את שם התלמידה ומבקשת אישור לפני שהיא רושמת את החיסור.
  8. \n
  9. כל שאר התלמידות בכיתה נרשמות כנוכחות.
  10. \n
\n

אם המורה כבר דיווחה על אותו שיעור היום, המערכת שואלת אם להחליף את הדיווח הקודם.

\n

דיווח למנהלת: אם מוגדר \"טלפון מנהלת\" במסך ההגדרות, שיחה מהמספר הזה משמיעה אילו מורות כבר דיווחו היום ואילו עדיין לא, לפי מערכת השעות.

\n

את הנוסחים שמושמעים בשיחה אפשר להתאים בהגדרות › הודעות.

" + }, + { + "order": 8, + "description": "מערכת שעות", + "value": "

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

\n

מערכת השעות מאפשרת לזהות אוטומטית את השיעור בדיווח הטלפוני ולדעת אילו מורות היו אמורות לדווח בכל יום.

\n\n

מערכת השעות משמשת גם את דוח \"מורות שדיווחו נוכחות\" ואת שיחת הדיווח למנהלת.

" + }, + { + "order": 9, + "description": "מעקב אחרי דיווחי המורות", + "value": "

כמה מסכים עוזרים לדעת מי דיווחה ומי צריכה תזכורת:

\n" + }, + { + "order": 10, + "description": "חיסורים מאושרים", + "value": "

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

\n

דרכים להזין חיסור מאושר

\n\n

במסך החיסורים המאושרים אפשר לסמן שורות ולבחור אישור חיסורים לתלמידה.

\n

סוגי אירועים לפי הרשאה: אפשר להגדיר סוגי אירועים עם מכסה שנתית, שדות חובה וחובת צירוף קובץ, ולשייך כל חיסור מאושר לסוג.

" + }, + { + "order": 11, + "description": "איחורים ואיך הם נספרים", + "value": "

מורות יכולות לדווח איחורים בקובץ הדיווח, בטופס הדיווח בזמן השיעור ובטלפון.

\n

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

\n

איחורי הסעות לפי הרשאה: כשההסעה מאחרת, תלמידה מתקשרת למערכת הטלפונית, מקישה תעודת זהות ומספר הסעה ומאשרת את שעת היציאה. המערכת רושמת חיסור מאושר עם ציון ההסעה. את רשימת ההסעות מגדירים בנתונים › הסעות.

" + }, + { + "order": 12, + "description": "ציונים וקשר בין נוכחות לציון", + "value": "

הזנת ציונים: בנתונים › ציונים, ידנית או בייבוא מאקסל, בטופס ציונים בזמן השיעור או בקבצי ציונים למורות.

\n

שמות ציונים (הגדרות): אפשר לתרגם ציון מספרי לתיאור מילולי, למשל 90 ומעלה הוא \"מצוין\". אפשר להגדיר שמות שונים לפי שיוך כיתה.

\n

שמות נוכחות (הגדרות): תיאור מילולי לאחוזי נוכחות, שיופיע בתעודה.

\n

קשר נוכחות ציון (הגדרות): קובע איך הנוכחות משפיעה על הציון הסופי. לפי אחוז נוכחות או לפי מספר חיסורים מגדירים השפעה בנקודות או באחוזים. למשל, מתחת ל-80% נוכחות יורדות 5 נקודות מהציון.

\n

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

" + }, + { + "order": 13, + "description": "מדריך לדוחות", + "value": "

כל הדוחות נמצאים בקבוצת דוחות בתפריט. בכולם אפשר לסנן ולייצא לאקסל.

\n\n

יומן נוכחות לכיתה: במסך כיתות מסמנים כיתות ובוחרים הורד יומן נוכחות כדי לקבל קובץ מסודר לכל כיתה.

" + }, + { + "order": 14, + "description": "הפקת תעודות", + "value": "

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

\n
    \n
  1. היכנסו לנתונים › תלמידות וסמנו את התלמידות הרצויות. אפשר לסמן כיתה שלמה בעזרת הסינון.
  2. \n
  3. לחצו על כפתור התעודה ובחרו את האפשרויות: טווח תאריכים, הצגת נוכחות או ציונים, קיבוץ לפי כיתה, ציון אחרון במקום ממוצע, סינון לפי ציון נמוך מסף ועוד.
  4. \n
  5. התעודות יורדו כקובץ אחד.
  6. \n
\n

הגדרות קבועות במסך הגדרות משתמש:

\n\n

שמות הכיתות, השיעורים והמורות בתעודה נלקחים מהשדה \"שם לתעודה\" אם מילאתם אותו.

" + }, + { + "order": 15, + "description": "פעולות על כמה שורות יחד", + "value": "

בכל טבלה אפשר לסמן כמה שורות. הפעולות הזמינות תלויות במסך:

\n\n

שימו לב: הפעולה חלה על כל השורות המסומנות בבת אחת. לפני האישור ודאו שהסינון נכון ושסומנו רק השורות הרצויות.

" + }, + { + "order": 16, + "description": "ניקוי נוכחות אוטומטי", + "value": "

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

\n

כללי ניקוי מתאימים לשיעור שבו רק חלק מהתלמידות אמורות להשתתף. הכלל מוחק אוטומטית את הנוכחות של התלמידות שלא שייכות לכיתה או למסלול שנבחרו.

\n" + }, + { + "order": 17, + "description": "קבוצות דיווח וחתימה דיגיטלית", + "value": "

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

\n

מיועד למסגרות שנדרשות להגיש תיעוד חתום של כל מפגש, למשל לתמ״ת.

\n" + }, + { + "order": 18, + "description": "הגדרות משתמש", + "value": "

במסך הגדרות משתמש קובעים איך המערכת עובדת אצלכם:

\n" + }, + { + "order": 19, + "description": "שאלות נפוצות ופנייה לתמיכה", + "value": "

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

\n

תלמידה לא מופיעה בקובץ הדיווח או בטופס.
בדקו שהיא משויכת לכיתה של השיעור בשיוך תלמידות לכיתות, שהיא מסומנת \"פעילה\", ושבורר השנה מוגדר לשנה הנכונה.

\n

הנתונים של שנה שעברה נעלמו.
הם לא נמחקו. בחרו את השנה הקודמת בבורר השנה.

\n

שלחתי קובץ במייל ולא קיבלתי תשובה.
ודאו שהמייל נשלח בדיוק לכתובת שמופיעה בהגדרות › כתובות מייל, ובדקו גם את תיבת הספאם. אם הגיעה תשובה בלי רשימת קבצים, הקובץ לא זוהה כאקסל: יש לצרף קובץ xlsx או xls.

\n

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

\n

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

\n

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

" + } +]; + +export class RefreshPagesContent1792348261458 implements MigrationInterface { + name = 'RefreshPagesContent1792348261458' + + public async up(queryRunner: QueryRunner): Promise { + await queryRunner.query(`DELETE FROM \`page\``); + for (const page of pages) { + await queryRunner.query( + `INSERT INTO \`page\` (\`description\`, \`value\`, \`order\`) VALUES (?, ?, ?)`, + [page.description, page.value, page.order], + ); + } + } + + public async down(queryRunner: QueryRunner): Promise { + // Previous content is not restorable; only remove the rows added here. + await queryRunner.query( + `DELETE FROM \`page\` WHERE \`description\` IN (?)`, + [pages.map(page => page.description)], + ); + } +}