אפיון מערכת לעסק: איך כותבים אפיון שחוסך הפתעות
אפיון מערכת הוא מסמך שמתאר מה המערכת צריכה לעשות, מי משתמש בה, ומה נחשב “גמור”, לפני שכותבים שורת קוד אחת. אפיון תוכנה טוב אינו ספר עב כרס. הוא מסמך קצר וברור שבעל העסק מבין, ומפתח יכול לבנות ממנו.
רוב ההפתעות בפרויקטים לא נובעות מקוד גרוע. הן נובעות מכך ששני הצדדים הבינו משהו אחר תחת אותה מילה. מסמך אפיון נועד לסגור את הפער הזה מוקדם, כשתיקון הוא עדיין פשוט וזול.
למה בכלל צריך אפיון
בלי אפיון, כל אחד מדמיין מערכת קצת אחרת. בעל העסק חושב על “מערכת הזמנות”, המפתח חושב על טופס, והעובדים מצפים לדוחות. רק באמצע הבנייה מתברר שהיו שלוש מערכות שונות בראש.
אפיון משיג שלושה דברים:
- הסכמה. כולם מסתכלים על אותו תיאור.
- הערכה סבירה. אי אפשר להעריך זמן בלי לדעת מה בונים.
- גבול. כשמופיע רעיון חדש באמצע, ברור אם הוא חלק מהמוסכם או תוספת.
מה כולל מסמך אפיון טוב
אין חובה לעקוב אחרי תבנית קשיחה, אבל הדברים הבאים כמעט תמיד שייכים:
המטרה והבעיה
מה הבעיה העסקית? “העובדים מבזבזים שעתיים ביום על עדכון אקסל” היא מטרה טובה. “צריך מערכת מודרנית” היא לא. כדאי לכתוב גם איך תדעו שהצלחתם.
מי משתמש במערכת
סוגי המשתמשים והתפקיד של כל אחד: בעל העסק, עובד, מנהל, לקוח. לכל סוג יש הרשאות אחרות ומסכים אחרים.
התהליכים העיקריים
תיאור של מה קורה צעד אחר צעד. למשל: לקוח משאיר פנייה, נציג מקבל התראה, מתקשר, מעדכן סטטוס, ושולח הצעה. את זה כדאי לתאר במילים פשוטות, אפילו עם תרשים ידני.
המסכים והשדות
אילו מסכים יש ומה בכל אחד. לא חייב להיות עיצוב מלא, מספיק שרטוט גס שמראה מה מוצג ומה אפשר לעשות.
חוקים עסקיים
כאן מסתתרות רוב ההפתעות: “הנחה מעל סכום מסוים דורשת אישור”, “לקוח לא יכול לבטל פחות מ-24 שעות לפני”. חוקים כאלה קיימים בראש של אנשים, וצריך להוציא אותם לכתב.
חיבורים למערכות אחרות
מייל, וואטסאפ, חשבוניות, יומן, מערכת קיימת. כל חיבור כזה הוא עבודה נפרדת, ולכן חשוב לציין אותו.
מה לא נכלל
הרשימה הזאת חשובה כמעט כמו הרשימה של מה כן נכלל. “בגרסה הראשונה אין אפליקציית מובייל”, “אין דוחות מותאמים”. היא מונעת אכזבות.
נתונים והעברה
האם יש מידע קיים שצריך להעביר? מאיפה? באיזה מצב הוא? נתונים מבולגנים הם אחד המקורות הנפוצים לעיכובים.
איך כותבים אפיון תוכנה צעד אחר צעד
- מתחילים משיחה. לפני שכותבים, מספרים על העסק ועל הכאב. אני מתחיל תמיד משאלות פשוטות ולא מרשימת פיצ’רים.
- מתארים יום רגיל בעבודה של כל סוג משתמש, מהבוקר עד הערב.
- מפרקים לתהליכים. כל תהליך מתואר בנפרד, בקצרה.
- מסמנים עדיפויות. מה חייב להיות בגרסה הראשונה, מה נחמד שיהיה, מה לשלב הבא.
- מראים לאנשים שישתמשו. עובד שמבין את העבודה היומיומית ימצא בעיות שבעל העסק לא ראה.
- מעדכנים. אפיון הוא מסמך חי, לפחות עד תחילת הבנייה.
טעויות נפוצות באפיון
- אפיון ארוך מדי. אם אף אחד לא קורא אותו, הוא לא עושה את העבודה.
- מילים עמומות כמו “מהיר”, “נוח”, “חכם” בלי הגדרה. מהיר ביחס למה?
- דילוג על מקרי קצה. מה קורה כשהלקוח מבטל? כשהתשלום נכשל? כשחסר שדה?
- ניסיון לחשוב על הכל מראש. אי אפשר, ואין צורך. עדיף גרסה ראשונה קטנה ומוגדרת היטב.
- אפיון בלי בעל העסק. מי שמבין את העסק צריך להיות מעורב, לא רק לחתום.
- טכנולוגיה לפני צורך. לבחור כלי לפני שברור מה בונים.
האם אפשר לעשות אפיון עם כלי AI
אפשר להיעזר בהם כדי לנסח ולארגן, וגם כדי לשאול שאלות שלא חשבתם עליהן. אבל הם לא מכירים את העסק שלכם ולא יידעו אילו חוקים לא כתובים קיימים אצלכם. אני משתמש בהם ככלי עבודה, ולא במקום השיחה.
תהליך העבודה שלי מתואר בעמוד איך זה עובד. ובמאמר כמה זמן לוקח לבנות מערכת לעסק אפשר לראות איך האפיון משפיע על לוח הזמנים.
דוגמה קצרה לתהליך אחד מתוך אפיון
כדי לראות כמה פשוט זה יכול להיות, הנה תהליך אחד כפי שהייתי כותב אותו, בלי שום ז’רגון:
- מתי זה מתחיל: לקוח ממלא טופס באתר.
- מה קורה במערכת: נוצרת כרטיסיית ליד, והנציג התורן מקבל הודעה.
- מה הנציג עושה: מתקשר, מסמן תוצאה (עניין, אין מענה, לא רלוונטי), וקובע מועד המשך.
- חוק עסקי: ליד שלא טופל תוך יום עבודה עולה למנהל.
- מה נחשב גמור: הליד נסגר בסטטוס, ויש תיעוד של כל שיחה.
חמש שורות כאלה לכל תהליך, וכבר יש בסיס לשיחה ולהערכה. אם משהו נשמע לא נכון, מגלים אותו עכשיו ולא באמצע הבנייה. ואם אתם מתלבטים אם בכלל לבנות מערכת, ראו CRM מותאם או מערכת מדף.
שאלות נפוצות
כמה זמן לוקח לכתוב אפיון?
למערכת קטנה עד בינונית, מדובר בדרך כלל בכמה ימים עד שבוע-שבועיים, כולל שיחות והבהרות. למערכת מורכבת עם הרבה תהליכים וחיבורים זה יכול להימשך יותר.
מי צריך לכתוב את האפיון, אני או המפתח?
הכי טוב ביחד. אתם מביאים את ההבנה של העסק, והמפתח מביא את היכולת לתרגם אותה למשהו שאפשר לבנות. מסמך שנכתב רק על ידי אחד הצדדים כמעט תמיד מפספס משהו.
האם אפשר להתחיל לבנות בלי אפיון?
לפרויקט קטן מאוד אולי, אבל גם אז כדאי עמוד אחד שמגדיר מטרה ותהליך. לפרויקט גדול יותר, בנייה בלי אפיון היא הדרך הבטוחה לחרוג בזמן ובתקציב.
מה ההבדל בין אפיון לעיצוב?
אפיון מגדיר מה המערכת עושה, ועיצוב מגדיר איך היא נראית. אפשר לעשות אפיון בלי עיצוב מלא, אבל קשה לעשות עיצוב טוב בלי אפיון.
אם יש לכם רעיון למערכת ואתם רוצים לעבור עליו יחד לפני שמתחילים, אפשר לכתוב לי בוואטסאפ או דרך עמוד יצירת הקשר, בלי לחץ.