From 1165fc148eb2473bb195d1f5ef90a5a8ff2da6fd Mon Sep 17 00:00:00 2001 From: aschemmel-git Date: Thu, 26 Mar 2026 08:53:50 +0100 Subject: [PATCH] Metamodel link renames Relates: #418 --- .../requirements/chklst_req_inspection.rst | 2 +- .../requirements/chklst_req_inspection.rst | 2 +- ...core_building_blocks_meta_model.drawio.svg | 2 +- ...s_meta_model_deployment_example.drawio.svg | 2446 +---------------- ...ng_blocks_meta_model_simplified.drawio.svg | 4 +- ...aceability_model_cmp_overview_1.drawio.svg | 2 +- ...aceability_model_cmp_overview_2.drawio.svg | 2 +- ...aceability_model_cmp_overview_3.drawio.svg | 2 +- ...raceability_model_feat_overview.drawio.svg | 2 +- ..._traceability_model_wp_overview.drawio.svg | 2 +- .../_assets/architecture_workflow.drawio.svg | 2 +- .../architecture_concept.rst | 7 +- .../guidance/architecture_guideline.rst | 5 +- .../guidance/architecture_process_reqs.rst | 16 +- .../_assets/impact_analysis.drawio.svg | 2 +- .../_assets/impact_iteration.drawio.svg | 2 +- .../guidance/change_management_reqs.rst | 2 +- .../guidance/implementation_guideline.rst | 2 +- .../_assets/aou_traceability.drawio.svg | 2 +- .../requirements_versioning.drawio.svg | 2 +- .../_assets/requirements_workflow.drawio.svg | 2 +- .../guidance/requirements_guideline.rst | 12 +- .../guidance/requirements_process_reqs.rst | 21 +- .../guidance/requirements_templates.rst | 14 +- .../requirements_concept.rst | 12 +- .../requirements_workflow.rst | 8 +- 26 files changed, 67 insertions(+), 2510 deletions(-) diff --git a/process/folder_templates/features/feature_name/requirements/chklst_req_inspection.rst b/process/folder_templates/features/feature_name/requirements/chklst_req_inspection.rst index 62ec0dff59..550bea405e 100644 --- a/process/folder_templates/features/feature_name/requirements/chklst_req_inspection.rst +++ b/process/folder_templates/features/feature_name/requirements/chklst_req_inspection.rst @@ -132,7 +132,7 @@ See also :need:`doc_concept__wp_inspections` for further information about revie - * - REQ_07_02 - Is the *security* attribute set correctly? - - For feature requirements this checklist item is supported by automated check: "Every requirement which satisfies a stakeholder requirement with security attribute set to YES inherits this". But the feature requirements/architecture may additionally also be subject to a :need:`wp__feature_security_analysis` + - For feature requirements this checklist item is supported by automated check: "Every requirement which is derived from a stakeholder requirement with security attribute set to YES inherits this". But the feature requirements/architecture may additionally also be subject to a :need:`wp__feature_security_analysis` - - - diff --git a/process/folder_templates/modules/module_name/component_name/docs/requirements/chklst_req_inspection.rst b/process/folder_templates/modules/module_name/component_name/docs/requirements/chklst_req_inspection.rst index 0136a8b5d3..c7d22cdf06 100644 --- a/process/folder_templates/modules/module_name/component_name/docs/requirements/chklst_req_inspection.rst +++ b/process/folder_templates/modules/module_name/component_name/docs/requirements/chklst_req_inspection.rst @@ -132,7 +132,7 @@ See also :need:`doc_concept__wp_inspections` for further information about revie - * - REQ_07_02 - Is the attribute *security* set correctly? - - For component requirements this checklist item is supported by automated check: "Every requirement which satisfies a feature requirement with security attribute set to YES inherits this". But the component requirements/architecture may additionally also be subject to a :need:`wp__sw_component_security_analysis`. + - For component requirements this checklist item is supported by automated check: "Every requirement which derives from a feature requirement with security attribute set to YES inherits this". But the component requirements/architecture may additionally also be subject to a :need:`wp__sw_component_security_analysis`. - - - 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 d0abde036f..150fb802c3 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,4 +1,4 @@ -
1, *
1, *
belongs_to
belongs_to
includes
includes
Feature
Feature
uses
uses
Component
Component
Delivery Container
Delivery Container
Feature
Requirements
Feature...
includes
includes
belongs_to
belongs_to
Feature
Architecture
Feature...
Component
Requirements
Component...
1,*
1,*
belongs_to
belongs_to
includes
includes
Unit
Unit
1, *
1, *
belongs_to
belongs_to
Source Code
Source Code
Stakeholder
 Requirements
Stakeholder...
implements
implements
1, *
1, *
Platform
Platform
1, *
1, *
consists of
consists of
has
has
1, *
1, *
uses
uses
Component
Architecture
Component...
satisfies
satisfies

belongs_to
belongs_to
Detailed
Design
Detailed...
belongs_to
belongs_to
satisfies
satisfies
implements
implements
consists of
consists of
implements
implements
1
1
*
*
Dependable Element
Dependable Element
includes
includes
1,*
1,*
Feature Safety/
Security Analysis
Feature Safety/...
Assumption of use
Assumption of use
- own AoU
-other AoU
- own AoU...
Platform Integration 
Tests
Platform Integration...
Feature
Integration Tests
Feature...
verifies
verifies
violates
violates
mitigated_by
mitigated_by
verifies
verifies
Component
Integration Tests
Component...
Component Safety /
Security Analysis
Component Safety /...
violates
violates
mitigated_by
mitigated_by
mitigated_by
mitigated_by
mitigated_by
mitigated_by
verifies
verifies
Unit Test
Unit Test
verifies
verifies
verifies
verifies
1
1
1,*
1,*
mitigated_by
mitigated_by
Platform Safety/
Security Analysis
Platform Safety/...
mitigated_by
mitigated_by
violates
violates
fulfils
fulfils
Logical Arc. Interface
Logical Arc. Interface
Legend
Legend
UML
(sphinx needs)
UML...
implicit
implicit
mandatory
mandatory
optional
optional
includes
includes
belongs_to
belongs_to
Dependable Element
View
Dependable Element...
Tool generated
Target not specified
Tool gener...
Line Color
Line Color
Line Style
Line Style
implements
implements
1
1
1, *
1, *
*
*
1
1
fulfills - but not the own AoU
fulfills - but not the own AoU
fulfills - but not the own AoU
fulfills - but not the own AoU
verifies
verifies
verifies
verifies
covers - but not the own AoU
covers - but not the own AoU
includes
includes
Platform
Architecture
Platform...
satisfies
satisfies
1, *
1, *
belongs_to
belongs_to
fulfills
fulfills
fulfills
fulfills
fulfills
fulfills
Text is not SVG - cannot display
+
1, *
1, *
satisfied_by
satisfied_by
includes
includes
Feature
Feature
uses
uses
Component
Component
Delivery Container
Delivery Container
Feature
Requirements
Feature...
includes
includes
belongs_to
belongs_to
Feature
Architecture
Feature...
Component
Requirements
Component...
1,*
1,*
satisfied_by
satisfied_by
includes
includes
Unit
Unit
1, *
1, *
belongs_to
belongs_to
Source Code
Source Code
Stakeholder
 Requirements
Stakeholder...
implements
implements
1, *
1, *
Platform
Platform
1, *
1, *
consists of
consists of
has
has
1, *
1, *
uses
uses
Component
Architecture
Component...
derived_from
derived_from

