RACQUET · ספר ההפעלה

חוברת הדרכה למנהל המערכת

כל מסך במערכת, כל כפתור עליו, מי רשאי ללחוץ, מה משתנה — ומה כבר אי אפשר להחזיר. החוברת נכתבה מול המערכת החיה: כל צילום מסך כאן צולם מהמערכת עצמה, וכל שם של כפתור הוא השם שמופיע על המסך, מילה במילה.

מסכי ניהול

26בשבע קבוצות

תפקידים

105 פלטפורמה · 5 ארגון

הרשאות

3022 פלטפורמה · 8 ארגון

צילומי מסך

63

עודכן

8.9.2026

1. הכניסה למערכת

איפה זה גר, איך נכנסים, ומה קורה לפני שנכנסים.

האפליקציה מוגשת מהשרת בכתובת https://www.data-pulse.co.il/racquet/app/. הקבצים עצמם יושבים ב־C:\Racquet\public\app\index.html, ו־nginx מגיש את התיקייה C:\Racquet\public\ תחת הכינוי /racquet/. ה־API יושב מאחורי אותו שם, תחת /racquet/api/v1/, ומופנה פנימה אל 127.0.0.1:8790.

שלוש נקודות שמנהל חייב להכיר במסך הזה:

• הטופס נושא method="post" ויש שכבת הגנה נפרדת שחוסמת שליחה עד שהאפליקציה נטענה במלואה. זו לא קישוטיות: ב־7.9.2026 שגיאת תחביר אחת בסקריפט גרמה לדפדפן לשלוח את הטופס כ־GET, עם הסיסמה בשורת הכתובת ומשם ביומן הגישה. אם הדף לא נטען כראוי תופיע ההודעה „הדף לא נטען במלואו והטופס אינו פעיל. רענן/י את העמוד ונסה/י שוב.”
• הכניסה מוגבלת בקצב ב־nginx: 10r/m לכתובת IP על נתיבי /racquet/api/v1/auth/, עם התפרצות של 5.
• השהיית חשבון מבטלת מיד את כל הכניסות הפתוחות שלו. זו לא פעולה שנכנסת לתוקף מחר.

2. התפריט הראשי

ארבע קבוצות. כל פריט נתלה לפי הרשאה, ולכן שני אנשים לא רואים את אותו תפריט.

המסכים שמאחורי התפריט

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

3. איך זה נראה בטלפון

רוב המשתמשים יגיעו מטלפון. שלושה דברים משתנים שם מהותית.

4. תפקידים והרשאות

מי רשאי מה — ולמה מנהל המערכת דווקא לא יכול לנהל מועדון.

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

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

מטריצת ההרשאות

עשר הרשאות נוספות נולדו אחרי שהמטריצה נכתבה, וכולן מוחזקות במנהל מערכת בלבד: platform.user.create, platform.user.mail, platform.organisation.read, platform.organisation.manage, platform.provider.approve, platform.tournament.manage, platform.rating.manage, platform.setting.manage, platform.course.approve, platform.academy.curate.

שמונה הרשאות הארגון: org.profile.edit, org.member.invite, org.member.remove, org.member.role.assign, org.service.publish, org.availability.manage, org.request.accept, org.court_offer.publish.

5. מסך הניהול — המבנה

הכניסה: תפריט ← ניהול ← ניהול המערכת. כותרת המסך היא ניהול, ומעליה הגדרות מערכת. בראש המסך יושבת שורה אחת שכדאי לקרוא פעם אחת ולזכור:

„המסך הזה נפתח רק למי שמחזיק הרשאות ניהול. הסתרה של כפתור היא נימוס, לא שמירה — כל פעולה כאן נבדקת שוב בשרת.”

שלושה כללים שחלים על כל 26 הכרטיסים:

• כרטיס בלי הרשאה לא נבנה כלל. לא אפור, לא נעול — פשוט לא שם. לשונית שמובילה לשום מקום גרועה יותר מהיעדר לשונית.
• טעינה עצלה. כל לשונית מושכת את הנתונים שלה רק בפתיחה הראשונה. שלוש לשוניות הן חריגה ונמשכות מראש, כי המספר עצמו הוא המידע: לאישור · N, נותני שירות · N, תמונות לאישור · N.
• משפט השגיאה אחיד. כשההרשאה חסרה בשרת המסך אומר: „לחשבון שלך אין את ההרשאה הדרושה (‹שם ההרשאה›). בלי ההרשאה הזאת אי אפשר ‹הפעולה›.”

שורת הכלים שחוזרת בכל טבלה

לרוב הכרטיסים יש אותה שורת כלים: שדה חיפוש, בורר מיון שמציע לכל עמודה „‹עמודה› — עולה” ו„‹עמודה› — יורד”, ומונה שאומר „N ‹פריטים›” או „N מתוך M ‹פריטים›”. בקטלוגים מצטרף רמז הגרירה: „גרור שורה, או השתמש בחיצים, כדי לשנות את הסדר.”

6. קבוצה: אנשים

ארבע לשוניות: משתמשים · תפקידים · נותני שירות · תפקידים והרשאות.

6.1 משתמשים

הרשאה לפתיחה: platform.user.read. לעריכה ולהשהיה: platform.user.suspend. לפתיחת חשבון: platform.user.create — מנהל מערכת בלבד.

