From e1bc55d3b226cda54aae365f70ec63db643f0259 Mon Sep 17 00:00:00 2001
From: Thomas Peetz <thomas.peetz@ingenieurbuero-peetz.de>
Date: Mon, 19 Jan 2026 20:14:22 +0100
Subject: [PATCH] vault backup: 2026-01-19 20:14:22

---
 .obsidian/types.json                          |  5 +-
 .../process-architectural-decision-record.md  | 56 +++++++++++++++++++
 Übersicht/SOP/Architektur Entscheidungen.md  | 29 ++++++++++
 Übersicht/SOP/Journal SOP.md                 |  1 -
 4 files changed, 89 insertions(+), 2 deletions(-)
 create mode 100644 Resources/Templates/process-architectural-decision-record.md
 create mode 100644 Übersicht/SOP/Architektur Entscheidungen.md

diff --git a/.obsidian/types.json b/.obsidian/types.json
index 43639b5..4aa5014 100644
--- a/.obsidian/types.json
+++ b/.obsidian/types.json
@@ -54,6 +54,9 @@
     "gilde": "multitext",
     "gekauft": "checkbox",
     "Erstaustrahlung_USA": "date",
-    "Folge": "number"
+    "Folge": "number",
+    "deciders": "multitext",
+    "consulted": "multitext",
+    "informed": "multitext"
   }
 }
\ No newline at end of file
diff --git a/Resources/Templates/process-architectural-decision-record.md b/Resources/Templates/process-architectural-decision-record.md
new file mode 100644
index 0000000..65b0180
--- /dev/null
+++ b/Resources/Templates/process-architectural-decision-record.md
@@ -0,0 +1,56 @@
+---
+title:
+status:
+date:
+deciders:
+consulted:
+informed:
+---
+# Title
+## Context and Problem Statement
+
+## Decision Drivers
+
+## Considered Options
+
+## Chosen Option/Decision Outcome
+
+## Consequences
+
+## Validation/Confirmation
+
+## More Information
+
+
+# AD: System Decomposition into Logical Layers
+
+## Context and Problem Statement
+
+Which concept is used to decompose the system under construction into logical building blocks?
+
+## Decision Drivers
+
+* Desire to divide the overall system into manageable parts to reduce complexity
+* Ability to exchange system parts without affecting others
+
+## Considered Options
+
+1. Layers pattern 
+2. Pipes-and-filters
+3. Workflow
+
+## Decision Outcome
+
+We decided to apply the Layers pattern and neglected other decomposition pattern such as pipes-and-filters or workflow because the system under construction and its capabilities do not suggest an organization by data flow or control flow. Technology is expected to be primary driver of change during system evolution. 
+
+### Consequences
+
+* Good, because the Layers pattern provides high flexibility regarding technology selections within the layers (changeability) and enables teams to work on system parts in parallel.
+* Bad, because there might be a performance penalty for each level of indirection and some undesired replication of implementation artifacts.
+
+## More Information
+
+* The three decomposition options come from the Cloud Computing Pattern [Distributed Application](https://www.cloudcomputingpatterns.org/distributed_application/).
+* The Layers pattern is featured in POSA Volume 1, see <http://www.dre.vanderbilt.edu/~schmidt/POSA-tutorial.pdf>
+
+A follow-on decision will be required to assign logical layers to physical tiers.
diff --git a/Übersicht/SOP/Architektur Entscheidungen.md b/Übersicht/SOP/Architektur Entscheidungen.md
new file mode 100644
index 0000000..4242c40
--- /dev/null
+++ b/Übersicht/SOP/Architektur Entscheidungen.md	
@@ -0,0 +1,29 @@
+---
+tags:
+  - process/sop
+---
+
+# Ziel und Zweck
+
+Die Nachverfolgung der Architektur Entscheidungen soll über Architecture Decision Records (ADR) erfolgen.
+Die Beschreibung der Erzeugung von ADR ist in den  [[Architektur Entscheidungen#Referenzen|Referenzen]] beschrieben.
+
+Die Erzeugung von ADR mit Hilfe eines Templates ([[process-architectural-decision-record]]) unterstützt.
+
+# Referenzen
+
+- [Gut dokumentiert: Architecture Decision Records](https://www.heise.de/hintergrund/Gut-dokumentiert-Architecture-Decision-Records-4664988.html?seite=all)
+- https://github.com/npryce/adr-tools
+- https://adr.github.io/
+- https://medium.com/olzzio/how-to-create-architectural-decision-records-adrs-and-how-not-to-93b5b4b33080
+- https://medium.com/olzzio/how-to-review-architectural-decision-records-adrs-and-how-not-to-2707652db196
+- [The Markdown ADR (MADR) Template Explained and Distilled](https://www.ozimmer.ch/practices/2022/11/22/MADRTemplatePrimer.html)
+
+# Weitergehende Informationen
+
+Ausschnitt aus [The Markdown ADR (MADR) Template Explained and Distilled](https://www.ozimmer.ch/practices/2022/11/22/MADRTemplatePrimer.html):
+ADRs help you keep **CALM** because they ease AD making and capturing:
+- **C**ollaborative content creation is enabled.
+- **A**ccountability is supported and unnecessary reconsideration of issues avoided.
+- **L**earning opportunities are provided, both for newcomers and for the experienced.
+- **M**anagement likes them too because it is used to making and executing decisions.
diff --git a/Übersicht/SOP/Journal SOP.md b/Übersicht/SOP/Journal SOP.md
index 4eb3dc3..36b4634 100644
--- a/Übersicht/SOP/Journal SOP.md	
+++ b/Übersicht/SOP/Journal SOP.md	
@@ -1,6 +1,5 @@
 ---
 id: Journal SOP
-aliases: []
 tags:
   - process/sop
 rework: true