الترخيص

القدرات، مستويات الترخيص، وخدمة الترخيص

هذه الصفحة هي مرجع وقت التشغيل لكيفية تشكيل الترخيص لسلوك Doconut: ما يسمح به كل حالة ترخيص، كيف تُمنح القدرات، وكيفية فحص كل ذلك من الشيفرة. (لـ تحميل ترخيص، راجع البدء → إعداد الترخيص.)

حالات الترخيص وما تفعله

الحالةيفتح المستندات؟علامة مائيةالقدرات
ترخيص كامل (مدفوع) (تم إصدار هذا البناء قبل تاريخ الاشتراك الخاص به)نعملا شيءالتي تم شراؤها (علامات Has*)
ترخيص مؤقت (مطور/غير تجاري — ترخيص التقييم، قبل تاريخ انتهاء صلاحيته)نعملا شيء على عارض الأساس؛ مخرجات الإضافات تحمل علامة مائيةالكل — منح شامل (قمع التقييم)
ترخيص مؤقت منتهي (بعد تاريخ LicenseExpiry الخاص به)نعمعلامة مائية للتقييملم يُمنح شيء
لا ملف ترخيص على الإطلاقنعمعلامة مائية للتقييملم يُمنح شيء
تم العثور عليه لكنه مرفوض (توقيع غير صالح، تم العبث به، مدرج على القائمة السوداء، أو تم إصدار بناء بعد تاريخ اشتراك الترخيص)لا — LicenseException عند كل فتح——

يستمر الترخيص المدفوع الذي تجاوز تاريخ اشتراكه في العمل — نظيفًا، مع قدراته — على كل بناء تم إصداره قبل ذلك التاريخ. فقط بناء تم إصداره بعد ذلك يُرفض.

اثنان من العواقب التي تستحق الفهم:

  • الترخيص المفقود ليس ترخيصًا مؤقتًا. بدون ملف ترخيص، تُظهر الصفحات علامة مائية ولا تكون أي قدرة (بحث، تعليقات، إضافات) نشطة. التجربة الكاملة غير المائية تتطلب ترخيصًا مؤقتًا فعليًا (احصل على واحد).
  • فقط الترخيص المرفوض يمنع الفتح. الترخيص المؤقت المنتهي يبقي التطبيق يعمل مع علامة مائية للتقييم، والترخيص المدفوع بعد تاريخ اشتراكه يظل يعرض نظيفًا على البنايات التي يغطيها؛ لكن نشر بناء تم إصداره بعد تاريخ اشتراك الترخيص يُرفض ويفشل بسرعة مع LicenseException، لذا تلتقطه عند النشر — وليس عن طريق إرسال مخرجات مائية بصمت. ذلك الاستثناء (من OpenDocumentAsync) يحمل السبب من License.RejectionMessage.

القدرات

يقوم Doconut بالتحكم في الوظائف الاختيارية عبر القدرة. يغطي ذلك ميزات البحث والتعليق المدمجة والإضافات الاختيارية Converter وDicom وSigner، كل منها يُمنح بواسطة ترخيصك. عارض الأساس ليس قدرة — إنه المتطلب المسبق، يُظهر كـ IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL رخصة موجودة AND تغطي نسخة هذا البناء

البوابة الوحيدة التي يستخدمها كامل خط الأنابيب هي IsCapabilityGranted:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

منطقه، حرفيًا من التنفيذ: الترخيص المؤقت النشط (غير منتهي) يمنح كل قدرة — بما في ذلك القدرات التي لا تملك علم شراء مخصص بعد؛ الترخيص الحقيقي المشتري يمنح بالضبط علاماته Has* ويكون رفضًا افتراضيًا لأي شيء غير مُطابق. (ملف من نوع TRIAL التراثي ليس استحقاقًا — يُعامل كغير مرخص: يحمل علامة مائية، ولا يُمنح شيء.)

التراخيص المؤقتة

التراخيص المؤقتة (مطور/غير تجاري) يتم تمييزها بعلامة 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.

csharp
// 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 القياسية:

csharp
app.MapHealthChecks("/health");

قم بدمجه في مراقبتك وسيصبح الاشتراك القريب من الانتهاء تنبيهًا بدلاً من تذكرة دعم. الفحص يبلغ عن Unhealthy عندما يُرفض الترخيص أو يكون IsExpired صحيحًا؛ بالنسبة لترخيص مدفوع، يعني ذلك أن تاريخ الاشتراك قد مر وحزمة تم إصدارها بعده ستُرفض — يبقى البناء الحالي يعرض نظيفًا.

ترقيات الإصدار

يغطي الترخيص نافذة إصدار. تحديث حزمة NuGet إلى بناء أحدث من تلك النافذة يجعل الترخيص غير صالح لهذا البناء: IsVersionValid يتحول إلى false ويُحظر الفتح بLicenseException (السبب في License.RejectionMessage) — فشل سريع مقصود، بحيث يُكتشف بناء قديم أو غير مرخص عند النشر بدلاً من وضع علامة مائية صامتة على مخرجات الإنتاج. جدد الاشتراك، استبدل .lic، وأعد تشغيل التطبيق حتى يقوم AddDoconut() بتحميل الترخيص الجديد.

هل كانت هذه الصفحة مفيدة؟