הנהלה רוחנית

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

כתובת האפליקציה — android.url שבתצורה.

הפעלה ראשונה

1. הריצו את migrations/000_schema.sql מול פרויקט ה-Supabase (supabase.url שבתצורה) דרך ה-SQL Editor — הוא הסכימה החיה, והרצה חוזרת אינה משנה דבר.
2. צרו את המשתמש הראשון ידנית ב-SQL Editor — ⛔ אין משתמש ברירת מחדל ואין סיסמה בריפו. הטביעה נגזרת בקונסולה של הדף עצמו: (await import('./core/auth.js')).authMakePassFp('<שש ספרות>') מחזירה {salt, fp}, והם נכנסים ל-pass_salt ול-pass_fp של שורה ב-hr_users, עם role שהוא 'admin'.

מסכים

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

פיתוח

הקליפה ב-index.html, והקוד ב-app/ וב-core/ — מודולים שהדפדפן טוען כמות שהם. אין build.

node tools/guard.mjs       # שומר הדחיפה — חובה לפני כל push

השומר בודק את תחביר sw.js, core/, app/ וכל סקריפט מוטבע, ⛔ ושכל קובץ ברשימת המטמון קיים — ⚠️ ורץ גם בכל דחיפה ובכל PR.

⚠️ קידום CACHE_NAME ב-sw.js חובה בכל שינוי קוד — ⛔ והוא מזהה הגרסה היחיד: ⭐ המספר שהמסך מציג נגזר משם המטמון החי, ⛔ ואינו ליטרל שני.

PDF

pdfmake (⛔ לא html2pdf — בעיות RTL), מ-jsDelivr בגרסה נעוצה.

APK

מעטפת אנדרואיד מסוג WebView (⛔ לא TWA) ב-android/, שטוענת את כתובת ה-Pages מהרשת. בנייה: Actions → Build APK → Run workflow. שחרור קוד web אינו מצריך APK חדש.