חדר כושר: מנוי, הקפאה, ביטול וגבייה באותו מצב לקוח

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

חמישה מצבים, ומה כל אחד עושה לשלוש מערכות

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

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

המעברים, ומה כל מעבר עושה לחיוב הבא

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

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

למה מנוי מוקפא ממשיך להתחייב?

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

הראשונה: הרצת הגבייה קראה את המצב ברגע שהיא התחילה לרוץ, ולא את המצב שתקף בתאריך החיוב. אם ההקפאה נרשמה ב-28 בחודש והתחילה ב-1, והרצה יצאה ב-31, מצב "פעיל" הוא מה שהרצה ראתה. התיקון אינו בתזמון אלא בשאילתה: המצב שנשאל הוא המצב בתאריך החיוב.

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

תיארוך אפקטיבי: מצב הוא טווח, לא ערך

השורה שמחזיקה את המצב צריכה להיראות כך:

• membership_id - המנוי, לא הלקוח. ללקוח יכולים להיות שני מנויים לאורך זמן.
• state - אחד מחמשת הערכים, מרשימה סגורה.
• valid_from ו-valid_to - טווח התוקף. valid_to ריק פירושו המצב הנוכחי.
• requested_by ו-approved_by - מי ביקש ומי אישר. לפעמים אותו אדם, ואז שני השדות מלאים באותו ערך.
• reason - סיבה מרשימה, לא טקסט חופשי.
• document_ref - הפניה לבקשה שהתקבלה, אם הייתה כזו.

השאלה "מה המצב ב-1 באוקטובר" הופכת לשאילתה על טווח ולא לניחוש. הצד השני של המטבע הוא שאסור לעדכן שורה קיימת: שינוי הוא סגירת הטווח הקודם ופתיחת חדש. מודלים מסחריים בונים את זה כך במפורש, וניתן לראות איך זה נראה במערכת חיצונית ב-Stripe Billing subscriptions.

האם פיגור הוא מצב או דגל?

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

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

הגישה בדלת היא החלטה נפרדת שנשענת על המצב ועל היתרה:

1. חסימה מיידית - נדירה, ובדרך כלל מיותרת ליום אחד של איחור.
2. חסימה אחרי סף ימים - הסף הוא הגדרה במערכת, לא כלל בקוד.
3. התראה בקבלה בלי חסימה - הכניסה נפתחת, ומופיעה הודעה לפקיד.

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

התאמה יומית בין הדלת לספר החיובים

בסוף כל יום שווה להריץ בדיקה קצרה שמחפשת רק סתירות:

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

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

מה נשבר בפועל

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

מקורות

• Stripe Billing - Subscriptions overview
• Stripe - Idempotent requests
• מס"ב - מרכז סליקה בנקאי