HE

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

המפרט בן העמוד האחד שמאשרים תחילה: תמונת השער של הפוסט בבלוג של Deployflix

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

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

מהו מפרט תוכנה, במילים פשוטות?

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

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

מה כולל מסמך דרישות בן עמוד אחד לאפליקציה?

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

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

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

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

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

איך קוראים מפרט לאפליקציה ואילו שאלות כדאי לשאול?

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

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

אילו חוסרים כדאי לחפש לפני האישור?

רוב המפרטים שמשתבשים אינם שגויים; הם פשוט אינם שלמים. אלה החוסרים הנפוצים ביותר.

מי יכול לראות מה

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

עריכה, ביטול ושחזור

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

כסף

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

הודעות ותזכורות

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

הנתונים הקיימים שלכם

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

מכשירים ושפות

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

למה לאשר את המפרט לפני שמתחילים לבנות?

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

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

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

איך מתכננים שינויים אחרי שהאפליקציה נבנתה?

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

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

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

תבנית למפרט אפליקציה שתוכלו להשתמש בה

אם אתם כותבים מפרט בעצמכם, העתיקו את הכותרות הבאות ומלאו כל סעיף במשפטים פשוטים:

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

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

שאלות

מה ההבדל בין מפרט אפליקציה למסמך דרישות?

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

מי צריך לכתוב את מפרט האפליקציה?

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

האם אפשר לשנות את המפרט לאחר שאישרתי אותו?

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

מה צריך להיות האורך של מפרט אפליקציה?

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

תארו את האפליקציה שלכם

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