מסננים: מצב („כל המצבים”), תפקיד („כל התפקידים” / „ללא תפקיד”), ענף („כל הענפים” / „ללא ענף”), מועדון („כל המועדונים” / „ללא מועדון”). מצבי חשבון: ממתין · פעיל · מושהה.

הפעולות

6.2 תפקידים

הרשאה: platform.role.assign — מנהל מערכת בלבד.

• הענקה: הוספת משתמש לתפקיד → שדה שם, אימייל או טלפון → חיפוש → הוספה. נכנס לתוקף מיד, בלי כפתור שמירה ובלי אישור. מי שכבר בתפקיד מסומן „כבר בתפקיד.”
• הסרה: הסרה מהתפקיד → „להסיר את ‹שם› מהתפקיד ‹תפקיד›?” → כן, להסיר / ביטול. אין שדה סיבה.
• שתי נעילות: „את התפקיד של עצמך אי אפשר להסיר מכאן — זה ינעל אותך מחוץ למסך הזה.” ו„זה האדם האחרון שיכול להעניק תפקידים. קודם צריך להעניק „מנהל מערכת” למישהו אחר, ורק אז להסיר.”
• תפקיד ארגון לא ניתן מכאן: „תפקיד של ארגון לא ניתן ישירות לאדם — הוא ניתן דרך חברות בארגון.”
• ביומן: role.assign = „הענקת תפקיד”, role.revoke = „הסרת תפקיד”. הישות היא תפקיד, ואין בשורה סיבה — כי אין שדה כזה במסך.

6.3 נותני שירות

הרשאה: platform.provider.approve.

הכרטיס מסביר את עצמו: „מי שסימן בפרופיל „נותן/ת שירות” מופיע כאן עד שמנהל מחליט. עד האישור השירותים שלו נשמרים כטיוטה ואינם מופיעים בחיפוש. אישור לא צריך נימוק; דחייה וביטול אישור כן — הנימוק נשמר, והאדם קורא אותו בפרופיל שלו.”

שדות הנימוק נושאים את שם האדם: נימוק לדחייה (חובה — ‹שם› יקרא אותו בפרופיל) ו־נימוק לביטול האישור (חובה — ‹שם› יקרא אותו בפרופיל), ואישור בשני שלבים — אישור הדחייה / אישור הביטול.

מה קורה בפועל: אישור הוא על האדם, לא על כל שירות בנפרד — מאמן שאושר מוסיף שירות שני בלי בדיקה נוספת. ביטול אישור מוריד מיד את כל שירותיו המפורסמים מהחיפוש, כי providers.require_approved נבדק בכל פרסום.

6.4 תפקידים והרשאות

הרשאה: platform.role.assign. לקריאה בלבד.

7. קבוצה: ארגונים

שתי לשוניות על אותו מנוע: מועדונים ו־עסקים וחנויות.

הרשאה לקריאה: platform.organisation.read. לעריכה: platform.organisation.manage. שתיהן מנהל מערכת בלבד.

עמודות: שם · סוג · מצב · בעלים וחברים · פעולות. תא הבעלים כתוב „‹שם› · N חברים”, ובהיעדר בעלים „אין בעלים רשום”. סוגים: מועדון · עסק · חנות · אחר. מצבים: טיוטה · מפורסם · מושהה · בארכיון.

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

8. קבוצה: תחרויות

חמש לשוניות: תחרויות · רמות (ליגות) · דירוגים · פורמטי משחק · ערכי ניקוד.

8.1 תחרויות

הרשאה: platform.tournament.manage (תווית במסך: ניהול תחרויות), או מנהל של מועדון מפורסם שהוא גם נותן שירות מאושר. פרק שלם על ניהול תחרות נמצא בסעיף 13.

הפעולות מתחת לכל שורה: עריכה · פרסום (או פתיחת ההרשמה מחדש) · סגירת ההרשמה · ביטול התחרות… · נרשמים · הגרלה (הופך ל־לוח אחרי ההגרלה, ולידו הגרלה מחדש) · לוח זמנים · יום התחרות. בטיוטה שלושת האחרונים מוצגים כטקסט מושבת: „הגרלה — אחרי הפרסום”, „לוח זמנים — אחרי הפרסום”, „יום התחרות — אחרי הפרסום”.

8.2 רמות (ליגות)

הרשאה: זהה לתחרויות.

ליגה היא עונה אחת של רמה אחת בענף אחד. חמש הרמות: רמה ד · רמה ג · רמה ב · רמה א · ליגת העל. 1–2 בתים, עד עשרה שחקנים בבית, כל אחד נגד כל אחד. ניצחון 2 נקודות, הפסד 1, ויתור 0 למוותר ו־2 למנצח.

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

בלי אישור כלל: פתיחת הרמה, חלוקה לבתים (אוטומטית) (דורסת כל שיוך בתים קיים), הסרה של שחקן, ביטול המשחק. בניית לוח מחדש כן שואל, ונעלם ברגע שהוכרע משחק. פרישה… מציע בורר: „פרישה: המשחקים שנותרו מבוטלים” או „פרישה: הפסדים טכניים”.

8.3 דירוגים

לצפייה: platform.rating.manage או platform.tournament.manage. לשינוי: platform.rating.manage בלבד.

