Project DeliverablesProject Deliverables

Version 5: 04/12/2005Version 5: 04/12/2005

Note: This document contains the deliverables from the Note: This document contains the deliverables from the first semester. first semester.

Do review these, as there are changes and some Do review these, as there are changes and some reorganizationreorganization

Overview of GuidanceOverview of Guidance I shall try to upgrade / refine I shall try to upgrade / refine

guidance for each deliverable as we guidance for each deliverable as we progress. progress.

Please view this file often as it will Please view this file often as it will change.change.

Suggestions for clarity and/or Suggestions for clarity and/or consistency are always welcome.consistency are always welcome.

Format of DeliverablesFormat of Deliverables All Deliverables will be via CD. All Deliverables will be via CD. OutsideOutside: Surface of CD is to clearly indicate : Surface of CD is to clearly indicate

your course number and the team number, your course number and the team number, as CEN 6017 - Team 2 or CIS 4328 – as CEN 6017 - Team 2 or CIS 4328 – Team5. Also include the project title.Team5. Also include the project title.

InsideInside: Each deliverable will be in a separate : Each deliverable will be in a separate folder on the same CD, so when I access the folder on the same CD, so when I access the CD, all I should see are individual folders CD, all I should see are individual folders with labels such as Deliverable n, as in with labels such as Deliverable n, as in Deliverable 4. Deliverable 4.

Contents of Folder Contents of Folder Folder is to contain four Word files plus a Folder.Folder is to contain four Word files plus a Folder. Team Num file,Team Num file, with file name as follows (for example): with file name as follows (for example):

Team3.TeamNumFile.Deliverable2.Date.09.27.04 Team3.TeamNumFile.Deliverable2.Date.09.27.04 In this file, you are to simply (may be a single Word file)In this file, you are to simply (may be a single Word file)::

List the names of the team members List the names of the team members Indicate who is team leader with phone number.Indicate who is team leader with phone number. List individual email accounts. List individual email accounts.

Iteration PlanIteration Plan with file name: with file name: Team3.IterationPlan.Deliverable2.Date.09.27.04 Team3.IterationPlan.Deliverable2.Date.09.27.04

Include for second semester deliverables only. Include for second semester deliverables only. Note that the Iteration Plan will change for each Note that the Iteration Plan will change for each

deliverable, that is, it will be deliverable, that is, it will be refined and ‘extendedrefined and ‘extended.’ The .’ The current iteration and a skeletal version of the next current iteration and a skeletal version of the next iteration constitute the ‘extensions.’ Each successive iteration constitute the ‘extensions.’ Each successive deliverable will contain a ‘revised’ Iteration Plan.deliverable will contain a ‘revised’ Iteration Plan.

First semester courses: Executive Summary will suffice.First semester courses: Executive Summary will suffice.

Continued…Continued… EExecutive Summary (in xecutive Summary (in Word) Word) with file name:with file name:

Team3.ExecutiveSummary.Deliverable2.Date.09.27.04Team3.ExecutiveSummary.Deliverable2.Date.09.27.04 Single page document; Summarizes the contents of this folderSingle page document; Summarizes the contents of this folder. .

What ‘activities’ were undertakenWhat ‘activities’ were undertaken What ‘artifacts’ were changed and rationaleWhat ‘artifacts’ were changed and rationale Note: revising artifacts is the norm in an iterative approach to Note: revising artifacts is the norm in an iterative approach to

software development. software development. What What newnew ‘artifacts’ were produced ‘artifacts’ were produced Must include signatures of EACH team member that he/she has Must include signatures of EACH team member that he/she has

reviewed and has ‘bought off’ on the contents of this deliverable.reviewed and has ‘bought off’ on the contents of this deliverable. Vision DocumentVision Document (in Word) (in Word)

ArtifactsArtifacts - a - a FolderFolder Goal: Contains sub folders and single files as appropriate.Goal: Contains sub folders and single files as appropriate. Example: You should have a subfolder entitled Rose Models and Example: You should have a subfolder entitled Rose Models and

perhaps another subfolder entitled Requisite Pro (Grad Students)perhaps another subfolder entitled Requisite Pro (Grad Students) E.g. Should have a folder for Rose Models; Folder for Use Cases; Folder E.g. Should have a folder for Rose Models; Folder for Use Cases; Folder

entitled Management Documents, which should contain simple Word files for, entitled Management Documents, which should contain simple Word files for, say, Risks List, Business Rules, etc… You have some flexibility here. Clear say, Risks List, Business Rules, etc… You have some flexibility here. Clear organization is a must.organization is a must.

New artifacts or revisited artifacts from previous deliverables, - New artifacts or revisited artifacts from previous deliverables, - specific specific componentscomponents of the deliverable should be found here, and a of the deliverable should be found here, and a number of these should be in their own subfolder, such as the user number of these should be in their own subfolder, such as the user interface prototype, Use Case diagrams, use case narratives, interface prototype, Use Case diagrams, use case narratives, analysis model, sequence diagrams. We will discuss in class.analysis model, sequence diagrams. We will discuss in class.

Guidance on the Rose Guidance on the Rose BrowserBrowser

Use Case Diagrams in Use Case Use Case Diagrams in Use Case Folder within Use Case Model in RoseFolder within Use Case Model in Rose Each Use Case is to be a separate Each Use Case is to be a separate

subfolder in the Use Case folder within subfolder in the Use Case folder within Use Case Model (see the Rose Browser).Use Case Model (see the Rose Browser).

But Use Case Narratives are in Requisite Pro But Use Case Narratives are in Requisite Pro for Grad Students.for Grad Students.

Actors in folder within Use Case Actors in folder within Use Case Model in RoseModel in Rose

Grammar and WordingGrammar and Wording Under NO circumstances will poor grammar or ill-conceived Under NO circumstances will poor grammar or ill-conceived

sentences be considered acceptable work. sentences be considered acceptable work. EACH portion of EACH deliverable should be reviewed and EACH portion of EACH deliverable should be reviewed and

‘signed off’ by EACH team member. (See Executive ‘signed off’ by EACH team member. (See Executive Summary)Summary)

Poor adherence to this ‘standard’ will impact EACH team Poor adherence to this ‘standard’ will impact EACH team member. So, check out your text BEFORE you submit it to member. So, check out your text BEFORE you submit it to me.me.

