CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Class Project OO Design Document Here is what you need to do for your class project SDD...

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Software Design Documentation Class project design will focus on component-level design. That is, the detailed design of class attributes (variables) and methods. Since there no single template for OO SDD, we’ll modify (reuse) the SRS document to capture major sections of SDD shown on the following slide. Section 3 of the SRS (Specific Requirements) is the major section for your SDD. You’ll expand the class tables of the SRS to include more design details about class variables and methods. You’ll need to update diagrams in the SRS as per changes made during the design phase, and any diagrams missing from the SRS should be included in the SDD submission.

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Major Sections of OO SDD Other sections and subsections may be added as needed. Table of Contents 1. Introduction (About the SDD) 1.1 Purpose 1.2 Scope 1.3 Definitions, acronyms, and abbreviations 1.4 References 2. Object Descriptions (Object Design) (Use table format from SRS) 3. Sequence Diagrams (Update from SRS as needed) 4. Object Collaboration Diagrams (Update from SRS as needed) 5. Object Behavior Diagrams (Update from SRS as needed) 6. Data Design (Data structures and data table design) 7. Other Design Requirements (Any design requirements specific to your project)

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Object Design (1) Here, focus on the component-level design of your objects (attributes and methods) and their messages. 1 - Data structure design 2 - Algorithm design Make sure to adhere to “information Hiding” and “functional independence” concepts as you design your objects.

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Object Design (2) (Class Diagram) - Create a specification class diagram by expanding the conceptual class diagram you created for the SRS. The new diagram should include: - other classes and relationships needed for modeling the solution (those are classes of interest to you - the designer) - details of new classes (attributes and operations) - Include the class diagram at beginning of section 2 of the SDD (slide #3), before the class description tables.

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Object Design (3) (Data Structure Design) For each attribute (variable) in each class, you need to provide more information about it (add columns to top part of the class table from the SRS). Such information include, but note limited to, the type, initial value, valid range of values (upper and lower values), visibility (public or private), what it represent ($, age, grade, etc…), and possible other information… For aggregate data structures (arrays, records, lists, etc…), define needed data structures (if any) in conjunction with class operations. Document your data structures in section 6 (Data Design) of the SDD (slide #3).

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Object Design (4) (Algorithmic Design) For each operation of the class, provide an algorithm description as a self-contained module (add a new column to the table for this purpose). Consider dividing complex operations into separate smaller operations, such that each smaller operation performs a well-defined functions. Apply stepwise refinement concept, such that: - define operation interfaces (list of parameters if any) - fill-in operation body sections - refine body details as needed Note: The level of details of your algorithmic description should be sufficient enough so that the implementer can translated it to source code without help from you (the designer).

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Modeling Diagrams Revise UML sequence diagrams you have in the SRS to include newly added control objects during the design phase and to reflect any changes made to the use-cases. Include revised diagrams in section 3 of the SDD (slide #3). Revise UML object collaboration diagrams you have in the SRS to include newly added control objects during the design phase. Include revised diagrams in section 4 of the SDD (slide #3). Revise UML state transition (behavior) diagrams you have in the SRS to include newly added control objects during the design phase. Include revised diagrams in section 5 of the SDD (slide #3).

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Please Remember… - The SDD has to be self-contained document. Thus, it should includes all the sections outlined in the TOC on slide #3. - SDD content should be updated from that of the SRS to include information and modeling of control objects. Those are implementation related classes that you did not include in the SRS (boundary and control classes) - Most design effort is spent on the object design (algorithmic and data structures details) - Make sure to include information and/or diagrams that were missing from your SRS. - Any other design requirements specific to your application go into section 7.

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. SDD Submission Submit a complete SDD as outline in slide #3. When appropriate, include references toward the end of the document. Review your SDD in conjunction with your SRS and check for flow, consistency, and potential updates to the SRS (if any) Due in class on Wednesday 11/18/09. The cover page should be similar to that of the SRS and to include names, project title, class, semester, and submission date. Please bring professionally prepared printed copy to class and send an electronic copy to the instructor (Word or PDF format).

CS 3610: Software Engineering – Fall 2009 Dr. Hisham Haddad – CSIS Dept. Last Slide