Wiki

Das Wiki ist die integrierte Wissensdatenbank: Arbeitsanweisungen, Prozessbeschreibungen, Gerätewissen und Einarbeitungsunterlagen liegen dort, wo auch die Prüfmittel und Kalibrierungen liegen.

Aufbau

Element	Beschreibung
Kategorien	Gliedern die Artikel im Baum. Kategorien sind sprachgebunden.
Artikel	Eine Seite je Sprache; Übersetzungen desselben Artikels gehören zusammen.
Blöcke	Der Editor arbeitet mit Blöcken: Überschrift, Absatz, Liste, Aufgabe, Zitat, Hinweis, Code, Tabelle, Bild.
Revisionen	Jedes Speichern legt eine neue Revision an. Ältere Fassungen bleiben lesbar.
Medien	Bilder und Anhänge hängen am Artikel und werden mit ihm ausgeliefert.

Breite der Seitenübersicht

Zwischen Seitenübersicht und Artikel sitzt ein Ziehgriff — die schmale Leiste in der Lücke. Damit lässt sich verschieben, wie viel Platz jede Seite bekommt: breiter, wenn ein tief verschachtelter Kategorienbaum sonst umbricht, schmaler, sobald der Artikel im Vordergrund steht. Die eingestellte Breite bleibt erhalten und gilt beim nächsten Aufruf wieder. Ohne Maus geht es genauso: den Griff mit der Tabulatortaste anspringen, dann Pfeil links/rechts (mit Umschalt in größeren Schritten) oder Pos1/Ende für die schmalste bzw. breiteste Einstellung. Wie weit sich der Griff ziehen lässt, begrenzt der Platz — Baum und Artikel behalten ihre Mindestbreite.

Auf Telefon und kleinem Tablet

Der Kategorienbaum steht auf breiten Bildschirmen links neben dem Artikel. Unterhalb von 768 px Fensterbreite bekommt der Artikel die volle Breite, und der Baum öffnet sich über den Knopf Seiten in der Kopfzeile; er schließt sich wieder, sobald eine Seite gewählt ist.

Im Editor führt auf Touch-Geräten der Griff (⋮) neben dem Block zu allen Blockaktionen — Absatz einfügen, verschieben, duplizieren, löschen und umwandeln. Die Griffe zum Anlegen und Löschen von Tabellenzeilen und -spalten sind dort dauerhaft sichtbar statt erst beim Überfahren mit der Maus.

Berechtigungen

Operation	Erlaubt
wiki_view	Artikel lesen
wiki_edit	Artikel anlegen und bearbeiten, Medien hochladen
wiki_delete	Artikel löschen
wiki_category_view / _edit / _delete	Kategorien lesen, pflegen, löschen
wiki_export	Das komplette Wiki als Paket herunterladen
wiki_import	Ein Wiki-Paket einspielen

Export und Import sind eigene Rechte

wiki_export und wiki_import sind bewusst keine Abstufung von wiki_edit. Der Export trägt die gesamte Wissensbasis als Datei aus dem Haus, der Import schreibt fremde Inhalte hinein — beides ist eine andere Entscheidung als „darf eine Seite ändern". Die beiden Operationen werden beim Update keiner Rolle automatisch zugewiesen; wer sie braucht, bekommt sie im Rollenmanagement.

Ganzes Wiki exportieren

Der Knopf Exportieren oben rechts lädt das komplette Wiki als ZIP-Paket (calserver.wiki-package) herunter:

wiki-export-2026-09-11.zip
├── manifest.json   Prüfsummen (sha256) je Eintrag
├── wiki.json       Kategorien, Artikel, alle Sprachvarianten, Inhalte
└── media/          die hochgeladenen Bilder und Anhänge

Bilder und Anhänge reisen mit: ein exportiertes Wiki bleibt vollständig, auch wenn Artikel Screenshots oder Anleitungen als Datei enthalten.

Das Paket eignet sich für den Umzug auf eine andere Installation, als zusätzliche Sicherung neben dem Datenbank-Backup und für die Übergabe an eine Zweitinstallation.

Wiki importieren

Der Knopf Importieren öffnet den Dialog. Importiert wird eine Paketdatei: ein ZIP aus einem Export, ein Paket von der Download-Seite (siehe unten) oder eine einzelne wiki.json.

Dazu die Frage, was mit bereits vorhandenen Seiten passiert:

Modus	Verhalten
Bestehende Seiten behalten (Vorgabe)	Ein Artikel, den es schon gibt, bleibt unangetastet. Derselbe Import zweimal ausgeführt ändert beim zweiten Mal nichts.
Bestehende Seiten überschreiben	Der Paketinhalt wird als neue Revision angelegt. Die bisherige Fassung bleibt in der Historie und lässt sich weiter einsehen.

Nach dem Import zeigt der Dialog, was tatsächlich passiert ist: angelegte Kategorien, angelegte, aktualisierte und übersprungene Seiten, übernommene Medien sowie eventuelle Hinweise.

