Konzepte

Das Objektmodell und Vokabular, das der Rest der Dokumentation voraussetzt.

Origin

Der Origin ist die kvellman-Installation, die Sie betreiben: Admin-Oberfläche, winget-Source-API und Installer-Auslieferung. Ein Origin ist ein vollständiges, in sich geschlossenes System — alles andere in dieser Doku (Sites, Nodes, Benutzer) wird darauf aufgesetzt.

Paket, Version, Manifest

Ein Paket hat eine feste Kennung (z. B. Hersteller.App) und eine oder mehrere Versionen. Das Manifest einer Version beschreibt sie in den Formen, die winget selbst definiert — Installer, Switches, Abhängigkeiten — und wird als strukturierte Daten gespeichert, nicht als Dateien auf der Platte.

Upstream und Overlay

Beim Import eines Pakets bleibt sein ursprüngliches Manifest unangetastet als Upstream-Stand erhalten. Jede Änderung, die Sie vornehmen, liegt als Overlay darüber, sodass Sie jederzeit den Unterschied zum Upstream sehen und darauf zurücksetzen können.

Overlay-Template

Ein Overlay-Template verallgemeinert ein Overlay zu einer wiederverwendbaren Regel — zum Beispiel eine Installer-URL mit $VERSION/$ARCH-Platzhaltern — und wendet sie automatisch auf jede künftige Version dieses Pakets an, sodass Sie dieselbe Änderung nicht bei jedem Release von Hand wiederholen.

Freigabe

Eine Version wird erst an Clients ausgeliefert, wenn sie freigegeben ist. Das erzwingt die API selbst, nicht nur die Oberfläche — eine nicht freigegebene Version taucht in den Ergebnissen, die winget erhält, schlicht nicht auf, egal wie sie in den Katalog kam.

Site und Site-Token

Eine Site ist ein benannter Kontext: ein Name, ein Standort, eine Standardsprache, eine Repository-URL. Ihr Token ist ihre Adresse — Clients erreichen sie unter https://ihr-origin/api/<site-token>. Die Werte einer Site lösen Platzhalter in Installer-URLs auf, sodass ein Manifest jeden Standort korrekt bedienen kann. Eine Site ist kein Mandant, kein separater Katalog, und für ihre Anlage wird nirgendwo etwas installiert — siehe Sites.