System Spec, Version 1

This delivery is a partial Vision and Scope document that focuses on why the system exists and what it should do, but without all detailed requirements listed. This delivery shows already a part of the system solution, by illustrating it with a deployment diagram.

Content

The delivery must contain the following sections:

Requirements Part

1. Problem and Background

Provide a brief description of the problem you want to solve. It should provide the context so that the reader can understand your vision in the next section.

Hints:

2. Vision

Provide a vision for the system to build. All team members should be aware of this vision and share it. Be concise and specific. Ideally, the vision connects the objectives with the problem description. The vision provides some details about the system that explain in very coarse language how the system will tackle the problem. It highlights what is new or special with the system.

Hints:

3. Objectives

State at least three objectives, but not much more than five. Objectives are goals that your system can achieve. They need to be specific, and they need to be verifiable. State the objective, and state how it can be verified. Objectives do not yet explain how the system is implemented, but are oriented towards the users' domain.

Hints:

4. Stakeholders

Identify the main stakeholders in the system. Identify their values and interest. Present all in a table.

Hints:

Criteria for the Requirements Part

All sections in the requirement part are evaluated together with the following criteria:

 

Excellent

Good

Sufficient

Not rateable

Alignment

Noticable and consistent alignment between all parts.

Overall good alignment between all parts.

Minor inconsisentcies in alignment.

Missing alignment.

Descriptions

Concise descriptions with focused formulations.

Overall good language.

Minor flaws in formulations and language.

Major language errors and typos.

Problem Description

 

Clearly identified, motivated and explained.

Problem is addressed and somewhat aligned with objectives and vision.

 

Vision

Vision serves as overall, consistent goal for the entire system.

Vision is well aligned with the problem and objectives.

Vision is provided, but somewhat lacking in overall value.

 

Objectives

Objectives are focused, compact, specific and relevant.

Objectives are specific.

A few good objectives are given.

 

Stakeholders

Reveal valuable requirements and motivation.

Are complete.

   
 

Use Case Part

5. Use Case Sea-Level Hierarchy

This is not an official diagram type, but it turned out so useful for the development process that we decided to add it as part of the delivery.

Show at least three use cases at the sea level. Add relevant ones at the fish-level that support the sea-level use cases. Also, make sure to have at least one cloud-level use case and relevant ones at the kit level to connect cloud-level with sea-level. Make sure that the use cases are at the right level and relevant for the vision and objectives of the system.

 

Excellent

Good

Sufficient

Not rateable

Hierarchy

Clear connection between use cases at different levels.

 

Connections between use cases of different levels.

No connection between use cases at different levels.

Levels

All use cases at proper levels.

All use cases at the sea level are relevant and correctly placed.

Most use cases are at a relevant level.

Use cases are not at the correct level.

Relevance

Clear relevance of the selected use cases for the requirements.

   

Selection of use cases appears random.

 

Architecture Part

7. Deployment Diagram

Present a first version of a deployment diagram of your system. Identify the main execution nodes of your system and how they are connected. Identify critical hardware components (even if you later chose to simulate them.) Identify communication protocols that you are already aware of, and identify execution environments.

Hints: Most likely, the deployment diagram will fit on a single A4 page in landscape orientation.

Criteria for the Deployment Diagram

The deployment diagram is evaluated based on general criteria for diagrams.

 

Excellent

Good

Sufficient

Not rateable

Layout

Layout follows a strategy that helps to understand the diagram.

Layout is structured.

Layout is structured.

Layout is unstructured and random.

Syntax

Correct syntax.

Correct Syntax.

Overall good syntax, with a few minor errors.

Major syntactical flaws.

Level of Detail

Consistent and intentional level of detail.

Adequate detailing.

Some inconsistencies, too much focus on some details on the expense of others.

 
 

Feedback Document and Delivery

On Teams, you find a template for the evaluation document, under Semester Project / feedback-v1-team-xx.docx. Create a copy, and fill it out for your own team:

Delivery

Deliver both the system specification and the feedback document via Blackboard.