Vorgaben¶

Unter Administration > Vorgaben (/v2/admin/requirements) werden die normativen Stammdaten gepflegt. Die Seite bündelt sechs Tabs:

Tab	Endpunkt	Operation
Prüfnormen	`/test-standards`	lesen: jeder API-Benutzer, pflegen: `test_standard_edit` / `test_standard_delete`
SI-Präfixe	`/admin/si-prefixes`	`basic_setting_admin`
Physikalische Größen	`/admin/physical-quantities`	`basic_setting_admin`
Qualitätsvorgaben	`/admin/provisions`	`basic_setting_admin`
Ressourcen	`/admin/resources`	`resource_view` / `resource_edit` / `resource_delete`
Feldvorgaben	`/admin/properties` (`settings/calibration`, `settings/customer`)	`basic_setting_admin`

Die Kataloge SI-Präfixe, Physikalische Größen und Qualitätsvorgaben stammen aus calServer V1 und lagen bis zur Zusammenführung im Tab „Vorgaben" der Grundeinstellungen; die Prüfnormen hatten eine eigene Menüseite. Ohne basic_setting_admin zeigt die Seite nur den Tab Prüfnormen (und, mit resource_view, die Ressourcen).

Feldvorgaben (Feldrollen, Kundensuche und Zähler)¶

Der Tab Feldvorgaben beantwortet die Frage, welches Feld eine bestimmte Systemrolle übernimmt und wie Kunden in Auswahlfeldern erscheinen. Die Werte standen bis ADR-031 als freie Textfelder in den Grundeinstellungen und bis zum 17.08.2026 in der Feldverwaltung; hier steht das Feldregister zur Verfügung, also wird die Zuweisung ausgewählt statt getippt.

Zuweisung	Wirkung
Statusfeld	Feld mit dem Gerätestatus; die E-Mail-Aktionen setzen es als Platzhalter `Status_Field` ein
Zusätzliches Statusfeld	Zweites Statusfeld, wenn der Ablauf zwei getrennte Status braucht
Typfeld	Feld mit dem Gerätetyp; steuert Gerätetyp-Blueprints und den Spezifikations-Abgleich
Zertifikatsfeld	Feld mit der Zertifikatsnummer einer Kalibrierung (Nur V1: V1 findet darüber die Nummer in Kalibrieransicht, Berichtsansicht und Mailversand; V2 spricht Kalibrierfelder über ihren api_name an)
Kunden-E-Mail-Feld	Feld, aus dem die Empfängeradresse für Kunden-E-Mails stammt
Inventarbeschreibung	Felder, die eine Inventar-Auswahlcombo anzeigt (Reihenfolge zählt)
Kundensuche	Felder, die eine Kunden-Auswahlcombo anzeigt (Reihenfolge zählt)

Die Auswahl zeigt Beschriftung und api_name. Beides zusammen, weil nur der api_name die Identität eines Felds ist: Auf einer mit db:install --v1 aufgesetzten Installation heißt das Statusfeld I4211, und in der Werksvorgabe trägt die Spalte name die Beschriftung „Kundennummer". Wer nur eines von beidem sieht, kann die Auswahl nicht überprüfen.

Ein Wert außerhalb der Liste bleibt erhalten. Aus einer V1-Übernahme stehen hier V1-Codes, die das Register nicht zwingend führt. Das Auswahlfeld erlaubt deshalb auch freie Eingabe und verwirft einen gespeicherten Wert nicht — sonst würde einmaliges Öffnen der Seite eine funktionierende Konfiguration leeren.

Globale Zähler¶

Nummernkreise für Vorgabewerte, im selben Tab. Ein Zähler wird über [GLOBAL_COUNTER_N] in einen Vorgabewert eingesetzt und dabei atomar hochgezählt (ADR-018).

Standardmäßig sind vier Zähler vorhanden; über Zähler hinzufügen / Letzten Zähler entfernen lässt sich die Anzahl anpassen. Entfernen ist nicht destruktiv: der gespeicherte Zählerstand bleibt erhalten und [GLOBAL_COUNTER_N] funktioniert weiter, auch wenn der Zähler in der Oberfläche ausgeblendet ist.
Automatischer Reset: je Zähler täglich, wöchentlich (Montag), monatlich (1.) oder jährlich (1.1.). Der nächtliche Lauf php artisan counters:reset (Scheduler, 00:00 Uhr; V1: yiic resetCounter) setzt fällige Zähler auf 0 zurück.
Führende Nullen: [GLOBAL_COUNTER_1|0000] liefert 0042 statt 42. Die Anzahl der Nullen ist die Breite; wird die Nummer länger, bleibt sie vollständig (12345 bei vier Stellen) — abgeschnitten wird nie. Dieselbe Schreibweise gilt für [STATUS_COUNT] und [CATEGORY_COUNT].

