الترخيص
القدرات، مستويات الترخيص، وخدمة الترخيص
هذه الصفحة هي مرجع وقت التشغيل لكيفية تأثير الترخيص على سلوك Doconut: ما يسمح به كل حالة ترخيص، كيف تُمنح القدرات، وكيفية فحص كل ذلك من الشيفرة. (لـ تحميل ترخيص، راجع البدء → إعداد الترخيص.)
حالات الترخيص وما تقوم به
| الحالة | يفتح المستندات؟ | علامة مائية | القدرات |
|---|---|---|---|
| رخصة كاملة (مدفوعة) (تم إصدار هذا البناء قبل تاريخ الاشتراك الخاص به) | نعم | لا شيء | التي تم شراؤها (علامات Has*) |
| رخصة مؤقتة (المطور/غير تجاري — رخصة التقييم، قبل تاريخ انتهاء صلاحيتها) | نعم | لا شيء على عارض الأساس؛ مخرجات الإضافة تحمل علامة مائية | الكل — منحة شاملة (قمع التقييم) |
رخصة مؤقتة منتهية (بعد تاريخ LicenseExpiry الخاص بها) | نعم | علامة مائية للتقييم | لم يتم منح أي شيء |
| لا ملف ترخيص على الإطلاق | نعم | علامة مائية للتقييم | لم يتم منح أي شيء |
| تم العثور عليه لكنه مرفوض (توقيع غير صالح، تم العبث به، مدرج في القائمة السوداء، أو تم إصدار بناء بعد تاريخ اشتراك الرخصة) | لا — LicenseException عند كل فتح | — | — |
تستمر رخصة مدفوعة انتهى تاريخ اشتراكها في العمل — نظيفة، مع قدراتها — على كل بناء تم إصداره قبل ذلك التاريخ. فقط البناء الذي يُصدر بعد ذلك يُرفض.
اثنان من العواقب التي تستحق الاستيعاب:
- الترخيص المفقود ليس رخصة مؤقتة. بدون ملف ترخيص، تُظهر الصفحات علامة مائية ولا تكون أي قدرة (بحث، تعليقات، إضافات) نشطة. التجربة الكاملة غير المائية تتطلب رخصة مؤقتة فعلية (احصل على واحدة).
- فقط الترخيص المرفوض يمنع الفتح. رخصة مؤقتة منتهية تبقي التطبيق يعمل مع علامة مائية للتقييم، ورخصة مدفوعة بعد تاريخ اشتراكها تظل تُظهر نظيفة على البنايات التي تغطيها؛ لكن نشر بناء تم إصداره بعد تاريخ اشتراك الرخصة يُرفض ويفشل سريعًا مع
LicenseException، لذا تلتقطه عند النشر — وليس عن طريق إرسال مخرجات مائية بصمت. ذلك الاستثناء (منOpenDocumentAsync) يحمل السبب منLicense.RejectionMessage.
القدرات
يقوم Doconut بالتحكم في الوظائف الاختيارية عبر القدرة. يغطي ذلك ميزات البحث والتعليق المدمجة والإضافات الاختيارية المحول، Dicom وSigner، كل منها يُمنح حسب رخصتك. عارض الأساس ليس قدرة — إنه المتطلب المسبق، يُظهر كـ IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // ترخيص non-TRIAL موجود ويغطي نسخة هذا البناءالبوابة الوحيدة التي يستخدمها كامل خط الأنابيب هي IsCapabilityGranted:
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.
// 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() الرخصة الجديدة.
هل كانت هذه الصفحة مفيدة؟