GunSpec
Transparenz

Datenqualität

Dieser Bereich dokumentiert das Qualitätsprogramm hinter dem Katalog: worauf jeder Datensatz geprüft wird, wie diese Prüfungen definiert sind und was ein bestandenes Ergebnis belegt. Jeder Katalog hat eine eigene Ergebnisseite. Diese Seite beschreibt die zugrunde liegende Methodik.

Der aktuelle Umfang des Programms, beim Laden der Seite live gelesen. Diese Werte beschreiben, wie viel gemessen wird, nicht wie gut die Daten sind; das zeigen die Seiten der einzelnen Kataloge.

MaßAktuell
gemessene Kataloge
durchgeführte Prüfungen
fehlgeschlagene Prüfungen

Eine Spezifikationsdatenbank eignet sich nur dann als Grundlage, wenn ihre Vollständigkeit belegt und nicht angenommen wird. Das Programm folgt vier Grundsätzen.

  • Wir veröffentlichen den Bericht, nach dem wir intern arbeiten. Dieselben Kennzahlen steuern unsere eigene Korrekturliste, und die Zusammenfassung wird ohne API-Schlüssel ausgeliefert, damit die Angaben unabhängig überprüfbar sind.
  • Wir berichten Datensätze statt Punktwerte. Ein Punktwert zeigt, wie weit den Daten zu trauen ist. Eine Liste von Bezeichnern sagt einem Entwickler oder einem automatisierten Prozess genau, was zu korrigieren ist. Jeder Fehlschlag nennt die betroffenen Datensätze.
  • Wir unterscheiden zwischen unbekannt und falsch. Ein nicht ermittelter Wert bleibt null statt einen Standardwert zu erhalten, denn ein Standardwert macht aus einer offenen Frage eine beantwortete, und der Datensatz wird nie erneut geprüft.
  • Wir berichten Vollständigkeit und Widerspruchsfreiheit getrennt. Ein zusammengefasster Index würde zulassen, dass ein Widerspruch durch gute Abdeckung an anderer Stelle ausgeglichen wird.

Jede Seite in diesem Bereich wendet dieselben zwei Maße in derselben Reihenfolge an.

MaßFragestellungBeispielbefund
Was fehltOb überhaupt ein Wert vorhanden ist. Null und leere Zeichenkette gelten beide als fehlend, sodass eine Spalte voller Leerwerte nie als vollständig ausgewiesen wird.594 Hersteller führen keine Website. Das ist eine offene Lücke und kein Fehler in den Daten.
Was sich widersprichtOb eine Aussage des Katalogs einer anderen Aussage desselben Katalogs widerspricht.Ein Unternehmen, dessen Schließung vor seiner Gründung verzeichnet ist, oder eine Waffe, die einem nicht geführten Hersteller zugeordnet wird.

Die Trennung ist beabsichtigt. Ein Katalog kann zu 98 Prozent vollständig sein und zugleich verzeichnen, dass ein Unternehmen elf Jahre vor seiner Eröffnung geschlossen hat. Eine einzelne Gesamtkennzahl würde sich nur für eine der beiden Bedingungen bewegen.

Ergebnisse werden je Katalog veröffentlicht statt in einem gemeinsamen Bericht, damit die Beurteilung eines Datenbestands nicht das Lesen der übrigen voraussetzt.

Jede Prüfung liefert eines von zwei Ergebnissen. Keines sagt etwas darüber aus, ob die Werte selbst zutreffen.

ErgebnisBedeutung
Bestandenbestätigt, dass kein Datensatz des Katalogs die Prüfung nicht besteht. Es belegt nicht, dass die Werte korrekt sind.
Fehlschlagbedeutet, dass mindestens ein Datensatz sie nicht besteht; die betroffenen Bezeichner stehen daneben. Fehlschläge werden veröffentlicht statt unterdrückt und sollten vor der Korrektur geprüft werden, da mitunter die Prüfung selbst zu streng ist.

Abdeckungsbalken kodieren allein die Breite und tragen keine Farbe. Farbe würde ein Feld als gut oder schlecht bewerten, und eine noch nicht verfasste Beschreibung ist kein Mangel.

Alle Kennzahlen werden beim Laden der Seite aus der Datenbank gelesen. Die Zusammenfassung ist öffentlich und benötigt keinen API-Schlüssel, sodass die Angaben dieser Seiten direkt überprüfbar sind. Die beiden Endpunkte mit vollständigen Bezeichnerlisten sind die operative Arbeitsliste und setzen einen Enterprise-Tarif voraus. Jede Zeile verweist auf ihren Eintrag in der API-Referenz.

