الترخيص

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

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

حالات الترخيص وما تقوم به

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

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

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

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

القدرات

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

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

البوابة الوحيدة التي يستخدمها كامل خط الأنابيب هي 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() الرخصة الجديدة.

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