Licensiering

Den här sidan är referensen vid körning för hur en licens formar Doconut:s beteende: vad varje licenstillstånd tillåter, hur funktioner beviljas, och hur man inspekterar allt detta från kod. (För laddning av en licens, se Kom igång → Licensinställning.)

Licenstillstånd och vad de gör

Två konsekvenser som är värda att internalisera:

• En saknad licens är inte en tillfällig licens. Utan licensfil renderas sidor med vattenstämpel och ingen funktion (sökning, annotation, plugins) är aktiv. Den fullständiga, ovattenstämplade upplevelsen kräver en faktisk Tillfällig licens (skaffa en).
• Endast en avvisad licens blockerar öppning. Kalender-/prenumerationsutgång degraderas till vattenstämplad rendering; men att distribuera en build nyare än licensens versionsfönster avvisas och misslyckas snabbt med en LicenseException, så du fångar den vid distribution — inte genom att tyst leverera vattenstämplat resultat. Det undantaget (från OpenDocumentAsync) innehåller orsaken från License.RejectionMessage.

Funktioner

Doconut styr valfri funktionalitet via funktion. Idag är det de valfria Converter- och DICOM-pluginsen samt de inbyggda Search- och Annotation-funktionerna, var och en beviljad av din licens. Basvisaren är inte en funktion — den är förutsättningen, exponerad som IsViewerLicensed:

bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's version

Den enda grind som hela pipeline använder är IsCapabilityGranted:

bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Logiken, ordagrant från implementationen: en aktiv (ej utgången) Tillfällig licens beviljar varje funktion — inklusive funktioner som ännu inte har en dedikerad köpflagga; en verklig köpt licens beviljar exakt dess Has* flaggor och är standardavslag för allt som inte är mappat. (En äldre TRIAL‑typ fil är inte en rättighet — den behandlas som olicensierad: vattenstämplad, inget beviljat.)

Tillfälliga licenser

Normal sökning och annotation använder sina befintliga funktioner direkt.

Tillfälliga (Utvecklare/NFR) licenser markeras med en ExpiryNote‑tagg och har ett fast utgångsdatum:

Utgångssemantiken varierar efter nivå: en tillfällig licens går ut på dess LicenseExpiry endast datum (dess prenumerationsfönster ignoreras; en tillfällig licens utan datum behandlas som utgången, felsäker). Alla andra licenser går ut på deras prenumerations-/uppdateringsfönster datum.

IDoconutLicenseService‑referens

Injecta IDoconutLicenseService (namnrymd Doconut.Core.Interfaces; registrerad som singleton — licensen parsas en gång vid start):

DoconutLicenseInfo exponerar en display‑vänlig snapshot för admin‑paneler: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, Has*‑flaggorna, de tillfälliga licensfälten och RejectionMessage.

// Feature-flag your UI from the same source of truth the SDK uses
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
    viewer     = lic.IsViewerLicensed || lic.IsTemporary,
    search     = lic.IsCapabilityGranted(LicenseCapability.Search),
    annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
    conversion = lic.HasConverter,
    dicom      = lic.HasDicom,
}));

Hälsokontroll

AddDoconut() registrerar en "doconut"‑hälsokontroll som rapporterar licens‑/utgångstillstånd via den standard ASP.NET Core‑mekanismen:

app.MapHealthChecks("/health");

Koppla in den i din övervakning så blir en utgående prenumeration ett larm istället för ett supportärende.

Versionsuppgraderingar

En licens täcker ett versionsfönster. Att uppdatera NuGet‑paketet till en build nyare än det fönstret gör licensen ogiltig för denna build: IsVersionValid blir false och öppning blockeras med en LicenseException (orsaken finns i License.RejectionMessage) — avsiktligt misslyckas snabbt, så en föråldrad eller olicensierad build fångas vid distribution snarare än att tyst vattenstämpla produktionsutdata. Förnya prenumerationen, ersätt .lic‑filen och starta om applikationen så att AddDoconut() laddar den nya licensen.