לוגו הנהגת ההורים
גרסה 1.0.0

אשף התקנה ראשונית

האשף זמין רק לפני התקנת המערכת. הוא בודק את החיבורים, מחבר תיקיית Google Drive, יוצר את מבנה הנתונים ומגדיר את משתמשת היו״ר הראשונה.

הכנות חד־פעמיות

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

📖 הצג מדריך
  1. פתחי פרויקט חדש ב־Google Apps Script בחשבון Google שישמש את הנהגת ההורים.
  2. פתחי בחבילה את apps-script/Code.gs, העתיקי את כל תוכנו והחליפי את תוכן Code.gs בפרויקט.
  3. העתיקי גם את תוכן apps-script/appsscript.json לקובץ manifest בפרויקט.
  4. לחצי Save.

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

📖 הצג מדריך
  1. פתחי Project Settings.
  2. ב־Script Properties לחצי Add script property.
  3. שם: API_KEY.
  4. ערך: מחרוזת אקראית ארוכה. שמרי אותה במקום בטוח לצורך Cloudflare.

חשוב: אין להעלות את המפתח ל־GitHub ואין לשלוח אותו לאחרים.

📖 הצג מדריך
  1. בחרי Deploy → New deployment → Web app.
  2. Execute as: Me.
  3. הגדירי גישה בהתאם לחשבון Google והוראות הארגון.
  4. לחצי Deploy ואשרי הרשאות ל־Google Drive ול־Google Sheets.
  5. שמרי את כתובת ה־Web App המסתיימת ב־/exec.

בדיקת הצלחה: פתיחת הכתובת בדפדפן מציגה תשובת JSON עם ok: true.

📖 הצג מדריך
  1. צרי מאגר GitHub פרטי.
  2. חלצי את קובץ ה־ZIP במחשב.
  3. העלי את כל התוכן שבתוך התיקייה הראשית של החבילה.
  4. בצעי Commit.

בדיקת הצלחה: בשורש המאגר מופיעים index.html, setup.html, functions ו־apps-script.

📖 הצג מדריך
  1. ב־Cloudflare Workers & Pages צרי פרויקט Pages וחברי את המאגר.
  2. ודאי שה־Production branch הוא main.
  3. הפרויקט משתמש ב־wrangler.toml; אין צורך לערוך אותו.
  4. המתיני לסטטוס Success.

בדיקת הצלחה: כתובת pages.dev של הפרויקט פותחת את האתר.

📖 הצג מדריך
  1. פתחי Settings → Variables and secrets.
  2. הוסיפי Secret בשם APPS_SCRIPT_URL ובערך הדביקי את כתובת ה־Web App.
  3. הוסיפי Secret בשם APPS_SCRIPT_API_KEY ובערך הדביקי את אותו מפתח שהוגדר כ־API_KEY ב־Apps Script.
  4. בצעי Redeploy לאחר השמירה.

בדיקת הצלחה: פתיחת /api/health מציגה ok: true.

📖 הצג מדריך
  1. ב־Google Drive צרי תיקייה חדשה וריקה.
  2. שם מומלץ: „מערכת הנהגת הורים — שם בית הספר”.
  3. אין צורך ליצור בתוכה תיקיות או קבצים.
  4. היכנסי לתיקייה והעתיקי את הקישור המלא משורת הכתובת.

חשוב: אין להפוך את התיקייה לציבורית. האשף יבדוק את הגישה דרך Apps Script.

אין קישור לאשף באתר הציבורי. מגיעים אליו לפי מדריך היו״ר בכתובת https://כתובת-האתר/setup. לאחר ההתקנה האשף ייחסם אוטומטית.

בדיקת חיבורים

הבדיקה אינה משנה נתונים. היא מוודאת שהאתר מתקשר עם Apps Script ושהמערכת עדיין אינה מותקנת.

פרטי המערכת ותיקיית Google Drive

כתובת זו תוגדר כמשתמשת היו״ר הראשונה.
הדביקי את הקישור המלא לתיקייה הריקה שיצרת.
📖 איך יוצרים ומעתיקים קישור לתיקיית Drive?
  1. פתחי Google Drive באותו חשבון שמפעיל את Apps Script.
  2. צרי תיקייה חדשה והיכנסי אליה.
  3. העתיקי את כתובת הדפדפן המלאה.
  4. אין לשנות את הגדרות השיתוף לציבוריות.

בדיקת תיקיית Google Drive

המערכת תנסה לפתוח את התיקייה באמצעות חשבון Google שמפעיל את Apps Script. בשלב זה לא ייווצרו קבצים.

התקנת המערכת

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