Licencování

Tato stránka je referencí za běhu, jak licence formuje chování Doconut: co každý stav licence umožňuje, jak jsou funkce uděleny a jak je lze 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 se stránky zobrazují s vodoznakem a žádná funkce (vyhledávání, anotace, pluginy) není aktivní. Plnohodnotný, bez vodoznaku, zážitek vyžaduje skutečnou Dočasnou licenci (získat jednu).
• Pouze odmítnutá licence blokuje otevírání. Vypršení kalendáře/předplatného vede k vykreslování s vodoznakem; ale nasazení sestavení novějšího než verzní okno 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 funkcionalitu pomocí funkce. Dnes jsou to volitelné pluginy Converter a DICOM plus vestavěné funkce Search a Annotation, každá udělena vaší licencí. Základní prohlížeč není funkcí — je předpokladem, vystupujícím jako IsViewerLicensed:

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

Jedna brána, kterou používá celý pipeline, 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 defaultně zamítnutá pro vše, co není mapováno. (Legacy soubor typu TRIAL není oprávněním — je považován za nelicencovaný: vodoznak, nic nepřidě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 nesou pevné datum vypršení:

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

Referenční dokumentace 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 administrativní 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 ticketu podpory.

Aktualizace verzí

Licence pokrývá verzní okno. Aktualizace balíčku NuGet na sestavení novější než toto okno způsobí, že licence je pro toto sestavení neplatná: IsVersionValid se nastaví na false a otevírání je blokováno s LicenseException (důvod je v License.RejectionMessage) — úmyslně selhává 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.