This is a TEAM responsibility!!This is a TEAM responsibility!! On the provided templates, there is room for signoff by the On the provided templates, there is room for signoff by the

team / team members. Use this for verification…team / team members. Use this for verification… This is also required via the Executive Summary document.This is also required via the Executive Summary document.

Second Semester StudentsSecond Semester StudentsGo to Slide 29Go to Slide 29

You may skip over the five deliverables of the You may skip over the five deliverables of the first semester. But there are changes within first semester. But there are changes within them that would make them better.them that would make them better.

There needs to be a deliverable between There needs to be a deliverable between deliverables 3 and 4 where the Façade-level deliverables 3 and 4 where the Façade-level use case is expanded to include the basic use case is expanded to include the basic course of events (but not all alternatives and course of events (but not all alternatives and exceptions) and possibly the activity diagrams exceptions) and possibly the activity diagrams or at least identification (not expansion) of or at least identification (not expansion) of alternative / exceptional threads. alternative / exceptional threads.

This will be added next iteration of this This will be added next iteration of this course…course…

Deliverable #1 The Business CaseDeliverable #1 The Business CaseDue: Wednesday 10/4Due: Wednesday 10/4

Purpose: Purpose: To understand the structure and dynamics of the To understand the structure and dynamics of the organization within which organization within which the application will operatethe application will operate;;To ensure customers, end-users, and developers understand the To ensure customers, end-users, and developers understand the organization;organization;To derive requirements on systems to support the organization;To derive requirements on systems to support the organization;To support these, a number of models and documents are needed. To support these, a number of models and documents are needed. Deliverable Artifacts:Deliverable Artifacts:

Business use case modelBusiness use case modelUse Cases and Actors - ModeledUse Cases and Actors - Modeled

Business object modelBusiness object modelUse Cases realized with actors and entities for the modelingUse Cases realized with actors and entities for the modelingUse Cases realized with actors for the Use Case Descriptions.Use Cases realized with actors for the Use Case Descriptions.

Additional Artifacts Additional Artifacts Business Vision document - textBusiness Vision document - textBusiness Glossary - textBusiness Glossary - textBusiness Rules – textBusiness Rules – text

Business Risk List - textBusiness Risk List - textDomain Model - model in Rational Rose (in next deliverable)Domain Model - model in Rational Rose (in next deliverable)

Guidance on Deliverable #1Guidance on Deliverable #1The Vision DocumentThe Vision Document

Use the templates provided. (You may use Requisite Pro if Use the templates provided. (You may use Requisite Pro if desired. Take the Requisite Pro Quick Tour…)desired. Take the Requisite Pro Quick Tour…)

This is an This is an essential documentessential document and should provide a list of and should provide a list of ‘features’ that the application to be developed should ‘features’ that the application to be developed should possess.possess.

These features are not behavioral (like the Use Cases). These features are not behavioral (like the Use Cases). These are text descriptions. Example of features:These are text descriptions. Example of features:

ClassicsCD.com Web ShopClassicsCD.com Web ShopSecure payment method.Secure payment method.Easy browsing for available titles.Easy browsing for available titles.Ability to check the status of an order.Ability to check the status of an order.Customer shall receive e-mail notification.Customer shall receive e-mail notification.The catalog shall be highly scaleable to include many The catalog shall be highly scaleable to include many titles and effective searching through those titles.titles and effective searching through those titles.Customer shall be able to customize the Web site.Customer shall be able to customize the Web site.Customer shall be able to register as a user for future Customer shall be able to register as a user for future purchases without needing to re-enter personal purchases without needing to re-enter personal information.information.

Guidance on Deliverable #1Guidance on Deliverable #1The Business CaseThe Business Case

Use the appropriate forms available at:Use the appropriate forms available at: RUP document templates are located at the site RUP document templates are located at the site

http://http://jdbv.sourceforge.net/RUP.htmljdbv.sourceforge.net/RUP.html.  .  The link for the Business Rules template is The link for the Business Rules template is

incorrect (points to the Business Modeling incorrect (points to the Business Modeling Guidelines template), so there is another link to Guidelines template), so there is another link to point to the Business Rules format.point to the Business Rules format.

There are also two former student examples on There are also two former student examples on my web page to guide you. (Note: I am not my web page to guide you. (Note: I am not disclosing their grades, or how I graded them.) disclosing their grades, or how I graded them.) These are merely samples of what they submitted.These are merely samples of what they submitted.

Guidance on Deliverable #1Guidance on Deliverable #1The Business CaseThe Business Case

When logging onto Rose, be sure to select RUP icon from When logging onto Rose, be sure to select RUP icon from the initial window.the initial window.

Be also certain to notice the tool mentors – when you select Be also certain to notice the tool mentors – when you select a folder in the Rose Browser, a description often appears a folder in the Rose Browser, a description often appears with invaluable information.with invaluable information.

The Business Use Case Model should be found in the Use The Business Use Case Model should be found in the Use Case View; Case View; This is a single model of the key business processes of the This is a single model of the key business processes of the

organization.organization. Business Object Model in the Logical View.Business Object Model in the Logical View. All business object models and the business use case model All business object models and the business use case model

are to be in a SINGLE copy of Rose.are to be in a SINGLE copy of Rose. (See examples on my web page.)(See examples on my web page.) Put your Business Object Models within the Business Object Put your Business Object Models within the Business Object

Model folder within Logical View in Rose – see examples on Model folder within Logical View in Rose – see examples on web page.web page.

Business object models are realizations of each of the business Business object models are realizations of each of the business use cases and contain business actors. (All domain-oriented)use cases and contain business actors. (All domain-oriented)

Deliverable #2Deliverable #2 Domain ModelDomain Modeland Statement of Work and Statement of Work

Due: October 13thDue: October 13th Develop the Domain ModelDevelop the Domain Model Iterate previous deliverable artifactsIterate previous deliverable artifacts

This means address EACH component and This means address EACH component and fix/repair/enhance/improve, etc. and certify.fix/repair/enhance/improve, etc. and certify.

Don’t make the same mistakes twice.Don’t make the same mistakes twice. Add a Statement of Work (SOW), that is, Add a Statement of Work (SOW), that is,

what is your team plan – who does what, what is your team plan – who does what, what is your plan, etc. (See textbook)what is your plan, etc. (See textbook)

Guidance on Deliverable #2 - Domain Guidance on Deliverable #2 - Domain ModelModel

