From 8b9f9bc5064172c7d317b6b7d705002950188494 Mon Sep 17 00:00:00 2001 From: "jhr2hi@bosch.com" Date: Thu, 8 Jan 2026 11:31:36 +0100 Subject: [PATCH 1/3] update architecture diagrams according to specification --- MODULE.bazel | 2 +- .../architecture_concept.rst | 10 +++++----- .../architecture_getstrt.rst | 2 +- .../guidance/architecture_modeling_example.rst | 17 +++++++---------- .../_assets/detailed_design_example.rst | 4 ++-- 5 files changed, 16 insertions(+), 19 deletions(-) diff --git a/MODULE.bazel b/MODULE.bazel index 5ad7a2c452..1454999784 100644 --- a/MODULE.bazel +++ b/MODULE.bazel @@ -50,4 +50,4 @@ bazel_dep(name = "buildifier_prebuilt", version = "8.2.0.2") ############################################################################### bazel_dep(name = "aspect_rules_lint", version = "1.5.3") bazel_dep(name = "score_tooling", version = "1.0.2") -bazel_dep(name = "score_docs_as_code", version = "2.2.0") +bazel_dep(name = "score_docs_as_code", version = "2.3.0") diff --git a/process/process_areas/architecture_design/architecture_concept.rst b/process/process_areas/architecture_design/architecture_concept.rst index d938c21e5f..d2e89d2e63 100644 --- a/process/process_areas/architecture_design/architecture_concept.rst +++ b/process/process_areas/architecture_design/architecture_concept.rst @@ -179,9 +179,9 @@ A SW Module represents a outcome of an component or a set of components realizin On this level also a view shall be defined which is called *Module View*. It represents the allocation of components into modules and displays the dependencies between the single modules. In this view also cyclic dependencies between modules can be identified. -.. mod_view_sta:: Module 3 +.. mod_view_sta:: Module 1 Static View :id: mod_view_sta__example_feature__archdes_3 - :includes: comp_arc_sta__example_feature__archdes_component_1 + :includes: comp__component_example_1 .. needarch:: :scale: 50 @@ -198,12 +198,12 @@ Static View The second viewpoint is named as *component architecture* and describes the implementation of the functionalities in a white-box view of the platform. It describes the structural decomposition of the *SW components* into *lower level* SW components. In the projects this viewpoint provides more detailed information concerning the respective interfaces of a component. If a SW component interacts with a different component it is also included via a *use* relationship in the diagram. An example of the *component architecture* is displayed here: -.. comp_arc_sta:: Component 2 - :id: comp_arc_sta__example_feature__archdes_component_2 +.. comp_arc_sta:: Component 1 Static View + :id: comp_arc_sta__example_feature__archdes_component_concept_1 :status: valid :safety: ASIL_B :security: NO - :includes: comp_arc_sta__example_feature__archdes_sub_component_1, comp_arc_sta__example_feature__archdes_sub_component_2, comp_arc_sta__example_feature__archdes_sub_component_3 + :includes: comp__archdes_sub_component_1, comp__archdes_sub_component_2, comp__archdes_sub_component_3 :fulfils: comp_req__example_feature__archdes_example_req .. needarch:: diff --git a/process/process_areas/architecture_design/architecture_getstrt.rst b/process/process_areas/architecture_design/architecture_getstrt.rst index f902a0299e..e3eb6e40d2 100644 --- a/process/process_areas/architecture_design/architecture_getstrt.rst +++ b/process/process_areas/architecture_design/architecture_getstrt.rst @@ -166,7 +166,7 @@ Component Architecture The following section is an example, how an component looks like and how the detail design of an component is described. Please note that components with an "ASIL_B" safety rating are highlighted with red borders in the diagram (e.g., "Component 1"). -.. comp_arc_sta:: Component 1 +.. comp_arc_sta:: Component 1 Static View :id: comp_arc_sta__example_feature__component_getstrt :status: valid :safety: ASIL_B diff --git a/process/process_areas/architecture_design/guidance/architecture_modeling_example.rst b/process/process_areas/architecture_design/guidance/architecture_modeling_example.rst index 757a854583..644026b9ca 100644 --- a/process/process_areas/architecture_design/guidance/architecture_modeling_example.rst +++ b/process/process_areas/architecture_design/guidance/architecture_modeling_example.rst @@ -171,6 +171,7 @@ Component Architecure File(s) :status: invalid :implements: logic_arc_int__example_feature__archdes_logical_interface_1, logic_arc_int__example_feature__archdes_logical_interface_2 :uses: logic_arc_int__example_feature__archdes_logical_interface_3 + :consists_of: comp__archdes_sub_component_1, comp__archdes_sub_component_2, comp__archdes_sub_component_3 Example Component 1 description. @@ -182,7 +183,6 @@ Component Architecure File(s) :uses: logic_arc_int__example_feature__archdes_logical_interface_3 :implements: logic_arc_int__example_feature__archdes_logical_interface_1, logic_arc_int__example_feature__archdes_logical_interface_2 :fulfils: comp_req__example_feature__archdes_example_req - :includes: comp_arc_sta__example_feature__archdes_sub_component_1, comp_arc_sta__example_feature__archdes_sub_component_2, comp_arc_sta__example_feature__archdes_sub_component_3 .. needarch:: :scale: 50 @@ -206,31 +206,28 @@ Component Architecure File(s) .. Subcomponents -.. comp_arc_sta:: Lower Level Component 1 - :id: comp_arc_sta__example_feature__archdes_sub_component_1 +.. comp:: Lower Level Component 1 + :id: comp__archdes_sub_component_1 :status: valid :safety: ASIL_B :security: NO :uses: logic_arc_int__example_feature__archdes_logical_interface_3 :implements: logic_arc_int__example_feature__archdes_logical_interface_2 - :fulfils: comp_req__example_feature__archdes_example_req -.. comp_arc_sta:: Lower Level Component 2 - :id: comp_arc_sta__example_feature__archdes_sub_component_2 +.. comp:: Lower Level Component 2 + :id: comp__archdes_sub_component_2 :status: valid :safety: ASIL_B :security: NO :uses: logic_arc_int__example_feature__archdes_logical_interface_3 :implements: logic_arc_int__example_feature__archdes_logical_interface_2 - :fulfils: comp_req__example_feature__archdes_example_req -.. comp_arc_sta:: Lower Level Component 3 - :id: comp_arc_sta__example_feature__archdes_sub_component_3 +.. comp:: Lower Level Component 3 + :id: comp__archdes_sub_component_3 :status: valid :safety: QM :security: NO :implements: logic_arc_int__example_feature__archdes_logical_interface_3 - :fulfils: comp_req__example_feature__archdes_example_req .. Requirements diff --git a/process/process_areas/implementation/_assets/detailed_design_example.rst b/process/process_areas/implementation/_assets/detailed_design_example.rst index 5d07605d07..b54a52e61b 100644 --- a/process/process_areas/implementation/_assets/detailed_design_example.rst +++ b/process/process_areas/implementation/_assets/detailed_design_example.rst @@ -31,7 +31,7 @@ Static Diagrams for Unit Interactions :safety: ASIL_B :status: valid :implements: comp_req__example_feature__archdes_example_req - :satisfies: comp_arc_sta__example_feature__archdes_sub_component_1 + :satisfies: comp_arc_sta__example_feature__archdes_component_1 :includes: sw_unit__example_feature__unit1, sw_unit__example_feature__unit2 .. uml:: dd_example_ex_sta.puml @@ -45,7 +45,7 @@ Dynamic Diagrams for Unit Interactions :safety: ASIL_B :status: valid :implements: comp_req__example_feature__archdes_example_req - :satisfies: comp_arc_sta__example_feature__archdes_sub_component_1 + :satisfies: comp_arc_sta__example_feature__archdes_component_1 .. uml:: dd_example_ex_dyn.puml From 643a322cfb5b4385d67246f7392e07576b411039 Mon Sep 17 00:00:00 2001 From: "jhr2hi@bosch.com" Date: Thu, 8 Jan 2026 11:46:32 +0100 Subject: [PATCH 2/3] fix need ref --- .../architecture_design/guidance/architecture_guideline.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/process_areas/architecture_design/guidance/architecture_guideline.rst b/process/process_areas/architecture_design/guidance/architecture_guideline.rst index 07dbdcdfa3..76ebc07849 100644 --- a/process/process_areas/architecture_design/guidance/architecture_guideline.rst +++ b/process/process_areas/architecture_design/guidance/architecture_guideline.rst @@ -220,7 +220,7 @@ UML diagram selection Static architecture ------------------- -As can be seen from the examples presented in :need:`feat_arc_sta__example_feature__feature_1` and :need:`comp_arc_sta__example_feature__archdes_component_2` +As can be seen from the examples presented in :need:`feat_arc_sta__example_feature__feature_1` and :need:`comp_arc_sta__example_feature__archdes_component_concept_1` for the static architecture a UML component diagram is expected (and supported by the tooling). Dynamic architecture From 38c3ee527fe8b6774c4245667bf5d6abe6225ae8 Mon Sep 17 00:00:00 2001 From: "jhr2hi@bosch.com" Date: Thu, 8 Jan 2026 12:07:22 +0100 Subject: [PATCH 3/3] fix feature view in concept --- .../architecture_design/architecture_getstrt.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/process/process_areas/architecture_design/architecture_getstrt.rst b/process/process_areas/architecture_design/architecture_getstrt.rst index e3eb6e40d2..dabbb9c2a6 100644 --- a/process/process_areas/architecture_design/architecture_getstrt.rst +++ b/process/process_areas/architecture_design/architecture_getstrt.rst @@ -165,6 +165,12 @@ Component Architecture The following section is an example, how an component looks like and how the detail design of an component is described. Please note that components with an "ASIL_B" safety rating are highlighted with red borders in the diagram (e.g., "Component 1"). +.. comp:: Component 1 + :id: comp__component_getstrt + :security: NO + :safety: ASIL_B + :status: invalid + :implements: logic_arc_int__example_feature__archdes_logical_interface_1 .. comp_arc_sta:: Component 1 Static View :id: comp_arc_sta__example_feature__component_getstrt @@ -172,7 +178,6 @@ The following section is an example, how an component looks like and how the det :safety: ASIL_B :security: NO :uses: logic_arc_int__example_feature__archdes_logical_interface_3 - :implements: logic_arc_int__example_feature__archdes_logical_interface_1 :fulfils: comp_req__example_feature__archdes_example_req .. needarch::