diff --git a/process/general_concepts/_assets/score_building_blocks_meta_model.drawio.svg b/process/general_concepts/_assets/score_building_blocks_meta_model.drawio.svg index 7bcef5b319..2805a92423 100644 --- a/process/general_concepts/_assets/score_building_blocks_meta_model.drawio.svg +++ b/process/general_concepts/_assets/score_building_blocks_meta_model.drawio.svg @@ -1,1615 +1,4 @@ - - - - - - - - - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - - -
-
-
- Feature -
-
-
-
- - Feature - -
-
-
- - - - - - - - - -
-
-
- Component -
-
-
-
- - Component - -
-
-
- - - - - - - - - -
-
-
- SEooC -
-
-
-
- - SEooC - -
-
-
- - - - - - - - -
-
-
- is -
-
-
-
- - is - -
-
-
- - - - - - - - - -
-
-
- Feature -
- Requirements -
-
-
-
- - Feature... - -
-
-
- - - - - - - - -
-
-
- fulfills -
-
-
-
- - fulfills - -
-
-
- - - - - - - - - -
-
-
- Feature -
- Architecture -
-
-
-
- - Feature... - -
-
-
- - - - - - - - -
-
-
- satifies -
-
-
-
- - satifies - -
-
-
- - - - - - - - - -
-
-
- Component -
- Requirements -
-
-
-
- - Component... - -
-
-
- - - - - - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - -
-
-
- consists of -
-
-
-
- - consists of - -
-
-
- - - - - - - - - - - - - -
-
-
- Unit -
-
-
-
- - Unit - -
-
-
- - - - - - - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - -
-
-
- consists of -
-
-
-
- - consists of - -
-
-
- - - - - - - - - -
-
-
- Source Code -
-
-
-
- - Source Code - -
-
-
- - - - -
-
-
- has -
-
-
-
- - has - -
-
-
- - - - - - - - - - - - - -
-
-
- Stakeholder -
- Requirements -
-
-
-
- - Stakeholder... - -
-
-
- - - - - - - - -
-
-
- satifies -
-
-
-
- - satifies - -
-
-
- - - - - - - - - - - -
-
-
- - implements - -
-
-
-
- - implements - -
-
-
- - - - -
-
-
- has -
-
-
-
- - has - -
-
-
- - - - - - - - - - - - - -
-
-
- Platform -
-
-
-
- - Platform - -
-
-
- - - - - - - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - -
-
-
- consists of -
-
-
-
- - consists of - -
-
-
- - - - -
-
-
- has -
-
-
-
- - has - -
-
-
- - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - - -
-
-
- Objectives -
-
-
-
- - Objectives - -
-
-
- - - - - - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - - - - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - - - - - -
-
-
- fulfills -
-
-
-
- - fulfills - -
-
-
- - - - - - - - - -
-
-
- Component -
- Architecture -
-
-
-
- - Component... - -
-
-
- - - - - - - - -
-
-
- satifies -
-
-
-
- - satifies - -
-
-
- - - - - - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - - -
-
-
- Detailed -
- Design -
-
-
-
- - Detailed... - -
-
-
- - - - - - - - - - - - -
-
-
- satifies -
-
-
-
- - satifies - -
-
-
- - - - - - - - -
-
-
- implements -
-
-
-
- - implements - -
-
-
- - - - -
-
-
- consists of -
-
-
-
- - consists of - -
-
-
- - - - - - - - -
-
-
- implements -
-
-
-
- - implements - -
-
-
- - - - - - - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - - - - -
-
-
- * -
-
-
-
- - * - -
-
-
- - - - - - - - - -
-
-
- Software Module -
-
-
-
- - Software Module - -
-
-
- - - - - - - - -
-
-
- includes -
-
-
-
- - includes - -
-
-
- - - - - - - -
-
-
- 1,* -
-
-
-
- - 1,* - -
-
-
- - - - - - - - - -
-
-
- * -
-
-
-
- - * - -
-
-
- - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - -
-
-
- is -
-
-
-
- - is - -
-
-
- - - - - - - - - - - - - - - - - - - - - -
-
-
- Feature -
- Safety Analysis -
-
-
-
- - Feature... - -
-
-
- - - - - - - - - -
-
-
- Feature -
- Assumptions of use -
-
-
-
- - Feature... - -
-
-
- - - - - - - - - - - - - -
-
-
- Platform Integration -
- Tests -
-
-
-
- - Platform Integration... - -
-
-
- - - - - - - - - - - - - - - - - -
-
-
- Feature -
- Integration Tests -
-
-
-
- - Feature... - -
-
-
- - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - -
-
-
- violates -
-
-
-
- - violates - -
-
-
- - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - - - - - - - - - - -
-
-
- Component -
- Integration Tests -
-
-
-
- - Component... - -
-
-
- - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - - - - - - - - - - -
-
-
- Component -
- Safety Analysis -
-
-
-
- - Component... - -
-
-
- - - - - - - - - - - - - -
-
-
- Component -
- Assumption of use -
-
-
-
- - Component... - -
-
-
- - - - -
-
-
- violates -
-
-
-
- - violates - -
-
-
- - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - - - - - - -
-
-
- Unit Test -
-
-
-
- - Unit Test - -
-
-
- - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - -
-
-
- has -
-
-
-
- - has - -
-
-
- - - - - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - - - - -
-
-
- 1,* -
-
-
-
- - 1,* - -
-
-
- - - - - - - - - - - - - -
-
-
- SW-Platform -
- Assumptions of use -
-
-
-
- - SW-Platform... - -
-
-
- - - - -
-
-
- satisfies -
-
-
-
- - satisfies - -
-
-
-
- - - - - Text is not SVG - cannot display - - - -
+ + + +
1, *
1, *
Feature
Feature
Component
Component
SEooC
SEooC
is
is
Feature
Requirements
Feature...
fulfills
fulfills
Feature
Architecture
Feature...
satifies
satifies
Component
Requirements
Component...
1
1
consists of
consists of
Unit
Unit
1, *
1, *
consists of
consists of
Source Code
Source Code
has
has
Stakeholder
 Requirements