In In additionaddition to standard items, this deliverable requires a complete Domain to standard items, this deliverable requires a complete Domain Model. The Domain Model is essential to understanding the environment Model. The Domain Model is essential to understanding the environment within which the application to be developed will function. Include also a within which the application to be developed will function. Include also a Statement of Work.Statement of Work.Turn in CD that contains all models and has links to text descriptions. Turn in CD that contains all models and has links to text descriptions.

Purpose:Purpose: Construct Domain Model (precursor activity to Use Case development)Construct Domain Model (precursor activity to Use Case development) Is an essential activity to facilitate good use case development that contains glossary items and objects Is an essential activity to facilitate good use case development that contains glossary items and objects

from the problem space (domain).from the problem space (domain).

Deliverable Artifacts for Deliverable #2:Deliverable Artifacts for Deliverable #2: Domain Model – taking into consideration additional attributes, multiplicities, associations, Domain Model – taking into consideration additional attributes, multiplicities, associations,

etc. The Domain Model should be captured as a etc. The Domain Model should be captured as a separate folderseparate folder under the Logical View under the Logical View in your Rose Browser.in your Rose Browser.

Statement of Work - a Word Document. See textbook and/or templates for formatStatement of Work - a Word Document. See textbook and/or templates for format

Other artifacts from Deliverable #1 to beOther artifacts from Deliverable #1 to be revisited. revisited. (Exec Summary will (Exec Summary will cite what changescite what changes you have done to each artifact…) you have done to each artifact…)

Business use case modelBusiness use case modelUse Cases and Actors - ModeledUse Cases and Actors - ModeledBusiness object modelBusiness object modelBusiness Vision document - textBusiness Vision document - textBusiness Glossary - textBusiness Glossary - textBusiness Rules - textBusiness Rules - text

Guidance on Deliverable #2: Domain Guidance on Deliverable #2: Domain ModelModel

Be certain to see example link on my web page and study Be certain to see example link on my web page and study carefully the slides in the appropriate two lectures. carefully the slides in the appropriate two lectures.

Be certain to fully consider my grading notes to you for Be certain to fully consider my grading notes to you for Deliverable #1 prior to submission of Deliverable #2.Deliverable #1 prior to submission of Deliverable #2.

For first deliverable or two, the Iteration Plan may For first deliverable or two, the Iteration Plan may be more ‘descriptive;’ that is, may contain be more ‘descriptive;’ that is, may contain textual descriptions. For textual descriptions. For subsequent iterations, plan subsequent iterations, plan will be more cryptic, perhaps bulleted, perhaps tabular. will be more cryptic, perhaps bulleted, perhaps tabular.

Not much verbiage. Activities undertaken, schedule, Not much verbiage. Activities undertaken, schedule, developers, results…developers, results…

Deliverable #3 - Use Case - Façade Deliverable #3 - Use Case - Façade Iteration plus Initial User Interface Iteration plus Initial User Interface

Prototype Prototype due: Monday 10/25due: Monday 10/25

