From cf73c1bcb2440e37d2f402f182ba7c162af67412 Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Tue, 26 Sep 2023 12:03:21 +0200
Subject: [PATCH] chore(uml):[TRI-1417] add more details

---
 .../ess-customer-notifications-submodel.puml  | 20 ++++++
 .../sequence/aggregate-bpnl.puml              | 13 ++++
 ... => ess-bottom-up-sequence-highlevel.puml} | 63 +++++++++++--------
 3 files changed, 69 insertions(+), 27 deletions(-)
 create mode 100644 docs/src/uml-diagrams/irs-recursive/ess-bottom-up/ess-customer-notifications-submodel.puml
 create mode 100644 docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/aggregate-bpnl.puml
 rename docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/{ess-bottim-up-sequence-highlevel.puml => ess-bottom-up-sequence-highlevel.puml} (59%)

diff --git a/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/ess-customer-notifications-submodel.puml b/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/ess-customer-notifications-submodel.puml
new file mode 100644
index 0000000000..16a48f41fa
--- /dev/null
+++ b/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/ess-customer-notifications-submodel.puml
@@ -0,0 +1,20 @@
+@startuml
+skinparam monochrome true
+skinparam shadowing false
+skinparam defaultFontName "Architects daughter"
+
+entity  Customers {
+     businessPartnerNumberLegalEntity : string
+}
+entity  CustomerParts{
+    globalAssetId : string
+}
+entity  Sites{
+    businessPartnerNumberSite : string
+}
+
+Customers "0..*" - "1..*" CustomerParts
+
+CustomerParts "0..*" - "1..*" Sites
+
+@enduml
\ No newline at end of file
diff --git a/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/aggregate-bpnl.puml b/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/aggregate-bpnl.puml
new file mode 100644
index 0000000000..097c388a07
--- /dev/null
+++ b/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/aggregate-bpnl.puml
@@ -0,0 +1,13 @@
+@startuml
+@startuml
+skinparam monochrome true
+skinparam shadowing false
+skinparam defaultFontName "Architects daughter"
+
+autonumber "<b>[000]"
+
+participant
+participant
+
+
+@enduml
\ No newline at end of file
diff --git a/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/ess-bottim-up-sequence-highlevel.puml b/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/ess-bottom-up-sequence-highlevel.puml
similarity index 59%
rename from docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/ess-bottim-up-sequence-highlevel.puml
rename to docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/ess-bottom-up-sequence-highlevel.puml
index 20f248ea7d..af4f32feb1 100644
--- a/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/ess-bottim-up-sequence-highlevel.puml
+++ b/docs/src/uml-diagrams/irs-recursive/ess-bottom-up/sequence/ess-bottom-up-sequence-highlevel.puml
@@ -32,29 +32,32 @@ ClientApp <-- dDTR_Tier_N : Array [{AAS shells}]
 
 ClientApp -> ClientApp : Extract globalAssetId
 
-ClientApp -> dDTR_Tier_N : /ess/broadcast/recipients/orders
+ClientApp -> dDTR_Tier_N : /ess/customers/investigations/orders
     note left
-        globalAssetIds [
-            bpn : <bpnl>
-            globalAssetIds : <globalAssetIds>
-        ]
-        bomLifecycle : asPlanned,
-        direction : upwards (SingleLevelUsageAsPlanned),
-        depth : 1,
-        filters [
+        Investigation of customers who must be notified about an incident.
+        parameters:
             {
-              validityTimestamp : <validityTimestamp>
-            },
-         ],
-        incidentBpns [<bpns>,..]
-
+            keys [
+                bpn : <bpnl>
+                globalAssetIds : <globalAssetIds>
+            ]
+            bomLifecycle : asPlanned,
+            direction : upwards (SingleLevelUsageAsPlanned),
+            depth : 1,
+            incidentBpns [<bpns>,..],
+            filterExpressions :  [
+                        {
+                          validityTimestamp : <validityTimestamp>
+                        },
+                     ]
+            }
     end note
 
     ref over dDTR_Tier_N, dDTR_Tier_3, SubmodelServer_Tier_3
         Determining relationships 1 tier level upwards
     end ref
 
-    dDTR_Tier_N -> dDTR_Tier_N : deduplicateBPNLs
+    dDTR_Tier_N -> dDTR_Tier_N : aggregateBPNLs
     note left
         Aggregate bpns numbers for each bpnl
     end note
@@ -62,7 +65,7 @@ ClientApp -> dDTR_Tier_N : /ess/broadcast/recipients/orders
 
     dDTR_Tier_N -> dDTR_Tier_N : validityPeriodChecker
     note left
-        validtyPeriodCheck: Checks if passed timestamp is in validity period defined with
+        validityPeriodCheck: Checks if passed timestamp is in validity period defined with
         validityPeriod.validFrom and  PartAsPlanned.validityPeriod.validTo
 
         PartAsPlanned.validityPeriod.validFrom
@@ -77,16 +80,22 @@ ClientApp -> dDTR_Tier_N : /ess/broadcast/recipients/orders
     ClientApp <-- dDTR_Tier_N : Get a batch with a given batchId for a given orderId.
     ClientApp --> dDTR_Tier_N : GET /irs/jobs/{id}
     ClientApp <-- dDTR_Tier_N : Return job with item graph for the requested id.
-    note left
-        [
-            {
-                globalAssetId : <globalAssetId>
-                bpnl : <bpnl>
-                bpns [
-                 <bpns>
-                 ]
-            },
-        ]
-    end note
     User <-- ClientApp : Return job with item graph for the requested id.
+      note left
+            {
+                customers : [
+                    {
+                        businessPartnerNumberLegalEntity : <bpnl>,
+                        "customerParts" [
+                            {
+                                globalAssetId:   <globalAssetId>,
+                                sites : [
+                                    {<bpns>},
+                                ],
+                             }, ...
+                        ]
+                    },
+                ]
+            }
+        end note
 @enduml
\ No newline at end of file