Stakeholder...
satifies
satifies
implements
implements
has
has
Platform
Platform
1, *
1, *
consists of
consists of
has
has
1, *
1, *
Objectives
Objectives
1
1
1, *
1, *
fulfills
fulfills
Component
Architecture
Component...
satifies
satifies
1, *
1, *
Detailed
Design
Detailed...
satifies
satifies
implements
implements
consists of
consists of
implements
implements
1
1
*
*
Software Module
Software Module
includes
includes
1,*
1,*
*
*
1, *
1, *
is
is
Feature Safety/
Security Analysis
Feature Safety/...
Feature
Assumptions of use
Feature...
Platform Integration 
Tests
Platform Integration...
Feature
Integration Tests
Feature...
verifies
verifies
violates
violates
mitigated_by
mitigated_by
verifies
verifies
Component
Integration Tests
Component...
verifies
verifies
Component Safety/
Security Analysis
Component Safety/...
Component
Assumption of use
Component...
violates
violates
mitigated_by
mitigated_by
mitigated_by
mitigated_by
mitigated_by
mitigated_by
verifies
verifies
Unit Test
Unit Test
verifies
verifies
verifies
verifies
has
has
1
1
1,*
1,*
SW-Platform
Assumptions of use
SW-Platform...
satisfies
satisfies
Text is not SVG - cannot display
\ No newline at end of file diff --git a/process/general_concepts/_assets/score_traceability_model_cmp_overview_1.drawio.svg b/process/general_concepts/_assets/score_traceability_model_cmp_overview_1.drawio.svg index 02ff7f32fa..819c61dde3 100644 --- a/process/general_concepts/_assets/score_traceability_model_cmp_overview_1.drawio.svg +++ b/process/general_concepts/_assets/score_traceability_model_cmp_overview_1.drawio.svg @@ -1,4 +1,4 @@ -
Component Assumption of use
Component Assumption...
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...


Component
 Architecture


Component...
Component
Safety Analysis
Component...
Feature
Architecture
Feature...

(external) Component Assumption of use
(external) Component...
Implementation
including Detailed Design and Unit
Implementation...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
implements
implements
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
fulfills
fulfills
fulfills
fulfills
satisfies
satisfies
satisfies
satisfies
violates
violates
mitigated_by
mitigated_by
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by
Text is not SVG - cannot display
\ No newline at end of file +
Component Assumption of use
Component Assumption...
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...


Component
 Architecture


Component...
Component
Safety/Security Analysis
Component...
Feature
Architecture
Feature...

(external) Component Assumption of use
(external) Component...
Implementation
including Detailed Design and Unit
Implementation...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
implements
implements
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
fulfills
fulfills
fulfills
fulfills
satisfies
satisfies
satisfies
satisfies
violates
violates
mitigated_by
mitigated_by
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by
Text is not SVG - cannot display
\ No newline at end of file diff --git a/process/general_concepts/_assets/score_traceability_model_cmp_overview_2.drawio.svg b/process/general_concepts/_assets/score_traceability_model_cmp_overview_2.drawio.svg index f5063908b6..407ecc7142 100644 --- a/process/general_concepts/_assets/score_traceability_model_cmp_overview_2.drawio.svg +++ b/process/general_concepts/_assets/score_traceability_model_cmp_overview_2.drawio.svg @@ -1,4 +1,4 @@ -
Component Assumption of use
Component Assumption...
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Component
 Architecture



