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