Licensiering

Denna sida ä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 Komma igång → Licensinställning.)

Licenstillstånd och vad de gör

Två konsekvenser värda att internalisera:

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

Funktioner

Doconut styr valfri funktionalitet via funktion. Idag är det de valfria Konverterare‑ och DICOM‑tilläggen samt de inbyggda Sökning‑ och Annotering‑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 gate som hela pipeline använder är IsCapabilityGranted:

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

Dess logik, ordagrant från implementationen: en aktiv (ej utgången) Tillfällig licens beviljar alla funktioner — inklusive funktioner som ännu inte har en dedikerad köpflagga; en riktig köpt licens beviljar exakt dess Has* flaggor och är standard‑nekad för allt som inte är mappat. (En äldre TRIAL‑typfil är inte en rättighet — den behandlas som olicensierad: vattenstämplad, inget beviljas.)

Tillfälliga licenser

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

Utgångssemantiken varierar per 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

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

DoconutLicenseInfo exponerar den visningsvänliga snapshoten 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 byggnad nyare än det fönstret gör licensen ogiltig för denna byggnad: IsVersionValid blir false och öppning blockeras med en LicenseException (orsaken finns i License.RejectionMessage) — avsiktligt misslyckas snabbt, så en föråldrad eller olicensierad byggnad 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.