רישוי

יכולות, רמות רישיון ושירות הרישיון

דף זה הוא ההתייחסות בזמן ריצה לאופן שבו רישיון מעצב את ההתנהגות של Doconut: מה כל מצב רישיון מאפשר, איך ניתנות היכולות, ואיך לבדוק את כל זה מהקוד. (לטעינת רישיון, ראו ההתחלה → הגדרת רישיון.)

מצבי רישיון ומה הם עושים

מצבפותח מסמכים?סימן מיםיכולות
רישיון מלא (בתשלום) (גרסה זו שוחררה לפני תאריך המנוי שלה)כןאיןהדגלים שנרכשו (Has* flags)
רישיון זמני (מפתח/‏NFR — רישיון ההערכה, לפני תאריך הפקיעה)כןאין על הצופה הבסיסי; פלט תוסף מסומן במיםהכול — מתן כולל (תהליך ההערכה)
רישיון זמני פג תוקף (עבר תאריך LicenseExpiry שלו)כןסימן מים של הערכהלא ניתנה שום
אין קובץ רישיון כללכןסימן מים של הערכהלא ניתנה שום
נמצא אך נדחה (חתימה לא תקפה, שונה, ברשימה שחורה, או גרסה שוחררה אחרי תאריך המנוי של הרישיון)לא — LicenseException בכל פתיחה——

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

שתי תוצאות שכדאי להטמיע:

  • חוסר רישיון אינו רישיון זמני. ללא קובץ רישיון, הדפים מוצגים עם סימן מים ואין שום יכולת (חיפוש, הערה, תוספים) פעילה. החוויה המלאה, ללא סימן מים, דורשת רישיון זמני (קבל אחד).
  • רק רישיון שנדחה חוסם פתיחה. רישיון זמני שפג משאיר את האפליקציה פועלת עם סימן מים של הערכה, ורישיון בתשלום שעבר את תאריך המנוי שלו ממשיך להציג ללא סימן מים על הגרסאות שהוא מכסה; אך פריסת גרסה שפורסמה אחרי תאריך המנוי של הרישיון נדחית ונכשלת מיידית עם LicenseException, כך שאתה תופס זאת בפריסה — ולא על ידי שליחת פלט עם סימן מים בשקט. החריגה ההיא (מOpenDocumentAsync) נושאת את הסיבה מLicense.RejectionMessage.

יכולות

Doconut מגביל פונקציונליות אופציונלית באמצעות יכולת. זה כולל את תכונות חיפוש והערה המובנות ואת התוספים Converter, Dicom וSigner שניתן לבחור בהם, שכל אחד ניתנת לפי הרישיון שלך. הצופה הבסיסי אינו יכולת — הוא דרישה מוקדמת, מוצג כIsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // רישיון non-TRIAL קיים AND מכסה את גרסת הבנייה הזו

השער היחיד שהצינור כולו משתמש בו הוא IsCapabilityGranted:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

ההיגיון שלו, במדויק מהיישום: רישיון זמני פעיל (שאינו פג תוקף) מעניק כל היכולת — כולל יכולות שאין להן עדיין דגל רכישה ייעודי; רישיון שנרכש במציאות מעניק בדיוק את דגלי Has* שלו והוא דחיית ברירת מחדל לכל דבר שלא ממופה. (קובץ מסוג TRIAL מורשת הוא לא זכות — הוא מתייחס כלא מורשה: מסומן במים, שום דבר לא ניתנת.)

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

רישיונות זמניים (מפתח/‏NFR) מסומנים בתג 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() טוען את הרישיון החדש.

האם דף זה היה מועיל?