מסמך בקרת ממשקים

מסמך בקרת ממשקים (באנגלית: Interface Control Document, או בקיצור ICD) הוא מסמך בתחום הנדסת מערכות והנדסת תוכנה, שמספק רישום של כל המידע הנוגע לממשקים של פרויקט מסוים. מידע זה כולל שרטוטים, דיאגרמות, טבלאות ומידע טקסטואלי.

מאפיינים

עריכה

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

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

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

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

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

ביקורת

עריכה

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

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

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