הדירוג הוא ELO שמחושב מתוצאות משחקים — של תחרות או של רמה. K=40 בעשרת המשחקים הראשונים, 24 עד השלושים, 16 אחר כך. ויתור ועולה בלי משחק לעולם אינם מזיזים דירוג. שלושת סוגי השורות ביומן הדירוג: משחק · תיקון ידני · איפוס לרמה המוצהרת. טווח מותר לתיקון ידני: 500–2500.

לחיצה על שורה פותחת את יומן השחקן — „לפני ← אחרי” לכל משחק, והסיבה לכל תיקון. תיקון ידני דורש סיבה (חובה) של שלוש אותיות לפחות („צריך לכתוב סיבה — לפחות שלוש אותיות.”) ושואל „לשנות את הדירוג של ‹שם› מ־‹א› ל־‹ב›?” → כן, לתקן / לא.

8.4 פורמטי משחק  ·  8.5 ערכי ניקוד

שניהם קטלוגים — ראו את מנוע הקטלוגים בסעיף הבא. שניהם דורשים platform.catalog.approve.

בערכי ניקוד יש שתי עמודות מעבר לקטלוג הרגיל: ערכי ניקוד וברירת מחדל. כל שורה נפתחת לשבעה שדות מספר (0–10000) שנערכים במקום, עם שמירת הערכים, ותיבת ברירת מחדל — אחת לכל היותר. הטבלה הנזרעת נקראת ברירת מחדל. הערכים המקוריים: אלוף 100 · סגן 75 · חצי גמר 50 · רבע גמר 35 · שמינית 25 · סיבוב 32 = 15 · השתתפות 5.

סדר הקדימויות — הצר מנצח את הרחב: ערכים מיוחדים שהוקלדו לתחרות עצמה ← הטבלה בשם שנבחרה לה ← הטבלה המסומנת ברירת מחדל ← ברירת המחדל שבקוד.

9. קבוצה: קטלוגים

שלוש לשוניות: ענפים · סוגי תעודות · קטגוריות. יחד עם פורמטי משחק וערכי ניקוד מקבוצת התחרויות — חמישה קטלוגים על מנוע אחד.

הרשאה לכל החמישה: platform.catalog.approve — תווית במסך ניהול הקטלוגים. זו ההרשאה היחידה של עורך תוכן.

ארבע הפעולות של כל קטלוג

עמודות הבסיס: סדר · ‹שם היחיד› · מזהה · זמין לבחירה · פעולות.

1. הוספה — + ‹יחיד› חדש, שדה, הוספה. „נוסף: ‹שם› (מזהה ‹code›).”
2. שינוי שם — שינוי שם → שדה שם → שמירה. ההערה הקבועה: „המזהה ‹code› נשאר כפי שהוא — כל מה שכבר נשמר מפנה אליו. השם הוא מה שרואים על המסך.”
3. כיבוי — תיבת זמין לבחירה („זמין” / „כבוי”). הפיך, בלי אישור. כל כרטיס מוסיף משפט תוצאה משלו, למשל: „‹ענף› כובה. הוא נעלם מרשימות הבחירה, ו־12 שירותים ו־30 דירוגים שמפנים אליו נשארו כפי שהם.”
4. מחיקה — שלוש שכבות הגנה, למטה.

שינוי סדר: גרירה, או החיצים ▲/▼ („להעלות את ‹שם› מקום אחד”). פעיל רק ברשימה מלאה שממוינת לפי סדר.

10. קבוצה: לאישור

ארבע לשוניות: תעודות לאישור · תמונות לאישור · מפרסמי קורסים · לאישור מחשב בלבד.

10.1 תעודות לאישור

הרשאה: platform.certificate.verify.

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

10.2 תמונות לאישור

הרשאה: platform.moderation.decide.

• אישור — מיידי. „התמונה של ‹שם› אושרה ומוצגת עכשיו לכולם.”
• דחייה — מוחקת את הקובץ. „לדחות את התמונה של ‹שם›? הקובץ יימחק.” → כן, לדחות / ביטול. „התמונה של ‹שם› נדחתה והקובץ נמחק.”
• „אי אפשר להחליט על התמונה של עצמך. מנהל אחר יעשה את זה.” · „על התמונה הזאת כבר הוחלט.”

10.3 מפרסמי קורסים

הרשאה: platform.course.approve — מנהל מערכת בלבד.

הוספה: שם · טלפון · אימייל · ארגון („ללא ארגון — אדם פרטי”) · הערה → הוספת מפרסם. מפרסם יכול להיות אדם — ואז הוא חייב להיות נותן שירות מאושר — או ארגון, ואז כל מי שמחזיק org.profile.edit בו מפרסם בשמו.

ביטול: ביטול ההרשאה… → הערה חובה → ביטול ההרשאה / להשאיר. „ביטול הרשאה דורש הערה — היא נשמרת ביומן.” ההרשאה מסומנת כמבוטלת ולא נמחקת, ו„קורסים שכבר פורסמו נשארים על כנם.” המפרסם פשוט לא יכול לגעת בהם יותר.

10.4 לאישור מחשב בלבד

הרשאה: platform.change_request.read, והחלטה דורשת platform.change_request.decide. כותרת הכרטיס: בקשות שינוי לאישור.

