רישוי

דף זה הוא ההתייחסות בזמן ריצה לאופן שבו רישיון מעצב את ההתנהגות של 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 ישן אינו זכות — הוא מתייחס כלא מורשה: עם סימן מים, ללא שום מתן.)

רישיונות זמניים

רישיונות זמניים (Developer/NFR) מסומנים בתג ExpiryNote ונושאים תאריך תפוגה קשוח:

משמעות התפוגה שונה לפי השכבה: רישיון זמני פג בתאריך LicenseExpiry רק בתאריך (חלון המנוי שלו מתעלם; רישיון זמני ללא תאריך מתייחס כפג, בטיחות). כל רישיון אחר פג בתאריך חלון המנוי/עדכון שלו.

הפנייה ל‑IDoconutLicenseService

הזרק IDoconutLicenseService (מרחב שם Doconut.Core.Interfaces; רשום כסינגלטון — הרישיון מפוענח פעם אחת בזמן האתחול):

DoconutLicenseInfo מציג את תמונת המצב הידידותית לתצוגה עבור פאנלים מנהליים: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, דגלי Has*, השדות של רישיון זמני, ו‑RejectionMessage.

// Feature-flag your UI from the same source of truth the SDK uses
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");

חבר זאת למערכת המעקב שלך והסבר מנוי שפג תוקף הופך להתראה במקום פנייה לתמיכה.

שדרוגי גרסה

רישיון מכסה חלון גרסה. עדכון חבילת NuGet לבנייה חדשה יותר מחלון זה גורם לרישיון להיות לא תקף עבור בנייה זו: IsVersionValid הופך ל‑false ופתיחה חסומה עם LicenseException (הסיבה נמצאת ב‑License.RejectionMessage) — כוונה לכשל מהיר, כך שבנייה מיושנת או לא מורשית נתפסת בפריסה במקום לסמן במים את הפלט בשקט. חידש את המנוי, החלף את קובץ ה‑.lic, והפעל מחדש את היישום כך ש‑AddDoconut() תטען את הרישיון החדש.