הבנייה הראשונה שלכם, דקה אחר דקה

טעות אחת: לכתוב מפרט במקום משפט

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

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

טעות שנייה: מעקב אחרי הפיד כאילו זה מסוף תקוע

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

מה שכדאי לצפות לו בפועל משתנה מאוד בהתאם לצורת הפרויקט. יומן הטיפוס — כמה עמודים, מודל נתונים מקומי, בלי קריאות ל-API חיצוני — מסתיים תוך פחות משלוש דקות, וזה טיפוסי לכל דבר שהוא בעצם "תעד את זה, הצג גרף של זה, הראה לי רשימה". ברגע שבנייה דורשת בקאנד אמיתי, אימות משתמשים, מסד נתונים עם קשרים בין טבלאות, משימות רקע — מדובר בשמונה עד שתים עשרה דקות, כי עכשיו יש יצירת סכימה והגירה, ומעבר האימות רץ פעם שנייה מול קוד שרת ולא רק מול סימון (markup). משחקים איטיים אף יותר, כי הם דורשים יצירת נכסים: ספרייטים, אפקטי סאונד, ולעיתים מעבר ויזואלי נוסף אם הניסיון הראשון לא נראה טוב בגודל שבו הוא אמור להיות מוצג. ואריזה נייטיבית — קובץ APK אמיתי להתקנה, לא עטיפת דפדפן, מועברת לשרשרת כלים אמיתית. Gradle, חתימה דיגיטלית, הכול. השלב הזה לבדו יכול להוסיף חמש עד עשר דקות נוספות מעל הכול, וזה השלב היחיד שבו פיד שקט אומר ששרשרת הכלים עסוקה בעבודתה, לא שמשהו נשבר.

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

טעות שלישית: בלבול בין "נוצר" ל"מוכן"

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

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

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

מה מקבלים כשנמנעים משלוש הטעויות

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

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