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
Last Slide
Dr. Hisham Haddad – CSIS Dept.