שדות: הנחיות לעובד (רק אם מאשרים לעובד) והערת מנהל (חובה בדחייה). שלוש החלטות:

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

11. קבוצה: פניות ודיווחים

חמש לשוניות. שלוש מהן מחשב בלבד.

11.1 מעקב בקשות מחשב בלבד

טופס פתיחה: כותרת · תחום · דחיפות · פירוט → פתיחת הבקשה. אחר כך אישור הבקשה („הבקשה אושרה. עכשיו אפשר להעביר אותה לעבודה.”), ואז בורר מצב הבקשה („ללא שינוי מצב — שמירת הערה בלבד” / „העברה ל‹מצב›”) עם מה נעשה (הערה) ו־שמירה.

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

11.2 בקשות שינוי מחשב בלבד

בורר מצב העובד: בתור · בעבודה · תוקן · נכשל · הועלה לאוויר — דיווח של אדם. הבחירה האחרונה קיימת כדי שהיומן יידע מי אמר שהתיקון עלה: „נרשם שהתיקון הועלה לאוויר. הדיווח הזה נזקף לך, לא לעובד.”

11.3 פניות תמיכה מחשב בלבד

הרשאה: platform.support.read; מענה דורש platform.support.respond.

11.4 דיווחים

הרשאה: platform.moderation.decide.

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

11.5 ביקורות שדווחו

הרשאה: platform.moderation.decide.

הטקסט שהכרטיס נושא: „ביקורות שמישהו דיווח עליהן ואף אחד עוד לא הסיר. ההסרה מסתירה את הביקורת מהעמוד הציבורי ומהממוצע — היא לא מוחקת אותה, כדי שאפשר יהיה לבדוק את ההחלטה בדיעבד. סיבה היא חובה.”

שדה סיבת ההסרה (חובה, נשמרת עם ההחלטה), כפתור הסרת הביקורת → „להסיר את הביקורת מהעמוד הציבורי ומהממוצע?” → כן, להסיר.

12. קבוצה: מערכת

שלוש לשוניות: לוח יד שנייה · מתגי תכונות · יומן פעולות.

12.1 לוח יד שנייה

הכרטיס מופיע אם מחזיקים לפחות אחת מהשלוש. הכלל שכדאי לזכור: „חשבון שמנהל חנות לא יכול לפרסם בלוח.”

12.2 מתגי תכונות

הרשאה: platform.feature_flag.toggle. לתצוגה בלבד.

12.3 יומן פעולות

הרשאה: platform.audit.read — מנהל מערכת בלבד.

כל שורה נושאת: תיאור בעברית וגם את הקוד — מסך שמראה רק פרוזה אי אפשר להצליב מול בסיס הנתונים; זמן; „בוצע על ידי ‹שם›” או „ללא משתמש מזוהה”; הישות; הארגון; ו„סיבה: ‹טקסט›” כשיש.

13. תחרות מקצה לקצה

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

13.1 שבעת ערכי סוג התחרות

הצירוף השמיני, „יחידים מעורב”, נדחה גם בשירות וגם באילוץ במסד — הוא לא קיים. הבחירה יחידים/זוגות ננעלת ברגע שיש נרשם ראשון.

13.2 ארבעת ערכי מבנה

מדריך רביעי, GUIDE_TOURNAMENT_DOUBLES_HE.html, חוצה מבנים ומכסה את ארבעת סוגי הזוגות. ארבעת המדריכים יושבים לצד החוברת הזאת, בתיקיית docs/.

13.3 מחזור החיים

שני צירים נוספים שמופיעים על המסך: טרם הוגרל · הוגרל · במשחק · הסתיימה למצב הלוח; ו־רשום/ה · ברשימת המתנה · ביטל/ה · נדחה/תה לנרשם. משחק: ממתין · נקבע · שוחק · ויתור · פרישה · עולה בלי משחק.

13.4 מי רשאי — שתי סמכויות, ואין שלישית

1. מנהל מערכת עם platform.tournament.manage (ניהול תחרויות) — פועל על כל תחרות, ורשאי לפתוח תחרות בלי מועדון.
2. מנהל של מועדון מפורסם שהוא גם נותן שירות מאושר — פועל רק על תחרויות המועדונים שלו. תחרות של מועדון אחר עונה 404, לא 403.

מי שלא אושר כנותן שירות מקבל סירוב עם provider_not_approved; מי שיש לו רק עסק או חנות, או מועדון בטיוטה, מקבל no_published_club.

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

13.5 ההגרלה

כמה מדורגים? המספר לא מוקלד — הוא נגזר מגודל הלוח: עד 8 → שניים, עד 16 → ארבעה, עד 32 → שמונה, עד 64 → שישה־עשר, מעבר → שלושים־ושניים.

איך מגרילים. הגרלה פותח רשימה ממוספרת שסדרה הוא סדר ההרשמה. סדר לפי דירוג מסדר לפי הדירוג המחושב מתוצאות (הגבוה ראשון; מי שאין לו — בסוף). החיצים ▲/▼ מזיזים שורה. בצע הגרלה שואל לפני שהוא מבצע: כן, להגריל / לא.