EndpunktTarifLiefert
GET/v1/data/gapsÖffentlichDer vollständige Bericht: Abdeckung jedes erfassten Feldes, Ergebnis jeder Prüfung und bis zu fünf Bezeichner hinter jedem Fehlschlag.
GET/v1/data/gaps/historyÖffentlichEine Zeile pro Tag aus der täglichen Momentaufnahme: wie viele Prüfungen liefen und fehlschlugen, wie viele Datensätze dahinterstanden und die gewichtete Feldabdeckung. Daran lassen sich die obigen Zahlen über die Zeit beurteilen.
GET/v1/data/gaps/recordsEnterpriseDie Datensätze, denen ein bestimmtes Feld fehlt, als Bezeichner mit Seitenaufteilung. Diesen Endpunkt konsumiert eine automatisierte Pipeline.
GET/v1/data/gaps/checks/{checkId}EnterpriseAlle Bezeichner, die eine bestimmte Prüfung nicht bestehen, vollständig statt als Stichprobe.
GET/v1/data/coverageEnterpriseFeldvollständigkeit je Tabelle als einzelner Prozentwert. Dieselbe Frage, die die Abdeckungstabellen oben beantworten, in der Form, die ein Dashboard braucht.
GET/v1/data/confidenceEnterpriseDie Datensätze, deren Konfidenzwert unter einem selbst gesetzten Schwellenwert liegt, damit eine Belegrecherche bei den schwächsten beginnen kann.

Das liefert der Verlaufs-Endpunkt. Kein Schlüssel, keine Registrierung, kein Vertriebsgespräch.

GET /v1/data/gaps/history
json
{  "success": true,  "data": {    "days": 90,    "runs": [      {        "ranOn": "2026-09-15",        "ranAt": "2026-09-15 03:00:00",        "scope": "all",        "checksTotal": 8,        "checksFailing": 1,        "recordsFailing": 3,        "coveragePct": 62.4      }    ]  }}

Vollständige Referenz, Parameter und Fehlerantworten

Nichts in diesem Bereich ist ein Build-Snapshot, sodass ein heute korrigierter Datensatz beim nächsten Aufruf berücksichtigt ist.

Daten zu Waffenspezifikationen sind fragmentiert, uneinheitlich erfasst und über Quellen hinweg häufig widersprüchlich. Jeder daraus gebaute Katalog hat Lücken. Unsere zu veröffentlichen ist eine bewusste Haltung und stützt sich auf vier Punkte.

  • Das Ausgangsmaterial ist der schwierige Teil. Spezifikationen unterscheiden sich nach Jahr, Werk, Charge und Markt; Hersteller nehmen Seiten vom Netz; Importeure und Händler geben Werte wieder, die sie nie gemessen haben. Ein Katalog, der Vollständigkeit behauptet, würde einen Datenbestand beschreiben, den es so nicht gibt.
  • Ein Anbieter, der nicht sagt, was fehlt, ist kein Anbieter ohne Lücken. Jeder Datenbestand in diesem Feld hat sie; der Unterschied liegt darin, ob man es vor dem Bauen erfährt oder danach.
  • Jede Zahl auf diesen Seiten wird von einem öffentlichen Endpunkt geliefert. Sie können denselben Bericht abrufen, nach dem wir arbeiten, ihm widersprechen und uns daran messen, ohne Konto und ohne Nachfrage.
  • Die Momentaufnahme entsteht täglich und der Verlauf wird mitveröffentlicht. Die Aussage ist also nicht, dass die Daten heute perfekt sind, sondern dass die Richtung sichtbar und dokumentiert ist.
  • Ein befülltes Feld ist nicht zwangsläufig ein korrektes. Die Abdeckung erfasst, ob ein Wert vorhanden ist, nie ob er zutrifft. Eine Waffe mit falschem Einführungsjahr gilt als vollständig abgedeckt.
  • Diese Prüfungen finden Datensätze, die einander widersprechen. Ein durchgehend falscher Datensatz besteht sie alle.
  • Ob eine zitierte Website noch erreichbar ist, wird hier nicht geprüft. Das braucht eine Anfrage pro Datensatz und gehört in einen geplanten Job, den es noch nicht gibt.
  • Diese Kennzahlen sind unsere eigene Messung unserer eigenen Daten und stellen kein externes Audit dar. Die zugrunde liegenden Endpunkte sind öffentlich, damit die Ergebnisse überprüft und nicht lediglich geglaubt werden.