diff --git a/doc/decisions/ADR-sqlite.asciidoc b/doc/decisions/ADR-sqlite.asciidoc new file mode 100644 index 0000000000000000000000000000000000000000..3858eb40ba58412207c56a198c5ed76dfdedf1c8 --- /dev/null +++ b/doc/decisions/ADR-sqlite.asciidoc @@ -0,0 +1,46 @@ +// architecture decision record +:lang: de +:encoding: utf-8 +:date: 2021-07-21 +:author: Andreas Romeyke + +// Hinweis: Bitte kurz fassen! + +ADR - Name +========== + +== Entscheidung + +// Einzeiler +// Es wurde entscheiden, dass. + +Statt SQL für eine PostgreSQL-Datenbank zu erzeugen, wird direkt eine SQLite-Datenbank generiert. + +Optional soll die Gnerierung des SQL-Scripts möglich bleiben. + +== Status + +// Status: Proposed -> Accepted -> Superseded +// -> Declined + +Proposed + +== Kontext + +// Gründe, Randbedingungen, die zur Entscheidung führen + +Bisher wird ein Script generiert, welches SQL für eine PostgreSQL-Datenbank erzeugt. Dies zieht folgende Probleme nach sich: + +1. das SQL-Script wird sehr groß, inbesondere, weil jedes Jahr mehr und mehr AIPs zu berücksichtigen sind +2. es muss eine extra Postgres-Datenbank aufgesetzt werden +3. das SQL Script ist von der Datenbank entkoppelt. Ob das Script tatsächlich funktioniert, kann erst bei Einspielen des Scripts in die Datenbank geprüft werden + +Mit der Nutzung von SQLite hätte man zum einen sofort eine lauffähige Datenbank, die nicht erst administriert werden muss. Zum anderen erspart man sich den Zwischenschritt der SQL-Script Generierung. + +== Konsequenzen + +// was folgt aus Entscheidung + +Durch die direkte Verwendung von SQLite entfällt der Erhalt der Eigenschaft "direkt lesbar". Durch die optionale Möglichkeit der Generierung des SQL-Scriptes wird dieser Nachteil abgefedert. + +Berücksichtigt werden sollte, dass es uU. möglich ist, dass eine SQLite-Datenbank-Datei nur mit bestimmten Versionen lesbar ist. Die Nutzbarkeit der SQLite-Datenbank muss durch regelmäßige Tests sichergestellt werden. diff --git a/doc/decisions/template.asciidoc b/doc/decisions/template.asciidoc new file mode 100644 index 0000000000000000000000000000000000000000..b5e6801a54e30bdb13f04555d0deacfaee5226cf --- /dev/null +++ b/doc/decisions/template.asciidoc @@ -0,0 +1,30 @@ +// architecture decision record +:lang: de +:encoding: utf-8 +:date: 2021-04-27 +:author: Andreas Romeyke + +// Hinweis: Bitte kurz fassen! + +ADR - Name +========== + +== Entscheidung + +// Einzeiler +// Es wurde entscheiden, dass. + +== Status + +// Status: Proposed -> Accepted -> Superseded +// -> Declined + +== Kontext + +// Gründe, Randbedingungen, die zur Entscheidung führen + +== Konsequenzen + +// was folgt aus Entscheidung + +