שיבוץ המדורגים בנוקאאוט: בלוח 8 — מספר 1 לשורה 1 ומספר 2 לשורה 8; בלוח 16 — 1 ו־16, והזוג 3–4 לשורות 5 ו־12; בלוח 32 — 1 ו־32, הזוג 3–4 ל־9 ו־24, והרביעייה 5–8 ל־8, 16, 17 ו־25. בתוך כל קבוצה ההגרלה אקראית. חופשים ממלאים את החוסר עד החזקה של 2, ניתנים למדורגים לפי הסדר, ולעולם לא שניים באותו משחק. מי שקיבל חופש עובר לסיבוב הבא כבר בזמן ההגרלה.

בבתים: מספר הבתים הוא תקרת (נרשמים ÷ גודל בית), והגדלים נבדלים ב־1 לכל היותר. ראשי הבתים הם המדורגים הבכירים, ואחריהם דרג נוסף אחד לכל בית באקראי. גודל בית: 3 שחקנים, 4 שחקנים או 5 שחקנים.

היומן שומר את זרע ההגרלה בשורה tournament.draw, יחד עם המדורגים, החופשים, גודל הלוח והבתים — כך שאפשר לשחזר בדיוק כל הגרלה בדיעבד.

13.6 ניקוד ודירוג — שלושה מספרים שאסור לבלבל

אף אחד משלושתם אינו קורא את השני.

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

הערכים: אלוף 100 · סגן 75 · חצי גמר 50 · רבע גמר 35 · שמינית 25 · סיבוב 32 = 15 · השתתפות 5. מנצח התנחומים מורם לניקוד השמינית, לעולם לא מעבר לרבע גמר, ורק אם זה יותר ממה שהלוח הראשי כבר נתן.

פקיעה: הניקוד תקף מתאריך התחלת התחרות ועד אותו תאריך בשנה שאחריה, לא כולל. השורה לא נמחקת — היא נשארת ביומן ומפסיקה להיספר.

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

13.7 לוח זמנים, PDF ודואר

לוח זמנים

• שכבה מעל ההגרלה. אפשר לרשום תוצאה בלי מגרש, בלי שעה ובלי יום. תחרות שלא פתחה את המסך מתנהלת בדיוק כמו קודם.
• מילוי אוטומטי בלחיצה שנייה רק משלים חסרים ולא מזיז דבר. רק סימון תכנון מחדש מנקה ומתזמן מהתחלה. משחק ששוחק אינו זז לעולם.
• דטרמיניסטי לגמרי, בלי אקראיות. מה שלא נכנס מופיע תחת לא ניתן לשבץ לפי האילוץ עם סיבה בעברית.

PDF

• דורש התקנה ידנית בשרת: C:\Racquet\.venv\Scripts\python.exe -m pip install fpdf2==2.8.7, וגופנים arial.ttf ו־arialbd.ttf. אימות: /readiness לא אמור למנות ייצוא בין הכשלים.
• ציבורי לתחרות שפורסמה. לטיוטה אין כפתור אלא המשפט „הדפסה ל-PDF — אחרי הפרסום”.
• בשום מסמך אין טלפון, אימייל או תאריך לידה — יש על זה בדיקה אוטומטית.

דואר תחרויות

• מי שולח: המשימה המתוזמנת Racquet_Mail_Sweep, כל 15 דקות. פעולת מנהל רק כותבת שורה לתור; הסריקה היא ששולחת.
• קיבוץ: כל מה שממתין לשחקן בתחרות מתקבץ להודעה אחת, לכל היותר אחת לשעה. שלוש דחיות שונות מגיעות כמייל אחד.
• ביטול תחרות הוא היוצא מן הכלל: הוא לא מחכה לשעה, ולא מושתק בכיבוי „הודעות על תחרויות” — שמשתיק את שש האחרות.
• בלי SMTP אין תור בכלל. תזכורות נכתבות רק מ־17:00 שעון ישראל והלאה, ותחרות זוגות אינה כותבת לתור — פער מוכר.

14. המודולים

מה כל מודול עושה, מה בו של המנהל, ומה בו קורה מעצמו.

14.1 מגרשים ברגע האחרון

„דקה 90”: מועדון מפרסם משבצת על מגרש שהתפנה, עם מחיר רגיל ומחיר מבצע, ושחקן לוקח אותה. רק מועדון שמצבו „מפורסם” יכול למכור; מנהל פלטפורמה אינו יכול לפרסם הצעה בשם מועדון. הלקיחה יוצרת הזמנה מסוג מגרש ברגע האחרון שנולדת ישר במצב אושרה — אין שלב „המועדון מאשר”.

אין לשונית ניהול למודול הזה. הכול נעשה מכרטיס המועדון בלשונית המועדונים שלי: + מגרש חדש, + פרסום הצעה, ו־ביטול ההצעה → כן, לבטל / להשאיר. הצעה שנתפסה אי אפשר לבטל. הרשאות: org.profile.edit למגרשים, org.court_offer.publish להצעות.

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

שלב חיים נוסף קיים בקוד ואינו מתועד ב־docs/COURTS_HE.md: אחרי „נתפסה” המועדון מאשר תשלום ומוסר קוד שער לשחקן.

14.2 קורסים והשתלמויות

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

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