Status- und Kategoriezähler haben jetzt denselben Rhythmus

Der automatische Reset gab es lange nur hier, für die globalen Zähler. Zähler, die an einem Status oder einer Kategorie hängen ([STATUS_COUNT], [CATEGORY_COUNT]), lassen sich inzwischen genauso einstellen — nicht auf dieser Seite, sondern unter Administration → Nummernkreise, je Zählerquelle. Derselbe nächtliche Lauf erledigt beides.

Eine Vorlage, viele Zähler — alle einsehbar

Ein [STATUS_COUNT] in einer Feld-Vorgabe zieht nicht einen Zähler, sondern den des Status, mit dem der Datensatz angelegt wird. Bei fünf Auftragsstatus laufen damit fünf getrennte Nummernkreise unter derselben Vorlage — dasselbe gilt für [CATEGORY_COUNT] und die Kategorien.

Administration → Nummernkreise listet sie in der Spalte Zähler und Rücksetzung einzeln auf: Stand und Rhythmus je Status bzw. Kategorie, direkt änderbar. Bei mehr als vier blendet n weitere anzeigen den Rest ein.

Eine Kategorie mit eigener Vorlage für dasselbe Feld erscheint dort nicht — für sie gilt die Basis-Vorlage nicht mehr, sondern ihre eigene Zeile im Register. Bei einem Status ist es anders: Seine eigene Vorlage greift beim Statuswechsel, die Basis-Vorlage beim Anlegen. Beide ziehen denselben Zähler, deshalb steht er unter beiden Zeilen.

Zwei Speichern-Knöpfe

Feldvorgaben speichern schreibt die Zuweisungen, Zähler speichern die Nummernkreise. Beide fassen nur ihren eigenen Ausschnitt an — der Zähler-Block hängt an counter_count und steht deshalb als einziger Teil nicht im Einstellungs-Katalog.

Berechtigung

Der Tab Feldvorgaben erfordert die Operation basic_setting_admin (die Werte sind Properties unter settings/calibration bzw. settings/customer). Ohne diese Operation blendet die Seite den Tab aus; die übrigen Vorgaben bleiben nutzbar.

Werksvorgabe: SI-Präfixe und physikalische Größen¶

Beide Kataloge kommen gefüllt aus der Installation. Vorher musste jede Installation Vorsätze und Einheiten von Hand anlegen, bevor die Feldtypen SI(Symbol) und UNIT(Symbol), der Prozedur- und Spezifikationseditor und der DCC-Export etwas anzubieten hatten.

SI-Präfixe — alle 24 dezimalen Vorsätze von Quetta (10³⁰) bis Quecto (10⁻³⁰), inklusive der bei Messgeräten üblichen Hekto/Dezi/Zenti (hPa, dm, cm) und der 2022 vom CGPM ergänzten Ronna/Quetta/Ronto/Quecto.

Physikalische Größen — die Größen, die in DAkkS-akkreditierten Kalibrierungen (DIN EN ISO/IEC 17025) üblich sind: die sieben SI-Basisgrößen, elektrische Größen (V, Ω, S, F, H, C, Hz, W, J, Wb, T, dB, dBm), Temperatur und Feuchte, Druck (Pa, bar), Kraft/Drehmoment/mechanische Spannung/Härte (N, Nm, N/mm², HRC, HV, HBW), Geometrie und Winkel, Kinematik und Drehzahl, Durchfluss, Chemie (pH, S/m, mol/l, ppm) sowie Photometrie und Akustik.

Drei Punkte, die beim Nacharbeiten auffallen:

Die Masse steht als Gramm. Die Vorsatzauswahl setzt vor das Einheitensymbol; nur mit g ergeben sich mg/g/kg. Als SI-Basiseinheit ist weiterhin kg eingetragen.
Die Spalte Dimension trägt die Dimensionssymbole nach ISO 80000 (L, M, T, I, Θ, N, J), zum Beispiel ML²T⁻³I⁻¹ für die elektrische Spannung — nicht noch einmal das Einheitensymbol.
Das Drehmoment steht als Nm, ohne Malpunkt: so erwartet es die Einheitenübersetzung des DCC-Exports.

Die Vorgabe ist additiv: eingespielt wird nur, was noch fehlt. Ein bereits vorhandenes Symbol — etwa die vier aus V1 stammenden Zeilen V, A, Ω und Hz — wird weder verdoppelt noch überschrieben. Alle Einträge lassen sich anschließend wie selbst angelegte Datensätze ändern und löschen.

