Licencování

Tato stránka je referenční příručkou za běhu, jak licence formuje chování Doconut: co umožňuje každý stav licence, jak jsou udělovány funkce a jak to vše zkontrolovat z kódu. (Pro načítání licence viz Začínáme → Nastavení licence.)

Stavy licence a co dělají

Dvě důsledky, které stojí za internalizaci:

• Chybějící licence není dočasná licence. Bez licenčního souboru jsou stránky zobrazovány s vodoznakem a žádná funkce (vyhledávání, anotace, pluginy) není aktivní. Plnohodnotný, bezvodoznakový zážitek vyžaduje skutečnou Dočasnou licenci (získat).
• Pouze odmítnutá licence blokuje otevírání. Vypršení kalendáře/předplatného vede k zobrazování s vodoznakem; ale nasazení sestavení novějšího než okno verze licence je odmítnuto a rychle selže s LicenseException, takže jej zachytíte při nasazení — ne tiše odesíláním výstupu s vodoznakem. Tato výjimka (z OpenDocumentAsync) nese důvod z License.RejectionMessage.

Funkce

Doconut řídí volitelnou funkčnost pomocí funkce. Dnes jsou to volitelné pluginy Converter a DICOM plus vestavěné funkce Search a Annotation, každá udělená vaší licencí. Základní prohlížeč není funkcí — je předpokladem, vystupuje jako IsViewerLicensed:

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

Jedna brána, kterou celý pipeline používá, je IsCapabilityGranted:

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

Jeho logika, doslovně z implementace: aktivní (nevypršená) Dočasná licence uděluje každou funkci — včetně funkcí, které ještě nemají dedikovaný nákupní příznak; skutečná zakoupená licence uděluje přesně své Has* příznaky a je default-deny pro vše, co není mapováno. (Legacy soubor typu TRIAL ne je oprávněním — je považován za nelicencovaný: vodoznak, nic není uděleno.)

Dočasné licence

Normální vyhledávání a anotace používají své existující funkce přímo.

Dočasné (Developer/NFR) licence jsou označeny tagem ExpiryNote a mají pevné datum vypršení:

Semantika vypršení se liší podle úrovně: dočasná licence vyprší k pouze datu LicenseExpiry (její okno předplatného je ignorováno; dočasná licence bez data je považována za vypršenou, bezpečnostní režim). Každá jiná licence vyprší k datu jejího okna předplatného/aktualizace.

Odkaz na IDoconutLicenseService

Injektujte IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrovaný jako singleton — licence je parsována jednou při spuštění):

DoconutLicenseInfo poskytuje uživatelsky přívětivý snímek pro administrační panely: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, příznaky Has*, pole dočasné licence a 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,
}));

Kontrola zdraví

AddDoconut() registruje health check "doconut", který hlásí stav licence/vypršení prostřednictvím standardního mechanismu ASP.NET Core:

app.MapHealthChecks("/health");

Zapojte jej do svého monitoringu a vypršející předplatné se stane upozorněním místo tiketů podpory.

Aktualizace verzí

Licence pokrývá okno verze. Aktualizace NuGet balíčku na sestavení novější než toto okno způsobí, že licence pro toto sestavení je neplatná: IsVersionValid se nastaví na false a otevírání je blokováno s LicenseException (důvod je v License.RejectionMessage) — úmyslně selhání rychle, takže zastaralé nebo nelicencované sestavení je zachyceno při nasazení místo tiše vodoznakovaného produkčního výstupu. Obnovte předplatné, nahraďte .lic a restartujte aplikaci, aby AddDoconut() načetl novou licenci.