המנהל אינו עורך, מפרסם או מבטל קורסים של אחרים — אין מסך כזה. הוא שולט ברשימת המפרסמים בלבד. ביטול קורס דורש סיבה, מקפיא את הקורס, משאיר את כל ההרשמות כפי שהן, ולא שולח שום הודעה.

14.3 לוח יד שנייה

לוח ציוד משומש בין אנשים פרטיים. הלוח עצמו ציבורי; הטלפון פשוט אינו קיים בתשובת השרת לקורא שאינו מחובר — הוא לא מוסתר בעיצוב.

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

המנהל שולט במכסה החודשית, בקטגוריות הלוח ובתור ההסרה — ראו סעיף 12.1.

14.4 ביקורות

דירוג חד־צדדי של לקוח על נותן שירות, 1–5 כוכבים וטקסט חופשי. ביקורת נולדת מבקשה שהושלמה, לא מכתיבה חופשית, ותוקפה 30 יום: „אפשר לכתוב ולערוך עד 30 יום מסיום השירות…”, ואחר כך „החלון לכתיבת ביקורת נסגר (30 יום מסיום השירות).”

אין למודול פריט תפריט. הכתיבה נעשית מההזמנות שלי, בכפתור כתיבת ביקורת / עריכת הביקורת. לנותן השירות מגיעה תגובה אחת בלבד לכל ביקורת.

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

2026-09-08 00:55:03  reviews  200 {"considered":0,"invited":0,"reminded":0,
                                    "failed":0,"mail_configured":true}

14.5 רמות (ליגות)

ראו סעיף 8.2. שוברי השוויון, לפי הסדר: המשחק ביניהם → אחוז מערכות → אחוז משחקונים → הגרלה עם זרע שנשמר. משחקי ליגה מזינים את ה־ELO בדיוק כמו משחקי תחרות. משחק שעבר את תאריך היעד מסומן „באיחור” — ההחלטה מה לעשות בו היא של המנהל, לא של המערכת.

14.6 דירוגים

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

14.7 SOS

קריאה דחופה: מנהל מועדון מפורסם או נותן שירות מאושר מפרסם צורך מיידי („המאמן חולה, צריך מחליף ל־17:00”), והמערכת מיידעת עד 30 נותני שירות מתאימים באזור. הפותח בוחר אחד — אין תשלום, אין הסלמה, אין SMS ואין פוש.

שלוש לשוניות: לפתוח SOS · SOS פתוחים בשבילי · ה־SOS שלי. מצבים: פתוח · נבחר מישהו · בוטל · פג. „אני זמין” אפשר לענות פעם אחת בלבד. הקריאה פגה אחרי שש שעות, והתפוגה מחושבת בקריאה — אין worker.

14.8 מחנות אימונים ואקדמיות

שני דברים נפרדים באותו מסך:

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

14.9 אזורי שירות

שבעה אזורים — צפון · חיפה והקריות · השרון · מרכז · ירושלים והסביבה · דרום · כל הארץ / אונליין — ומתחתם 32 תת־אזורים. זה הבסיס לכל סינון מיקום במוצר.

אין מסך ניהול לאזורים, בכוונה. הוספה, פיצול או שינוי שם דורשים מיגרציה בבסיס הנתונים, כי תת־אזור שמישהו כבר בחר מקושר משלוש טבלאות, ופיצול הוא החלטת מוצר — לאן עוברים מי שבחרו את הישן. משתמש בוחר עד 12 תת־אזורים.

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

14.10 נותני שירות ושירותים

ראו סעיף 6.3 לאישור האדם. מעבר שירות למצב מפורסם נחסם על שלושה שערים, וכולם צריכים להיפתח:

1. האדם חייב להיות מאושר כנותן שירות.
2. חייב להיות לו לפחות תת־אזור אחד. ההודעה במסך: „אזור פעילות הוא חובה לפרסום…” עם כפתור לבחירת אזורים.
3. קטגוריה שמסומנת דורש תעודה (שופטים וכדומה) מתפרסמת רק למי שמחזיק תעודה מאושרת אחת לפחות.

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

גישה לשירות שאינו שלך מוחזרת כ־404, לא 403 — מכוון: 403 היה מאשר שהשירות קיים למי שסורק מזהים.

15. תפעול השרת

מה רץ מעצמו, מתי, איפה הלוגים, ומה עושים כשמשהו נופל.

15.1 ארבע המשימות המתוזמנות

לראות את כולן בבת אחת, בשרת:

Get-ScheduledTask | Where-Object { $_.TaskName -match 'Racquet' } |
  ForEach-Object { $_.TaskName + '(' + $_.State + ')' }

הרצה ידנית: schtasks /run /tn Racquet_Mail_Sweep, או ישירות powershell -NoProfile -ExecutionPolicy Bypass -File C:\Racquet\racquet_sweeps.ps1 -Job reviews.

15.2 הגיבוי הלילי, והשחזור

הגיבוי רץ ב־05:00 ולא בשעה אחרת. הוא מייצר קובץ בשם Racquet_yyyy-MM-dd_HHmm.bak בתיקייה C:\Backups\Racquet\ — למשל Racquet_2026-09-07_0500.bak, בערך 30MB — ורושם ל־ C:\Backups\Racquet\backup.log.

