الترخيص

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

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

نتيجتان تستحقان الاستيعاب:

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

القدرات

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

bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's version

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

bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

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

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

التراخيص المؤقتة (المطور/NFR) تُميز بعلامة ExpiryNote وتحمل تاريخ انتهاء صريح:

تختلف دلالات الانتهاء حسب المستوى: الرخصة المؤقتة تنتهي في تاريخ LicenseExpiry فقط (يُهمل نافذة الاشتراك؛ الرخصة المؤقتة التي تفتقد التاريخ تُعامل كمنتهية، آلية فشل آمنة). كل رخصة أخرى تنتهي في تاريخ نافذة الاشتراك/التحديث الخاصة بها.

مرجع IDoconutLicenseService

استخرج IDoconutLicenseService (المساحة Doconut.Core.Interfaces) من DoconutHost.Services. هو كائن مفرد — تُحلل الرخصة مرة واحدة، في DoconutHost.Initialize:

DoconutLicenseInfo تعرض اللقطة الصديقة للعرض للوحة الإدارة: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, أعلام Has*، حقول الرخصة المؤقتة، و RejectionMessage.

// GET /Features - feature-flag your UI from the same source of truth the SDK uses
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

فحص الصحة

Doconut يسجل فحص صحة "doconut" الذي يبلغ عن حالة الترخيص. ASP.NET الكلاسيكي لا يمتلك نقطة نهاية صحة خاصة به، لذا عرّفه من خلال متحكم:

// GET /Health - Doconut registers a "doconut" health check that reports the license state:
// Healthy (valid), Degraded (trial or no license file), Unhealthy (expired).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

اربطه بمراقبتك وستصبح الاشتراكات القريبة من الانتهاء تنبه بدلاً من أن تكون تذكرة دعم. انظر DoconutHost لقيم الحالة.

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

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