רישוי
יכולות, רמות רישיון ושירות הרישיון
דף זה הוא ההתייחסות בזמן ריצה לאופן שבו רישיון מעצב את ההתנהגות של Doconut: מה כל מצב רישיון מאפשר, איך ניתנות היכולות, וכיצד לבדוק את כל זה מהקוד. (לטעינה רישיון, ראו התחלה → הגדרת רישיון.)
מצבי רישיון ומה הם עושים
| מצב | פותח מסמכים? | סימן מים | יכולות |
|---|---|---|---|
| רישיון מלא (בתשלום) (גרסה זו שוחררה לפני תאריך המנוי שלה) | כן | אין | הדגלים שנרכשו (Has* flags) |
| רישיון זמני (Developer/NFR — רישיון הערכה, לפני תאריך הפקיעה) | כן | אין במציג הבסיס; פלט התוסף מסומן במים | הכול — מתן כולל (משפך ההערכה) |
רישיון זמני שפג (לאחר תאריך LicenseExpiry שלו) | כן | סימן מים של הערכה | לא ניתנה |
| אין קובץ רישיון כלל | כן | סימן מים של הערכה | לא ניתנה |
| נמצא אך נדחה (חתימה לא תקפה, שונה, ברשימה שחורה, או גרסה שוחררה אחרי תאריך המנוי של הרישיון) | לא — LicenseException ב‑כל פתיחה | — | — |
רישיון בתשלום שתאריך המנוי שלו עבר ממשיך לעבוד — ללא סימן מים, עם היכולות שלו — על כל גרסה שוחררה לפני תאריך זה. רק גרסה שוחררה אחרי תאריך המנוי נדחית.
שתי תוצאות שכדאי להטמיע:
- חוסר רישיון אינו רישיון זמני. בלי קובץ רישיון, הדפים מוצגים עם סימן מים ואין שום יכולת (חיפוש, הערות, תוספים) פעילה. החוויה המלאה ללא סימן מים דורשת רישיון זמני אמיתי (קבל אחד).
- רק רישיון שנדחה חוסם פתיחה. רישיון זמני שפג תוקף משאיר את האפליקציה פועלת עם סימן מים של הערכה, ורישיון בתשלום אחרי תאריך המנוי שלו משאיר את ההצגה נקייה על הגרסאות שהוא מכסה; אך פריסת גרסה שוחררה אחרי תאריך המנוי של הרישיון נדחית ונכשלת מיידית עם
LicenseException, ולכן אתה תופס זאת בפריסה — ולא על ידי שליחת פלט עם סימן מים בשקט. החריגה (מOpenDocumentAsync) נושאת את הסיבה מLicense.RejectionMessage.
יכולות
Doconut מגביל פונקציונליות אופציונלית באמצעות יכולת. הוא כולל את תכונות חיפוש ו-הערות המובנות ואת תוספי Converter, 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 ישן אינו זכות — הוא מטופל כלא מורשה: מסומן במים, שום דבר אינו ניתנת.)
רישיונות זמניים
רישיונות זמניים (Developer/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.
// 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() יטען את הרישיון החדש.
האם דף זה היה מועיל?