From b1cc62459b8371c8c140f979a4796c7d0db8f0d0 Mon Sep 17 00:00:00 2001 From: Luc Weinbrecht Date: Wed, 27 Mar 2024 09:00:55 +0100 Subject: [PATCH] started documenting building blocks --- README.md | 14 ++++++ .../diagram/building-block-view-level-0.puml | 32 +++++++++++++ ...ew-level-1-camunda-carbon-reductor-c7.puml | 19 ++++++++ ...ew-level-1-camunda-carbon-reductor-c8.puml | 24 ++++++++++ ...ock-view-level-1-carbon-reductor-core.puml | 42 ++++++++++++++++++ .../generated/building-block-view-level-0.png | Bin 0 -> 36557 bytes ...iew-level-1-camunda-carbon-reductor-c7.png | Bin 0 -> 17384 bytes ...iew-level-1-camunda-carbon-reductor-c8.png | Bin 0 -> 28887 bytes ...lock-view-level-1-carbon-reductor-core.png | Bin 0 -> 46384 bytes camunda-carbon-reductor-c7/README.md | 9 ++++ camunda-carbon-reductor-c8/README.md | 14 +++++- carbon-reductor-core/README.md | 13 ++++++ 12 files changed, 166 insertions(+), 1 deletion(-) create mode 100644 assets/diagram/building-block-view-level-0.puml create mode 100644 assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c7.puml create mode 100644 assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c8.puml create mode 100644 assets/diagram/building-block-view-level-1-carbon-reductor-core.puml create mode 100644 assets/diagram/generated/building-block-view-level-0.png create mode 100644 assets/diagram/generated/building-block-view-level-1-camunda-carbon-reductor-c7.png create mode 100644 assets/diagram/generated/building-block-view-level-1-camunda-carbon-reductor-c8.png create mode 100644 assets/diagram/generated/building-block-view-level-1-carbon-reductor-core.png diff --git a/README.md b/README.md index 4d58350..4924272 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,7 @@ You want to contribute 🌱? Please read the [Contribution Guidelines](CONTRIBUT * [Camunda 8](#camunda-8) * [Camunda 7](#camunda-7) * 📈 [Reporting Carbon Reduction via Camunda Optimize](#reporting-carbon-reduction-via-camunda-optimize) +* [🏗️ Building Blocks](#building-blocks) * 📚 [Releases](#releases) * 📆 [Publications](#publications) * 📨 [Contact](#contact) @@ -75,6 +76,19 @@ we visualized the results for out example process and it looks like the followin The exported Dashboard Definition could be found [here](assets/optimize-dashboard-definition.json). +# 🏗️Building Blocks + +![Building Block View Level 0 Camunda Carbon Reductor](assets/diagram/generated/building-block-view-level-0.png) + +| Element | Description | +|--------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------| +| [Carbon Reductor Core](./carbon-reductor-core/README.md#building-blocks) | Core module which calculates the possible time shifting base on data it fetches from the external systems. | +| Carbon Aware API | Custom Client to connect to the Carbon Aware SDK. | +| Carbon Aware Computing API | Custom Client to connect to the Carbon Aware Computing API. | +| [Camunda Carbon Reductor C8](./camunda-carbon-reductor-c8/README.md#building-blocks) | Camunda 8 Job Worker. | +| [Camunda Carbon Reductor C7](./camunda-carbon-reductor-c7/README.md#building-blocks) | Camunda 7 External Task Worker. | + + # 📚Releases The list of [releases](https://github.com/envite-consulting/camunda-carbon-reductor/releases) contains a detailed changelog. diff --git a/assets/diagram/building-block-view-level-0.puml b/assets/diagram/building-block-view-level-0.puml new file mode 100644 index 0000000..fedd7b0 --- /dev/null +++ b/assets/diagram/building-block-view-level-0.puml @@ -0,0 +1,32 @@ +@startuml + +component "Camunda Carbon Reductor" { + portin "Camunda 7" + portin "Camunda 8" + + component "Carbon Reductor Core" <> + component "Camunda Carbon Reductor C7" <> + component "Camunda Carbon Reductor C8" <> + + component API <> { + component "Carbon Aware API" <> + component "Carbon Aware Computing API" <> + } + + portout "Carbon Aware SDK \n (WattTime | ElectricityMaps)" as CarbonAwareSDK + portout "Carbon Aware Computing" + + "Camunda 7" --> "Camunda Carbon Reductor C7" + "Camunda 8" --> "Camunda Carbon Reductor C8" + + "Camunda Carbon Reductor C7" --> "Carbon Reductor Core" + "Camunda Carbon Reductor C8" --> "Carbon Reductor Core" + + "Carbon Reductor Core" --> "Carbon Aware API" + "Carbon Reductor Core" --> "Carbon Aware Computing API" + + "Carbon Aware API" --> CarbonAwareSDK + "Carbon Aware Computing API" --> "Carbon Aware Computing" +} + +@enduml diff --git a/assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c7.puml b/assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c7.puml new file mode 100644 index 0000000..be300af --- /dev/null +++ b/assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c7.puml @@ -0,0 +1,19 @@ +@startuml + +component "Camunda Carbon Reductor C7" <> { + portin "Camunda 7" + + component CarbonReductorTaskHandler + + component CarbonReductorVariableMapper + + portout "Carbon Reductor Core" <> + + "Camunda 7" <-- CarbonReductorTaskHandler : import + "Carbon Reductor Core" --> CarbonReductorTaskHandler : use + + CarbonReductorTaskHandler -> CarbonReductorVariableMapper : use + CarbonReductorVariableMapper -> "Carbon Reductor Core" : import +} + +@enduml diff --git a/assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c8.puml b/assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c8.puml new file mode 100644 index 0000000..1bc3da9 --- /dev/null +++ b/assets/diagram/building-block-view-level-1-camunda-carbon-reductor-c8.puml @@ -0,0 +1,24 @@ +@startuml + +component "Camunda Carbon Reductor C8" <> { + portin "Camunda 8" + + component CarbonReductorWorker + + component CarbonReductorVariableMapper + component CarbonReductorInputVariable + component CarbonReductorOutputVariable + + portout "Carbon Reductor Core" <> + + "Camunda 8" <-- CarbonReductorWorker : import + "Carbon Reductor Core" --> CarbonReductorWorker : use + + CarbonReductorWorker --> CarbonReductorVariableMapper : use + CarbonReductorVariableMapper --> "Carbon Reductor Core" : import + + CarbonReductorVariableMapper --> CarbonReductorInputVariable : import + CarbonReductorVariableMapper --> CarbonReductorOutputVariable : import +} + +@enduml diff --git a/assets/diagram/building-block-view-level-1-carbon-reductor-core.puml b/assets/diagram/building-block-view-level-1-carbon-reductor-core.puml new file mode 100644 index 0000000..63d5414 --- /dev/null +++ b/assets/diagram/building-block-view-level-1-carbon-reductor-core.puml @@ -0,0 +1,42 @@ +@startuml + +component "Carbon Reductor Core" <> { + portin "Camunda Carbon Reductor C7" <> + portin "Camunda Carbon Reductor C8" <> + + ' Usecase + component DelayCalculator <> + component CarbonEmissionQuery <> + + ' Domain + component DelayCalculatorService <> + + component CarbonReduction <> + component CarbonReductorConfiguration <> + + ' Adapter + component CarbonAwareSdkClient <> + component CarbonAwareComputingApiClient <> + + portout "Carbon Aware API" <> + portout "Carbon Aware Computing API" <> + + + DelayCalculatorService --> CarbonReduction : use + DelayCalculatorService --> CarbonReductorConfiguration : use + + DelayCalculator <-- DelayCalculatorService : implements + CarbonEmissionQuery <-- CarbonAwareSdkClient : implements + CarbonEmissionQuery <-- CarbonAwareComputingApiClient : implements + + DelayCalculatorService --> CarbonEmissionQuery : use + + + "Camunda Carbon Reductor C7" --> DelayCalculator + "Camunda Carbon Reductor C8" --> DelayCalculator + + CarbonAwareSdkClient --> "Carbon Aware API" + CarbonAwareComputingApiClient --> "Carbon Aware Computing API" +} + +@enduml diff --git a/assets/diagram/generated/building-block-view-level-0.png b/assets/diagram/generated/building-block-view-level-0.png new file mode 100644 index 0000000000000000000000000000000000000000..15227031b4d5a6e8c9118ed43ee03072fc105be5 GIT binary patch literal 36557 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 literal 0 HcmV?d00001 diff --git a/assets/diagram/generated/building-block-view-level-1-camunda-carbon-reductor-c7.png b/assets/diagram/generated/building-block-view-level-1-camunda-carbon-reductor-c7.png new file mode 100644 index 0000000000000000000000000000000000000000..6afd10c4fd0717006385b370d17f197181b3e308 GIT binary patch literal 17384 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 literal 0 HcmV?d00001 diff --git a/assets/diagram/generated/building-block-view-level-1-carbon-reductor-core.png b/assets/diagram/generated/building-block-view-level-1-carbon-reductor-core.png new file mode 100644 index 0000000000000000000000000000000000000000..0cef2e07ac5b8e2f026aa0431efcc3bd03f28dde GIT binary patch literal 46384 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 Ad;kCd literal 0 HcmV?d00001 diff --git a/camunda-carbon-reductor-c7/README.md b/camunda-carbon-reductor-c7/README.md index fb23b59..977974d 100644 --- a/camunda-carbon-reductor-c7/README.md +++ b/camunda-carbon-reductor-c7/README.md @@ -12,6 +12,7 @@ Provides also a Service Task Template for configuration ([carbon-reductor.json]( * [Adding the element template to the modeler](#adding-the-element-template-to-the-modeler) * [Configuring the element template](#configuring-the-element-template) * [🖐🏼 Manual Override](#-manual-override) +* [🏗️ Building Blocks](#building-blocks) # 🚀Getting Started @@ -99,3 +100,11 @@ There are 2 options: ![Attached Error Event in the process model](../docs/error-handling/error-handling-c7-process.png) +# 🏗️Building Blocks + +![Building Block View Level 1 Camunda Carbon Reductor C7](../assets/diagram/generated/building-block-view-level-1-camunda-carbon-reductor-c7.png) + +| Element | Description | +|------------------------------|---------------------------------------------------------------------------------------| +| CarbonReductorTaskHandler | `ExternalTaskHandler` which connects to the model element and does the time shifting. | +| CarbonReductorVariableMapper | Maps the process data to the internal configuration model. | \ No newline at end of file diff --git a/camunda-carbon-reductor-c8/README.md b/camunda-carbon-reductor-c8/README.md index 8cef258..aed8e8b 100644 --- a/camunda-carbon-reductor-c8/README.md +++ b/camunda-carbon-reductor-c8/README.md @@ -15,6 +15,7 @@ implementation of the Carbon Redcutor. * [Adding the element template to the modeler](#adding-the-element-template-to-the-modeler) * [Configuring the element template](#configuring-the-element-template) * [🖐🏼 Manual Override](#-manual-override) +* [🏗️ Building Blocks](#building-blocks) # 🗒️Notes @@ -144,4 +145,15 @@ There are 2 options: * On Exceptions a BPMN Error will be thrown that can be caught in the process model. * The process model needs to catch the thrown BPMN Error with the name **carbon-reductor-error** -![Attached Error Event in the process model](../docs/error-handling/error-handling-c8-process.png) \ No newline at end of file +![Attached Error Event in the process model](../docs/error-handling/error-handling-c8-process.png) + +# 🏗️Building Blocks + +![Building Block View Level 1 Camunda Carbon Reductor C8](../assets/diagram/generated/building-block-view-level-1-camunda-carbon-reductor-c8.png) + +| Element | Description | +|------------------------------|-----------------------------------------------------------------------------| +| CarbonReductorWorker | `JobWorker` which connects to the model element and does the time shifting. | +| CarbonReductorVariableMapper | Maps the process data to the internal configuration model. | +| CarbonReductorInputVariable | Object representing the input data from the process. | +| CarbonReductorOutVariable | Object representing the data which is written back to the process. | diff --git a/carbon-reductor-core/README.md b/carbon-reductor-core/README.md index ad50a04..6e44943 100644 --- a/carbon-reductor-core/README.md +++ b/carbon-reductor-core/README.md @@ -7,6 +7,7 @@ Uses the [Carbon Aware API](../api/api-carbon-aware/README.md). # Table of Contents * [🔧️Configuration](#configuration) +* [🏗️ Building Blocks](#building-blocks) # 🔧️Configuration @@ -14,3 +15,15 @@ The environmental variable `CARBON-REDUCTOR_CARBON-AWARE-API_BASE-PATH` allows y Default is `http://localhost:8090`. Or you can override all properties in the [application.yaml](./src/main/resources/application.yaml) by applying e.g. a custom one. + + +# 🏗️Building Blocks + +![Building Block View Level 1 Carbon Reductor Core](../assets/diagram/generated/building-block-view-level-1-carbon-reductor-core.png) + +| Element | Description | +|------------------------------|-----------------------------------------------------------------------------| +| CarbonReductorWorker | `JobWorker` which connects to the model element and does the time shifting. | +| CarbonReductorVariableMapper | Maps the process data to the internal configuration model. | +| CarbonReductorInputVariable | Object representing the input data from the process. | +| CarbonReductorOutVariable | Object representing the data which is written back to the process. |