belongs_to
belongs_to
Detailed
Design
Detailed...
belongs_to
belongs_to
satisfies
satisfies
implements
implements
consists of
consists of
implements
implements
1
1
*
*
Dependable Element
Dependable Element
includes
includes
1,*
1,*
Feature Safety/
Security Analysis
Feature Safety/...
Assumption of use
Assumption of use
- own AoU
-other AoU
- own AoU...
Platform Integration 
Tests
Platform Integration...
Feature
Integration Tests
Feature...
verifies
verifies
violates
violates
mitigated_by
mitigated_by
verifies
verifies
Component
Integration Tests
Component...
Component Safety /
Security Analysis
Component Safety /...
violates
violates
mitigated_by
mitigated_by
mitigated_by
mitigated_by
mitigated_by
mitigated_by
verifies
verifies
Unit Test
Unit Test
verifies
verifies
verifies
verifies
1
1
1,*
1,*
mitigated_by
mitigated_by
Platform Safety/
Security Analysis
Platform Safety/...
mitigated_by
mitigated_by
violates
violates
fulfils
fulfils
Logical Arc. Interface
Logical Arc. Interface
Legend
Legend
UML
(sphinx needs)
UML...
implicit
implicit
mandatory
mandatory
optional
optional
includes
includes
belongs_to
belongs_to
Dependable Element
View
Dependable Element...
Tool generated
Target not specified
Tool gener...
Line Color
Line Color
Line Style
Line Style
implements
implements
1
1
1, *
1, *
*
*
1
1
fulfills - but not the own AoU
fulfills - but not the own AoU
fulfills - but not the own AoU
fulfills - but not the own AoU
verifies
verifies
verifies
verifies
covers - but not the own AoU
covers - but not the own AoU
includes
includes
Platform
Architecture
Platform...
derived_from
derived_from
1, *
1, *
belongs_to
belongs_to
fulfills
fulfills
fulfills
fulfills
fulfills
fulfills
Text is not SVG - cannot display
diff --git a/process/general_concepts/_assets/score_building_blocks_meta_model_deployment_example.drawio.svg b/process/general_concepts/_assets/score_building_blocks_meta_model_deployment_example.drawio.svg index 23d82682b9..398545e147 100644 --- a/process/general_concepts/_assets/score_building_blocks_meta_model_deployment_example.drawio.svg +++ b/process/general_concepts/_assets/score_building_blocks_meta_model_deployment_example.drawio.svg @@ -1,2442 +1,4 @@ - - - - - - - - - - -
-
-
-
-

- - - - Project - - - -

-
-
-

- - - - refer - - - - ence_integration - - - - -
-
-
-
-
-

- - repository - -
-
-
-
-
- - Project... - -
-
-
- - - - - - - -
-
-
- Project Dependable Element -
- repository -
-
-
-
- - Project Dependable Element... - -
-
-
- - - - - - - -
-
-
- - - - - PROJECT main repository -
-
-
-
- - PROJECT main repository - -
-
-
- - - - - - - - - - - - -
-
-
- belongs_to -
-
-
-
- - belongs_to - -
-
-
- - - - - - - - -
-
-
- provides -
-
-
-
- - provides - -
-
-
- - - - - - - - -
-
-
- uses -
-
-
-
- - uses - -
-
-
- - - - - - - - - -
-
-
- Feature -
-
-
-
- - Feature - -
-
-
- - - - - - - - -
-
-
- - uses - -
-
-
-
- - uses - -
-
-
- - - - - - - - - - - - - -
-
-
- Component -
-
-
-
- - Component - -
-
-
- - - - - - - - - -
-
-
- Delivery Container -
-
-
-
- - Delivery Container - -
-
-
- - - - - - - - -
-
-
- includes -
-
-
-
- - includes - -
-
-
- - - - - - - - -
-
-
- belongs_to -
-
-
-
- - belongs_to - -
-
-
- - - - - - - - -
-
-
- - covers - but not the own AoU - -
-
-
-
- - covers - but not the own AoU - -
-
-
- - - - - - - - - -
-
-
- Component -
- Requirements -
-
-
-
- - Component... - -
-
-
- - - - - - - -
-
-
- 1,* -
-
-
-
- - 1,* - -
-
-
- - - - -
-
-
- belongs_to -
-
-
-
- - belongs_to - -
-
-
- - - - -
-
-
- belongs to -
-
-
-
- - belongs to - -
-
-
- - - - - - - - -
-
-
- includes -
-
-
-
- - includes - -
-
-
- - - - - - - - - -
-
-
- Unit -
-
-
-
- - Unit - -
-
-
- - - - - - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - -
-
-
- belongs_to -
-
-
-
- - belongs_to - -
-
-
- - - - - - - - - -
-
-
- Source Code -
-
-
-
- - Source Code - -
-
-
- - - - - - - - - -
-
-
- Stakeholder -
- Requirements -
-
-
-
- - Stakeholder... - -
-
-
- - - - - - - - -
-
-
- satisfies -
-
-
-
- - satisfies - -
-
-
- - - - - - - - -
-
-
- implements -
-
-
-
- - implements - -
-
-
- - - - - - - - -
-
-
- has -
-
-
-
- - has - -
-
-
- - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - -
-
-
- has -
-
-
-
- - has - -
-
-
- - - - - - - - - -
-
-
- Platform -
-
-
-
- - Platform - -
-
-
- - - - - - - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - -
-
-
- consists of -
-
-
-
- - consists of - -
-
-
- - - - - - - - -
-
-
- uses -
-
-
-
- - uses - -
-
-
- - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - - -
-
-
- Component -
- Architecture -
-
-
-
- - Component... - -
-
-
- - - - - - - - -
-
-
-
-
-
-
-
-
-
- - -
-
-
- - - - -
-
-
- - belongs_to - -
-
-
-
- - belongs_to - -
-
-
- - - - - - - - - -
-
-
- Detailed -
- Design -
-
-
-
- - Detailed... - -
-
-
- - - - - - - - -
-
-
- belongs_to -
-
-
-
- - belongs_to - -
-
-
- - - - - - - - -
-
-
- satisfies -
-
-
-
- - satisfies - -
-
-
- - - - - - - - -
-
-
- implements -
-
-
-
- - implements - -
-
-
- - - - -
-
-
- consists of -
-
-
-
- - consists of - -
-
-
- - - - - - - - -
-
-
- implements -
-
-
-
- - implements - -
-
-
- - - - - - - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - - - - -
-
-
- * -
-
-
-
- - * - -
-
-
- - - - - - - - - -
-
-
- Dependable Element -
-
-
-
- - Dependable Element - -
-
-
- - - - - - - - -
-
-
- includes -
-
-
-
- - includes - -
-
-
- - - - - - - -
-
-
- 1,* -
-
-
-
- - 1,* - -
-
-
- - - - - - - - -
-
-
- violates -
-
-
-
- - violates - -
-
-
- - - - - - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - - - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - - - - - - -
-
-
- Platform -
- Assumptions of use -
-
-
-
- - Platform... - -
-
-
- - - - - - - -
-
-
- - own AoU -
- -other AoU -
-
-
-
- - - own AoU... - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - - -
-
-
- Platform Integration -
- Tests -
-
-
-
- - Platform Integration... - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - - -
-
-
- Feature -
- Integration Tests -
-
-
-
- - Feature... - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - - -
-
-
- Component -
- Integration Tests -
-
-
-
- - Component... - -
-
-
- - - - - - - - -
-
-
- - mitigated_by - -
-
-
-
- - mitigated_by - -
-
-
- - - - - - - - - -
-
-
- Component Safety / -
- Security Analysis -
-
-
-
- - Component Safety /... - -
-
-
- - - - - - - - -
-
-
- - mitigated_by - -
-
-
-
- - mitigated_by - -
-
-
- - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - - -
-
-
- Unit Test -
-
-
-
- - Unit Test - -
-
-
- - - - - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - - - - -
-
-
- 1,* -
-
-
-
- - 1,* - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - - - - - -
-
-
- mitigated_by -
-
-
-
- - mitigated_by - -
-
-
- - - - - - - - - -
-
-
- Platform Safety/ -
- Security Analysis -
-
-
-
- - Platform Safety/... - -
-
-
- - - - - - - - -
-
-
- - violates - -
-
-
-
- - violates - -
-
-
- - - - - - - - - -
-
-
- Logical Arc. Interface -
-
-
-
- - Logical Arc. Interface - -
-
-
- - - - - - - -
-
-
- Legend -
-
-
-
- - Legend - -
-
-
- - - - - - - -
-
-
- UML -
- (sphinx needs) -
-
-
-
-
- - UML... - -
-
-
- - - - - - - -
-
-
- implicit -
-
-
-
- - implicit - -
-
-
- - - - - - - -
-
-
- mandatory -
-
-
-
- - mandatory - -
-
-
- - - - - - - -
-
-
- optional -
-
-
-
- - optional - -
-
-
- - - - - - - - -
-
-
- includes -
-
-
-
- - includes - -
-
-
- - - - - - - - -
-
-
- belongs_to -
-
-
-
- - belongs_to - -
-
-
- - - - - - - - - -
-
-
- Dependable Element -
- View -
-
-
-
- - Dependable Element... - -
-
-
- - - - - - - -
-
-
- Tool generated -
- Target not specified -
-
-
-
- - Tool gener... - -
-
-
- - - - - - - -
-
-
- Line Color -
-
-
-
- - Line Color - -
-
-
- - - - - - - -
-
-
- Line Style -
-
-
-
- - Line Style - -
-
-
- - - - - - - - -
-
-
- - implements - -
-
-
-
- - implements - -
-
-
- - - - - - - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - -
-
-
- 1, * -
-
-
-
- - 1, * - -
-
-
- - - - - - - - - -
-
-
- * -
-
-
-
- - * - -
-
-
- - - - -
-
-
- 1 -
-
-
-
- - 1 - -
-
-
- - - - - - - - -
-
-
- fulfills - but not the feature's own AoU -
-
-
-
- - fulfills - but not the feature's own AoU - -
-
-
- - - - - - - - -
-
-
- fulfills - but not the component's own AoU -
-
-
-
- - fulfills - but not the component's own AoU - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - -
-
-
- verifies -
-
-
-
- - verifies - -
-
-
- - - - - - - - -
-
-
- includes -
-
-
-
- - includes - -
-
-
- - - - - - - - - -
-
-
- Platform -
- Architecture -
-
-
-
- - Platform... - -
-
-
- - - - - - - - - -
-
-
- Feature -
- Architecture -
-
-
-
- - Feature... - -
-
-
- - - - - - - - - -
-
-
- Modul -
- Assumptions of use -
-
-
-
- - Modul... - -
-
-
- - - - - - - -
-
-
- - own AoU -
- -other AoU -
-
-
-
- - - own AoU... - -
-
-
- - - - - - - - -
-
-
- - satisfies - -
-
-
-
- - satisfies - -
-
-
- - - - - - - - - -
-
-
- Feature -
- Requirements -
-
-
-
- - Feature... - -
-
-
- - - - - - - - - -
-
-
- Feature Safety/ -
- Security Analysis -
-
-
-
- - Feature Safety/... - -
-
-
- - - - - - - - -
-
-
- - covers - but not the own AoU - -
-
-
-
- - covers - but not the own AoU - -
-
-
- - - - - - - - -
-
-
- violates -
-
-
-
- - violates - -
-
-
- - - - - - - - -
-
-
- fulfills -
-
-
-
- - fulfills - -
-
-
- - - - - - - - -
-
-
- fulfills -
-
-
-
- - fulfills - -
-
-
- - - - - - - - -
-
-
- fulfills -
-
-
-
- - fulfills - -
-
-
- - - - - - - - -
-
-
- fulfills -
-
-
-
- - fulfills - -
-
-
-
- - - - - Text is not SVG - cannot display - - - -
+ + + +

