স্কিপ করে মূল কন্টেন্ট এ যান

চেঞ্জলগ

SuperAdmin.Rbac-এর সব উল্লেখযোগ্য পরিবর্তন। ভার্সন SemVer অনুসরণ করে।

0.2.3​

ঠিক করা হয়েছে​

  • Blazor-এর SuperAdminMenu ও SuperAdminLayout মেনু আইটেম, লগআউট, সেটিংস ও লোগোর জন্য পূর্ণ লিংক (http://host/admin/sync) লিখত। এখন এগুলো Razor মেনুর মতোই রুট-রিলেটিভ লিংক লেখে (/admin/sync, অথবা path base-এর নিচে /base/admin/sync)। HTTPS বন্ধ করে দেওয়া প্রক্সির পেছনে, অ্যাপ ফরওয়ার্ডেড হেডার না পড়লেও লিংক আর http:// দিয়ে শুরু হয় না।
  • UI:Stylesheets: লোকাল এন্ট্রিতে (~/... বা /..., তাদের MapStaticAssets() ফিঙ্গারপ্রিন্ট করা URL-ও) আর লগইন লাগে না। আগে Protection:Scope = All হলে সাইন-ইন পেজ সেগুলো লোড করতে পারত না।

0.2.2​

প্যাচ ভার্সনে ব্রেকিং পরিবর্তন: Blazor-এর <SuperAdminMenu /> এখন সাইডবার মার্কআপ রেন্ডার করে। 0.2.* রেফারেন্স করা অ্যাপ এটি স্বয়ংক্রিয়ভাবে পায়। পুরনো লিস্ট মার্কআপের জন্য Variant="SuperAdminMenuVariant.Plain" দিন, অথবা 0.2.1-এ পিন করুন।

যোগ করা হয়েছে​

  • Blazor শেল কম্পোনেন্ট, যাতে Blazor অ্যাপকে আর প্যানেলের মার্কআপ কপি করতে না হয়:
    • SuperAdminLayout: হেডার, ইউজার মেনু (সেটিংস, antiforgery টোকেনসহ লগআউট), সার্চ ও মেনুসহ সাইডবার, পেজ বডি। _AdminLayout.cshtml-এর মতোই মার্কআপ। এটিকে লেআউট হিসেবে ব্যবহার করুন অথবা নিজের লেআউট এর ভেতরে রাখুন (@layout SuperAdminLayout)।
    • <SuperAdminHead />: <head>-এর জন্য থিম CSS, superadmin.css, UI:Stylesheets ও কালার-মোড স্ক্রিপ্ট। MapStaticAssets() সহ ফিঙ্গারপ্রিন্ট করা পাথ।
    • <SuperAdminScripts />: <body>-এর জন্য Bootstrap বান্ডল ও superadmin.js।
    • SuperAdminAssets: প্যাকেজের স্ট্যাটিক ফাইল পাথের কনস্ট্যান্ট।
  • UI:Stylesheets: বিল্ট-ইন পেজ, সাইন-ইন পেজ ও <SuperAdminHead />-এ প্যাকেজের CSS-এর পরে লোড হওয়া বাড়তি CSS ফাইল।
  • UI:ColorMode = Light (ডিফল্ট), Dark বা Auto (prefers-color-scheme অনুসরণ করে), Bootstrap-এর data-bs-theme-এর মাধ্যমে।
  • থিমে রঙের ভ্যারিয়েবল: --sa-accent, --sa-sidebar-bg, --sa-sidebar-text, --sa-main-bg, --sa-surface-bg ও আরও (README, "Theme and colours")। প্রতিটির ডার্ক মান আছে। পুরনো নামগুলো (--menu-bg, --main-bg, ...) এখনো কাজ করে।
  • theme/: styles.css-এর SCSS সোর্স ও তার বিল্ড (npm run build)।

পরিবর্তন​

  • Bootstrap 5.3.8 (আগে 5.1.3), CSS ও JS। থিম সেটিংস নিয়ে আসা হয়েছে, তাই প্যানেল দেখতে একই। .text-bg-*-এর মতো নতুন 5.3 ক্লাস পাওয়া যায়।
  • ব্রেকিং: Blazor-এর <SuperAdminMenu /> এখন প্যানেলের সাইডবার মার্কআপ রেন্ডার করে (ul#menu, ভাঁজযোগ্য গ্রুপ, li.active), প্যাকেজের CSS দিয়ে স্টাইল করা। 0.2-এর মার্কআপের (sa-menu ক্লাস, NavLink) জন্য Variant="SuperAdminMenuVariant.Plain" দিন।
  • superadmin.js document থেকে ডেলিগেট করা হ্যান্ডলার ব্যবহার করে, তাই Blazor রি-রেন্ডারের পরও সাইডবার টগল, মেনু সার্চ ও নিশ্চিতকরণ কাজ করে।
  • হেডার, কার্ড, টেবিল ও সাইন-ইন পেজ নির্দিষ্ট সাদা ব্যাকগ্রাউন্ডের বদলে থিম ভ্যারিয়েবল ব্যবহার করে, তাই ডার্ক মোড অনুসরণ করে।
  • থিম CSS-এ আর এমন থার্ড-পার্টি উইজেটের রুল নেই যা প্যানেল ব্যবহার করে না (choices.js, flatpickr, toastify, icon picker, dual list box, grid helpers)। যে ফন্ট ফাইল কখনো দেওয়া হয়নি (.eot, .ttf, .svg) সেগুলো আর রেফারেন্স করা হয় না।

0.2.1 বা আগের ভার্সন থেকে আপগ্রেড​

  1. যে Blazor অ্যাপ নিজে .sa-menu স্টাইল করেছে: <SuperAdminMenu />-এ Variant="SuperAdminMenuVariant.Plain" যোগ করুন, অথবা SuperAdminLayout-এ চলে যান।
  2. যে Blazor অ্যাপ প্যানেলের লেআউট কপি করেছে: কপি করা হেডার ও সাইডবার মার্কআপের জায়গায় @layout SuperAdminLayout দিন, হার্ড-কোড করা _content/SuperAdmin.Rbac/... লিংকের জায়গায় <SuperAdminHead /> ও <SuperAdminScripts /> দিন, এবং লোকাল .text-bg-* CSS বাদ দিন (এখন Bootstrap 5.3-এ আছে)।
  3. ব্র্যান্ডের রং: সেগুলো UI:Stylesheets-এ তালিকাভুক্ত একটি স্টাইলশিটে সরিয়ে --sa-* ভ্যারিয়েবল ব্যবহার করুন।

0.2.0​

যোগ করা হয়েছে​

  • Blazor Server সমর্থন (AddSuperAdminBlazor()):
    • একটি রিভ্যালিডেটিং AuthenticationStateProvider: নিষ্ক্রিয় করা, ফোর্স লগআউট ও পাসওয়ার্ড পরিবর্তন চলমান সার্কিটও শেষ করে (Auth:RevalidationMinutes, ডিফল্ট ১);
    • [HasUrlPermission] / পলিসি SuperAdminDefaults.UrlPolicy ("sa:url"): AuthorizeRouteView-এর মাধ্যমে সার্কিটের প্রতিটি নেভিগেশনে পারমিশনের URL রুল চেক করে। হ্যান্ডলার HttpContext, Blazor RouteData, UrlResource বা পাথ স্ট্রিং গ্রহণ করে;
    • <SaCan Permission="" Roles="" Url=""> ও <SuperAdminMenu /> কম্পোনেন্ট;
    • সার্কিটের ভেতরে ICurrentAdmin প্রতিটি কলে বর্তমান ইউজার পড়ে।
  • Auth:SetDefaultScheme: SuperAdmin কুকিকে [Authorize], AuthorizeView ও HttpContext.User-এর ডিফল্ট স্কিম করে।
  • Database:Mode = Auto | Create | Migrate | None। প্লাগইনের কোনো টেবিল বা কলাম না থাকলে স্টার্টআপ এখন সাথে সাথে ব্যর্থ হয়।
  • SQL Server, PostgreSQL, MySQL, Oracle ও SQLite-এর SQL স্ক্রিপ্ট: GenerateSuperAdminSqlScript() এবং প্যাকেজে sql/<provider>/0001_init.sql (ইনস্টল) ও 0002_user_attributes.sql (0.1.x থেকে আপগ্রেড)। সবগুলো আবার চালানো নিরাপদ, এবং ইনস্টল স্ক্রিপ্ট বিদ্যমান টেবিলে নতুন ভার্সনের কলামও যোগ করে। SQL Server স্ক্রিপ্ট ANSI_NULLS ও QUOTED_IDENTIFIER সেট করে।
  • SQL Server (LocalDB), PostgreSQL 17, MySQL 9.1 (MySql.EntityFrameworkCore) ও SQLite-এ টেস্ট করা। Oracle (Oracle.EntityFrameworkCore, 23ai ও 19c কম্প্যাটিবিলিটি) সমর্থিত; এর স্ক্রিপ্ট ও মডেল চেক দিয়ে যাচাই করা, এখনো লাইভ ডাটাবেসে চালানো হয়নি।
  • Protection:SkipUrlRulesForAssets (ডিফল্ট true): MapStaticAssets()-এর ফাইল ও Blazor ফ্রেমওয়ার্ক রিকোয়েস্টে (/_framework/*, /_blazor, /_blazor/*) লগইন লাগে কিন্তু URL রুল লাগে না। আগে Protection:Scope = All মিলে যাওয়া রুল নেই এমন ইউজারের জন্য blazor.web.js আটকে দিত, তাই তাদের সার্কিট কখনো শুরু হতো না।
  • কমান্ড লাইন: superadmin seed-admin ও superadmin sql-scriptসহ RunSuperAdminCommandAsync(args)।
  • ইউজার ইম্পোর্ট: UserInput.PasswordHash (ASP.NET Core Identity v2/v3 হ্যাশ), UserInput.Id, UserInput.LockoutEnd।
  • ইউজারের বাড়তি ফিল্ড: sa_users.Attributes (JSON), UserInput.Attributes, SaUser.GetAttributes(), AccessSnapshot.Attributes।
  • ইভেন্ট: ISuperAdminEvents (SignedIn, কারণসহ SignInFailed, SignedOut, UserChanged, RoleChanged, PermissionChanged, MenuChanged)।
  • আপনার নিজের অডিট টেবিলের জন্য IOperationLogSink, এবং OperationLog:WriteToDatabase।
  • বিল্ট-ইন পেজ বন্ধ করতে UI:Enabled ও UI:Pages (Account, Management, All)।
  • লকআউট, কুকির মেয়াদ, রেট লিমিট, টাইমস্ট্যাম্প ও লগ রিটেনশনে TimeProvider ব্যবহার হয় (টেস্টে বদলে দিন)।
  • Source Link, সিম্বলে (.snupkg) এমবেড করা সোর্স এবং ডিটারমিনিস্টিক CI বিল্ড।
  • একটি Blazor Server স্যাম্পল (samples/Sample.Blazor)।

পরিবর্তন​

  • প্লাগইন IDbContextFactory<SuperAdminDbContext> এবং প্রতি অপারেশনে একটি স্বল্পস্থায়ী কনটেক্সট ব্যবহার করে, তাই Blazor সার্কিটে সার্ভিসগুলো নিরাপদ। SuperAdminDbContext এখনো scoped সার্ভিস হিসেবে ইনজেক্ট করা যায়।
  • সব DateTime মান DateTimeKind.Utc হিসেবে পড়া হয়।
  • ইউজার ও পারমিশন সার্চ প্রতিটি ডাটাবেসে কেস-ইনসেনসিটিভ (PostgreSQL-এ কেস-সেনসিটিভ ছিল)।
  • Oracle: sa_permission_routes.HttpMethods nullable (Oracle ''-কে NULL হিসেবে রাখে), এবং সর্বোচ্চ দৈর্ঘ্য ছাড়া স্ট্রিং NVARCHAR2(2000)-এর বদলে NCLOB। নির্দিষ্ট id সহ ইউজার ইম্পোর্ট করলে Oracle আইডেন্টিটি সামনে এগিয়ে যায়।
  • তৈরি হওয়া অ্যাডমিন পাসওয়ার্ড আর লগ হয় না। Seed:AdminPassword ছাড়া Development কনসোলে একটি র‍্যান্ডম পাসওয়ার্ড ছাপে; অন্য এনভায়রনমেন্টে কোনো অ্যাডমিন ইউজার তৈরি হয় না (superadmin seed-admin ব্যবহার করুন)।
  • Database:AutoMigrate অপ্রচলিত; false এখনো কাজ করে এবং মানে Mode = None।

ঠিক করা হয়েছে​

  • লগইন পেজ বাতিল হওয়া সেশনকে (পুরনো সিকিউরিটি স্ট্যাম্প) সাইন-ইন হিসেবে ধরত, ড্যাশবোর্ডে রিডাইরেক্ট করত এবং returnUrl হারিয়ে ফেলত। এখন এটি পুরনো কুকি মুছে ফর্ম দেখায়।

0.1.x থেকে আপগ্রেড​

  1. ডাটাবেস: 0.2.0 nullable কলাম sa_users.Attributes যোগ করে।
    • মাইগ্রেশন ছাড়া Mode Auto/Create: স্টার্টআপে স্বয়ংক্রিয়ভাবে যোগ হয়।
    • EF Core মাইগ্রেশন: dotnet ef migrations add SuperAdmin020 --context SuperAdminDbContext।
    • SQL স্ক্রিপ্ট: প্যাকেজ থেকে sql/<provider>/0002_user_attributes.sql চালান, অথবা GenerateSuperAdminSqlScript() আবার তৈরি করে চালান। কলামটি না থাকা পর্যন্ত Mode = None "missing sa_users.Attributes" দিয়ে অ্যাপ থামিয়ে দেয়।
  2. 0.1.x তৈরি হওয়া অ্যাডমিন পাসওয়ার্ড অ্যাপ্লিকেশন লগে লিখত। Seed:AdminPassword ছাড়া 0.1.x চালিয়ে থাকলে ওই অ্যাডমিনের পাসওয়ার্ড বদলান এবং সংরক্ষিত লগ থেকে লাইনটি সরান।
  3. প্রোডাকশন: খালি ডাটাবেসে প্রথম স্টার্টের আগে SuperAdmin:Seed:AdminPassword সেট করুন (বা superadmin seed-admin চালান)।
  4. ম্যানেজমেন্ট সার্ভিস নিজে তৈরি করলে (DI ছাড়া), নতুন কনস্ট্রাক্টর আর্গুমেন্ট দিন।

0.1.0.1, 0.1.0​

প্রথম রিলিজ। দুটোই তৈরি হওয়া অ্যাডমিন পাসওয়ার্ড লগে লেখে; 0.2.0 বা পরের ভার্সন ব্যবহার করুন। 0.1.0.1 চার-অংশের ভার্সন; পরের রিলিজগুলো তিন-অংশের SemVer ব্যবহার করে।