Datenmethodik

Grundsätze

Jede Kennzahl muss Quelle, Bedeutung, Aktualität, Abdeckung und Transformation nennen. Fehlende Daten bleiben fehlend: Alveos füllt Ausfälle nicht mit Schätzwerten. „Offiziell“, „verifiziert“ oder „unabhängig“ wird nur verwendet, wenn die Quelle diese Aussage tatsächlich trägt.

Quellenklassen

• Öffentliche Anbieterquelle: direkte öffentliche APIs oder Einträge wie VS Code Marketplace, Open VSX, GitHub Releases, PyPI und Packagist.
• Öffentlicher Datensatz / vertrauenswürdiger Dritter: benannte Datensätze wie PSF BigQuery oder PypiStats.
• Produkteigene Telemetrie: das verbundene Produkt sendet Lifecycle-Ereignisse an Alveos (Beacon; Streaming Zebra bald verfügbar). Die Zahlen kommen aus dem Produkt und der Zählweise des Publishers — ereignisgesteuert, nicht von einem Marktplatz abgeholt.
• Manueller Publisher-Import: etwa vom Publisher bereitgestellte VS-Code-Publisher-Hub-Daten. Sie bleiben von öffentlichen Gallery-Zählern getrennt.

Bedeutung der Kennzahlen

Was die Quelle liefert, speichert Alveos. Was sie nicht liefert, wird hier nicht erfasst.

Zähler mit unterschiedlicher Bedeutung werden nicht stillschweigend als dieselbe Kennzahl dargestellt.

Erfassung, Aktualität und Lücken

Öffentliche Stores holt Alveos einmal täglich um 05:20 Europe/Berlin. Gespeichert wird der heutige UTC-Tag. Ein fehlgeschlagener Abruf überspringt den Tag, behält die Historie und schreibt keine Nullen. Gallery, Open VSX, GitHub, PyPI-JSON, PypiStats und Packagist werden nicht drei Tage rückwärts nachgezogen.

Was im Graphen passiert: Ab dem ersten gespeicherten Tag bleibt die durchgezogene Linie auf dem letzten bekannten Stand (Step-Hold). Fehlt dazwischen ein Abruf, zeichnet Alveos denselben Stand gestrichelt — letzter bekannter Wert, keine Hochrechnung und keine Trendkurve über den realen Punkten. Fehlende Tage im Fenster werden markiert. Tage vor der Verbindung sind keine Lücken. GitHub Releases, Open VSX und Packagist nutzen diese Bestandslinie. Die Y-Achse ist dieselbe Zahl wie in der Tabelle. Der Tageszuwachs steht in der Tagesliste. Die Spalten heißen nach der Bedeutung: Release-Dateien, VSIX-Abrufe. Eine Versionsmarke gibt es je Version, am Veröffentlichungstag.

Liegt der letzte erfolgreiche Tag zwei oder drei Tage zurück, gilt die Reihe als verzögert; ab dem vierten Tag als veraltet. Das ist eine Anzeige, kein Nachzug.

Zwei Ausnahmen schreiben jüngere Tage nach, wenn der nächste Abruf gelingt: Streaming Zebra speichert D−2 und D−1 aus der Summary; PyPI-Länder (BigQuery, zahlende Tarife) schreiben die letzten sieben UTC-Tage erneut. Publisher-Import und Beacon sind kein Tagesabruf und gelten nicht als verpasste Lücken.

Transformation und Vergleichbarkeit

Alveos behält rohe Anbieterwerte und kennzeichnet abgeleitete Werte wie Differenzen kumulativer Zähler, Summen, Verhältnisse, importierte Werte und gefilterte Partitionen. Direkte Auslieferungs- und GitHub-Kanäle, die dieselbe Auslieferung beschreiben können, bleiben getrennt. Streaming-Zebra- und Beacon-Updates werden nicht doppelt addiert.

Reproduzierbare Exporte

CSV- und JSON-Exporte enthalten Anbieter, externe ID, Quellenklasse, Kennzahlenbedeutung, Abdeckungsbeginn, Rhythmus, Transformationsversion, Quellenlink und einen SHA-256-Zeilenhash. Historische Snapshots besitzen derzeit UTC-Tagesgenauigkeit: fetched_on enthält den Tag, time_precision ist day, und fetched_at bleibt leer statt eine Uhrzeit zu erfinden.

Anbieterreferenzen

• VS Code Marketplace
• Open VSX
• GitHub Release Assets API
• Öffentliche PyPI-Daten in BigQuery
• Packagist API

Auditierbare Korrekturen

Angemeldete Owner und Staff melden unter Datenkorrekturen eine bereits gespeicherte Verbindung: einen UTC-Tag, eine Kennzahl (Downloads, Installationen oder Updates), eine ganze Zahl und eine Begründung. Die Anfrage friert den Rohwert zum Zeitpunkt der Meldung ein. Eine Korrektur füllt keinen fehlenden Abruf und schreibt keine Schätzung in eine Lücke. Es gibt keinen Korrektur-Import und keine Korrektur-API.

Eine andere Person muss annehmen, bevor Leser die neue Zahl sehen. Der Provider-Snapshot bleibt unverändert. Graphen und Summen lesen das aktive Overlay. Ein fehlender Tag bleibt eine Lücke.

Kennzeichnung im Export

CSV und JSON behalten die Kennzahlenspalten. In einer korrigierten Zeile sind das die Overlay-Werte, nicht die abgerufenen Provider-Ganzzahlen.

row_hash ist der SHA-256 dieser Exportzeile, einschließlich der Overlay-Zahlen und dieser vier Spalten. Vergleichen Sie correction_original_json mit dem Provider, wenn Sie die abgerufene Ganzzahl brauchen.

Fragen oder vermutete Datenfehler: support@alveos.eu.