Component...
Component
Safety Analysis
Component...
Feature
Architecture
Feature...

(external) Component Assumption of use
(external) Component...
Implementation
including Detailed Design and Unit
Implementation...
Component 1
Component 1
Component n
Component n
...
...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
satisfies
satisfies
satisfies
satisfies
violates
violates
mitigated_by
mitigated_by
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by
implements
implements
fulfills
fulfills
fulfills
fulfills
Text is not SVG - cannot display
\ No newline at end of file +
Component Assumption of use
Component Assumption...
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Component
 Architecture



Component...
Component
Safety/Security Analysis
Component...
Feature
Architecture
Feature...

(external) Component Assumption of use
(external) Component...
Implementation
including Detailed Design and Unit
Implementation...
Component 1
Component 1
Component n
Component n
...
...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
satisfies
satisfies
satisfies
satisfies
violates
violates
mitigated_by
mitigated_by
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by
implements
implements
fulfills
fulfills
fulfills
fulfills
Text is not SVG - cannot display
\ No newline at end of file diff --git a/process/general_concepts/_assets/score_traceability_model_cmp_overview_3.drawio.svg b/process/general_concepts/_assets/score_traceability_model_cmp_overview_3.drawio.svg index a481c71bdc..92b647b770 100644 --- a/process/general_concepts/_assets/score_traceability_model_cmp_overview_3.drawio.svg +++ b/process/general_concepts/_assets/score_traceability_model_cmp_overview_3.drawio.svg @@ -1,4 +1,4 @@ -
Component Assumption of use
Component Assumption...
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Component
Safety Analysis
Component...
Feature
Architecture
Feature...

Implementation
including Detailed Design and Unit
Implementation...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
implements
implements
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
mitigated_by
mitigated_by
mitigated_by
mitigated_by
Text is not SVG - cannot display
\ No newline at end of file +
Component Assumption of use
Component Assumption...
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Component
Safety/Security Analysis
Component...
Feature
Architecture
Feature...

Implementation
including Detailed Design and Unit
Implementation...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
implements
implements
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
mitigated_by
mitigated_by
mitigated_by
mitigated_by
Text is not SVG - cannot display
\ No newline at end of file diff --git a/process/general_concepts/_assets/score_traceability_model_feat_overview.drawio.svg b/process/general_concepts/_assets/score_traceability_model_feat_overview.drawio.svg index e487a2a0b6..360327494e 100644 --- a/process/general_concepts/_assets/score_traceability_model_feat_overview.drawio.svg +++ b/process/general_concepts/_assets/score_traceability_model_feat_overview.drawio.svg @@ -1,4 +1,4 @@ -
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Feature
Architecture
Feature...

(external) Component Assumption of use
(external) Component...
Stakeholder
Requirements
Stakeholder...
Feature Assumption of use
Feature Assumption o...
Feature
Safety Analysis
Feature...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
satisfies
satisfies
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
SW-Platform
Assumption of Use
SW-Platform...
satisfies
satisfies
contains
contains
?
?
Text is not SVG - cannot display
\ No newline at end of file +
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Feature
Architecture
Feature...

