الترخيص
القدرات، مستويات الترخيص، وخدمة الترخيص
هذه الصفحة هي مرجع وقت التشغيل لكيفية تشكيل الترخيص لسلوك Doconut: ما يسمح به كل حالة ترخيص، وكيف تُمنح القدرات، وكيفية فحص كل ذلك من الشيفرة. (لـ تحميل ترخيص، راجع البدء → إعداد الترخيص.)
حالات الترخيص وما تفعله
| الحالة | يفتح المستندات؟ | علامة مائية | القدرات |
|---|---|---|---|
| الترخيص الكامل (مدفوع) (تم إصدار هذا البناء قبل تاريخ اشتراكه) | نعم | لا شيء | التي تم شراؤها (Has* flags) |
| الترخيص المؤقت (Developer/NFR — ترخيص التقييم، قبل تاريخ انتهاء صلاحيته) | نعم | لا شيء على عارض الأساس؛ مخرجات الإضافات تحمل علامة مائية | الكل — منح شامل (قمع التقييم) |
الترخيص المؤقت المنتهي (بعد تاريخ LicenseExpiry الخاص به) | نعم | علامة مائية للتقييم | لم يتم منح أي شيء |
| لا ملف ترخيص على الإطلاق | نعم | علامة مائية للتقييم | لم يتم منح أي شيء |
| تم العثور عليه لكن رُفض (توقيع غير صالح، تم التلاعب به، مدرج في القائمة السوداء، أو بنية تم إصدارها بعد تاريخ اشتراك الترخيص) | لا — LicenseException عند كل فتح | — | — |
الترخيص المدفوع الذي تجاوز تاريخ اشتراكه يظل يعمل — نظيفًا، مع قدراته — على كل بنية تم إصدارها قبل ذلك التاريخ. فقط البنية التي تم إصدارها بعده تُرفض.
نتيجتان تستحقان الاستيعاب:
- الترخيص المفقود ليس ترخيصًا مؤقتًا. بدون ملف ترخيص، تُظهر الصفحات علامة مائية ولا تكون أي قدرة (بحث، تعليقات، إضافات) نشطة. التجربة الكاملة غير المائية تتطلب ترخيصًا مؤقتًا (احصل على واحد).
- فقط الترخيص المرفوض يمنع الفتح. الترخيص المؤقت المنتهي يبقي التطبيق يعمل مع علامة مائية للتقييم، والترخيص المدفوع بعد تاريخ اشتراكه يظل يعرض نظيفًا على البنيات التي يغطيها؛ لكن نشر بنية تم إصدارها بعد تاريخ اشتراك الترخيص يُرفض ويفشل بسرعة مع
LicenseException، لذا تلتقطه عند النشر — لا عن طريق إرسال مخرجات مائية بصمت. ذلك الاستثناء (منOpenDocumentAsync) يحمل السبب منLicense.RejectionMessage.
القدرات
Doconut يتحكم في الوظائف الاختيارية عبر القدرة. يغطي ميزات البحث والتعليق المدمجة والإضافات الاختيارية Converter وDicom وSigner، كل منها يُمنح بواسطة ترخيصك. عارض الأساس ليس قدرة — إنه المتطلب المسبق، يُظهر كـ IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL رخصة موجودة AND تغطي build's versionالبوابة الوحيدة التي يستخدمها كامل خط الأنابيب هي IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);منطقه، حرفيًا من التنفيذ: الترخيص المؤقت النشط (غير منتهي) يمنح كل قدرة — بما في ذلك القدرات التي لا تملك علم شراء مخصص بعد؛ الترخيص المدفوع الحقيقي يمنح بالضبط أعلام Has* الخاصة به ويكون default-deny لأي شيء غير مُطابق. (ملف نوع TRIAL القديم ليس استحقاقًا — يُعامل كغير مرخص: يحمل علامة مائية، ولا يُمنح شيء.)
تراخيص مؤقتة
التراخيص المؤقتة (Developer/NFR) يتم تمييزها بوسم ExpiryNote وتحمل تاريخ انتهاء صلب:
| العضو | المعنى |
|---|---|
IsTemporary | وجود وسم ExpiryNote (الكشف يتم بوجود الوسم — لا يطابق نص الملاحظة أبدًا، فهو ديناميكي) |
ExpiryNote | نص معلوماتي مدمج في الترخيص |
LicenseExpiry | تاريخ الانتهاء الصلب (DateTime?) |
تختلف دلالات الانتهاء حسب المستوى: الترخيص المؤقت ينتهي في تاريخ LicenseExpiry فقط (يُتجاهل نافذة الاشتراك؛ الترخيص المؤقت الذي يفتقد التاريخ يُعامل كمنتهي، آمن). كل ترخيص آخر ينتهي في تاريخ نافذة الاشتراك/التحديث؛ بالنسبة للترخيص المدفوع، IsExpired يذكر فقط أن هذا التاريخ قد مر — البنيات التي صدرت قبل ذلك تظل نظيفة وتحتفظ بقدراتها.
مرجع IDoconutLicenseService
حقن IDoconutLicenseService (المساحة الاسمية Doconut.Core.Interfaces؛ مسجل كحيدة — يُحلل الترخيص مرة واحدة عند بدء التشغيل):
| العضو | المعنى |
|---|---|
License | لقطة كاملة DoconutLicenseInfo (أدناه) |
IsTrial | ملف نوع TRIAL قديم (يُعامل كغير مرخص — ليس استحقاقًا) |
IsTemporary / ExpiryNote / LicenseExpiry | علامات الترخيص المؤقت |
IsExpired | منتهي وفقًا لقواعد المستوى أعلاه |
IsVersionValid | هذه البنية تقع ضمن نافذة دعم الترخيص |
IsViewerLicensed | تم العثور على ملف غير TRIAL و تم تغطية الإصدار — المتطلب الأساسي |
IsCapabilityGranted(cap) | البوابة الوحيدة للقدرة |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | علم واحد لكل قدرة: تم شراؤه بواسطة ترخيص يغطي هذه البنية، أو مُمنح بواسطة ترخيص مؤقت نشط. IsCapabilityGranted يجيب على نفس السؤال حسب القدرة |
IsValidForDomain(host) | تغطية المضيف؛ تراخيص V4 تستخدم البدل *.* |
LicenseRejectionReason | غير فارغ ⇒ يتم حظر الفتح بهذه الرسالة |
DoconutLicenseInfo يكشف عن اللقطة الصديقة للعرض للوحة الإدارة: Owner، LicenseType، Domain، IsLicenseFileFound، IsVersionValid، IsTrial، IsExpired، أعلام Has*، حقول الترخيص المؤقت، وRejectionMessage.
// Feature-flag واجهة UI الخاصة بك من نفس مصدر الحقيقة الذي يستخدمه SDK
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,
}));فحص الصحة
AddDoconut() يسجل فحص صحة "doconut" الذي يبلغ عن حالة الترخيص/الانتهاء عبر آلية ASP.NET Core القياسية:
app.MapHealthChecks("/health");اربطه بمراقبتك وسيصبح الاشتراك القريب الانتهاء تنبيهًا بدلاً من تذكرة دعم. الفحص يبلغ عن Unhealthy عندما يُرفض الترخيص أو يكون IsExpired صحيحًا؛ بالنسبة للترخيص المدفوع، يعني ذلك أن تاريخ الاشتراك قد مر وحزمة صدرت بعده ستُرفض — البنية الحالية تظل تعرض نظيفة.
ترقيات الإصدار
الترخيص يغطي نافذة الإصدار. تحديث حزمة NuGet إلى بنية أحدث من تلك النافذة يجعل الترخيص غير صالح لهذه البنية: IsVersionValid يتحول إلى false ويتم حظر الفتح بــ LicenseException (السبب في License.RejectionMessage) — فشل سريع متعمد، بحيث يُكتشف بناء قديم أو غير مرخص عند النشر بدلاً من وضع علامة مائية صامتة على مخرجات الإنتاج. جدد الاشتراك، استبدل .lic، وأعد تشغيل التطبيق حتى يحمل AddDoconut() الترخيص الجديد.
هل كانت هذه الصفحة مفيدة؟