( ) תכן תוכנה מפרט 4 – פרויקט SDS

Transcription

( ) תכן תוכנה מפרט 4 – פרויקט SDS
‫‪30/10/2010‬‬
‫‪SDS v1.4‬‬
‫‪SDS\PICFILTER‬‬
‫פרויקט ‪ – 4‬מפרט תכן תוכנה )(‬
‫מידע כללי‬
‫שם הפרויקט‪:‬‬
‫צוות הפרויקט‬
‫מסמכים מצורפים‪:‬‬
‫מסמכים קשורים‪:‬‬
‫‪PicFilter‬‬
‫עדרי אמונה‪036668101 ,‬‬
‫שראל נתנאל‪036892982 ,‬‬
‫מינס יובל‪037708307 ,‬‬
‫אלפסי נתנאל‪036980613 ,‬‬
‫דיין יוסי‪038082137 ,‬‬
‫הצעת פרויקט‪ -SRS ,SDP ,‬כולם באתר הפרוייקט‬
‫תוכן העניינים‬
‫מידע כללי ‪1 .....................................................................................................................‬‬
‫הסטורית שינויים ‪2 ............................................................................................................‬‬
‫הקדמה‪2 ..............................................................................................................‬‬
‫‪.1‬‬
‫‪7.1‬‬
‫ארגון המסמך ‪2 ..................................................................................................‬‬
‫‪7.2‬‬
‫מטרות המסמך ‪2 ................................................................................................‬‬
‫‪.2‬‬
‫ארכיטקטורת הפצה – ‪2 .......................................................... Deployment Diagrams‬‬
‫‪.3‬‬
‫תרשימי מבנה סטטי – ‪3 ....................................................................Class Diagrams‬‬
‫‪.4‬‬
‫תרשימי רצף התנהגותי – ‪3 .........................................................Sequence Diagrams‬‬
‫‪5.‬‬
‫שמירת נתונים ‪5 .....................................................................................Persistence -‬‬
‫‪.6‬‬
‫טבלת עקיבות לדרישות ‪5 ........................................................................................‬‬
‫‪.7‬‬
‫תוכנית בדיקות ותיעוד )ראשונית(‪5 ............................................................................‬‬
‫‪7.1‬‬
‫דרישות ‪5 ..........................................................................................................‬‬
‫‪7.2‬‬
‫בדיקות ‪5 ..........................................................................................................‬‬
‫‪7.3‬‬
‫תוצאות רצויות ‪6 .................................................................................................‬‬
‫‪7.4‬‬
‫תוכנית תיעוד ‪6 ..................................................................................................‬‬
‫תוכן‪7 .............................................................................................................................‬‬
‫נקודות שעלו במפגש ‪7 .......................................................................................................‬‬
‫טבלת משימות הנובעות מהמפגש ‪7 .....................................................................................‬‬
‫‪1‬‬
‫‪SDS\PICFILTER‬‬
‫הסטורית שינויים‬
‫גרסה‬
‫‪1.0‬‬
‫‪1.3‬‬
‫‪1.4‬‬
‫תאור השינוי‬
‫תאריך‬
‫גרסה התחלתית‬
‫‪8/11/2010‬‬
‫‪ 09/11/2010‬הוספת נתונים ועדכון פרטים ע"פ יגל‬
‫‪ 09/11/2010‬הוספת סיכום סקר‪ ,‬עדכון בדיקות ותרשימים‬
‫מקור השינוי‬
‫לא ישים‬
‫‪ .1‬הקדמה‬
‫‪ 7.1‬ארגון המסמך‬
‫עיקר תוכנו של מסמך זה הוא תיאור מבנה הפרויקט בעזרת דיאגרמות ‪:UML‬‬
‫‪ .1‬דיאגרמת הפצה ‪ -‬דיאגרמה המתארת את פריסת המערכת באופן פיזי אצל הלקוח‬
‫‪ .2‬דיאגרמת מחלקות ‪ -‬דיאגרמה המתארת את מחלקות התוכנה ואת היחסים ביניהן‬
‫‪ .3‬תרשימי רצף התנהגותי ‪ -‬דיאגרמות המתארות קשר בין עצמים של המערכת על ציר הזמן‪.‬‬
‫בנוסף לדיאגראמות ‪ ,‬במסמך זה יש תיאור של סוגי הקבצים המתארים מידע שישמר‪ ,‬וגם תכנון‬
‫של הבדיקות הנדרשות מהמוצר ואת התיעוד המתכונן שיימסר ללקוח‪.‬‬
‫‪ 7.2‬מטרות המסמך‬
‫מטרת המסמך היא לארגן תבנית )שלד(‪ ,‬של ארכיטקטורת המערכת‪ ,‬כגון חלוקה למחלקות‪,‬‬
‫תכנון אופן התהגות של המערכת‪ ,‬הכנה למימוש הקוד‪ ,‬הכנה לבדיקת נכונות ע''י בדיקות‬
‫שיבוצעו ועוד‪ .‬הדיאגראמות המצורפות יעזרו לנו לתכנן את המערכת באופן יעיל‪ ,‬ולהיכנס‬
‫לפרטים קטנים וחשובים‪ ,‬שכדאי להקדיש להםמחשבה לפני שניגשים לכתיבת הקוד‪.‬‬
‫‪ .2‬ארכיטקטורת הפצה – ‪Deployment Diagrams‬‬
‫עיבוד נתונים‬
‫מחשב אישי‬
‫מחשב אישי‬
‫קליטת העדפות‬
‫והגדרות באלגוריתם‬
‫ניתוח התמונות‬
‫מערכת‬
‫‪WINDOWS‬‬
‫מערכת‬
‫‪WINDOWS‬‬
‫פלט אלגוריתם ניתוח‬
‫התמונות‬
‫עיבוד‬
‫וסינון‬
‫תוכנת‬
‫‪PicFilter‬‬
‫מקלדת‬
‫עכבר‬
‫ספריית התמונות‬
‫‪2‬‬
SDS\PICFILTER
GUI
Image
- Source Folder : String
- Source Folder : String
1
- Destionation Folder (Filtered
Pictures) : String
- Accuracy Percentage: Int
- ConvertToGray()
‫הופכת התמונה לגווני אפור‬
- putInIntArray()
‫מציגה את התמונה כמערך‬
- Filter Type (Automatic or Semi
Auto) : Bool
1
1
Compare
SortImage
- Destionation Folder : String
- Images Array : Int[][]
- Filter Type : Bool
1
- Images Array : Int[][]
- Accuracy Percentage: Int
- Compare(AccPer)
‫השוואת שתי תמונות בהתאם‬
‫לדרישה‬
- filter(FilterType)
‫סינון התמונות בהתאם לבחירת‬
‫המשתמש‬
Class Diagrams – ‫ תרשימי מבנה סטטי‬.3
Sequence Diagrams – ‫ תרשימי רצף התנהגותי‬.4
:‫תרשים הפעלה‬
3
SDS\PICFILTER
excecutePicFilter()
GUI
User choosedirectories,auto
or manual,etc.
‫הפעלה‬
showChociesPanel
Load()
Make the directories
and start filter
:‫ ביצוע סינון‬- ‫תרשים פעולה‬
excecutePicFilter()
GUI
GUI
‫הפעלה‬
userChoose
Options
makeDirectory
Target
filterPics
showResults
autoFilter
Load()
showOptionsPanel()
targetDirectory
manualFilte
sourceDirectory
makeDirectories()
saveDataToNextUse
End
getResult()
4
‫‪SDS\PICFILTER‬‬
‫‪ .5‬שמירת נתונים ‪Persistence -‬‬
‫בכל שלב ניצור קובץ הגדרות אשר יישמור את הגדרות המשתמש מחד‪ ,‬ואת הגדרות התוכנה‬
‫מאידך‪.‬‬
‫ישנו קובץ הגדרות ששומר את כל הגדרות המשתמש )תיקייה‪ ,‬סוגי קבצים לסינון‪ ,‬סוג הסינון‬
‫והעדפות נוספות(‪ ,‬וקובץ נוסף אותו פולט האלגוריתם הראשי והוא שומר את פלט התוכנה‪.‬‬
‫‪ .6‬טבלת עקיבות לדרישות‬
‫ארכיטקטורת הפצה‬
‫‪ .1‬עיצוב ממשק למשתמש‬
‫‪ .2‬קבלת הנתונים מהלקוח‬
‫‪ .3‬עיבוד נתונים והעדפות‬
‫תרשים מבנה סטטי‬
‫‪ .1‬מבצע העברת ההגדרות וההעדפות של במשתמש לאלגוריתם המתאים‬
‫‪ .2‬ביצוע השוואה וסינון התמונות‬
‫‪ .3‬החזרת התמונות המסוננות למשתמש‬
‫‪ .7‬תוכנית בדיקות ותיעוד )ראשונית(‬
‫מסמך בדיקה הוא אחד המפתחות למוצר מוצלח‪.‬מאוד חשוב לתכנן את הבדיקות כדי להבטיח מוצר‬
‫איכותי ומושלם‪ .‬ביצוע בדיקות במהלך יצירת הפרוייקט יעזור לאתר שגיאות בשלבים מוקדמים של‬
‫הפיתוח ולא במהלך סגירת המוצר או גרוע מכך לאחר שהמוצר נשלח ללקוח‪.‬‬
‫מטרתו של סעיף זה‪ :‬לתאר את כל הבדיקות שהולכות להתבצע על המוצר‪.‬‬
‫‪ 7.1‬דרישות‬
‫הדרישות למסמך זה מתוארות המסמך ה‪ SDS-‬שבאתר הקורס‬
‫‪ 7.2‬בדיקות‬
‫בשלב זה עדיין אין תיאור לבדיקת כל המוצר אנו צריכים לראות איך לבצע את האינטגרציה בין חלקי‬
‫התוכנית השונים אשר מקורם גם בתוכנות שונות ולאחר מכן נוסיף גם בדיקות אלו )ניתן לומר‬
‫שבמקרה זה אנו נרצה לבדוק שכל חלקי המערכת עובדים בצורה טובה כאשר הכל בא כיחידה אחת(‬
‫•‬
‫‪Matlab‬‬
‫במטלב אנו נשתמש בכדי לבצע את אלגוריתם הפילטור עצמו‪ .‬אנו נרצה לבדוק מספר פרמטרים‬
‫שונים ואף שילובים שלהם‪.‬‬
‫‪ .1‬גדלי קבצים שונים‪.‬‬
‫‪ .2‬תמונות לאורך ולרוחב‪ ,‬כך שמרבית התמונה זהה‪.‬‬
‫‪ .3‬סיומות שונות של קבצים )‪.(bmp, jpg, etc‬‬
‫‪5‬‬
‫‪SDS\PICFILTER‬‬
‫בכל פעם אנו נכניס תיקייה בעלת מאפיינים שונים לסינון וננתח את התוצאות המתקבלות‪.‬‬
‫•‬
‫‪GUI‬‬
‫ב‪ GUI-‬אנו נשתמש כדי לספק ממשק נוח למשתמש‪ .‬אנו נרצה לבדוק שמה שסופק עובד‬
‫כמצופה‪ .‬הדברים הבאים ייבדקו‪:‬‬
‫‪ .1‬תפעול פקדים‪.‬‬
‫‪ .2‬קלט חוקי‪.‬‬
‫‪ .3‬נוחיות הממשק‪ .‬ניקח גורם חיצוני וניתן לו להתמודד עם התוכנה באופן עצמי לאחר מכן הוא‬
‫יישאל מס' שאלות שיתנו לנו אומדן לגבי הממשק עצמו‪) .‬עד כמה הוא פשוט‪ ,‬האם הוא‬
‫ידידותי‪ ,‬האם הוא מובן כראוי וכו'(‬
‫‪ 7.3‬תוצאות רצויות‬
‫•‬
‫‪Matlab‬‬
‫שעבור כל תיקייה שתועבר לסינון‪ ,‬פלט התוכנית יהיה ‪ 2‬תיקיות אשר הסינון בהן יהיה מספק –‬
‫זהו אינו קריטריון כמותי אך ניתן לומר עליו כמעט בוודאות לאחר שמספר אנשים מבצעים את‬
‫הפעולה הזו‬
‫•‬
‫‪GUI‬‬
‫‪ .1‬הפקדים מבצעים את מה שהם אמורים לעשות‬
‫‪ .2‬בדיקות אימות לקלט‪ ,‬במידה והקלט אינו חוקי ניתנת הודעת שגיאה למשתמש אשר מפרטת‬
‫אלו שדות אינם חוקיים‪ .‬תינתן אפשרות לשנות שדות אלו‪.‬‬
‫‪ .3‬ניתוח תשובותיו של הגורם החיצוני והגעה למסקנה שהממשק נוח‬
‫‪ 7.4‬תוכנית תיעוד‬
‫התיעוד יכלול‬
‫• מדריך למשתמש‬
‫• הוראות התקנה והסרה‬
‫• מדריך לשימוש בתוכנה‬
‫• שאלות נפוצות ותשובות‬
‫• מייל לקבלת פידבק‬
‫‪6‬‬
‫‪SDS\PICFILTER‬‬
‫סיכום סקר תיכון תוכנה ‪ -‬‬
‫תוכן‬
‫שם הפרויקט הנסקר‬
‫נציג הלקוח )הסוקר(‬
‫מועד ומקום הפגישה‬
‫שמות משתתפים‬
‫‪PicFilter‬‬
‫רותם יאנשוי‬
‫יום שלישי ‪ 09‬נובמבר ‪ 2010‬חברת מוביליי בע"מ‬
‫יובל מינס‬
‫נקודות שעלו במפגש‬
‫‪.1‬‬
‫‪.2‬‬
‫‪.3‬‬
‫תיאור על אלו קבצי תמונה התוכנה תהיה מסוגלת לעבוד‬
‫ארכיטקטורת גואי ראשונית – לדאוג שתהיה נוחה ופשוטה למשתמש‬
‫יצירת אינטגרציה בין שתי סביבות פיתוח שונות‬
‫טבלת משימות הנובעות מהמפגש‬
‫נושא‬
‫קבצי תמונה‬
‫‪GUI‬‬
‫אינטגרציה‬
‫פעולה נדרשת‬
‫סקר שוק‪ ,‬מה השכיחות של קבצים מסויימים בשמירת‬
‫תמונות‪,‬‬
‫גואי ראשוני רק ברמת העיצוב )עדיין לא מחייב‬
‫שהפקדים יפעלו(‬
‫בשלב זה למידת הנושא‬
‫באחריות‬
‫נתי אלפסי ‪ ,‬יוסי‬
‫דיין‬
‫נתנאל שראל ‪,‬‬
‫אמונה עדרי‬
‫יובל מינס‬
‫‪7‬‬