POG CASINO — תוכנית עבודה למעבר מלא לשרתים פרטיים
עודכן: 7.9.2026
המסמך מרכז כל מה שנדרש כדי להעביר את האפליקציה מ-Base44 לתשתית בבעלותך. האפליקציה כבר מוכנה מהצד שלה: קיימת שכבת מתאם מרכזית וקיים מרכז הגדרות בלשונית ADMINISTRATION. מה שנותר הוא בעיקר עבודת תשתית בצד שלך, ולאחריה החלפה מבוקרת של הקריאות באפליקציה.
מה כבר מוכן באפליקציה
  • מרכז הגדרות מלא בלשונית ADMINISTRATION — כל כתובת, פורט ומפתח נשמרים במסד ללא נגיעה בקוד.
  • שכבת מתאם מרכזית (API Adapter) שחושפת בדיוק את אותן פעולות של Base44 ומנתבת אותן לפי מצב ה-API.
  • כרטיס CONNECTION STATUS עם בדיקת חיבור לשרת שלך דרך GET /health.
  • מתג API MODE שמאפשר מעבר בין INTERNAL ל-EXTERNAL בלי פריסה מחדש של קוד.
מה עוד נדרש
  • הקמת שרת API עם כל נקודות הקצה לנתונים ולפעולות הכספיות.
  • הקמת מסד נתונים נקי — ללא העברת נתונים היסטוריים, פרט להגדרות המשחקים.
  • הקמת שרת הזדהות שיחליף את מנגנון ההתחברות של Base44.
  • העברת קבצי המדיה (תמונות סמלים, צלילים, מסכי עזרה) לאחסון שלך.
  • חיבור המשחקים ולוח הניהול לשכבת המתאם, משחק-משחק.
  • הרצת תקופת עבודה מקבילה, ולאחריה מעבר סופי וכיבוי התלות ב-Base44.
שלב 1 — הקמת התשתית אצלך
אחריות: באחריותך / איש DevOps • זמן משוער: שבוע עד שבועיים
  • הקמת שרת (VPS או ענן) עם Node.js, תעודת HTTPS תקפה ודומיין ייעודי ל-API.
  • הקמת מסד PostgreSQL עם משתמש ייעודי לאפליקציה והרשאות מוגבלות למסד הקזינו בלבד.
  • חסימת גישה ישירה למסד מהאינטרנט — רק שרת ה-API יורשה להתחבר אליו.
  • הקמת אחסון קבצים או CDN לתמונות ולצלילים של המשחקים.
  • הגדרת גיבוי אוטומטי יומי של המסד לשרת גיבוי נפרד.
תנאי סיום השלב: הדומיין נטען ב-HTTPS, שרת ה-API מחזיר תשובה, והמסד נגיש רק מהשרת.
שלב 2 — סכימת מסד הנתונים
אחריות: באחריותך • זמן משוער: שבוע
  • יצירת 6 טבלאות: Player, AdminAccount, SpinResult, TokenTransaction, GameConfig, AppSetting.
  • לכל טבלה חייבים להיות השדות המובנים: id, created_date, updated_date, created_by_id.
  • שמירה על שמות שדות זהים לחלוטין לאלה שבאפליקציה — שינוי שם שדה ישבור את הקוד.
  • אינדקסים על השדות שנשלפים הרבה: player_name, game_id, created_date, parent_admin_id.
  • שדות כספיים בדיוק של שתי ספרות אחרי הנקודה (NUMERIC) ולא נקודה צפה, כדי שהקרדיטים לא יסטו.
