DevOps Storage Plugin

DevOps Storage ist die fachliche Datenhaltung der DWDO-Schicht: ein versioniertes SQLite-Schema für Projekte, Arbeitselemente, Beziehungen, Einstellungen und Prüfspur, dazu Export und Wiederherstellung als JSONL. Seiteninhalt bleibt ausdrücklich in DokuWiki. Gedacht ist das Paket für Plugin-Entwickler der Suite und für Verwalter, die Daten sichern oder zurückholen müssen.

Erste Schritte

Schnelleinstieg: Die erste Ausfuhr und ihr Einspielplan — der kürzeste Weg zum ersten Ergebnis, in drei Schritten.

Schema ansehen → Grenze zu den Seiten klären → Export einrichten

Häufige Aufgaben

Was Sie wollen	Für wen	Wo Sie das tun	Anleitung
nachsehen, welche Tabellen es gibt	Entwickler	–	Das Schema
entscheiden, ob Daten hierher gehören	Entwickler	–	Grenze zwischen Datenbank und Seiten
Daten exportieren	Verwaltung	–	Export und Wiederherstellung
Daten wiederherstellen	Verwaltung	–	Export und Wiederherstellung
eine Einstellung ändern	Verwaltung	Konfigurationsmanager	Konfiguration
den allgemeinen SQLite-Dienst finden	Entwickler	–	wkstorage

Zweck

Die fachliche Datenhaltung der DWDO-Schicht: das versionierte Schema, eine Repository-Schicht über vorbereiteten Anweisungen mit vereinheitlichten Fehlern, sowie Export und Wiederherstellung als JSONL. Den technischen Zugang liefert Storage Plugin; dieses Plugin besitzt die Tabellen.

Angemeldete Dienste (siehe Core Plugin): dwdo.storage, dwdo.repos, dwdo.export.

Das Schema

Stand 013, 22 Tabellen. Gruppiert nach Zweck:

Bereich	Tabellen
Projekte und Fachdaten	`dwdo_projects`, `dwdo_workitems`, `dwdo_relations`, `dwdo_risks`, `dwdo_queries`, `dwdo_settings`
Prüfspur	`dwdo_audit`
Pipelines	`dwdo_pipelines`, `dwdo_pipeline_runs`
Lokale Git-Repos (Git Plugin)	`dwdo_git_repos`, `dwdo_git_repo_links`, `dwdo_source_links`
ADO-Verbindung (Azure DevOps Connector)	`dwdo_ado_connections`, `dwdo_ado_repo_map`, `dwdo_ado_workitem_map`
ADO-Abgleich (vorbereitet, kein aktives Plugin)	`dwdo_ado_sync_state`, `dwdo_ado_sync_inbox`, `dwdo_ado_sync_outbox`, `dwdo_ado_sync_conflicts`
ADO-Git-Proxy (wkdoadogit)	`dwdo_adogit_mounts`, `dwdo_adogit_user_tokens`
Verwaltung	`schema_migrations`

Das Schema ist breiter als die installierte Plugin-Menge. Tabellen für Boards, Abfragen, Berichte und den ADO-Abgleich liegen bereits bereit; die zugehörigen Plugins sind noch nicht installiert. Das ist Absicht — ein Schemaschritt nachträglich einzuziehen ist teurer, als eine Tabelle vorerst leer stehen zu lassen.

Wo die Grenze zwischen Datenbank und Seiten liegt

Strukturierte Daten in die Datenbank, Inhalt in Seiten. Ein Arbeitselement hat Zustand, Beziehungen und eine Prüfspur — dafür ist eine Tabelle richtig. Seine Beschreibung ist Text und gehört auf eine Wiki-Seite, wo Versionierung, Suche, Diff und Export ohne Zutun funktionieren.

Siehe auch den entsprechenden Hinweis in Storage Plugin.

Export und Wiederherstellung

Der Dienst dwdo.export schreibt den Bestand als JSONL — eine Zeile je Datensatz. Das Format ist bewusst zeilenweise: es lässt sich anhängen, mit gewöhnlichen Werkzeugen filtern und teilweise einlesen, und eine beschädigte Zeile kostet einen Datensatz statt der ganzen Datei.

Der Wiederherstellungsweg ist im Plugin unter RECOVERY.md beschrieben.

Konfiguration

Keine. Der Ablageort kommt von Storage Plugin, der fachliche Zuschnitt aus dem Schema.

Paketangaben

Plugin: wkdostorage
Namespace: lib/plugins/wkdostorage/
Autor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Lizenz: GPL 2