Executive Summary (overviews new artifacts Executive Summary (overviews new artifacts and ALL changes/revisions to existing artifacts, and ALL changes/revisions to existing artifacts, such as the revised Iteration Plan, etc. as such as the revised Iteration Plan, etc. as required.required.

Specific Work:Specific Work: Revisit the Business Case (Deliverables 1 and 2) Revisit the Business Case (Deliverables 1 and 2)

including artifacts listed below and update them. including artifacts listed below and update them. (Risks Lists; Business Rules; Domain Model; (Risks Lists; Business Rules; Domain Model; Statement of Work, etc.)Statement of Work, etc.)

Include an index (numbered) for Use Cases that Include an index (numbered) for Use Cases that follow. (discussed in class and via slides)follow. (discussed in class and via slides) Use Case Index is to contain a number, Use Case Use Case Index is to contain a number, Use Case

name, short description, and other high level items name, short description, and other high level items you consider important. Construct this in tabular you consider important. Construct this in tabular form using a table in Word. See power point slides form using a table in Word. See power point slides for detailed attributes neededfor detailed attributes needed

Guidance on Façade Guidance on Façade IterationIteration

Develop an overall Use Case Model (all application Develop an overall Use Case Model (all application Use Cases and Actors). Similar to Business Use Use Cases and Actors). Similar to Business Use Case Model.Case Model.

Develop Develop Façade Use Case DescriptionsFaçade Use Case Descriptions and and associated associated Use Case Diagrams for each Use Case. for each Use Case.

Use Rose (Use Case View) for your models. Link the Use Rose (Use Case View) for your models. Link the Use Case Description text and ensure these Use Case Description text and ensure these descriptions are on the CD you turn in for grading. descriptions are on the CD you turn in for grading.

CEN 6016 students must use Requisite Pro*CEN 6016 students must use Requisite Pro* Model your Façade Use Cases using the Kulak and Model your Façade Use Cases using the Kulak and

Guiney book. Again, see power point lectures for Guiney book. Again, see power point lectures for required attributesrequired attributes. .

Additional information: Visual Modeling book and Additional information: Visual Modeling book and Rose Basics (see power point lecture slides for Rose Basics (see power point lecture slides for examples on including your Use Cases in your Rose examples on including your Use Cases in your Rose Model in the Use Case View.)Model in the Use Case View.)

Guidance onGuidance on: Facade Iteration: Facade Iteration Remember that the Façade iteration names Remember that the Façade iteration names

the use case, identifies actors, provides a the use case, identifies actors, provides a short description, frequently includes pre- and short description, frequently includes pre- and post conditions, triggers, etc. But it does NOT post conditions, triggers, etc. But it does NOT include the detailed actor-system interactions.include the detailed actor-system interactions.

See lecture notes for required attributes.See lecture notes for required attributes. Must include all Use Cases.Must include all Use Cases. Include your single Use Case Model in the Use Include your single Use Case Model in the Use

Case View (in Rose) in the folder provided by Case View (in Rose) in the folder provided by Rose. Note: this is NOT the Business Use Rose. Note: this is NOT the Business Use Case Model, which has been completed; Case Model, which has been completed; more, the icons are different for the actors and more, the icons are different for the actors and use cases. Be sure to note the differences.use cases. Be sure to note the differences.

Guidance on User Interface PrototypeGuidance on User Interface Prototype Develop User Interface Prototype…needed for Develop User Interface Prototype…needed for

requirements capture!!! Iterate this a as needed. requirements capture!!! Iterate this a as needed. (Should be done in conjunction with the Façade Use (Should be done in conjunction with the Façade Use Case and will (together with Domain Model) greatly Case and will (together with Domain Model) greatly assist you for Deliverable #4, your full-blown Use Case assist you for Deliverable #4, your full-blown Use Case Descriptions with alternate and exception paths.Descriptions with alternate and exception paths.

You may use any prototyping tool you wish: VB, Java, You may use any prototyping tool you wish: VB, Java, etc. Your prototype should include storyboarding.etc. Your prototype should include storyboarding. Most teams use static html; some use Front Page; some Most teams use static html; some use Front Page; some

contain Javascript, etc.contain Javascript, etc. Recommend testing your interface with someone from a Recommend testing your interface with someone from a

different group. If you link up with me, I will be glad to assist.different group. If you link up with me, I will be glad to assist. To accompany the Façade Use Cases, user interface To accompany the Façade Use Cases, user interface

prototype needs to be total complete. While we are not prototype needs to be total complete. While we are not including actor – application ‘interchanges,’ these are including actor – application ‘interchanges,’ these are essential for the next deliverable. essential for the next deliverable.

See examples of initial user interface prototypes on See examples of initial user interface prototypes on my web page.my web page.

See also (ahead) lecture slides on User Interface See also (ahead) lecture slides on User Interface DesignDesign

Deliverable #4Deliverable #4Full Use Cases Model & Activity Full Use Cases Model & Activity

DiagramsDiagramsdue: 11/8due: 11/8

Executive SummaryExecutive Summary Develop Focused and Filled Use Case Descriptions and Develop Focused and Filled Use Case Descriptions and

associated Use Case Diagrams for each Use Case.associated Use Case Diagrams for each Use Case. Use Rose (Use Case View) and Requisite Pro*Use Rose (Use Case View) and Requisite Pro* Kulak and Guiney book (Use Cases); Visual Modeling book Kulak and Guiney book (Use Cases); Visual Modeling book

and Rose Basics (see power point lecture slides for and Rose Basics (see power point lecture slides for examples.)examples.)

EachEach Use Case is to be accompanied by an Activity Diagram Use Case is to be accompanied by an Activity Diagram that should indicate flow for all paths in the Use Casethat should indicate flow for all paths in the Use Case

*CEN 6016 Students only*CEN 6016 Students only (Recognize that Use Cases are really never ‘finished.’)(Recognize that Use Cases are really never ‘finished.’) Your Use Case Diagrams will likely be supplemented with Your Use Case Diagrams will likely be supplemented with

Included or Extended Use Cases, as appropriate. Redo your Included or Extended Use Cases, as appropriate. Redo your Use Case Model for the Application.Use Case Model for the Application.

Guidance on Deliverable #4: Guidance on Deliverable #4: ‘Complete’ Use Case Model‘Complete’ Use Case Model

Executive Summary – as usual; All on CD.Executive Summary – as usual; All on CD. Complete Complete Use Case Model and Use Case Diagrams for for

eacheach Use Case – Use Case – This is a major assignmentThis is a major assignment. Consider . Consider alternative, exception flows, and ‘sub-flows’, using alternative, exception flows, and ‘sub-flows’, using extension points as appropriate.extension points as appropriate.

Reflect any use cases you feel are ‘included’ or Reflect any use cases you feel are ‘included’ or ‘extending.’ ‘extending.’

Activity DiagramsActivity Diagrams – one per Use Case (should include – one per Use Case (should include all alternate paths) (Include as package in Rose Model)all alternate paths) (Include as package in Rose Model)

Put Use Cases into groups – packages that ‘seem’ to go Put Use Cases into groups – packages that ‘seem’ to go together functionally, like the GUI or those that address together functionally, like the GUI or those that address business activities. business activities. (These will help in our architecture – as these will become (These will help in our architecture – as these will become

likely subsystems).likely subsystems). Iterate on the Use Case Model and/or your User Iterate on the Use Case Model and/or your User

Interface Prototype (and any other documents) from Interface Prototype (and any other documents) from Deliverable #3 as appropriateDeliverable #3 as appropriate

Guidance on Deliverable #4: Guidance on Deliverable #4: ‘Complete’ Use Case Model‘Complete’ Use Case Model

Allocate functional requirements to use casesAllocate functional requirements to use cases via the stories of via the stories of interchange. (and domain objects) This is a painstaking and interchange. (and domain objects) This is a painstaking and long task! It will underpin your entire design. Spend time long task! It will underpin your entire design. Spend time here!!!! Recognize that Use Cases are NOT functional here!!!! Recognize that Use Cases are NOT functional requirements; rather, they are stories of actor-application requirements; rather, they are stories of actor-application interactions which contain the required functionality.interactions which contain the required functionality.

Requirements with extension points to address alternate and Requirements with extension points to address alternate and exception flows. – see class notes.exception flows. – see class notes.

AllAll customer functionality should be accounted for here. Be customer functionality should be accounted for here. Be certain to use your Domain Model and italicize or bold all certain to use your Domain Model and italicize or bold all references to entities in the domain model.references to entities in the domain model.

Ensure everything the customer desires is accounted for!Ensure everything the customer desires is accounted for!

Keep the alternatives /exceptions WITH the use case. They Keep the alternatives /exceptions WITH the use case. They should be included with the use case and not made should be included with the use case and not made separate. See examples on web page.separate. See examples on web page.

Use the Use the User-Interface to ensure all functionality is User-Interface to ensure all functionality is captured. captured.

Develop Activity Diagrams – one Develop Activity Diagrams – one perper Use Case – that Use Case – that captures all paths (scenarios) in a Use Case. See Visual captures all paths (scenarios) in a Use Case. See Visual Modeling text for examples and use Rose.Modeling text for examples and use Rose.

Activity Diagrams should be placed in the Use Case View Activity Diagrams should be placed in the Use Case View under Use Case Models in a Folder entitled Activity under Use Case Models in a Folder entitled Activity DiagramsDiagrams

Deliverable #5 - Developing the Analysis Deliverable #5 - Developing the Analysis Model and Non-Functional Requirements - Model and Non-Functional Requirements - due 12/01due 12/01 Analysis Model (Preliminary Design)Analysis Model (Preliminary Design)

Contains communicating Contains communicating boundary, control, entity boundary, control, entity objects with relationshipsobjects with relationships, etc. , etc.

Will flow from your use case narratives and prototypeWill flow from your use case narratives and prototype Supports Interaction Modeling and much more…Supports Interaction Modeling and much more… Designed to lead ultimately to the class model (static)Designed to lead ultimately to the class model (static)

Sources: Use your prototype (boundary) again, Sources: Use your prototype (boundary) again, domain model (entities), and use case domain model (entities), and use case descriptions (control) in earnest. They are not descriptions (control) in earnest. They are not enough, but will help. See also your Vision enough, but will help. See also your Vision Document.Document. See Visual ModelingSee Visual Modeling Book; RUP; Logical View on RoseBook; RUP; Logical View on Rose

Guidance on Deliverable #5 Analysis Guidance on Deliverable #5 Analysis ModelModel

Include boundary classes together, control Include boundary classes together, control classes together, and entity classes together all classes together, and entity classes together all without associations to other classes. (a one-without associations to other classes. (a one-page drawing) This should partition all the page drawing) This should partition all the classes by type. Include all attributes / classes by type. Include all attributes / methods with each class, but not connectivity.methods with each class, but not connectivity.

Follow this with a fully ‘connected’ model – for Follow this with a fully ‘connected’ model – for each use case.each use case. Use those analysis classes Use those analysis classes appropriate to the use case and associate the classes.appropriate to the use case and associate the classes.

Be sure to study textbook and lectures on Be sure to study textbook and lectures on boundary, control, and entity models boundary, control, and entity models

Class structure may be realized with the Class structure may be realized with the standard standard stereotypedstereotyped classes or the RUP icons classes or the RUP icons

Guidance on Deliverable #5 Analysis Guidance on Deliverable #5 Analysis ModelModel

Remember, the validity of the model is simply Remember, the validity of the model is simply can I look at any path through a can I look at any path through a use caseuse case and see and see where/which objects will accommodate all the where/which objects will accommodate all the functionality captured in a scenario? Can it be functionality captured in a scenario? Can it be tracedtraced (with your finger...) through the objects (with your finger...) through the objects as you read through the path description? as you read through the path description?

This is the check to make! This is the check to make! VerifyVerify Traceability!!!Traceability!!! Try to cite as many attributes and methods Try to cite as many attributes and methods

(responsibilities) as possible in the respective (responsibilities) as possible in the respective class-names – boundary, control, and entity. class-names – boundary, control, and entity.

Yes, I am after associations, dependencies, etc. Yes, I am after associations, dependencies, etc. among the classes – as much as practical.among the classes – as much as practical.

Guidance on Deliverable #5 Analysis Guidance on Deliverable #5 Analysis ModelModel

For boundary to control classes, the association line is For boundary to control classes, the association line is sufficient, because it cannot be determined what method sufficient, because it cannot be determined what method in control class will be invoked from the boundary class in control class will be invoked from the boundary class unless we consider a specific scenario. Better, though, is unless we consider a specific scenario. Better, though, is a series of boundary classes constituting the interface. a series of boundary classes constituting the interface. See lecture slides for example. See lecture slides for example.

Associations among entity classes should have the Associations among entity classes should have the multiplicities, aggregations, dependencies, etc. cited, as multiplicities, aggregations, dependencies, etc. cited, as usual. They are appropriate here and may come from usual. They are appropriate here and may come from your domain model, which will VERY likely need your domain model, which will VERY likely need upgrading after/during your exercise. upgrading after/during your exercise.

BE CERTAIN to look at the slides on my web site which BE CERTAIN to look at the slides on my web site which ‘supplement’ your readings! There are many examples of ‘supplement’ your readings! There are many examples of the format you will need for the classes.the format you will need for the classes.

For next time:For next time: This Analysis Model assignment This Analysis Model assignment

should include a sequence diagram should include a sequence diagram using the analysis classes for each using the analysis classes for each use case.use case.

Did not require this in the past – Did not require this in the past – should have. should have.

Note: 2/9/05Note: 2/9/05

Guidance Deliverable 5: Non-Functional Guidance Deliverable 5: Non-Functional RequirementsRequirements

See Use Case Textbook for ‘tables’See Use Case Textbook for ‘tables’ Small systems: Small systems:

functionality; performancefunctionality; performance Large systems: Large systems:

Portability; Maintainability; Scalability; Reliability; Portability; Maintainability; Scalability; Reliability; Security Security

How about:How about: Persistence? Persistence?

Will discuss more in class; Remember the Will discuss more in class; Remember the Supplementary Specifications for Non-Supplementary Specifications for Non-Functional Requirements.Functional Requirements.

Thus the Supplementary Specifications Thus the Supplementary Specifications Document should be a Word document Document should be a Word document containing the non-functional ‘tables.’containing the non-functional ‘tables.’

Second Semester DeliverablesSecond Semester Deliverables(anticipated)(anticipated)

Deliverable #6 – User Interface DesignDeliverable #6 – User Interface Design Deliverable #7 – Layered Architectural DesignDeliverable #7 – Layered Architectural Design Deliverable #8 – Detailed Design - Iteration PlanningDeliverable #8 – Detailed Design - Iteration Planning

and Use Case Realizations – Context Diagrams and Use Case Realizations – Context Diagrams only. only. Deliverable #9 – Subsystem Design – InteractionDeliverable #9 – Subsystem Design – Interaction

Diagrams (both) and VOPC diagrams. Diagrams (both) and VOPC diagrams. Deliverable #10 –Class Design and Implementation #1; Deliverable #10 –Class Design and Implementation #1;

First Functional DemonstrationFirst Functional Demonstration Deliverable #11 – Final Deliverable: CompleteDeliverable #11 – Final Deliverable: Complete

Implementation Model and Demonstration including Implementation Model and Demonstration including client testing. client testing.

Deliverable #6 - User Interface Deliverable #6 - User Interface DesignDesign

due: Wednesday, 26 January 2005due: Wednesday, 26 January 2005 Purpose: To design a user interface that reflects Purpose: To design a user interface that reflects

application functionality.application functionality. This should be a refinement of your initial user This should be a refinement of your initial user

interface prototype based on your further interface prototype based on your further learning about your application.learning about your application.

This user interface should demonstrate all This user interface should demonstrate all required functionality as found in the use cases.required functionality as found in the use cases.

In your presentation, you are to In your presentation, you are to demonstratedemonstrate how your UI satisfies all Usability Principles as how your UI satisfies all Usability Principles as cited in the lecture slides and your text.cited in the lecture slides and your text.

Verify your UI by running it against your use Verify your UI by running it against your use cases to ensure all functionality is captured. cases to ensure all functionality is captured.

Deliverable #6 - User Interface Deliverable #6 - User Interface DesignDesign

I should be able to access the Deliverable I should be able to access the Deliverable #6 folder on your CD and bring up the UI #6 folder on your CD and bring up the UI and execute it successfully.and execute it successfully.

Recognize that some of the windows / Recognize that some of the windows / displays will be / may be hard coded and displays will be / may be hard coded and that demonstrated functionality may not that demonstrated functionality may not be backed up with implemented code or be backed up with implemented code or efficient algorithms. But the implied efficient algorithms. But the implied functionality must be evident.functionality must be evident.

Text caveats in the UI are appropriate.Text caveats in the UI are appropriate.

Deliverable #7 – Layered Deliverable #7 – Layered Architecture due: Wed, February 9, Architecture due: Wed, February 9,

20052005 Layers:Layers:

You are to design a layered architectural prototype to You are to design a layered architectural prototype to accommodate your application requirements.accommodate your application requirements.

The The namednamed layers are to consist of major subsystems layers are to consist of major subsystems and packages, their contents (other subsystems, and packages, their contents (other subsystems, packages, etc.). All component dependencies (coupling) packages, etc.). All component dependencies (coupling) are to be indicated via appropriate UML connectors. are to be indicated via appropriate UML connectors.

The main purpose and The main purpose and suggested contentssuggested contents of each of of each of your layers must be spelled out in a text-accompanying your layers must be spelled out in a text-accompanying document. (see lecture slides for examples)document. (see lecture slides for examples)

Your choice (decision) of architectural pattern should be Your choice (decision) of architectural pattern should be fully discussed using the eleven design principles; that fully discussed using the eleven design principles; that is, how does your choice support the design principles is, how does your choice support the design principles enumerated upon in the lecture slides and your enumerated upon in the lecture slides and your textbook. (Word document, please)textbook. (Word document, please)

Deliverable #7 – Layered Deliverable #7 – Layered ArchitectureArchitecture

Subsystems / Packages.Subsystems / Packages. For each subsystem, you should provide a single sentence citing the For each subsystem, you should provide a single sentence citing the

purpose of the subsystem (that is, how it ‘coheres’). purpose of the subsystem (that is, how it ‘coheres’). You should provide a rationale explaining exactly why specific subsystems / You should provide a rationale explaining exactly why specific subsystems /

packages were placed in their respective layers; that is, a record of your packages were placed in their respective layers; that is, a record of your design decisionsdesign decisions. (Cohesion). (Cohesion)

The detailed contents of the subsystems / packages (subsystems, packages, The detailed contents of the subsystems / packages (subsystems, packages, classes and their associations / dependencies) of each design element classes and their associations / dependencies) of each design element should be supplied at this time (cohesion). This means that classes, for should be supplied at this time (cohesion). This means that classes, for example, constituting a subsystem or package, must have their properties example, constituting a subsystem or package, must have their properties named and methods (responsibilities) cited – as much as possible. named and methods (responsibilities) cited – as much as possible.

You should NOT INCLUDE the detailed description of properties (that is, You should NOT INCLUDE the detailed description of properties (that is, float, char, integer, String, etc.) nor the number and types of parameters for float, char, integer, String, etc.) nor the number and types of parameters for the methods nor the algorithms, etc. used by the methods. Only named the methods nor the algorithms, etc. used by the methods. Only named methods / return items.methods / return items.

These models should be realized in Rose. Supplement this layered These models should be realized in Rose. Supplement this layered model separately as needed in Word.model separately as needed in Word.

Deliverable #7 should have the Rose model in a folder with your other Deliverable #7 should have the Rose model in a folder with your other Rose models. Of course, this is merely a significant extension of what Rose models. Of course, this is merely a significant extension of what you already have. So, there should be a Rose folder.you already have. So, there should be a Rose folder.

Also, all supporting Also, all supporting newnew documents for Deliverable #7 that are documents for Deliverable #7 that are associated with associated with this deliverablethis deliverable need to be in a folder entitled: need to be in a folder entitled: Architectural Support Documents, and reside in the Deliverable #7 Architectural Support Documents, and reside in the Deliverable #7 parent folder.parent folder.

Other documents, such as an executive summary, etc. should be Other documents, such as an executive summary, etc. should be separate as usual.separate as usual.

Deliverable #7 – Layered Deliverable #7 – Layered ArchitectureArchitecture

Please note that your architectural Please note that your architectural modeling (layers and their components, modeling (layers and their components, etc.) should be captured in Rose: Logical etc.) should be captured in Rose: Logical View, Design Model, <Layer-Name> Layer.View, Design Model, <Layer-Name> Layer.

The <Layer-Name> Layer has subfolders The <Layer-Name> Layer has subfolders for packages, subsystems, etc., which you for packages, subsystems, etc., which you will like (I hope).will like (I hope).

There are mechanisms for, say, a There are mechanisms for, say, a subsystem, to name the subsystem and subsystem, to name the subsystem and site the dependencies and interfaces site the dependencies and interfaces related to this subsystem.related to this subsystem.

Approximately what I’d like your Approximately what I’d like your deliverable to look like:deliverable to look like:

…

…

…

Presentation Layer

Application Layer

Middleware Layer

Name each of your layers (probably four…), subsubsystems, packages, classes, etc. etc.

See next page.

Subsystem name Package Name Subsystem name

Package name

Package name

Package nameSubsystem name

Subsystem name Subsystem name

However many

However many

However many

Architectural Layers – the basic idea

… additional layers as you decide.

You will communicate the interface of each component by taking each component (subsystem) and showing the responsibilities of the subsystem by showing the interface class. (Note the stereotype below) You will need to show the arguments that are part of the signature.

Please note that a package has no specific interface and thus the classes in a package needs to explicitly show its public interface.

(name interface)<<interface>>

Maintain Database

Addrec(xxxx, xx) boolUpdateRec(xx, xx) intDeleteREc(xxxxxx) etc……

Components and Their Interfaces

You may combine this drawing with the previous drawing; otherwise, make this separate.

For each component, you should also – as much as possible - include the classes and their properties/methods that are needed to ‘realize’ the interface. Recognize those signatures in the interface must be accommodated by the classes or other components (along with other dependencies ‘they’ might have) in the subsystem.

You may also show any dependencies these objects will experience with realizing the interface…

(name interface)<<interface>>

Maintain Database

Addrec(xxxx, xx) boolUpdateRec(xx, xx) intDeleteREc(xxxxxx) etc……

…

… …

Design Elements in Each Component

1..2*

Add properties, methods, and anything else that will assist in realizing the interface.

Showing a dependency between this object (in sub) and an object in another design element (package, here)

We are saying that the interface is realized by this combination of objects and dependencies.

XXXX Package

Deliverable #8: Detailed Design - OverviewDeliverable #8: Detailed Design - Overview due: Wednesday, 2 March 2005 due: Wednesday, 2 March 2005

0. Folder with Deliverable #8 on CD. 0. Folder with Deliverable #8 on CD. Executive Summary, as usual.Executive Summary, as usual.

1. A carefully constructed Iteration Plan. 1. A carefully constructed Iteration Plan. This now becomes an essential part of your This now becomes an essential part of your deliverable, as we are about to go into the deliverable, as we are about to go into the Construction phase.Construction phase.

2. A sequence diagram and a 2. A sequence diagram and a communications diagrams for the basic communications diagrams for the basic course of events for each of your use cases. course of events for each of your use cases. The sequence diagram is to be fully annotated, The sequence diagram is to be fully annotated,

as shown in lecture slides.as shown in lecture slides. This is a design-level sequence diagram, so it This is a design-level sequence diagram, so it

should include subsystems via their interfaces; should include subsystems via their interfaces; also the persistency mechanism.also the persistency mechanism.

Deliverable #8: Detail Design – Iteration Deliverable #8: Detail Design – Iteration PlanPlan

Iteration PlanIteration Plan You should sketch out what you feel will be the number of You should sketch out what you feel will be the number of

iterations that will be needed and the features (scenarios) iterations that will be needed and the features (scenarios) that you will implement in each iteration.that you will implement in each iteration.

Remember! Jump on the scenarios / features that you Remember! Jump on the scenarios / features that you feel present to your team the MOST RISK! Secondly, your feel present to your team the MOST RISK! Secondly, your most important most important core functionalitiescore functionalities should be second. should be second.

Map these out into a number of iterations with short Map these out into a number of iterations with short duration and stick to the plan. Include dates, scenarios, duration and stick to the plan. Include dates, scenarios, and responsible developers, expected outcomes, and and responsible developers, expected outcomes, and room for your iteration assessment - shortcomings (a post room for your iteration assessment - shortcomings (a post mortem). Use Word or Excel. Include span time dates of mortem). Use Word or Excel. Include span time dates of iteration!iteration!

Your first iteration must be totally understood before you Your first iteration must be totally understood before you start it and you should have a ‘pretty good idea’ of the start it and you should have a ‘pretty good idea’ of the specifics of your second. As you finish the first, roll into specifics of your second. As you finish the first, roll into the second one anything ‘not quite right,’ finalize it before the second one anything ‘not quite right,’ finalize it before you start this one and map out a ‘pretty good idea’ for you start this one and map out a ‘pretty good idea’ for the third iteration. Iterate.the third iteration. Iterate.

Deliverable #8: Detail Design – Iteration Deliverable #8: Detail Design – Iteration PlanPlan

Technology Assessment.Technology Assessment. Your iteration plan should include your Your iteration plan should include your

preliminary assessment of the technologies preliminary assessment of the technologies that you plan to use, where (for what that you plan to use, where (for what features) you plan to use them, sources of features) you plan to use them, sources of knowledge of these technologies and overall knowledge of these technologies and overall assessment of your team’s familiarities with assessment of your team’s familiarities with these technologies.these technologies.

Tell me who knows what and the extent of Tell me who knows what and the extent of that knowledge.that knowledge.

See examples on my web page .See examples on my web page .

Deliverable #8: Detail Design – Use Case Deliverable #8: Detail Design – Use Case RealizationsRealizations

Interaction Diagrams.Interaction Diagrams. For each Use Case, you are to develop a For each Use Case, you are to develop a

Sequence Diagram in Rose. These should be Sequence Diagram in Rose. These should be located in the Logical View, Design Package, located in the Logical View, Design Package, etc. Check out Use Case Realizations.etc. Check out Use Case Realizations.

Sequence diagrams are to be fully annotated Sequence diagrams are to be fully annotated and should include subsystem interfaces, and should include subsystem interfaces, persistency references, etc. as appropriate.persistency references, etc. as appropriate.

Be certain to look at past examples of Be certain to look at past examples of sequence diagrams in the lecture slides.sequence diagrams in the lecture slides.

Use the toggle (F5) to generate the Use the toggle (F5) to generate the Communications Diagram.Communications Diagram.

Deliverable #8: Detail Design – Use Case Deliverable #8: Detail Design – Use Case RealizationsRealizations

Class DiagramClass Diagram For each sequence diagram, you are to For each sequence diagram, you are to

produce in Rose the VOPC (View of produce in Rose the VOPC (View of Participating Classes) for that sequence Participating Classes) for that sequence diagram. diagram.

Be certain to include all the associations, Be certain to include all the associations, multiplicities, etc. in this class diagram.multiplicities, etc. in this class diagram.

Some of the details of Deliverable #7 that Some of the details of Deliverable #7 that might not have gotten ‘finalized’ (the might not have gotten ‘finalized’ (the attributes and operations of some of the attributes and operations of some of the classes) will need to be finalized at this time.classes) will need to be finalized at this time.

Deliverable #9 – Detail DesignDeliverable #9 – Detail DesignSubsystem Design and Realization – Subsystem Design and Realization –

due: 16 March 2005due: 16 March 2005 For each subsystem, you are to provide an For each subsystem, you are to provide an interaction interaction

diagramdiagram of at least one responsibility accommodated of at least one responsibility accommodated by the subsystem from its interface. (lecture 32)by the subsystem from its interface. (lecture 32) No more than one interaction diagram should address No more than one interaction diagram should address

accommodating persistency. You should, however, include accommodating persistency. You should, however, include one that does this.one that does this.

You should also present the corresponding communications You should also present the corresponding communications (collaboration) diagram. Note the differences.(collaboration) diagram. Note the differences.

You are also to provide the internal structure of your You are also to provide the internal structure of your subsystems, like slides 4 and 6 in lecture 33. This is subsystems, like slides 4 and 6 in lecture 33. This is your VOPC. These are to be fully annotated your VOPC. These are to be fully annotated (dependencies, communications, multiplicities, etc.)(dependencies, communications, multiplicities, etc.)

You are to annotate via stereotyping which objects You are to annotate via stereotyping which objects are persistent in your modified VOPC as well as any are persistent in your modified VOPC as well as any other stereotyping you feel is necessary in this other stereotyping you feel is necessary in this rendering. (see lectures on class design and rendering. (see lectures on class design and persistency)persistency)

Deliverable #9 – Detail DesignDeliverable #9 – Detail DesignSubsystem Design and Realization Subsystem Design and Realization

All messages in your sequence diagrams All messages in your sequence diagrams need to be numbered need to be numbered as shownas shown in lecture 32 in lecture 32 (numbers and their sub-parts).(numbers and their sub-parts).

ALL of your design class model elements ALL of your design class model elements must have the package or subsystem they must have the package or subsystem they are associated with in with the class header are associated with in with the class header as shown in lecture 33. Packages and as shown in lecture 33. Packages and Subsystems should have a stereotype Subsystems should have a stereotype indicating the layer in which they reside.indicating the layer in which they reside.

Sequence Diagrams may require UML Notes Sequence Diagrams may require UML Notes to clarify interactions. Use them as to clarify interactions. Use them as necessary.necessary.

Deliverable #9 - QuestionsDeliverable #9 - Questions What is a proxy class and what is its purpose?What is a proxy class and what is its purpose? What do we mean by a dependency?What do we mean by a dependency?

What are the pros and cons of dependencies?What are the pros and cons of dependencies? Under what kind of situation is a subsystem Under what kind of situation is a subsystem

interface sufficient in a sequence diagram?interface sufficient in a sequence diagram? In behavioral modeling, when must the interface be In behavioral modeling, when must the interface be

realized? How is it done? What kind of model(s) realized? How is it done? What kind of model(s) is/are used to capture the details of the inner is/are used to capture the details of the inner workings of a subsystem?workings of a subsystem?

Why should dependencies on a subsystem be on Why should dependencies on a subsystem be on the subsystem interface?the subsystem interface?

Turn these in via a separate Word document.Turn these in via a separate Word document.

Deliverable #10Deliverable #10Class Design and Implementation Class Design and Implementation

#1 due 30 March#1 due 30 March In addition to Executive Summary, In addition to Executive Summary, Update your Iteration Plan for remaining iterations Update your Iteration Plan for remaining iterations

based on your assessment of the previous iterations. based on your assessment of the previous iterations. Document that assessment as part of the Iteration Document that assessment as part of the Iteration

Plan (may use Word)Plan (may use Word) This may likely be a few paragraphs. Don’t wimp out on this!This may likely be a few paragraphs. Don’t wimp out on this!

Ensure all methods in your Use Case Realizations Ensure all methods in your Use Case Realizations have full signatures in their calling sequences.have full signatures in their calling sequences.

Using Rose, ensure your classes and attributes are Using Rose, ensure your classes and attributes are all correct by revising your VOPCs ensuring that all all correct by revising your VOPCs ensuring that all connections are either associations or dependencies. connections are either associations or dependencies. This can be shown by clicking on objects across the This can be shown by clicking on objects across the top of sequence diagrams and filling in the window top of sequence diagrams and filling in the window specifications.specifications.

Deliverable #10Deliverable #10Class Design and Implementation Class Design and Implementation

#1 due 30 March#1 due 30 March Document Document howhow your Use Cases drove your Use Cases drove

your iteration plan and development.your iteration plan and development. Document Document howhow your architecture your architecture

assisted (was central) in your assisted (was central) in your development.development.

Demonstrate and Discuss your (first and) Demonstrate and Discuss your (first and) second Iterationsecond Iteration in class (possibly) in class (possibly) (not formal; 15 minutes per team)(not formal; 15 minutes per team)

Deliverable #10Deliverable #10Class Design and Implementation Class Design and Implementation

#1 due 30 March#1 due 30 March You are to include your source-level components. You are to include your source-level components.

These need to be organized ‘by design unit’ (that These need to be organized ‘by design unit’ (that is, package, subsystem), ‘by component’ (within is, package, subsystem), ‘by component’ (within these higher level components). Read these higher level components). Read documentation section of Component View in Rose.documentation section of Component View in Rose.

Please note: Your source code absolutely must Please note: Your source code absolutely must be internally documented with meaningful, guiding be internally documented with meaningful, guiding comments. These will be reviewed very carefully!!!comments. These will be reviewed very carefully!!!

So, your organization should be Component View, So, your organization should be Component View, Implementation Model, Package or Subsystem, and Implementation Model, Package or Subsystem, and specific component within the owning package or specific component within the owning package or subsystem.subsystem.

Deliverable #11 – FinalDeliverable #11 – FinalTesting and DemonstrationTesting and Demonstration

This deliverable is a chance to This deliverable is a chance to finalizefinalize any shortcomings in your Iteration Plans, any shortcomings in your Iteration Plans, Rose Models, or any design Rose Models, or any design models/artifacts you have undertaken.models/artifacts you have undertaken.

ALL ALL codecode is to be fully documented and is to be fully documented and submitted in folders “by type,” that means submitted in folders “by type,” that means jsp files together, .java files together, jsp files together, .java files together, servlets, …etc.servlets, …etc.

There will NOT be a separate test plan There will NOT be a separate test plan document required, as originally planned. document required, as originally planned.

Deliverable #11 – FinalDeliverable #11 – FinalTesting and DemonstrationTesting and Demonstration

On the day you are demonstrating your projects, On the day you are demonstrating your projects, you are to provide to me a hardcopy of your use you are to provide to me a hardcopy of your use cases. I will arbitrarily select one or two for you cases. I will arbitrarily select one or two for you to demonstrate during class. to demonstrate during class.

You may also be asked some general questions.You may also be asked some general questions. Your demonstration, etc. should not last beyond Your demonstration, etc. should not last beyond

thirty minutes.thirty minutes. If you need separate computer support, you If you need separate computer support, you

should plan to go to class early to set up / should plan to go to class early to set up / connect to whatever you need.connect to whatever you need.

Good luck and have fun!Good luck and have fun!