Project

 reference_integration

repository
Project...
Project Dependable Element 
repository
Project Dependable Element...
PROJECT main repository
PROJECT main repository
satisfied_by
satisfied_by
provides
provides
uses
uses
Feature
Feature
uses
uses
Component
Component
Delivery Container
Delivery Container
includes
includes
belongs_to
belongs_to
covers - but not the own AoU
covers - but not the own AoU
Component
Requirements
Component...
1,*
1,*
satisfied_by
satisfied_by
belongs to
belongs to
includes
includes
Unit
Unit
1, *
1, *
belongs_to
belongs_to
Source Code
Source Code
Stakeholder
 Requirements
Stakeholder...
derived_from
derived_from
implements
implements
has
has
1, *
1, *
has
has
Platform
Platform
1, *
1, *
consists of
consists of
uses
uses
1, *
1, *
Component
Architecture
Component...

belongs_to
belongs_to
Detailed
Design
Detailed...
belongs_to
belongs_to
satisfies
satisfies
implements
implements
consists of
consists of
implements
implements
1
1
*
*
Dependable Element
Dependable Element
includes
includes
1,*
1,*
violates
violates
mitigated_by
mitigated_by
mitigated_by
mitigated_by
Platform
Assumptions of use
Platform...
- own AoU
-other AoU
- own AoU...
verifies
verifies
Platform Integration 
Tests
Platform Integration...
verifies
verifies
verifies
verifies
Feature
Integration Tests
Feature...
verifies
verifies
verifies
verifies
Component
Integration Tests
Component...
mitigated_by
mitigated_by
Component Safety /
Security Analysis
Component Safety /...
mitigated_by
mitigated_by
verifies
verifies
Unit Test
Unit Test
1
1
1,*
1,*
verifies
verifies
mitigated_by
mitigated_by
mitigated_by
mitigated_by
Platform Safety/
Security Analysis
Platform Safety/...
violates
violates
Logical Arc. Interface
Logical Arc. Interface
Legend
Legend
UML
(sphinx needs)
UML...
implicit
implicit
mandatory
mandatory
optional
optional
includes
includes
belongs_to
belongs_to
Dependable Element
View
Dependable Element...
Tool generated
Target not specified
Tool gener...
Line Color
Line Color
Line Style
Line Style
implements
implements
1
1
1, *
1, *
*
*
1
1
fulfills - but not the feature's own AoU
fulfills - but not the feature's own AoU
fulfills - but not the component's own AoU
fulfills - but not the component's own AoU
verifies
verifies
verifies
verifies
includes
includes
Platform
Architecture
Platform...
Feature
Architecture
Feature...
Modul
Assumptions of use
Modul...
- own AoU
-other AoU
- own AoU...
derived_from
derived_from
Feature
Requirements
Feature...
Feature Safety/
Security Analysis
Feature Safety/...
covers - but not the own AoU
covers - but not the own AoU
violates
violates
fulfills
fulfills
fulfills
fulfills
fulfills
fulfills
fulfills
fulfills
Text is not SVG - cannot display
diff --git a/process/general_concepts/_assets/score_building_blocks_meta_model_simplified.drawio.svg b/process/general_concepts/_assets/score_building_blocks_meta_model_simplified.drawio.svg index 768494ba0e..073e86bf7c 100644 --- a/process/general_concepts/_assets/score_building_blocks_meta_model_simplified.drawio.svg +++ b/process/general_concepts/_assets/score_building_blocks_meta_model_simplified.drawio.svg @@ -1,4 +1,4 @@ - + -
belongs_to
belongs_to
includes
includes
Feature
Feature
Component
Component
Delivery Container
Delivery Container
Feature
Requirements
Feature...
includes
includes
belongs_to
belongs_to
Feature
Architecture
Feature...
Component
Requirements
Component...
1,*
1,*
belongs_to
belongs_to
Unit
Unit
1, *
1, *
belongs_to
belongs_to
Source Code
Source Code
Stakeholder
 Requirements
Stakeholder...
implements
implements
1, *
1, *
Platform
Platform
1, *
1, *
consists of
consists of
has
has
1, *
1, *
Component
Architecture
Component...
satisfies
satisfies