V1-Installationen

Die gleiche Vorgabe liefert die Yii-Migration m260803_000001_seed_si_prefixes_and_physical_quantities an Systeme, die noch V1 fahren. uIDs und Inhalte sind auf beiden Seiten identisch, damit eine spätere V1→V2-Übernahme (v1:sync) dieselben Zeilen trifft und den Katalog nicht ein zweites Mal anlegt.

Uebersicht¶

Der AdminProvisionController verwaltet Qualitaetsvorgaben (Provisions), die als Grundlage fuer die Einhaltung von Qualitaetsstandards dienen. Vorgaben definieren Anforderungen, die bei Kalibrierungen und Pruefungen eingehalten werden muessen.

Struktur¶

Vorgaben sind hierarchisch aufgebaut:

Vorgabe (Provision)
  +-- Detail 1 (Sortierung: 1)
  +-- Detail 2 (Sortierung: 2)
  +-- Detail 3 (Sortierung: 3)

Hierarchische Struktur

Jede Vorgabe kann mehrere Detail-Eintraege enthalten, die ueber eine Sortierreihenfolge geordnet werden.

Vorgaben verwalten¶

Uebersicht¶

Unter Admin > Vorgaben > Qualitätsvorgaben werden alle Qualitaetsvorgaben aufgelistet:

Feld	Beschreibung
Name	Bezeichnung der Vorgabe
Beschreibung	Detaillierte Erlaeuterung
Status	Aktiv / Inaktiv
Sortierung	Reihenfolge in der Anzeige

Neue Vorgabe erstellen¶

Navigieren Sie zu Admin > Vorgaben > Qualitätsvorgaben
Klicken Sie auf Neue Vorgabe
Geben Sie Name und Beschreibung ein
Speichern Sie die Vorgabe

Messbereiche¶

Jede Vorgabe traegt Zeilen, die je einen Messbereich mit der dort erreichbaren Messunsicherheit beschreiben. Erreichbar ueber die Zeilenaktion Messbereiche am Vorgaben-Grid.

Feld	Beschreibung
Bezeichnung	Was gemessen wird, im Wortlaut der Anlage, z. B. „Gleichspannung"
Messart	z. B. DCV, ACI, Widerstand. Fuer den Akkreditierungsumfang zaehlt sie: erkennt calServer darin (ohne Messart in der Bezeichnung) eine Messfunktion, deckt die Zeile nur Messpunkte dieser Funktion. Die CMC-Pruefung ordnet weiter nur ueber Einheit und Bereich zu
Bereich von / bis	Untere und obere Bereichsgrenze, in Praefix + Einheit der Zeile
SI-Praefix, Einheit	Symbole aus dem Praefix- und Einheitenkatalog
Zweiter Bereich von / bis	Optionaler zweiter Parameter derselben Zeile, z. B. ein Frequenzband; der Akkreditierungsumfang liest ihn als Frequenzband in Hz
Messunsicherheit (absolut)	Fester Anteil der kleinsten angebbaren erweiterten Messunsicherheit (k = 2), in Praefix + Einheit
Messunsicherheit (relativer Anteil)	Wertabhaengiger Anteil als dimensionsloser Faktor: „50 µV/V" ist 0,00005, „0,05 %" ist 0,0005
Aufloesung	Kleinster Teilschritt der Messeinrichtung
Reihenfolge	Position in der Liste

Die Untergrenze an der Stelle x rechnet sich als relativer Anteil · |x| + absoluter Anteil. Beide Anteile sind einzeln optional — DAkkS-Anlagen fuehren reine Prozentangaben ebenso wie reine Festwerte.

Beispiel: Messfaehigkeit Gleichspannung

Vorgabe: DAkkS D-K-99001-01-00 — Elektrik

Gleichspannung, DCV, 0,1 ... 10 V, „12 µV/V + 5 µV": relativer Anteil 0,000012, absolut 0,000005 V
Gleichspannung, DCV, 10 ... 1000 V, „20 µV/V + 0,1 mV": relativer Anteil 0,00002, absolut 0,0001 V

Messfaehigkeit, keine Anforderung — aber eine Untergrenze

