גרסה 1.0.0

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

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

בחירת ארכיטקטורת המערכת

לפני תחילת ההתקנה יש לבחור את התשתית שעליה תרוץ המערכת. הבחירה קובעת אילו שלבי הכנה יופיעו בהמשך האשף.

Google Drive + Apps Scriptהארכיטקטורה הקיימת והנבדקת. הנתונים נשמרים בגיליונות Google Sheets בתוך תיקיית Drive ייעודית, והשרת רץ על Google Apps Script.

Cloudflare (D1 + R2)ארכיטקטורה חדשה, ללא תלות בחשבון Google — הנתונים נשמרים במסד נתונים D1 וקבצים באחסון R2, שניהם על גבי Cloudflare בלבד. שלב הקמת התשתית האוטומטי כבר זמין; שלב יצירת היו״ר והוועדות בפועל על גבי ארכיטקטורה זו עדיין בפיתוח, ולכן האשף יעצור בשלב זה לאחר הקמת התשתית.

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

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

יצרתי פרויקט Google Apps Script והעתקתי אליו את קובצי המערכתCode.gs ו־appsscript.json

📖 הצג מדריך

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

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

הגדרתי API_KEY ב־Apps Scriptמפתח סודי ארוך ואקראי

📖 הצג מדריך

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

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

פרסמתי את Apps Script כ־Web Appכתובת שמסתיימת ב־/exec

📖 הצג מדריך

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

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

העליתי את תוכן החבילה למאגר GitHubאת התוכן שבתיקייה, לא תיקייה נוספת מעליו

📖 הצג מדריך

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

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

חיברתי את GitHub ל־Cloudflare Pagesוהפריסה הסתיימה בהצלחה

📖 הצג מדריך

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

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

הגדרתי שני Secrets ב־CloudflareAPPS_SCRIPT_URL ו־APPS_SCRIPT_API_KEY

📖 הצג מדריך

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

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

יצרתי תיקיית Google Drive ריקהבאותו חשבון שמפעיל את Apps Script

📖 הצג מדריך

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

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

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

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

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

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

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

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

התקנת המערכת

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

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

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

יצרתי חשבון Cloudflare ייעודיניתן להשתמש בכל כתובת דוא״ל

📖 הצג מדריך

היכנסי אל dash.cloudflare.com ופתחי חשבון חדש.
אין צורך בהגדרות מיוחדות בשלב זה — שאר ההקמה תתבצע דרך האשף.

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

📖 הצג מדריך

ב־Cloudflare Dashboard בחרי R2 מהתפריט הצדדי.
לחצי Enable R2 והזיני פרטי אמצעי תשלום.
שלב זה מתבצע פעם אחת בלבד לכל חשבון ואינו ניתן לאוטומציה.

יצרתי Token API מוגבל הרשאותיש להדביק אותו בשלב הבא — כאן באשף, לא בממשק Cloudflare

📖 הצג מדריך

My Profile → API Tokens → Create Token → Custom token.
הרשאות נדרשות: Account - D1:Edit, Account - Workers R2 Storage:Edit, Account - Cloudflare Pages:Edit.
הגבילי את ה־Token לחשבון הספציפי הזה בלבד, לא ל־All accounts.
בסיום, Cloudflare מציגה את ה־Token פעם אחת בלבד — העתיקי אותו מיד; לא ניתן לחזור ולראות אותו אחר כך (אם פספסת, פשוט צרי Token חדש).
מה עושים איתו: אין להזין אותו בשום מקום בממשק Cloudflare עצמו. יש להדביק אותו כאן, באשף — בשלב הבא (״הקמת תשתית״), בשדה Cloudflare API Token.

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

הקמת תשתית Cloudflare

הפעולה יוצרת (או מאתרת, אם כבר קיימים) את פרויקט ה־Pages עצמו, מסד D1 ודלי R2, ומחברת את המשאבים הללו יחד עם משתני הסביבה הנדרשים. אין צורך שהפרויקט יתקיים מראש — ניתן להריץ את האשף כולו מקומית (למשל דרך wrangler pages dev) בלי לפרסם דבר. הפעולה בטוחה להרצה חוזרת — משאבים קיימים לא נמחקים ולא נוצרים מחדש.

Cloudflare API Tokenהדביקי כאן את ה־Token שיצרת ב־Cloudflare בשלב הקודם (My Profile → API Tokens). הוא נשלח פעם אחת לצורך ההקמה בלבד ואינו נשמר — לא בדפדפן ולא בשרת.

Account ID

School ID

שם פרויקט ה־Pagesייווצר אוטומטית אם אינו קיים עדיין (פרויקט direct-upload, בלי חיבור ל־Git).

⚙️ אפשרויות מתקדמות

סביבה (לא חובה)

שם מסד D1 (לא חובה)

שם דלי R2 (לא חובה)

אזור מסוכן — איפוס מערכת

הפעולה מוחקת לצמיתות את כל הנתונים במסד ה־D1 ואת כל הקבצים בדלי ה־R2 של הפרויקט המוגדר למעלה (Account ID / סביבה / שמות מסד ודלי). מבנה הנתונים, החיבורים (bindings) והסוד השמור נשארים — ניתן להתקין מחדש מיד לאחר האיפוס בלי להריץ שוב את הקמת התשתית. אין להשתמש בפעולה זו על סביבת RC או Production עם נתונים אמיתיים — מיועדת לחשבונות בדיקה/פיתוח בלבד, ולא ניתן לבטל אותה.

יצירת יו״ר ראשי

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

חשוב: לפני מילוי הטופס יש לוודא שבוצעה פריסה (deploy) חדשה של פרויקט ה־Pages לאחר הקמת התשתית למעלה — חיבורי D1/R2 נכנסים לתוקף רק בפריסה הבאה, לא באופן מיידי.