belongs_to
belongs_to
Detailed
Design
Detailed...
satisfies
satisfies
implements
implements
implements
implements
*
*
Dependable Element
Dependable Element
includes
includes
Feature Safety/
Security Analysis
Feature Safety/...
violates
violates
Component Safety /
Security Analysis
Component Safety /...
violates
violates
verifies
verifies
Unit Test
Unit Test
Platform Safety/
Security Analysis
Platform Safety/...
violates
violates
fulfils
fulfils
Logical Arc. Interface
Logical Arc. Interface
Legend
Legend
UML
(sphinx needs)
UML...
implicit
implicit
mandatory
mandatory
belongs_to
belongs_to
Dependable Element
View
Dependable Element...
Tool generated
Target not specified
Tool gener...
Line Color
Line Color
Line Style
Line Style
1
1
1, *
1, *
*
*
1
1
includes
includes
Platform
Architecture
Platform...
satisfies
satisfies
1, *
1, *
belongs_to
belongs_to
Text is not SVG - cannot display
\ No newline at end of file +
satisfied_by
satisfied_by
includes
includes
Feature
Feature
Component
Component
Delivery Container
Delivery Container
Feature
Requirements
Feature...
includes
includes
belongs_to
belongs_to
Feature
Architecture
Feature...
Component
Requirements
Component...
1,*
1,*
satisfied_by
satisfied_by
Unit
Unit
1, *
1, *
belongs_to
belongs_to
Source Code
Source Code
Stakeholder
 Requirements
Stakeholder...
implements
implements
1, *
1, *
Platform
Platform
1, *
1, *
consists of
consists of
has
has
1, *
1, *
Component
Architecture
Component...
derived_from
derived_from

belongs_to
belongs_to
Detailed
Design
Detailed...
satisfies
satisfies
implements
implements
implements
implements
*
*
Dependable Element
Dependable Element
includes
includes
Feature Safety/
Security Analysis
Feature Safety/...
violates
violates
Component Safety /
Security Analysis
Component Safety /...
violates
violates
verifies
verifies
Unit Test
Unit Test
Platform Safety/
Security Analysis
Platform Safety/...
violates
violates
fulfils
fulfils
Logical Arc. Interface
Logical Arc. Interface
Legend
Legend
UML
(sphinx needs)
UML...
implicit
implicit
mandatory
mandatory
belongs_to
belongs_to
Dependable Element
View
Dependable Element...
Tool generated
Target not specified
Tool gener...
Line Color
Line Color
Line Style
Line Style
1
1
1, *
1, *
*
*
1
1
includes
includes
Platform
Architecture
Platform...
derived_from
derived_from
1, *
1, *
belongs_to
belongs_to
Text is not SVG - cannot display
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 1eb3abb9e6..4a05e96587 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/Security Analysis
Component...
Feature
Architecture
Feature...

(external)
 Assumption of use
(external)...
Implementation
including Detailed Design and Unit
Implementation...
belongs_to
belongs_to
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
fulfills
fulfills
fulfills
fulfills
fulfills
fulfills
satisfies
satisfies
violates
violates
mitigated_by
mitigated_by
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by


Component

Component...
belongs_to
belongs_to
fulfills
fulfills
Text is not SVG - cannot display
+
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)
 Assumption of use
(external)...
Implementation
including Detailed Design and Unit
Implementation...
belongs_to
belongs_to
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
fulfills
fulfills
fulfills
fulfills
fulfills
fulfills
violates
violates
mitigated_by
mitigated_by
derived_from
derived_from
fulfills
fulfills
mitigated_by
mitigated_by


Component

Component...
satisfied_by
satisfied_by
fulfills
fulfills
Text is not SVG - cannot display
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 67f73ae213..960d72de13 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/Security Analysis
Component...
Feature
Architecture
Feature...

(external)
 Assumption of use
(external)...
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
fulfills
fulfills
fulfills
fulfills
satisfies
satisfies
fulfills
fulfills
mitigated_by
mitigated_by
implements
implements
fulfills
fulfills
fulfills
fulfills
Text is not SVG - cannot display
+
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)
 Assumption of use
(external)...
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
fulfills
fulfills
fulfills
fulfills
derived_from
derived_from
fulfills
fulfills
mitigated_by
mitigated_by
implements
implements
fulfills
fulfills
fulfills
fulfills
Text is not SVG - cannot display
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 df83ab4e4a..6d531e2712 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 @@ -
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
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
Text is not SVG - cannot display
+
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
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
derived_from
derived_from
fulfills
fulfills
Text is not SVG - cannot display
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 f80d86f046..db95034daa 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...
belongs_to
belongs_to
Feature
Architecture
Feature...
(external)
Assumption of use
(external)...
Stakeholder
Requirements
Stakeholder...
Feature
Assumption of use
Feature...
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
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
SW-Platform
Assumption of Use
SW-Platform...
Platform
Safety/Security Analysis
Platform...
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
Feature
Feature
belongs_to
belongs_to
fulfills
fulfills
Text is not SVG - cannot display
+
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
satisfied_by
satisfied_by
Feature
Architecture
Feature...
(external)
Assumption of use
(external)...
Stakeholder
Requirements
Stakeholder...
Feature
Assumption of use
Feature...
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
derived_from
derived_from
derived_from
derived_from
fulfills
fulfills
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
SW-Platform
Assumption of Use
SW-Platform...
Platform
Safety/Security Analysis
Platform...
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
Feature
Feature
belongs_to
belongs_to
fulfills
fulfills
Text is not SVG - cannot display
diff --git a/process/general_concepts/_assets/score_traceability_model_wp_overview.drawio.svg b/process/general_concepts/_assets/score_traceability_model_wp_overview.drawio.svg index 07fa6ddc33..8724fde9e4 100644 --- a/process/general_concepts/_assets/score_traceability_model_wp_overview.drawio.svg +++ b/process/general_concepts/_assets/score_traceability_model_wp_overview.drawio.svg @@ -1,4 +1,4 @@ -
Stakeholder
Requirements
Stakeholder...
Feature
Feature
Component
Component
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Component
 Architecture
Component...
Implementation





 
Implementation...
Component Integration Test
Component Integratio...
Platform Integration Test
Platform Integration...
Feature
Architecture
Feature...
Unit
Unit









SW-Platform






SW-Platform...
verifies
verifies
Unit Test
Unit Test
Feature Integration Test
Feature Integration...
Platform Verification Report
Platform Verificatio...
Software Module Verification Report
Software Module Veri...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Issue Tracking System
(Change Request)
Issue Tracking Syste...
Affected
Work Products
Affected...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
Detailed Design
Detailed Desi...
Source Code
Source Code
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
satisfies
satisfies
satisfies
satisfies
implements
implements
implements
implements
satisfies
satisfies
satisfies
satisfies
fulfills
fulfills
fulfills
fulfills
satisfies
satisfies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
Text is not SVG - cannot display
+
Stakeholder
Requirements
Stakeholder...
Feature
Feature
Component
Component
Feature Requirements
Feature Requirements
Component Requirements
Component Requiremen...
Component
 Architecture
Component...
Implementation





 
Implementation...
Component Integration Test
Component Integratio...
Platform Integration Test
Platform Integration...
Feature
Architecture
Feature...
Unit
Unit









SW-Platform






