Merge pull request #1093 from ds-crehm/main

chore(documentation): #915 BPN-EDC configuration documentation

docs/src/docs/user/user-manual.adoc

@@ -93,10 +93,18 @@ Possibility to check the network status based on logfiles and will provide acces
 
 ==== BPN-EDC configuration
 
-In the BPN-EDC configuration screen an admin user can add URLs for BPNs. Any URLs here will be used directly for the configured BPN instead of looking up the URL with the EDC DiscoveryFinder service. Existing configurations can be edited or removed.
+In the BPN-EDC configuration screen an admin user can add URLs for BPNs. Existing configurations can be edited or removed.
 
 image::https://raw.githubusercontent.com/eclipse-tractusx/traceability-foss/main/docs/src/images/user-manual/navigation/bpn_edc_configuration.png[]
 
+Any configured BPNs will have their URLs merged in addition to the URLs found by the DiscoveryService.
+The resulting list of URLs will be used whenever a notification is sent to those BPNs. In case an URL returns an error response, the remaining URLs will be used as backup.
+
+[plantuml, target=bpn-edc-configuration, format=svg]
+....
+include::../../uml-diagrams/user-manual/bpn-edc-configuration.puml[]
+....
+
 ==== Contracts - view and export
 
 In the Contracts view an admin user can view contract agreements and sort them by the contract ID.

docs/src/uml-diagrams/user-manual/bpn-edc-configuration.puml

@@ -0,0 +1,22 @@
+@startuml
+skinparam monochrome true
+skinparam shadowing false
+skinparam defaultFontName "Architects daughter"
+
+title Receive EDC URLs
+participant "Trace-X" as TX
+participant "BPN-EDC configuration" as BEC
+participant "DiscoveryFinder" as DF
+
+activate TX
+TX -> BEC: Look up URLs for configured BPN
+activate BEC
+BEC --> TX: URLs
+deactivate BEC
+TX -> DF: Look up URLs for configured BPN
+activate DF
+DF --> TX: URLs
+deactivate DF
+TX -> TX: Merge URLs into list (no duplicates)
+
+@enduml