Wiedererkennung über die Artikel-ID

Artikel werden über ihre general_page_id wiedererkannt, nicht über den Titel. Ein umbenannter Artikel bleibt derselbe Artikel; ein neu getippter Artikel mit gleichem Titel ist ein anderer.

Das Manifest wird geprüft

Ein ZIP wird nur eingelesen, wenn jede Datei mit der im manifest.json hinterlegten Prüfsumme übereinstimmt und keine ungelistete Datei mitreist. Ein nachträglich geändertes Paket wird abgelehnt — das ist der Grund, warum Pakete von einer Download-Seite überhaupt vertrauenswürdig sind. Wer den Inhalt bearbeiten will, lädt die entpackte wiki.json einzeln hoch.

Vorlagen herunterladen

Fertige Wiki-Vorlagen stehen auf der Download-Seite des Vorlagen-Repos in der Kategorie Wiki-Vorlagen bereit — dieselbe Seite, die auch die Report-Pakete und Prüfpläne ausliefert.

Warum nicht im Produkt eingebaut

Eine Wiki-Vorlage ist redaktioneller Inhalt: Sie ändert sich, wenn die Norm oder die Formulierung sich ändert, nicht wenn calServer eine neue Version bekommt. Im Produkt eingebaut hieße, für eine Textkorrektur eine Release zu fahren. Über das Vorlagen-Repo steht eine überarbeitete Fassung sofort bereit, und der Import bleibt derselbe.

Vorlage ISO/IEC 17025 (zwei Varianten)

Zur Norm gibt es zwei Pakete mit demselben Handbuchtext. Sie unterscheiden sich darin, ob die Umsetzung in calServer Teil des Handbuchs ist:

Paket	Kapitel	Passt, wenn
wiki-iso-17025.zip	14 (QMH-00 bis QMH-13)	das Handbuch softwareneutral bleiben soll
wiki-iso-17025-calserver.zip	15 (zusätzlich QMH-14)	calServer die führende Aufzeichnung ist und im Audit gezeigt wird

Beide gleichzeitig zu importieren ergibt 29 Artikel, die dasselbe Handbuch zweimal beschreiben — die Artikel-IDs sind verschieden, der Import erkennt sie also nicht als dieselben. Eine Variante wählen.

Softwareneutrale Fassung

Das Paket wiki-iso-17025.zip enthält eine Startvorlage für das QM-Handbuch eines Kalibrierlabors nach DIN EN ISO/IEC 17025:2018-03: 14 Kapitel (QMH-00 bis QMH-13), jeweils in Deutsch und Englisch, je Sprache in einer Kategorie. Das ist der Handbuchtext selbst, nicht eine Übersicht der Norm: Alles Laborspezifische steht als Platzhalter in eckigen Klammern ([Laborname], [DAkkS-Registriernummer], [Turnus]), und jedes Kapitel beginnt mit einem Hinweisblock, der auflistet, was zu ersetzen und zu entscheiden ist.

Kapitel	Inhalt	Normkapitel
QMH-00	Deckblatt, Platzhalter, Kapitelübersicht, Dokumentenlenkung	8.3, 8.4
QMH-01	Anwendungsbereich und Akkreditierungsumfang	1, 5
QMH-02	Unparteilichkeit und Vertraulichkeit	4.1, 4.2
QMH-03	Organisation und Verantwortlichkeiten	5
QMH-04	Personal und Qualifikation	6.2
QMH-05	Räumlichkeiten und Umgebungsbedingungen	6.3
QMH-06	Ausrüstung und Normale	6.4
QMH-07	Metrologische Rückführbarkeit und externe Leistungen	6.5, 6.6
QMH-08	Auftragsabwicklung und Kalibrierverfahren	7.1, 7.2, 7.4
QMH-09	Ermittlung der Messunsicherheit	7.6
QMH-10	Sicherstellung der Validität der Ergebnisse	7.7
QMH-11	Kalibrierscheine und Konformitätsaussagen	7.8
QMH-12	Beschwerden, nichtkonforme Arbeit und Korrekturmaßnahmen	7.9, 7.10, 8.7
QMH-13	Risiken und Chancen, interne Audits, Managementbewertung	8.5, 8.8, 8.9

Die Tabellen bringen die Struktur mit — Dokumentenkopf, Akkreditierungsumfang, Rollenmatrix, Rückführungsplan, Unsicherheitsbudget, Aufbewahrungsfristen. Ihre Zeilen sind Beispiele und werden vor der Freigabe überschrieben. Wo ein Kapitel einen Nachweis beschreibt, der in calServer entsteht (Normale, Fälligkeiten, Kalibrierscheine, Beschwerden), benennt es das Modul.

Eine Startvorlage, kein fertiges QM-Handbuch