תנאי סיום השלב: שאילתת בדיקה על כל טבלה מחזירה מבנה זהה למה שהאפליקציה מצפה לו.
שלב 3 — נקודות קצה לנתונים
אחריות: באחריותך • זמן משוער: שבוע עד שבועיים
  • GET /health — בדיקת חיים. זו נקודת הקצה שכפתור הבדיקה בלוח הניהול פונה אליה.
  • GET /entities/:name — עם פרמטרים query, sort, limit.
  • GET /entities/:name/:id — שליפת רשומה בודדת.
  • POST /entities/:name ו-POST /entities/:name/bulk — יצירת רשומה אחת או מרובות.
  • PATCH /entities/:name/:id, PATCH /entities/:name/bulk, PATCH /entities/:name/many — עדכונים.
  • DELETE /entities/:name/:id ו-DELETE /entities/:name/many — מחיקות.
  • תמיכה באופרטורים שהאפליקציה משתמשת בהם: $in, $set, $gte.
  • בקרת הרשאות בצד שרת: שחקן יכול לגשת רק לרשומות שלו, אדמין רק לשחקנים שתחתיו.
תנאי סיום השלב: לחיצה על TEST MY SERVER בלוח הניהול מחזירה תשובה ירוקה.
שלב 4 — הפעולות הכספיות בצד שרת
אחריות: באחריותך — קריטי • זמן משוער: שבוע
  • POST /functions/movePlayerCredits — העברת קרדיטים בין בנק אדמין לשחקן ובחזרה.
  • POST /functions/transferAdminPoints — העברות נקודות בין חשבונות אדמין.
  • POST /functions/awardPlayerWin — רישום זכיות ומעקב על קרדיטים שיצאו.
  • POST /functions/goldRowBonus — הגרלת הבונוס של Gold Row.
  • POST /functions/cleanupOldTransactions — משימה מתוזמנת לניקוי היסטוריה ישנה.
  • כל שינוי יתרה חייב לרוץ בטרנזקציה אטומית עם נעילת שורה, כדי שלא ייווצר כפל חיוב או זכייה.
  • ההגרלות והחישובים הכספיים חייבים לרוץ בשרת בלבד — לעולם לא בדפדפן של השחקן.
תנאי סיום השלב: הרצת 100 העברות במקביל לאותו שחקן מסתיימת ביתרה מדויקת ללא סטייה.
שלב 5 — הזדהות
אחריות: באחריותך • זמן משוער: שבוע
  • נקודת קצה להתחברות שחקן ואדמין המחזירה token עם תוקף.
  • אימות ה-token בכל בקשה לנקודות הקצה של הנתונים.
  • שמירת סיסמאות מוצפנות (hash) בלבד — לא טקסט גלוי.
  • הפקת מפתח AUTH API KEY והזנתו במרכז ההגדרות בלוח הניהול.
  • מגבלת ניסיונות התחברות כדי למנוע פריצה בכוח.
תנאי סיום השלב: התחברות עם סיסמה נכונה מחזירה token, ועם שגויה נדחית ונרשמת ביומן.
שלב 6 — התחלה נקייה (ללא העברת היסטוריה)
אחריות: משותף • זמן משוער: חצי יום
  • המסד החדש מוקם ריק. שחקנים, אדמינים, העברות, סיבובים וכל הסטטיסטיקות לא מועברים.
  • הפריט היחיד שכן מועבר: 22 רשומות הגדרות המשחקים (GameConfig) — RTP, מינימום ומקסימום הימור, ומצב פעיל או נעול.
  • ניתן להזין את 22 הרשומות ידנית, או לייצא אותן מ-Base44 (Data → GameConfig → Export) ולטעון פעם אחת.
  • הגדרות המערכת (AppSetting) מוזנות מחדש דרך מרכז ההגדרות בלוח הניהול — אין צורך בייצוא.
  • חשבונות האדמין והשחקנים נוצרים מחדש בלוח הניהול על השרת החדש, עם סיסמאות חדשות.
  • העברת קבצי המדיה (סמלים, צלילים, מסכי עזרה) לאחסון שלך ועדכון STORAGE ENDPOINT.
  • ייצוא גיבוי מלא מ-Base44 בכל זאת, ושמירתו כארכיון היסטורי בלבד — לא נטען למסד החדש.