(external) Component Assumption of use
(external) Component...
Stakeholder
Requirements
Stakeholder...
Feature Assumption of use
Feature Assumption o...
Feature
Safety/Security Analysis
Feature...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
satisfies
satisfies
satisfies
satisfies
fulfills
fulfills
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
SW-Platform
Assumption of Use
SW-Platform...
satisfies
satisfies
contains
contains
?
?
Text is not SVG - cannot display
\ No newline at end of file diff --git a/process/general_concepts/score_building_blocks_concept.rst b/process/general_concepts/score_building_blocks_concept.rst index b2cc4dcb42..1092a2656b 100644 --- a/process/general_concepts/score_building_blocks_concept.rst +++ b/process/general_concepts/score_building_blocks_concept.rst @@ -17,6 +17,10 @@ Building blocks concept ----------------------- +.. doc_concept:: Building Block Concept + :id: doc_concept__general_building_blocks + :status: valid + :tags: process_management Building blocks meta model ++++++++++++++++++++++++++ @@ -42,9 +46,9 @@ also implemented by the **Source Code** (grey box, bottom, 3rd column). The Deta verified by **Unit Tests** (grey box, middle, 5th column). Components are defined by **Component Requirements** (green box, middle, 3rd column) and the -**Component Architecture** (green box, middle, 4th column). A **Component Safety Analysis** +**Component Architecture** (green box, middle, 4th column). A **Component Safety/Security Analysis** (green box, middle, 6th column) is required to verify the Component Architecture, whereby -violations of safety requirements must be documented. Potential faults +violations of safety/security requirements must be documented. Potential faults may mitigated by updating the Component Requirements or by the **Component Assumptions of Use** (green box, middle, 8nd column). The latter one must be considered by the user of the Component. **Component Tests** (green box, middle, 5th column) verify the Component requirements, and @@ -54,8 +58,8 @@ as well as the Integration of multiple Units to a Component. As mentioned above a Software Module is defined as a Component or a set of components realizing a Feature of the platform. Features consists of Components and are defined by **Feature Requirements** (yellow box, middle, 3rd column) and the **Feature Architecture** (yellow box, middle, 4th column). -A **Feature Safety Analysis** (yellow box, middle, 6th column) is required to verify the Feature -Architecture, whereby violations of safety requirements must be documented. Potential +A **Feature Safety/Security Analysis** (yellow box, middle, 6th column) is required to verify the Feature +Architecture, whereby violations of safety/security requirements must be documented. Potential faults may mitigated by updating the Feature Requirements or by the **Feature Assumptions of Use** (yellow box, middle, 8nd column). The latter one must be considered by the user of the Feature. **Feature Integration Tests** (yellow box, middle, 5th column) verify diff --git a/process/general_concepts/score_lifecycle_concept.rst b/process/general_concepts/score_lifecycle_concept.rst index f23551a166..1467a91cd2 100644 --- a/process/general_concepts/score_lifecycle_concept.rst +++ b/process/general_concepts/score_lifecycle_concept.rst @@ -17,6 +17,11 @@ Lifecycle concept ----------------- +.. doc_concept:: Lifecycle Concept + :id: doc_concept__general_lifecycle + :status: valid + :tags: process_management + Contributions to the project are driven by feature/component requests. As features and components are the main structuring elements of the project, new diff --git a/process/general_concepts/score_traceability_concept.rst b/process/general_concepts/score_traceability_concept.rst index f0b2945fd5..30a80604e6 100644 --- a/process/general_concepts/score_traceability_concept.rst +++ b/process/general_concepts/score_traceability_concept.rst @@ -17,6 +17,11 @@ Traceability concept -------------------- +.. doc_concept:: Traceability Concept + :id: doc_concept__general_traceability + :status: valid + :tags: process_management + Traceability is the key to ensure consistency between work products. Furthermore, traceability supports impact analysis, dependency analysis, coverage determination for requirements and verification, and tracking of implementation status. @@ -33,7 +38,7 @@ High level traceability overview The following figure shows the traceability between the major project work products on each requirements level. Starting from top, the platform level, going down to feature, component to the bottom the unit level. The concept is based on the classical V-model approach. -Note also that this decribes the traceability of functional (and interface) type requirements. +Note also that this describes the traceability of functional (and interface) type requirements. Change request are traced to all affected work products. @@ -46,7 +51,7 @@ Change request are traced to all affected work products. High level traceability overview for project work products The next figure sets the focus on the feature level and adds the traceability from the Feature -Requirements to the Feature Architecture, Feature Safety Analysis and the Feature Assumption +Requirements to the Feature Architecture, Feature Safety/Security Analysis and the Feature Assumption of use. For convenience also the traceability to upper and lower lever requirements is shown. .. figure:: _assets/score_traceability_model_feat_overview.drawio.svg @@ -57,7 +62,7 @@ of use. For convenience also the traceability to upper and lower lever requireme High level traceability overview for project feature work products The next figures sets the focus on the component level and adds the traceability from the -Component Requirements to the Component Architecture, Component Safety Analysis +Component Requirements to the Component Architecture, Component Safety/Security Analysis and the Component Assumption of use. Further the traceability to Component Assumptions of use from external Components is included. diff --git a/process/introduction/index.rst b/process/introduction/index.rst index db10d796d7..12cd11d27c 100644 --- a/process/introduction/index.rst +++ b/process/introduction/index.rst @@ -17,6 +17,11 @@ Introduction ============ +.. doc_concept:: Process Meta Model + :id: doc_concept__process_meta_model + :status: valid + :tags: process_management + .. toctree:: :maxdepth: 2 :caption: Contents: