מאור - ניהול בית כנסת (לוח דיגיטלי חכם) — Next.js + Firebase
הקמה (פעם אחת)
- Firebase Console → צרו פרויקט. תחת Authentication → Sign-in method הפעילו Email/Password ו-Anonymous (המסך בטלוויזיה נכנס אנונימית).
- Firestore Database → Create database (production mode).
- Project settings → Your apps → Web app → העתיקו את ה-config לקובץ
.env.local (תבנית ב-.env.local.example).
- Firestore → Rules → הדביקו את
firestore.rules ולחצו Publish.
- במחשב:
npm install ואז npm run dev (או העלו ל-Vercel והגדירו שם את אותם משתני סביבה).
- הירשמו ב-
/login. ב-Firestore Console פתחו users/<uid> ושנו: role = super_admin, status = approved. מעכשיו /super-admin שלכם.
זרימת עבודה
- גבאי נרשם ב-
/login ← מצב pending ← אתם ב-/super-admin משייכים בית כנסת, בוחרים חבילה ומאשרים.
- ב-
/super-admin לכל בית כנסת: כניסה כגבאי (שליטה מלאה ב-/admin?s=<id>), הקפא/הפשר (הגבאי חסום והמסך מציג הודעת השהיה), מחק (מוחק את כל הנתונים).
- הגבאי מנהל ב-
/admin; כפתור תצוגה מקדימה פותח חלון חי של המסך. הטלוויזיה (Fully Kiosk) פותחת: /display?s=<synagogueId>&screen=main-hall
מבנה Firestore
users/{uid}: uid, email, role (super_admin|gabbai|sub_gabbai), status (pending|approved|rejected|suspended), synagogueId, createdAtsynagogues/{sid}: name, city, street, location{lat,lng,elevation}, plan{planTier,maxScreens,features,subscriptionStatus,validUntil}, settings{...}- תתי-אוספים: announcements, memorials, refuah, halacha, prayers, overrides, members, receipts, donations, tickets, inventory, expenses, screens (heartbeat), private (org, counters)
מה לא כלול (להשלמה)
- דף
/report לדיווח תקלות ע״י מתפללים (QR) ובוט וואטסאפ.
- סנכרון חי עם נדרים פלוס/משולם/Grow (דורש Cloud Function ומפתחות הספק). קיים ייבוא CSV.
- אכיפת מגבלת הנצחות לפי חבילה בצד השרת (קיימת ב-UI בלבד). מגבלת המסכים נאכפת ב-rules לפי
index.
- קבלות סעיף 46: טיוטה בלבד, יש לאמת מול רואה חשבון ורשות המסים.
חיבור איטי / WebSockets חסומים
המסך מציג מיד עותק שמור, ואם אין תשובה חיה תוך 4 שניות הוא קורא את הנתונים בקריאה חד-פעמית וממשיך לנסות ברקע. Firestore מוגדר לזיהוי אוטומטי של Long Polling. לכפיית Long Polling בסטרימר מסוים פתחו פעם אחת /display?...&lp=1 (נשמר במכשיר; lp=0 מבטל), או הגדירו NEXT_PUBLIC_FORCE_LONG_POLLING=1.
PWA / APK
public/manifest.json, אייקונים ב-public/icons/ ו-public/sw.js כבר כלולים (הקישור ב-app/layout.js). לאחר פריסה ל-HTTPS הדביקו את כתובת האתר ב-PWABuilder.com ← Package for stores ← Android.
עבודה ללא אינטרנט (Offline)
- Firestore שומר את כל הנתונים ב-IndexedDB (
persistentLocalCache, כולל מספר לשוניות), ועותק נוסף ב-localStorage. מסך שנפתח ללא רשת מציג מיד את המידע האחרון (סימון בפינה: "אופליין").
- זמני היום מחושבים תמיד מקומית ב-
kosher-zmanim לפי הקואורדינטות השמורות, לכן הם מדויקים גם בלי רשת.
- כשהרשת חוזרת (או נקודה חמה לכמה שניות) המסך מתחבר מחדש ומתעדכן לבד, בלי רענון.
- כדי שהמסך ייפתח אופליין גם אחרי הדלקה מחדש של הסטרימר: פתחו את
/display?... פעם אחת עם חיבור (ה-service worker שומר את האפליקציה).
"שכחתי סיסמה" (/login → /api/auth/forgot-password)
- הטופס דורש אימייל + טלפון (בהרשמה נשמר גם
phone ב-users/{uid}). הבקשה נשלחת למייל FORGOT_PASSWORD_NOTIFY_TO (ברירת מחדל [email protected]) עם האימייל, הטלפון, התאריך והשעה, ה-IP ותוצאת ההתאמה.
- אם האימייל והטלפון תואמים לרשומה ב-
users – נשלח גם מייל האיפוס הסטנדרטי של Firebase (PASSWORD_RESET). התשובה למשתמש זהה בכל מקרה (למניעת בדיקת קיום חשבונות).
- משתני סביבה ב-Vercel (ראו
.env.local.example): שליחת מייל – SMTP_HOST/SMTP_PORT/SMTP_USER/SMTP_PASS (למשל Gmail עם סיסמת אפליקציה) או RESEND_API_KEY; ולאימות מול Firestore – FIREBASE_SERVICE_ACCOUNT (JSON של Service Account). בלי מייל מוגדר הטופס מחזיר שגיאה; בלי Service Account נשלחת התראה למנהל בלבד (ללא איפוס אוטומטי).
- משתמשים שנרשמו לפני הוספת השדה אין להם
phone ולכן לא יותאמו אוטומטית – ההתראה למנהל תגיע ואפשר לאפס ידנית, או להוסיף להם phone ב-Firestore.
התחברות בטלפון + סיסמה (ללא SMS)
- הרשמה והתחברות במספר נייד ישראלי וסיסמה. מאחורי הקלעים נוצר ב-Firebase Auth זהות
[email protected] (לא נשלחים אליה מיילים) – הסיסמאות מוצפנות ומנוהלות ע״י Firebase, בלי JWT עצמי.
- התחברות במייל ממשיכה לעבוד לחשבונות קיימים (שדה אחד "טלפון או אימייל").
- שכחתי סיסמה: הבקשה מגיעה למנהל המערכת; ב-Super Admin לוחצים "🔑 אפס סיסמה" (
/api/admin/reset-password, דורש FIREBASE_SERVICE_ACCOUNT) ומוסרים בטלפון סיסמה זמנית. המשתמש מחליף אותה ב"הגדרות מערכת ← שינוי סיסמה".
שיוך אוטומטי של גבאי לבית כנסת
- הרשמה: בוחרים "בית כנסת חדש" (שם + עיר) או "הצטרפות עם קוד".
/api/auth/onboard (Admin SDK, דורש FIREBASE_SERVICE_ACCOUNT) יוצר את בית הכנסת / מממש את הקוד וכותב users/{uid}.synagogueId – בלי עריכה ידנית ב-Firestore.
- בית כנסת חדש: הסטטוס נשאר "ממתין" עד שמנהל המערכת לוחץ "אשר" (ה-ID כבר משויך). אפשר לאשר אוטומטית עם
AUTO_APPROVE_NEW_SYNAGOGUES=1.
- קוד הצטרפות: הגבאי הראשי יוצר אותו ב"הגדרות מערכת ← 🔗 קוד הצטרפות" (אוסף
joinCodes, חוקי Firestore כבר מעודכנים – צריך לפרסם אותם בקונסולה). המצטרף הופך לגבאי משנה (הודעות בלבד) ומאושר מיידית.