Die Texte sind ein Ausgangspunkt. Vor der Freigabe müssen die Platzhalter ersetzt, die Beispielzeilen durch die eigenen Angaben überschrieben, nicht zutreffende Kapitel begründet gestrichen und die Verweise auf die eigenen Verfahrensanweisungen ergänzt werden. Eine unverändert übernommene Vorlage belegt gegenüber einer Akkreditierungsstelle nichts — stehengebliebene Platzhalter fallen im Audit sofort auf.

Fassung mit calServer-Umsetzung

wiki-iso-17025-calserver.zip trägt denselben Handbuchtext, ergänzt aber jedes Kapitel um drei Abschnitte:

Abschnitt	Frage, die er beantwortet
Umsetzung in calServer	Wo landet die Anforderung, und was entsteht dort als Nachweis? Mit Modul, Menüpfad und Operation.
Nachweis im Audit	Was fragt eine Begutachtung, womit wird geantwortet, wo im Programm liegt das?
Grenzen	Was calServer hier nicht leistet — als Aufgabenliste, die offen bleibt, bis das Labor den Punkt außerhalb geregelt hat.

Dazu kommt QMH-14 als Arbeitsblatt: eine Abdeckungsmatrix über alle Normabschnitte mit der Bewertung, wie weit calServer das jeweilige Kapitel trägt (weitgehend, teilweise, gering), die fünf größten Lücken und eine Lückenliste zum Abhaken. Das Kapitel nennt außerdem, was eine brauchbare Meldung über eine fehlende Funktion enthalten muss.

Die Grenzen-Abschnitte sind der eigentliche Zweck dieser Fassung. Sie sagen zum Beispiel, dass eine Qualifikationsmatrix kein Datenobjekt ist, dass der Sollbereich der Umgebungsbedingungen gedruckt und nicht geprüft wird, dass kein Unsicherheitsbudget nach GUM gerechnet wird und dass die Freigabe eines Kalibrierscheins den Akkreditierungsumfang bewusst nicht prüft.

Die Bewertung gilt für einen Stand

QMH-14 bewertet den Auslieferungsstand von calServer V2, nicht die eigene Installation samt zugebuchten Modulen. Nach einem Update gehört die Seite durchgesehen — sonst behauptet das Handbuch Lücken, die es nicht mehr gibt, oder verschweigt neue.

Mehrere Kapitel verweisen auf Konfigurationspakete derselben Download-Seite (Statusmodelle, Ticketmanagement, Kategoriebaum, Kalibrierschein-Vorlage). Zusammen ergeben sie eine Installation, in der die beschriebenen Nachweise tatsächlich entstehen.

Bestehende Installationen

Die Vorlage kommt nicht automatisch mit einem Update — und das ist auch nicht nötig, denn sie lässt sich zu jedem Zeitpunkt nachholen. Nach dem Update auf eine Version mit dieser Funktion:

1. Die Operationen wiki_export und wiki_import stehen im Rollenmanagement zur Verfügung (die Migration zieht sie in den Katalog nach).
2. Der gewünschten Rolle wiki_import zuweisen.
3. wiki-iso-17025.zip von der Download-Seite laden.
4. Im Wiki auf Importieren klicken, Datei auswählen, Modus Bestehende Seiten behalten lassen, importieren.

Ein zweiter Durchlauf ist ungefährlich: bereits vorhandene Artikel werden übersprungen. Eine später überarbeitete Fassung übernimmt man mit Bestehende Seiten überschreiben — die bisherigen Texte bleiben als Revision erhalten.

Kommandozeile

Für Erstinbetriebnahme, Migration oder Support-Zugriff gibt es denselben Weg ohne Rechtevergabe:

# Ein Paket von der Platte einlesen (idempotent)
docker exec calserver-api-v2 php artisan wiki:import /pfad/wiki-iso-17025.zip

# Bestehende Seiten als neue Revision überschreiben
docker exec calserver-api-v2 php artisan wiki:import /pfad/wiki-iso-17025.zip --mode=overwrite

# Revisionen einem bestimmten Benutzer zuschreiben (sonst: erster Superadmin)
docker exec calserver-api-v2 php artisan wiki:import /pfad/wiki-iso-17025.zip --user=<uID>

API

Methode	Endpunkt	Recht
GET	/api/v2/wiki/export	wiki_export
POST	/api/v2/wiki/import	wiki_import

Der Export nimmt optional ?language=de und ?category_id=3. Der Import erwartet eine hochgeladene Datei (file) und optional mode (skip oder overwrite).

Format

Das Paketformat heißt calserver.wiki-package (Version 1), das Dokument darin calserver.wiki. Das maschinenlesbare Schema des Manifests liegt unter wiki-package.schema.json. Wer eigene Vorlagen beisteuern will, findet die Regeln im Vorlagen-Repo calhelp/calServer-reports (robots.md, Abschnitt 0.4).

Hintergrund zur Formatentscheidung: ADR 2026-09-11 – Wiki-Vorlagen kommen über den Import.