דלג לתוכן הראשי

פיצ'רים מתקדמים למערכת

סקירה של יכולות תשתיתיות נוספות בשרת.

Webhooks

מודול ה-Webhook מאפשר אינטגרציה עם מערכות צד שלישי על ידי שליחת בקשות HTTP בעת אירועים במערכת.

הגדרה

מנהל יכול להגדיר כתובת URL (Endpoint) שתקבל הודעות עבור:

  • Device Status Change: מכשיר התנתק/התחבר.
  • Alert Triggered: התראה חדשה הופעלה.
  • User Created/Deleted: שינויים במשתמשים.

המערכת שולחת POST Request עם Payload בפורמט JSON המכיל את פרטי האירוע.

ניהול קבצים (Uploads)

מודול ה-Upload מרכז את הטיפול בקבצים במערכת.

אחסון

המערכת תומכת במספר ספקי אחסון (ניתן להגדרה ב-ENV):

  1. Local: שמירה בדיסק המקומי (תיקיית /uploads). מתאים לפיתוח או רשתות סגורות.
  2. Cloudinary: שירות ענן לניהול מדיה (מומלץ לפרודקשן). תומך בכיווץ אוטומטי והתאמת גודל תמונה.
  3. S3: (אופציונלי) אחסון באמזון S3.

סוגי קבצים נתמכים

  • תמונות (JPG, PNG) עבור הנצחות ולוגו.
  • קבצי APK עבור עדכוני תוכנה.
  • מסמכי PDF (לעיתים רחוקות).

מצב תחזוקה (Maintenance Mode)

מודול ה-Maintenance מאפשר למנהלי על להעביר את המערכת למצב מוגבל.

התנהגות

כאשר המצב פעיל (SYSTEM_MAINTENANCE=true):

  • כל בקשות ה-API (למעט של Admins) נחסמות עם שגיאת 503 Service Unavailable.
  • מסכי הקצה (Tfila) יציגו הודעה שהשרת בטיפול, אך ימשיכו לעבוד עם המידע השמור אצלם (Cache) במצב Offline.
  • זה מאפשר לבצע מיגרציות DB או שדרוגי שרת בצורה בטוחה.