Die Zeilen sagen, was das Labor kann (CMC) — nicht, was ein Pruefling einzuhalten hat. Seit der CMC-Pruefung liest die Freigabe-Abschlusspruefung sie als Untergrenze: weist eine Messzeile eine kleinere Messunsicherheit aus, als die Anlage fuer diese Einheit und diesen Bereich hergibt, meldet der Bereich „Plausibilitaet" einen Hinweis (plausibility_capability, ILAC-P14). Bewusst keine Blockade: die Zuordnung laeuft ueber Einheit und Bereich, und bei mehreren passenden Zeilen zaehlt die kleinste Untergrenze — was darueber liegt, kann die andere Messgroesse sein. Wo keine Messbereiche gepflegt sind, wird nichts geprueft. Umgebungsanforderungen wie „Raumtemperatur 23 +/- 2 °C" lassen sich hoechstens als Freitext in die Beschreibung schreiben; einen Sollbereich, der auf dem Kalibrierschein landet, pflegt man unter Ressourcen.

Akkreditierungsumfang je Messpunkt

Aus denselben Zeilen leitet calServer bei der Erfassung ab, ob ein Messpunkt im Akkreditierungsumfang liegt; Punkte ausserhalb kennzeichnet der Schein mit „*“. Dafuer zaehlen nur Vorgaben mit dem Inhaber „Eigenes Labor“ (oder ohne Inhaber), am Kalibriertag gueltig nach „Gültig ab“ und „Gültig bis“, und Zeilen mit Einheit. Einzelheiten: Akkreditierungsumfang.

Import und Export¶

Die Anlage einer Akkreditierungsurkunde reist als eine JSON-Datei im Format calserver.quality_provision (Version 1): je Vorgabe der Kopf plus ihre Messbereiche. Im Tab Qualitätsvorgaben stehen dafuer Exportieren (laedt den ganzen Katalog bzw. ?ids=… eine Auswahl) und Importieren — der Dialog nimmt eine Datei oder eingefuegtes JSON, zeigt vor dem Schreiben den Plan (neu / ersetzt / uebersprungen) und kennt drei Modi:

Modus	Wirkung
Neu anlegen	Jede Vorgabe wird neu angelegt; ein vergebener Name ist ein Fehler (Namen sind eindeutig)
Vorhandene ueberspringen	Gleichnamige Vorgaben bleiben unangetastet, nur fehlende kommen dazu
Vorhandene ersetzen	Kopf wird ueberschrieben, Messbereiche neu aufgebaut; die ID bleibt, Prozedur-Zuordnungen bleiben gueltig

Ein vollstaendiges Beispiel — die fiktive DAkkS-Anlage des Demo-Labors NORDCAL mit sieben Messgroessen — liegt zum Herunterladen bereit: net-cal-dakks-cmc.json. Es laesst sich unveraendert importieren und dient als Vorlage fuer die eigene Anlage.

MCP¶

Fuer Agenten sind die Qualitaetsvorgaben ueber die generischen Config-Werkzeuge erreichbar (quality_provision und quality_provision_detail in list_config_resources), fuer ganze Anlagen gibt es import_quality_provisions (Modi wie oben, dry_run fuer den Plan) und describe_provision_format fuer den Feldkatalog samt Beispiel-Payload. Alle Wege verlangen basic_setting_admin — dieselbe Operation wie die REST-Endpunkte.

Sortierung¶

Die Sortierung bestimmt die Reihenfolge, in der Vorgaben und deren Details angezeigt werden. Niedrigere Werte erscheinen zuerst.

Sortierung: 10 --> wird zuerst angezeigt
Sortierung: 20 --> wird danach angezeigt
Sortierung: 30 --> wird zuletzt angezeigt

Luecken in der Sortierung

Verwenden Sie Schritte von 10 (10, 20, 30, ...), um spaeter weitere Eintraege einfuegen zu koennen, ohne bestehende Sortierungen aendern zu muessen.

Verwendung¶

Qualitaetsvorgaben werden in folgenden Bereichen referenziert:

Kalibrierauftraege: Zuordnung relevanter Vorgaben zum Auftrag
Pruefberichte: Dokumentation der Einhaltung
Geraeteakte: Hinterlegung geraetespezifischer Anforderungen

API-Zugriff¶

GET    /api/v2/admin/provisions          # Alle Vorgaben abrufen
POST   /api/v2/admin/provisions          # Neue Vorgabe erstellen
GET    /api/v2/admin/provisions/export   # Katalog (oder ?ids=…) als JSON-Datei
POST   /api/v2/admin/provisions/import   # JSON-Datei/Payload einspielen (mode, dry_run)
GET    /api/v2/admin/provisions/{id}     # Einzelne Vorgabe abrufen
PUT    /api/v2/admin/provisions/{id}     # Vorgabe aktualisieren
DELETE /api/v2/admin/provisions/{id}     # Vorgabe loeschen (inkl. ihrer Messbereiche)