תנאי סיום השלב: 22 הגדרות המשחקים קיימות במסד שלך עם ערכי RTP זהים, והמדיה נטענת מהאחסון שלך.
שלב 7 — חיבור האפליקציה למתאם
אחריות: באחריותי • זמן משוער: שבוע — לאחר שהשרת שלך מוכן
  • החלפת קריאות Base44 בקריאות דרך שכבת המתאם, בהדרגה ובקבוצות קטנות.
  • סדר העבודה: קודם לוח הניהול, אחריו הלובי וההתחברות, ולבסוף המשחקים אחד-אחד.
  • לוגיקת המשחקים, ההגרלות, טבלאות התשלום וה-RTP לא משתנות בכלל — רק כתובת היעד של הקריאה.
  • בדיקה מלאה של כל אחד מ-12 המשחקים אחרי כל קבוצה: הימור, זכייה, בונוס, יציאה.
  • בדיקת נוכחות שחקנים אונליין ועדכוני יתרה בזמן אמת מול ה-WebSocket שלך.
תנאי סיום השלב: כל 12 המשחקים עוברים סבב בדיקה מלא במצב EXTERNAL ללא סטיית קרדיט.
שלב 8 — עבודה מקבילה ומעבר סופי
אחריות: משותף • זמן משוער: שבוע עד שבועיים
  • הפעלת השרת שלך במקביל ל-Base44 ומעקב יומי אחר יומני שגיאות.
  • מעבר תחילה עם קבוצת שחקנים קטנה ובדיקת התנהגות תחת עומס אמיתי.
  • הפעלת מצב תחזוקה בזמן החלפת ה-API MODE הסופי, כדי שלא יאבד סיבוב באמצע.
  • העברת ה-API MODE ל-EXTERNAL בלוח הניהול ואימות שכל הקריאות זורמות לשרת שלך.
  • הרצת תקופת צל של שבוע לפני כיבוי סופי של התלות ב-Base44.
  • שמירת הגיבוי המלא מ-Base44 לפחות שלושה חודשים לאחר המעבר.
תנאי סיום השלב: שבוע שלם של פעילות אמיתית על השרת שלך בלי שגיאות ובלי סטיית יתרות.
סיכונים שחייבים לשים לב אליהם
  • סטיית קרדיטים — הסיכון החמור ביותר. חייבות טרנזקציות אטומיות עם נעילת שורה בכל שינוי יתרה.
  • שינוי שם של שדה או טבלה ישבור את האפליקציה. חובה לשמור על שמות זהים לחלוטין.
  • ביצוע חישובי כסף או הגרלות בדפדפן במקום בשרת יפתח פתח לרמאות.
  • מעבר בלי מצב תחזוקה עלול לתפוס שחקן באמצע סיבוב ולאבד את התוצאה.
  • התחלה נקייה מייתרת את סיכוני העברת הנתונים, אך בתמורה כל היתרות והסטטיסטיקות ההיסטוריות לא יופיעו במערכת החדשה. חובה לתאם זאת מול האדמינים לפני המעבר.
  • שחקן שנשארה לו יתרה ב-Base44 בזמן המעבר לא יראה אותה בשרת החדש. יש לאפס או לפדות את כל היתרות לפני ההחלפה.
רשימת בדיקה לפני המעבר הסופי
☐שרת API באוויר עם HTTPS ודומיין תקף
☐מסד נתונים עם 6 הטבלאות והשדות המובנים
☐GET /health מחזיר תשובה תקינה
☐כל נקודות הקצה לנתונים ממומשות
☐חמש הפעולות הכספיות ממומשות בטרנזקציות אטומיות
☐שרת הזדהות מנפיק ומאמת token
☐אחסון קבצים ו-CDN פעילים
☐גיבוי אוטומטי יומי מוגדר
☐22 הגדרות המשחקים הוזנו ואומתו (שאר הנתונים לא מועברים)
☐כל השדות מולאו במרכז ההגדרות ונשמרו
☐כפתור TEST MY SERVER מחזיר תשובה ירוקה
☐כל 12 המשחקים נבדקו במצב EXTERNAL