Lisensi – Doconut Dokumentasi

Halaman ini adalah referensi runtime tentang bagaimana lisensi membentuk perilaku Doconut: apa yang diizinkan oleh setiap status lisensi, bagaimana kapabilitas diberikan, dan cara memeriksa semuanya dari kode. (Untuk memuat lisensi, lihat Memulai → Penyiapan Lisensi.)

Status lisensi dan apa yang mereka lakukan

Status	Membuka dokumen?	Tanda air	Kapabilitas
Lisensi penuh (berbayar) (dalam jendela langganan/pembaruan)	Ya	Tidak ada	Yang dibeli (`Has*` flags)
Lisensi sementara (Developer/NFR — lisensi evaluasi, sebelum tanggal kedaluwarsanya)	Ya	Tidak ada	Semua — pemberian blanket (alur evaluasi)
Kedaluwarsa (lisensi sementara yang melewati tanggal kedaluwarsa, atau langganan berbayar yang melewati tanggal perbaruan)	Ya	Tanda air evaluasi	Tidak ada yang diberikan
Tidak ada berkas lisensi sama sekali	Ya	Tanda air evaluasi	Tidak ada yang diberikan
Ditemukan tetapi ditolak (tanda tangan tidak valid, dimanipulasi, masuk daftar hitam, atau build lebih baru daripada jendela versi lisensi)	Tidak — `LicenseException` pada setiap pembukaan	—	—

Dua konsekuensi yang patut diinternalisasi:

Lisensi yang hilang bukan lisensi sementara. Tanpa berkas lisensi, halaman ditampilkan dengan tanda air dan tidak ada kapabilitas (pencarian, anotasi, plugin) yang aktif. Pengalaman penuh fitur tanpa tanda air memerlukan Lisensi Sementara yang sebenarnya (dapatkan satu).
Hanya lisensi yang ditolak yang memblokir pembukaan. Kedaluwarsa kalender/langganan menurunkan tampilan menjadi ber‑tanda air; tetapi menyebarkan build lebih baru daripada jendela versi lisensi ditolak dan gagal cepat dengan LicenseException, sehingga Anda menangkapnya saat penyebaran — bukan dengan diam‑diam mengirimkan output ber‑tanda air. Pengecualian itu (dari OpenDocumentAsync) membawa alasan dari License.RejectionMessage.

Kapabilitas

Doconut mengatur fungsionalitas opsional dengan kapabilitas. Saat ini yang ada adalah plugin Converter dan DICOM yang dapat diaktifkan serta fitur bawaan Search dan Annotation, masing‑masing diberikan oleh lisensi Anda. Penampil dasar bukanlah kapabilitas — ia adalah prasyarat, disajikan sebagai IsViewerLicensed:

csharp

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

Gerbang tunggal yang digunakan seluruh pipeline adalah IsCapabilityGranted:

csharp

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

Logikanya, persis dari implementasi: lisensi Sementara yang aktif (tidak kedaluwarsa) memberikan setiap kapabilitas — termasuk kapabilitas yang belum memiliki flag pembelian khusus; lisensi berbayar yang sebenarnya memberikan tepat flag Has*‑nya dan default‑deny untuk apa pun yang tidak dipetakan. (Berkas tipe TRIAL warisan bukan hak — diperlakukan sebagai tidak berlisensi: ber‑tanda air, tidak ada yang diberikan.)

Lisensi sementara

Pencarian dan Anotasi standar menggunakan kapabilitas yang sudah ada secara langsung.

Lisensi sementara (Developer/NFR) ditandai dengan tag ExpiryNote dan memiliki tanggal kedaluwarsa keras:

Anggota	Makna
`IsTemporary`	Tag `ExpiryNote` ada (deteksi berdasarkan keberadaan tag — tidak pernah mencocokkan teks catatan, bersifat dinamis)
`ExpiryNote`	Teks informasional yang disematkan dalam lisensi
`LicenseExpiry`	Tanggal kedaluwarsa keras (`DateTime?`)

Semantik kedaluwarsa berbeda menurut tingkatan: lisensi sementara kedaluwarsa pada tanggal LicenseExpiry‑nya saja (jendela langganannya diabaikan; lisensi sementara yang tidak memiliki tanggal diperlakukan sebagai kedaluwarsa, aman gagal). Semua lisensi lain kedaluwarsa pada tanggal jendela langganan/pembaruan mereka.

Referensi IDoconutLicenseService

Suntikkan IDoconutLicenseService (namespace Doconut.Core.Interfaces; terdaftar sebagai singleton — lisensi diparsir sekali saat startup):

Anggota	Makna
`License`	Snapshot lengkap `DoconutLicenseInfo` (di bawah)
`IsTrial`	Berkas tipe TRIAL warisan (diperlakukan sebagai tidak berlisensi — bukan hak)
`IsTemporary` / `ExpiryNote` / `LicenseExpiry`	Penanda lisensi sementara
`IsExpired`	Kedaluwarsa sesuai aturan tingkatan di atas
`IsVersionValid`	Build ini berada dalam jendela dukungan lisensi
`IsViewerLicensed`	Berkas non‑`TRIAL` ditemukan dan versi tercakup — prasyarat dasar
`IsCapabilityGranted(cap)`	Gerbang kapabilitas tunggal
`HasSearch` `HasAnnotation` `HasConverter` `HasDicom`	Flag pembelian per‑kapabilitas — gunakan `IsCapabilityGranted` untuk jawaban yang memperhitungkan lisensi sementara
`IsValidForDomain(host)`	Cakupan host; lisensi V4 menggunakan wildcard `.`
`LicenseRejectionReason`	Tidak kosong ⇒ pembukaan diblokir dengan pesan ini

DoconutLicenseInfo mengekspos snapshot yang ramah tampilan untuk panel admin: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, flag Has*, bidang lisensi sementara, dan RejectionMessage.

csharp

// 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,
}));

Pemeriksaan kesehatan

AddDoconut() mendaftarkan pemeriksaan kesehatan "doconut" yang melaporkan status lisensi/kedaluwarsa melalui mekanisme standar ASP.NET Core:

csharp

app.MapHealthChecks("/health");

Hubungkan ke pemantauan Anda dan langganan yang akan kedaluwarsa menjadi peringatan alih‑alih tiket dukungan.

Pembaruan versi

Lisensi mencakup jendela versi. Memperbarui paket NuGet ke build lebih baru daripada jendela itu membuat lisensi tidak valid untuk build ini: IsVersionValid menjadi false dan pembukaan diblokir dengan LicenseException (alasan ada di License.RejectionMessage) — sengaja gagal cepat, sehingga build yang usang atau tidak berlisensi tertangkap saat penyebaran bukan secara diam‑diam menandai air output produksi. Perbarui langganan, ganti .lic, dan mulai ulang aplikasi sehingga AddDoconut() memuat lisensi baru.