הנדסה לאחור של מערכת קיימת – מה עושים כשהקוד עובד אבל אף אחד לא באמת מבין אותו

סדר העבודה, ולמה הסדר עצמו הוא העיקר

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

הכללים שאינם כתובים

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

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

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

למה שכתוב מלא נכשל

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

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

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

שלושה מדדים לשליטה

תחושה של «אנחנו מבינים את המערכת» אינה מדד ניהולי, ולכן צריך להחליף אותה במדדים ברורים שכן אפשר לבדוק.

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

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

מצב שכיח: מעבירים פיתוח לספק אחר

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

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

איך אני עובד על זה

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

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