SW-Platform...
verifies
verifies
Unit Test
Unit Test
Feature Integration Test
Feature Integration...
Platform Verification Report
Platform Verificatio...
Software Module Verification Report
Software Module Veri...
Bidirectional traceability (mandatory)
Bidirectional traceability (mandato...
Issue Tracking System
(Change Request)
Issue Tracking Syste...
Affected
Work Products
Affected...
Bidirectional traceability (optional)
Bidirectional traceability (optio...
Detailed Design
Detailed Desi...
Source Code
Source Code
manually linked
manually linked
automatically linked
automatically linked
manually linked
manually linked
automatically linked
automatically linked
derived_from
derived_from
derived_from
derived_from
implements
implements
implements
implements
satisfies
satisfies
fulfills
fulfills
fulfills
fulfills
satisfies
satisfies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
verifies
Text is not SVG - cannot display
diff --git a/process/process_areas/architecture_design/_assets/architecture_workflow.drawio.svg b/process/process_areas/architecture_design/_assets/architecture_workflow.drawio.svg index bf392be01f..e93daad7f6 100644 --- a/process/process_areas/architecture_design/_assets/architecture_workflow.drawio.svg +++ b/process/process_areas/architecture_design/_assets/architecture_workflow.drawio.svg @@ -1,4 +1,4 @@ -
Feature Architecture
(Concept)
Feature Architecture...
Model
Feature Architecture
Model...
Feature Level
Feature Level
Component Level
Component Level
Model
Component  Architecture
Model...
Component
Architecture
[status = valid]
Component...
links
[fulfils= featreq.uid]
[linkhash = featreq.hash]
links...
PR Review
PR Review
1
1
2
2
8
8
9
9
Feature
Requirement
Feature...
4
4
PR Review
PR Review
Feature
Architecture
[status = valid]
Feature...
links
[defined metamodel]
links...
Component Requirements
Component Requiremen...
3
3
5
5
7
7
links
[fulfils= compreq.uid]
[linkhash = compreq.hash]
links...
Component
Architecture
Component...
6
6
6
6
Text is not SVG - cannot display
\ No newline at end of file +
Feature Architecture
(Concept)
Feature Architecture...
Model
Feature Architecture
Model...
Feature Level
Feature Level
Component Level
Component Level
Model
Component  Architecture
Model...
Component
Architecture
[status = valid]
Component...
links
[fulfils= featreq.uid]
[linkhash = featreq.hash]
links...
PR Review
PR Review
1
1
2
2
8
8
9
9
Feature
Requirement
Feature...
4
4
PR Review
PR Review
Feature
Architecture
[status = valid]
Feature...
links
[defined metamodel]
links...
Component Requirements
Component Requiremen...
3
3
5
5
7
7
links
[fulfils= compreq.uid]
[linkhash = compreq.hash]
links...
Component
Architecture
Component...
6
6
6
6
Text is not SVG - cannot display
diff --git a/process/process_areas/architecture_design/architecture_concept.rst b/process/process_areas/architecture_design/architecture_concept.rst index ae8b9ccb06..f1e6c5fcbb 100644 --- a/process/process_areas/architecture_design/architecture_concept.rst +++ b/process/process_areas/architecture_design/architecture_concept.rst @@ -51,7 +51,7 @@ Use Cases which require architectural information #. **Security Analysis** - * The architecture created to fulfill the requirements does not introduce possible vulnerabilities + * The architecture created to fulfil the requirements does not introduce possible vulnerabilities #. **Safety Planning** @@ -337,7 +337,7 @@ For creating architectural elements also templates for each level are available: Establish traceability between requirements and architectural elements ********************************************************************** -During the architectural design process all feature and component requirements shall be allocated to a single architecture element at the corresponding level via the attribute **fulfils**. +During the architectural design process all feature and component requirements shall be allocated to a single architecture element at the corresponding level via the attribute **satisfies**. .. _reviews of the architecture: @@ -525,7 +525,8 @@ To make *needuml* work we have to replace the *need()* call with a different fun :status: valid :safety: ASIL_B :security: NO - :uses: logic_arc_int__example_feature__archcon_logical_interface_1 + :uses: logic_arc_int__example_feature__archex_logical_interface_1 + :fulfils: comp_req__example_feature__archex_example_req :belongs_to: comp__component_component_manual_getstrt .. needuml:: diff --git a/process/process_areas/architecture_design/guidance/architecture_guideline.rst b/process/process_areas/architecture_design/guidance/architecture_guideline.rst index 41abc22592..d207130cd9 100644 --- a/process/process_areas/architecture_design/guidance/architecture_guideline.rst +++ b/process/process_areas/architecture_design/guidance/architecture_guideline.rst @@ -216,7 +216,8 @@ In the next step, the already derived feature requirements shall be allocated to If needed, additional feature requirements, which may arise due to architectural decisions, should be created and allocated to the feature architecture itself. -These links shall be established from architectural elements to feature requirements via the attribute *fulfils*. +These links may be established from architectural views to feature requirements via the attribute *fulfills* +but all the feature requirements must be allocated to the feature element via the attribute *satisfied_by*. .. _review_architectural_design: @@ -249,7 +250,7 @@ For this step, the following guidance is available: :need:`Feature Architecture Allocate component requirements to architectural elements --------------------------------------------------------- -In this step, the component requirements shall be derived (see :need:`[[title]] `) and allocated to the architectural elements via the attribute *fulfils*. +In this step, the component requirements shall be derived (see :need:`[[title]] `) and allocated to the respective component element via the attribute *satisfied_by*. .. _model_component_architecture: diff --git a/process/process_areas/architecture_design/guidance/architecture_process_reqs.rst b/process/process_areas/architecture_design/guidance/architecture_process_reqs.rst index 04ee125e8a..13f9df5991 100644 --- a/process/process_areas/architecture_design/guidance/architecture_process_reqs.rst +++ b/process/process_areas/architecture_design/guidance/architecture_process_reqs.rst @@ -168,7 +168,13 @@ Traceability to Requirements and AoU :complies: std_req__iso26262__support_6425, std_req__aspice_40__SWE-2-BP4 :satisfies: wf__cr_mt_featarch, wf__cr_mt_comparch - Architectural views (feature/comp_arc_sta, feature/comp_arc_dyn) and interfaces (logic/real_arc_int) should be linked to a requirement. + Architectural views (feature/comp_arc_sta, feature/comp_arc_dyn) and interfaces (logic/real_arc_int) + should be linked to a requirement on the corresponding level. + + **Examples:** + + * feat_req <-> feat_arc_(sta|dyn), logic_arc_(int|int_op) + * comp_req <-> comp_arc_(sta|dyn), real_arc_(int|int_op) .. gd_req:: Architecture attribute: fulfils (AoU) :id: gd_req__arch_attr_fulfils_aou @@ -182,16 +188,16 @@ Traceability to Requirements and AoU .. gd_req:: Architecture traceability :id: gd_req__arch_traceability :status: valid - :tags: manual_prio_2 + :tags: manual_prio_1 :complies: std_req__iso26262__support_6432, std_req__aspice_40__SWE-2-BP4 :satisfies: wf__cr_mt_featarch, wf__cr_mt_comparch - Requirements shall be fulfilled by an architectural element on the corresponding level. + Requirements shall be satisfied by an architectural element on the corresponding level. **Examples:** - * feat_req <-> feat_arc_(sta|dyn), logic_arc_(int|int_op) - * comp_req <-> comp_arc_(sta|dyn), real_arc_(int|int_op) + * feat_req <-> feat + * comp_req <-> comp .. note:: In general the traceability is visualized in :ref:`general_concepts_traceability` diff --git a/process/process_areas/change_management/_assets/impact_analysis.drawio.svg b/process/process_areas/change_management/_assets/impact_analysis.drawio.svg index 4abf0d31d5..80107a8a29 100644 --- a/process/process_areas/change_management/_assets/impact_analysis.drawio.svg +++ b/process/process_areas/change_management/_assets/impact_analysis.drawio.svg @@ -1,4 +1,4 @@ -
Feature
Requirements
Feature...
fulfills
fulfills
Feature
Architecture
Feature...
satifies
satifies
Component
Requirements
Component...
Source Code
Source Code
Stakeholder
 Requirements
Stakeholder...
satifies
satifies
fulfills
fulfills
Component
Architecture
Component...
satifies
satifies
1, *
1, *
Detailed
Design
Detailed...
satifies
satifies
implements
implements
implements
implements
Feature
Safety Analysis
Feature...
Feature
Assumptions of use
Feature...
Platform
Tests
Platform...
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
not needed, not safety relevant
not needed, not safe...
not needed, should fail (all verifies links)
not needed, should f...
both ways
both ways
follow the arrow
follow the arrow
follow back the arrow
follow back the arrow

Which changes to follow for impact analysis

Which changes to follow for impact analysis
Text is not SVG - cannot display
+
Feature
Requirements
Feature...
fulfills
fulfills
Feature
Architecture
Feature...
Component
Requirements
Component...
Source Code
Source Code
Stakeholder
 Requirements
Stakeholder...
derived_from
derived_from
fulfills
fulfills
Component
Architecture
Component...
derived_from
derived_from
1, *
1, *
Detailed
Design
Detailed...
satifies
satifies
implements
implements
implements
implements
Feature
Safety Analysis
Feature...
Feature
Assumptions of use
Feature...
Platform
Tests
Platform...
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
not needed, not safety relevant
not needed, not safe...
not needed, should fail (all verifies links)
not needed, should f...
both ways
both ways
follow the arrow
follow the arrow
follow back the arrow
follow back the arrow

Which changes to follow for impact analysis

Which changes to follow for impact analysis
Text is not SVG - cannot display
diff --git a/process/process_areas/change_management/_assets/impact_iteration.drawio.svg b/process/process_areas/change_management/_assets/impact_iteration.drawio.svg index 724f87bb08..b8cd29fc6a 100644 --- a/process/process_areas/change_management/_assets/impact_iteration.drawio.svg +++ b/process/process_areas/change_management/_assets/impact_iteration.drawio.svg @@ -1,4 +1,4 @@ -
Detailed
Design
Detailed...
implements
implements

How to follow changes for impact analysis iteratively

How to follow changes for impact analysis iterative...
Component
Requirements
Component...
Component
Architecture
Component...
Detailed
Design
Detailed...
satifies
satifies
implements
implements
implements
implements
Feature
Requirements
Feature...
Feature
Architecture
Feature...
satifies
satifies
fulfills
fulfills
satifies
satifies
Component
Safety Analysis
Component...
mitigated_by
mitigated_by
Source Code
Source Code
Source Code
Source Code
Component
Requirements
Component...
Component
Architecture
Component...
Detailed
Design
Detailed...
satifies
satifies
implements
implements
implements
implements
Source Code
Source Code
Text is not SVG - cannot display
+
Detailed
Design
Detailed...
implements
implements

How to follow changes for impact analysis iteratively

How to follow changes for impact analysis iterative...
Component
Requirements
Component...
Component
Architecture
Component...
Detailed
Design
Detailed...
satifies
satifies
implements
implements
implements
implements
Feature
Requirements
Feature...
fulfills
fulfills
derived_from
derived_from
Component
Safety Analysis
Component...
mitigated_by
mitigated_by
Source Code
Source Code
Source Code
Source Code
Component
Requirements
Component...
Component
Architecture
Component...
Detailed
Design
Detailed...
satifies
satifies
implements
implements
implements
implements
Source Code
Source Code
Text is not SVG - cannot display
diff --git a/process/process_areas/change_management/guidance/change_management_reqs.rst b/process/process_areas/change_management/guidance/change_management_reqs.rst index b30fb42537..e05e1b2c97 100644 --- a/process/process_areas/change_management/guidance/change_management_reqs.rst +++ b/process/process_areas/change_management/guidance/change_management_reqs.rst @@ -182,7 +182,7 @@ Change Request Traceability Impact Analysis Tool The picture is derived from the building blocks metamodel containing all the work products (:ref:`general_concepts_building_blocks`). Its arrows show how every work product is linked (manually) to other work products (e.g. feature requirements are linked to - stakeholder requirements via "satisfies"). The color code describes which of these Links + stakeholder requirements via "derived_from"). The color code describes which of these Links need to be followed for the impact analysis (so for the example this means: if a stakeholder requirement is changed, the feature requirements linked are affected, but not the other way round). "Black" links do not need to be followed, these are the "verifies" links. And these are diff --git a/process/process_areas/implementation/guidance/implementation_guideline.rst b/process/process_areas/implementation/guidance/implementation_guideline.rst index 008990c066..6b5877a5d2 100644 --- a/process/process_areas/implementation/guidance/implementation_guideline.rst +++ b/process/process_areas/implementation/guidance/implementation_guideline.rst @@ -55,7 +55,7 @@ the static and the dynamic view for unit interactions is described. :width: 30% :name: static_view_fig -The static diagram statisfies the architecture and implements the requirements of the related component. The static diagram includes Unit1+2. +The static diagram satisfies the architecture and implements the requirements of the related component. The static diagram includes Unit1+2. .. figure:: _assets/dynamic_view.drawio.svg diff --git a/process/process_areas/requirements_engineering/_assets/aou_traceability.drawio.svg b/process/process_areas/requirements_engineering/_assets/aou_traceability.drawio.svg index 6539053380..95c7ded2dd 100644 --- a/process/process_areas/requirements_engineering/_assets/aou_traceability.drawio.svg +++ b/process/process_areas/requirements_engineering/_assets/aou_traceability.drawio.svg @@ -1,4 +1,4 @@ -
i
i
contains
contains
(internal) Component Assumption of use
(internal) Component...
Stakeholder
Requirements
Stakeholder...
satisfies
satisfies
Feature Requirements
Feature Requirements
satisfies
satisfies
mitigated_by
mitigated_by
Component Requirements
Component Requiremen...
fulfils
fulfils
Component
 Architecture
Component...
fulfils
fulfils
(internal) Module Safety Manual
(internal) Module Sa...
violates
violates
Component
Safety Analysis
Component...
mitigated_by
mitigated_by
Feature
Architecture
Feature...

Feature
Safety Analysis
Feature...
Feature
Assumption of use
Feature...
mitigated_by
mitigated_by
Platform Safety Manual
Platform Safety Manu...
i
i
contains
contains
i
i
contains
contains
mitigated_by
mitigated_by
violates
violates
i
i
contains
contains
(external) Component Assumption of use
(external) Component...
(external) Module Safety Manual
(external) Module Sa...
fulfils
fulfils
fulfils
fulfils
i
i
SW-Platform
Assumption of use
SW-Platform...
contains
contains
Platform
Safety Analysis
Platform...
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
Text is not SVG - cannot display
+
i
i
contains
contains
(internal) Component Assumption of use
(internal) Component...
Stakeholder
Requirements
Stakeholder...
derived_from
derived_from
Feature Requirements
Feature Requirements
derived_from
derived_from
mitigated_by
mitigated_by
Component Requirements
Component Requiremen...
fulfils
fulfils
Component
 Architecture
Component...
fulfils
fulfils
(internal) Module Safety Manual
(internal) Module Sa...
violates
violates
Component
Safety Analysis
Component...
mitigated_by
mitigated_by
Feature
Architecture
Feature...

Feature
Safety Analysis
Feature...
Feature
Assumption of use
Feature...
mitigated_by
mitigated_by
Platform Safety Manual
Platform Safety Manu...
i
i
contains
contains
i
i
contains
contains
mitigated_by
mitigated_by
violates
violates
i
i
contains
contains
(external) Component Assumption of use
(external) Component...
(external) Module Safety Manual
(external) Module Sa...
fulfils
fulfils
fulfils
fulfils
i
i
SW-Platform
Assumption of use
SW-Platform...
contains
contains
Platform
Safety Analysis
Platform...
mitigated_by
mitigated_by
mitigated_by
mitigated_by
violates
violates
Component
Component
satisfied_by
satisfied_by
Text is not SVG - cannot display
diff --git a/process/process_areas/requirements_engineering/_assets/requirements_versioning.drawio.svg b/process/process_areas/requirements_engineering/_assets/requirements_versioning.drawio.svg index 2adc5603bb..cea2669e24 100644 --- a/process/process_areas/requirements_engineering/_assets/requirements_versioning.drawio.svg +++ b/process/process_areas/requirements_engineering/_assets/requirements_versioning.drawio.svg @@ -1,4 +1,4 @@ -
Commit 1
Commit 1
Commit 3
Commit 3
Commit 2
Commit 2
Requirement
  • UID: REQ_11
  • Hash: 11
  • Satisfies: REQ_1
  • Satisfies Hash: 1
Requirement...
Satisfies
Satisfies
Satisfies Hash
Satisfies...
Requirement
  • UID: REQ_1
  • Hash: 1
Requirement...
Requirement
  • UID: REQ_1
  • Hash: 2
Requirement...
Requirement
  • UID: REQ_11
  • Hash: 12
  • Satisfies: REQ_1
  • Satisfies Hash:2
Requirement...
Depends On
Depends On
Text is not SVG - cannot display
\ No newline at end of file +
Commit 1
Commit 1
Commit 3
Commit 3
Commit 2
Commit 2
Requirement
  • UID: REQ_11
  • Hash: 11
  • Derived_from: REQ_1
  • Derived Hash: 1
Requirement...
derived_from
derived_fr...
Derived Hash
Derived Ha...
Requirement
  • UID: REQ_1
  • Hash: 1
Requirement...
Requirement
  • UID: REQ_1
  • Hash: 2
Requirement...
Requirement
  • UID: REQ_11
  • Hash: 12
  • Derived_from: REQ_1
  • Derived Hash:2
Requirement...
Depends On
Depends On
Text is not SVG - cannot display
diff --git a/process/process_areas/requirements_engineering/_assets/requirements_workflow.drawio.svg b/process/process_areas/requirements_engineering/_assets/requirements_workflow.drawio.svg index a06cc5452a..09873202b3 100644 --- a/process/process_areas/requirements_engineering/_assets/requirements_workflow.drawio.svg +++ b/process/process_areas/requirements_engineering/_assets/requirements_workflow.drawio.svg @@ -1,4 +1,4 @@ -
PR Review
PR Review
Linkage Document
Linkage Document
Parent Requirement
Parent Requirement
Parent Requirement
[status = valid]
Parent Requirement...
PR Review
PR Review
Requirement Level n
Requirement Level n
Requirement Level n+1
Requirement Level n+1
Requirement
Requirement
Requirement
[status = valid]
Requirement...
links
[satisfies = parentreq.uid]
[linkhash = parentreq.hash]
links...
PR Review
PR Review
1
1
3
3
4
4
5
5
[status = valid]
[status = val...
[status = valid]
[status = val...
6
6
7
7
2
2
Parent Requirement
[reqcovered = yes]
Parent Requirement...
Formal Review 
Formal Review 
8
8
&
&
Text is not SVG - cannot display
\ No newline at end of file +
PR Review
PR Review
Linkage Document
Linkage Document
Parent Requirement
Parent Requirement
Parent Requirement
[status = valid]
Parent Requirement...
PR Review
PR Review
Requirement Level n
Requirement Level n
Requirement Level n+1
Requirement Level n+1
Requirement
Requirement
Requirement
[status = valid]
Requirement...
links
[derived_from = parentreq.uid]
[linkhash = parentreq.hash]
links...
PR Review
PR Review
1
1
3
3
4
4
5
5
[status = valid]
[status = val...
[status = valid]
[status = val...
6
6
7
7
2
2
Parent Requirement
[reqcovered = yes]
Parent Requirement...
Formal Review 
Formal Review 
8
8
&
&
Text is not SVG - cannot display
diff --git a/process/process_areas/requirements_engineering/guidance/requirements_guideline.rst b/process/process_areas/requirements_engineering/guidance/requirements_guideline.rst index dfd1ce1e99..d60abc2927 100644 --- a/process/process_areas/requirements_engineering/guidance/requirements_guideline.rst +++ b/process/process_areas/requirements_engineering/guidance/requirements_guideline.rst @@ -50,9 +50,6 @@ Templates * - AoU Requirements - :need:`[[title]] ` - ``aou_req__`` - * - Process Requirements - - :need:`[[title]] ` - - ``gd_req__`` * - Tool Requirements - :need:`[[title]] ` - ``tool_req__`` @@ -170,7 +167,7 @@ For this the following templates are available: Note: For non-functional (and process) type requirements no children need to be derived (on lower requirement levels), these can mostly be directly fulfilled and verified. -To ease verification a link to these ("process" type) requirements can be established from :need:`gd_temp__req_process_req`. +To ease verification a link to these ("process" type) requirements can be established from :need:`gd_temp__process_requirement`. .. _review_child_requirement: @@ -227,9 +224,9 @@ In this workflow (as it describes SEooC development) these AoUs are created both AoUs can be of different class and shall be handled by tracing those -* to Feature/Component (architecture) (via fulfills), if those are on (external) Component Level and can be fulfilled by (internal) Feature/Component +* to Feature/Component (architecture) (via fulfils), if those are on (external) Component Level and can be fulfilled by (internal) Feature/Component * to Stakeholder Requirements (via covers), if AoU are of general nature and can be fulfilled by platform -* or by containing those in Platform(s) Safety Manual(s), if AoU cannot be fulfilled by platform or its components (alone) but need to be satisfied by the user of the platform +* or by containing those in Platform(s) Safety Manual(s), if AoU cannot be fulfilled by platform or its components (alone) but need to be fulfilled by the user of the platform .. figure:: ../_assets/aou_traceability.drawio.svg @@ -246,6 +243,9 @@ Internal component's AoU can also be fulfilled (and linked) by other internal co External component's AoUs which cannot be fulfilled by the platform alone are contained in the platform safety manual, whereas the internal component's AoUs are part of the module safety manual. +Note that it is not mandatory to have component architecture (in case the component has no "sub" components). +Therefore the "component" architecture element is depicted, which is used to link external Component Assumption of Use. + Like other requirements also an AoU needs to be verified - but by the user of the feature/component. To improve the usability of a feature/component, its responsible team should already provide integration tests the user has to run to prove the fulfillment of the AoU(s). diff --git a/process/process_areas/requirements_engineering/guidance/requirements_process_reqs.rst b/process/process_areas/requirements_engineering/guidance/requirements_process_reqs.rst index 1c28e80633..7562994e53 100644 --- a/process/process_areas/requirements_engineering/guidance/requirements_process_reqs.rst +++ b/process/process_areas/requirements_engineering/guidance/requirements_process_reqs.rst @@ -21,7 +21,7 @@ Process Requirements :id: gd_req__req_structure :status: valid :tags: done_automation, structure - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool, wf__req_feat_aou, wf__req_comp_aou + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool, wf__req_feat_aou, wf__req_comp_aou :complies: std_req__iso26262__support_6431, std_req__iso26262__support_6432 Requirements shall be hierarchically grouped into three levels. @@ -46,7 +46,7 @@ Process Requirement Attributes :id: gd_req__req_attr_uid :status: valid :tags: manual_prio_1, attribute, mandatory - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool, wf__req_feat_aou, wf__req_comp_aou + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool, wf__req_feat_aou, wf__req_comp_aou :complies: std_req__iso26262__support_6425, std_req__iso26262__support_6432 Each requirement shall have a unique ID. It shall consist of three parts: @@ -61,7 +61,7 @@ Process Requirement Attributes :id: gd_req__req_attr_title :status: valid :tags: manual_prio_1 attribute, mandatory - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool, wf__req_feat_aou, wf__req_comp_aou + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool, wf__req_feat_aou, wf__req_comp_aou :complies: std_req__iso26262__support_6424 The title of the requirement shall provide a short summary of the description, but is not an "additional" requirement. @@ -72,7 +72,7 @@ Process Requirement Attributes :id: gd_req__req_attr_description :status: valid :tags: manual_prio_1, attribute, mandatory - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool, wf__req_feat_aou, wf__req_comp_aou + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool, wf__req_feat_aou, wf__req_comp_aou :complies: std_req__iso26262__support_6424 Each requirement shall have a description. @@ -183,13 +183,12 @@ Process Requirement Linkage :status: valid :tags: manual_prio_1, attribute :complies: std_req__iso26262__support_6432, std_req__aspice_40__SWE-1-BP5 - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool - Requirements shall be linked to its adjacent level via the attribute satisfies. + Requirements shall be linked to its adjacent level via the attribute derived_from. * stakeholder requirements <- feature requirements * feature requirements <- component requirements - * workflow or stakeholder requirements <- process requirements * process requirements or stakeholder requirements <- tool requirements .. gd_req:: Requirement Linkage to AoU @@ -212,9 +211,9 @@ Process Requirement Linkage :status: valid :tags: done_automation, attribute :complies: std_req__iso26262__support_6432, std_req__aspice_40__SWE-1-BP5 - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool - Bi-directional traceability shall be provided by adding a "back-link" via attribute satisfied by (i.e. make a <-> out of the <- in :need:`gd_req__req_linkage`). + Bi-directional traceability shall be provided by adding a "back-link" via attribute derives (i.e. make a <-> out of the <- in :need:`gd_req__req_linkage`). .. gd_req:: Requirement attribute: requirement covered :id: gd_req__req_attr_req_cov @@ -287,7 +286,7 @@ Process Requirements Checks :id: gd_req__req_check_mandatory :status: valid :tags: done_automation, check - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool, wf__req_feat_aou, wf__req_comp_aou + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool, wf__req_feat_aou, wf__req_comp_aou It shall be checked if all mandatory attributes for each requirement is provided by the user. For all requirements following attributes shall be mandatory: @@ -303,7 +302,7 @@ Process Requirements Checks :id: gd_req__req_desc_weak :status: valid :tags: done_automation, check - :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_proc_tool, wf__req_feat_aou, wf__req_comp_aou + :satisfies: wf__req_stkh_req, wf__req_feat_req, wf__req_comp_req, wf__req_tool, wf__req_feat_aou, wf__req_comp_aou It shall be ensured that no *weak words* are contained in the requirement description for: diff --git a/process/process_areas/requirements_engineering/guidance/requirements_templates.rst b/process/process_areas/requirements_engineering/guidance/requirements_templates.rst index 0ee95a34a8..54b95bc70e 100644 --- a/process/process_areas/requirements_engineering/guidance/requirements_templates.rst +++ b/process/process_areas/requirements_engineering/guidance/requirements_templates.rst @@ -49,18 +49,6 @@ Templates See the Assumption of Use requirement snippets in the `module template documentation `__. -.. gd_temp:: Process Requirements Template - :id: gd_temp__req_process_req - :status: valid - :complies: std_req__iso26262__support_641, std_req__iso26262__support_6421, std_req__iso26262__support_6425 - - .. code-block:: rst - - .. gd_req:: - :id: gd_req__<process>__<Title> - :satisfies: <link to guidance id> - :complies: <link to standard requirement> - :status: <valid|invalid> .. gd_temp:: Tool Requirements Template :id: gd_temp__req_tool_req @@ -73,7 +61,7 @@ Templates :id: tool_req__<tool>__<Title> :security: <YES|NO> :safety: <QM|ASIL_B> - :satisfies: <link to process req id> + :derived_from: <link to process req id> :status: <valid|invalid> :implemented: <YES|PARTIAL|NO> diff --git a/process/process_areas/requirements_engineering/requirements_concept.rst b/process/process_areas/requirements_engineering/requirements_concept.rst index 594264f91f..17f8e0a44d 100644 --- a/process/process_areas/requirements_engineering/requirements_concept.rst +++ b/process/process_areas/requirements_engineering/requirements_concept.rst @@ -49,7 +49,7 @@ Stakeholders for the requirements #. :need:`Tester <rl__committer>` - * Verify that the specification is fulfilled by the elements under test + * Verify that the specification is satisfied by the elements under test * Consider AoUs for test case specification #. :need:`Safety Architect <rl__safety_engineer>` @@ -133,7 +133,7 @@ However the detailed interaction of the underlying components itself which is re Component Requirements ====================== -The lowest abstraction level is represented by the *component requirements*. They are derived from *feature requirements* and describe component specific implementation details. It is described which behaviour a component itself needs to fulfil in the context of the feature, for example: +The lowest abstraction level is represented by the *component requirements*. They are derived from *feature requirements* and describe component specific implementation details. It is described which behaviour a component itself needs to satisfy in the context of the feature, for example: .. code-block:: text @@ -207,13 +207,13 @@ Following attributes are automatically generated: * - Attribute - Description - Tool - * - Satisfied by - - This attribute is automatically generated into the parent requirement based on the attribute satisfies of the current requirement + * - Derives + - This attribute is automatically generated into the parent requirement based on the attribute derived_from of the current requirement - Docs-as-Code * - Hash - This attribute contains a hash value which is calculated over all mandatory requirement attributes. However this script needs to be executed manually, as this information is required to be present in the rst file. - Script - * - Satisfies Hash + * - Derived Hash - It contains the hash of the parent requirement. If the parent requirement is changed the hash will also change and the linkage has to be revisited again. A more detailed description is provided here: :need:`gd_req__req_attr_version` - Script * - Implemented by @@ -258,7 +258,7 @@ During docs build it shall be checked if the attribute hash matches the actual h Linking child requirements including hashes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -If a requirement is linked to a top level requirement also the hash of the target requirement shall be part of the link. It shall automatically be written into the attribute *satisfies hash*. Upon docs build it shall be checked if the attribute *satisfies hash* matches the calculated hash of the requirement which is linked via *satisfies*. +If a requirement is linked to a top level requirement also the hash of the target requirement shall be part of the link. It shall automatically be written into the attribute *derived hash*. Upon docs build it shall be checked if the attribute *derived hash* matches the calculated hash of the requirement which is linked via *derived_from*. As this check is included in the docs build as a warning it can be guaranteed that a change of a parent requirement can only be merged if the `linkhashes` in the requirements are also updated in a `Depends-On` PR. diff --git a/process/process_areas/requirements_engineering/requirements_workflow.rst b/process/process_areas/requirements_engineering/requirements_workflow.rst index 43f608db04..eb57ac3cc1 100644 --- a/process/process_areas/requirements_engineering/requirements_workflow.rst +++ b/process/process_areas/requirements_engineering/requirements_workflow.rst @@ -89,8 +89,8 @@ For a detailed explanation of workflows and their role within the process model, Based on the safety concept on component level, component AoUs can be derived. See also :ref:`aou_workflow` -.. workflow:: Create/Maintain Process and Tool Requirements - :id: wf__req_proc_tool +.. workflow:: Create/Maintain Tool Requirements + :id: wf__req_tool :status: valid :tags: requirements_engineering :responsible: rl__contributor @@ -98,10 +98,10 @@ For a detailed explanation of workflows and their role within the process model, :supported_by: rl__safety_manager, rl__security_manager :input: wp__process_description :output: wp__requirements_proc_tool - :contains: gd_temp__req_process_req, gd_temp__req_tool_req, gd_temp__req_formulation + :contains: gd_temp__req_tool_req, gd_temp__req_formulation :has: doc_concept__req_process, doc_getstrt__req_process - Based on the process descriptions (which comply to standards) and/or stakeholder/feature/component requirements process and tool requirements are derived. + Based on the process descriptions (which comply to standards) and/or stakeholder/feature/component requirements tool requirements are derived. .. workflow:: Monitor/Verify Requirements :id: wf__monitor_verify_requirements