שמירה: שבעת הקבצים האחרונים מקומית — ספירה, לא ימים (-LocalKeepCount 7) — ושלושים יום ב־Google Drive. כשל בהעלאה לענן אינו מפיל את הגיבוי; הקובץ המקומי בטוח, והלוג יאמר זאת.

gdrive:DataPulse-BackUp/<yyyy-MM-dd>/Racquet/Racquet_<yyyy-MM-dd>_0500.bak

לילה תקין נראה כך — שורות אמיתיות מהשרת, מהגיבוי של 7.9.2026:

2026-09-07 05:00:01  === Racquet backup start ===
2026-09-07 05:00:03  SQL backup OK: C:\Backups\Racquet\Racquet_2026-09-07_0500.bak (31.1 MB)
2026-09-07 05:00:44  uploaded to gdrive:DataPulse-BackUp/2026-09-07/Racquet
2026-09-07 05:14:49  drive retention applied (removed > 30 d under gdrive:DataPulse-BackUp/*/Racquet)
2026-09-07 05:14:49  local backups kept: 7 (ceiling 7)
2026-09-07 05:14:49  === Racquet backup done ===

שחזור

rclone copy gdrive:DataPulse-BackUp/2026-09-07/Racquet/Racquet_2026-09-07_0500.bak ^
  C:\restore\ --config C:\Backups\rclone.conf

RESTORE DATABASE [Racquet]
FROM DISK='C:\restore\Racquet_2026-09-07_0500.bak'
WITH REPLACE;

אם צריך לרשום את המשימה מחדש מאפס:

schtasks /create /tn Racquet_DB_Backup ^
 /tr "powershell -NoProfile -ExecutionPolicy Bypass -File C:\Backups\backup_db.ps1 ^
      -Database Racquet -Dir C:\Backups\Racquet -RemoteBase gdrive:DataPulse-BackUp ^
      -RcloneExe C:\Backups\rclone\rclone.exe -RcloneConf C:\Backups\rclone.conf ^
      -LocalKeepCount 7" ^
 /sc DAILY /st 05:00 /ru SYSTEM /rl HIGHEST /f

זו בדיוק שורת הפעולה הרשומה במשימה היום — הועתקה מהשרת, לא נבנתה מהזיכרון.

15.3 הפריסה ושלושת השערים

הפריסה מעלה גרסה חדשה של הקוד ושל העמודים. יש בה שלושה שערים, לא שניים:

1. שער הסכימה. משווה את מספר המיגרציה שהמסד נמצא בו למספר שהקוד דורש. הודעת כשל אמיתית: The database is at migration 70 and this code needs 71. Nothing was uploaded. — שום דבר לא הועלה.
2. שער העמודים. מהדר — ולעולם לא מריץ — כל סקריפט פנימי בכל קובץ RACQUET_*.html. שגיאת תחביר אחת עוצרת את הפריסה לפני ההעלאה. זה בדיוק הכשל שהדליף פעם סיסמה לשורת הכתובת.
3. שער הזמינות. אחרי ההחלפה, קריאה ל־/readiness ול־/health. שער זה מדווח ולא מונע — אם הוא נכשל, הקוד כבר עלה.

15.4 איפה הלוגים

שורת גישה תקינה ב־nginx נראית כך:

93.172.44.10 - - [08/Sep/2026:06:10:04 +0300] "GET /racquet/app/ HTTP/1.1" 200 1348406
  "https://www.data-pulse.co.il/racquet/" "Mozilla/5.0 (iPhone; ...)"

בשרת מחכים כמה כלי ניתוח מוכנים, כולם לקריאה בלבד, תחת Scripts\server\: errors_since.py (כל שגיאות ה־5xx של היום לפי שעה), errors_detail.py, cr_traffic.py, sessions_today.py, support_today.py.

15.5 לקרוא את יומן הביקורת ישירות

המסך יומן פעולות נותן את רוב מה שצריך, אבל לא את מסנן מזהה הבקשה — שהוא המסנן החזק ביותר. מול בסיס הנתונים:

USE Racquet;
GO
SET NOCOUNT ON;
DECLARE @action    nvarchar(120)    = N'tournament.';  -- prefix; NULL = all
DECLARE @actorName nvarchar(200)    = NULL;
DECLARE @since     datetime2(3)     = '2026-09-01';
DECLARE @until     date             = '2026-09-08';
DECLARE @corr      uniqueidentifier = NULL;

SELECT TOP (200)
       a.id, a.created_at, a.action_code, a.entity_type, a.entity_reference,
       a.correlation_id, a.reason, a.safe_metadata,
       u.public_id AS actor_public_id, p.display_name AS actor_name,
       o.name AS organisation_name
FROM dbo.AuditEvents a
LEFT JOIN dbo.Users         u ON u.id      = a.actor_user_id
LEFT JOIN dbo.Profiles      p ON p.user_id = a.actor_user_id
LEFT JOIN dbo.Organisations o ON o.id      = a.organisation_id
WHERE (@action    IS NULL OR a.action_code  LIKE @action + N'%')
  AND (@actorName IS NULL OR p.display_name LIKE N'%' + @actorName + N'%')
  AND (@corr      IS NULL OR a.correlation_id = @corr)
  AND (@since     IS NULL OR a.created_at   >= @since)
  AND (@until     IS NULL OR a.created_at    < DATEADD(day, 1, @until))
ORDER BY a.id DESC;
GO

הרצה בשרת: sqlcmd -S SERVER2\SQLEXPRESS -E -d Racquet -I -b -i <file.sql>.

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

16. מה אי אפשר להחזיר

הפרק שכדאי לקרוא לפני הלחיצה, לא אחריה.

ארבע פעולות הרסניות שלא רושמות סיבה ביומן

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

17. מה עוד לא נסגר

דברים שנמצאו תוך כדי כתיבת החוברת ומעבר על המערכת החיה. אף אחד מהם אינו חוסם עבודה — אבל מנהל שלא יודע עליהם יבזבז זמן.

17.1 פערים במוצר

1. אין מסך ניהול ל־SOS. מסלול השרת קיים, המסך לא נבנה.
2. אין מסך ניהול לאקדמיות מומלצות. ניהול רק דרך ה־API, ובלעדיו הרשימה הציבורית ריקה.
3. אין מדריך למבנה „בתים”. ארבעת המדריכים מכסים שלושה מבנים מתוך ארבעה.
4. לשתי הסריקות אין מסך. שתיהן מתוזמנות ורצות (Racquet_Mail_Sweep כל 15 דקות, Racquet_Review_Sweep ב־06:10) — אבל אין באפליקציה כפתור להריץ אחת מהן עכשיו, ואין שום מסך שאומר מתי הן רצו לאחרונה. כדי לדעת, צריך לפתוח את sweeps.log בשרת.
5. דואר תחרויות לא נכתב לתור בתחרות זוגות. פער מוכר.

17.2 באגים קטנים במסך

1. לשונית עסקים וחנויות אומרת „N מועדונים” ו„אין מועדונים שמתאימים לסינון.”
2. כל חמשת הקטלוגים אומרים „+ קטגוריה חדש” ו„אין קטגוריות שמתאימים לסינון” — התבנית מקודדת בזכר.
3. חמש הרשאות מוצגות כקוד באנגלית על מסך עברי.
4. בכרטיס נותני שירות, הכפתור אישור מוצע גם על שורה שכבר נדחתה — והופך דחייה מנומקת בלחיצה אחת בלי אישור.
5. ליד ההזמנות שלי בתפריט נדבק מונה גם כשהוא אפס.
6. תיאורי רמות הטניס בלשונית הרמה שלי מסומנים טיוטה ומכילים שגיאות כתיב — הם עדיין לא הוגהו.
7. בכרטיס תפקידים, שורת „טוען…” אינה נעלמת גם אחרי שהנתונים הגיעו, וחמשת כרטיסי התפקידים תופסים מקום בעמוד בלי להיצבע בצילום אוטומטי. התוכן קיים במסמך העמוד — ראו את ההערה בסעיף 6.2.
8. לחיצה על הרמה שלי או על SOS בתפריט אינה עושה דבר כשהפריט לא נתלה לחשבון — וזה תקין; אבל שני המסכים האלה אינם נגישים לחשבון ניהול נקי, ולכן אין להם צילום בחוברת.

17.3 פערים תפעוליים

המספרים כאן נמדדו בשרת ב־8.9.2026, לא נאמדו.

1. יומן הגישה של nginx הוא 597MB ואינו מתגלגל. C:\nginx\logs\access.log גדל ברציפות מ־4.5.2026. בכונן נותרו 7GB פנויים מתוך 50 — זהו צרכן הדיסק הגדול ביותר בשרת, והוא היחיד ברשימה הזאת שיש לו מועד.
2. קובץ הגיבוי ב־Google Drive אינו מוצפן, והוא עותק מלא של כל הטלפונים והתעודות.
3. ההעלאה לענן תפוג במהלך 2026 — rclone עדיין משתמש ב־client_id המשותף שגוגל מוציאה משימוש. מתועד כאזהרה בכל לילה ב־backup.log.
4. אין מדיניות שמירה ליומן הביקורת — dbo.AuditEvents גדל בלי גבול, ולא הוגדר לו שום ניקוי.
5. sweeps.log ו־backup.log אינם מתגלגלים. (api.log דווקא כן, יומי.)
6. 81 תיקיות C:\Backups\Racquet\deploy_*, יחד 0.33GB, מ־6.9.2026 ואילך — אף אחת לא נמחקת. בקצב הזה זה עוד לא כואב, אבל אף אחד לא מנקה אותן.
7. קוד יציאה 0 בסריקות אינו מוכיח הצלחה, ו־267011 אינו כישלון. רק sweeps.log אומר את האמת.
8. לא נמצא ניטור זמינות חיצוני שרץ על השרת הזה; אם קיים כזה, הוא יושב במקום אחר ולא נבדק כאן. מה שכן קיים בשרת: התראת מייל על שגיאת 500, לא יותר מאחת לדקה לנתיב.

17.4 שני מסמכים שמפגרים אחרי הקוד

• docs/COURTS_HE.md אינו מכיר את שלב אישור התשלום וקוד השער.
• docs/RATINGS_HE.md אינו מזכיר את סולם הזוגות.
• docs/ADMIN_GUIDE_HE.md מתאר 14 לשוניות; יש 26. החוברת הזאת מחליפה אותו כמפת המסכים, אבל התוכן האיכותי שבו עדיין שווה קריאה.