চেঞ্জলগ
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.jsdocumentথেকে ডেলিগেট করা হ্যান্ডলার ব্যবহার করে, তাই Blazor রি-রেন্ডারের পরও সাইডবার টগল, মেনু সার্চ ও নিশ্চিতকরণ কাজ করে।- হেডার, কার্ড, টেবিল ও সাইন-ইন পেজ নির্দিষ্ট সাদা ব্যাকগ্রাউন্ডের বদলে থিম ভ্যারিয়েবল ব্যবহার করে, তাই ডার্ক মোড অনুসরণ করে।
- থিম CSS-এ আর এমন থার্ড-পার্টি উইজেটের রুল নেই যা প্যানেল ব্যবহার করে না (choices.js, flatpickr, toastify, icon picker, dual list box, grid helpers)। যে ফন্ট ফাইল কখনো দেওয়া হয়নি (
.eot,.ttf,.svg) সেগুলো আর রেফারেন্স করা হয় না।
0.2.1 বা আগের ভার্সন থেকে আপগ্রেড
- যে Blazor অ্যাপ নিজে
.sa-menuস্টাইল করেছে:<SuperAdminMenu />-এVariant="SuperAdminMenuVariant.Plain"যোগ করুন, অথবাSuperAdminLayout-এ চলে যান। - যে Blazor অ্যাপ প্যানেলের লেআউট কপি করেছে: কপি করা হেডার ও সাইডবার মার্কআপের জায়গায়
@layout SuperAdminLayoutদিন, হার্ড-কোড করা_content/SuperAdmin.Rbac/...লিংকের জায়গায়<SuperAdminHead />ও<SuperAdminScripts />দিন, এবং লোকাল.text-bg-*CSS বাদ দিন (এখন Bootstrap 5.3-এ আছে)। - ব্র্যান্ডের রং: সেগুলো
UI:Stylesheets-এ তালিকাভুক্ত একটি স্টাইলশিটে সরিয়ে--sa-*ভ্যারিয়েবল ব্যবহার করুন।
0.2.0
যোগ করা হয়েছে
- Blazor Server সমর্থন (
AddSuperAdminBlazor()):- একটি রিভ্যালিডেটিং
AuthenticationStateProvider: নিষ্ক্রিয় করা, ফোর্স লগআউট ও পাসওয়ার্ড পরিবর্তন চলমান সার্কিটও শেষ করে (Auth:RevalidationMinutes, ডিফল্ট ১); [HasUrlPermission]/ পলিসিSuperAdminDefaults.UrlPolicy("sa:url"):AuthorizeRouteView-এর মাধ্যমে সার্কিটের প্রতিটি নেভিগেশনে পারমিশনের URL রুল চেক করে। হ্যান্ডলারHttpContext, BlazorRouteData,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.HttpMethodsnullable (Oracle''-কেNULLহিসেবে রাখে), এবং সর্বোচ্চ দৈর্ঘ্য ছাড়া স্ট্রিংNVARCHAR2(2000)-এর বদলেNCLOB। নির্দিষ্ট id সহ ইউজার ইম্পোর্ট করলে Oracle আইডেন্টিটি সামনে এগিয়ে যায়। - তৈরি হওয়া অ্যাডমিন পাসওয়ার্ড আর লগ হয় না।
Seed:AdminPasswordছাড়াDevelopmentকনসোলে একটি র্যান্ডম পাসওয়ার্ড ছাপে; অন্য এনভায়রনমেন্টে কোনো অ্যাডমিন ইউজার তৈরি হয় না (superadmin seed-adminব্যবহার করুন)। Database:AutoMigrateঅপ্রচলিত;falseএখনো কাজ করে এবং মানেMode = None।
ঠিক করা হয়েছে
- লগইন পেজ বাতিল হওয়া সেশনকে (পুরনো সিকিউরিটি স্ট্যাম্প) সাইন-ইন হিসেবে ধরত, ড্যাশবোর্ডে রিডাইরেক্ট করত এবং
returnUrlহারিয়ে ফেলত। এখন এটি পুরনো কুকি মুছে ফর্ম দেখায়।
0.1.x থেকে আপগ্রেড
- ডাটাবেস: 0.2.0 nullable কলাম
sa_users.Attributesযোগ করে।- মাইগ্রেশন ছাড়া
ModeAuto/Create: স্টার্টআপে স্বয়ংক্রিয়ভাবে যোগ হয়। - EF Core মাইগ্রেশন:
dotnet ef migrations add SuperAdmin020 --context SuperAdminDbContext। - SQL স্ক্রিপ্ট: প্যাকেজ থেকে
sql/<provider>/0002_user_attributes.sqlচালান, অথবাGenerateSuperAdminSqlScript()আবার তৈরি করে চালান। কলামটি না থাকা পর্যন্তMode = None"missing sa_users.Attributes" দিয়ে অ্যাপ থামিয়ে দেয়।
- মাইগ্রেশন ছাড়া
- 0.1.x তৈরি হওয়া অ্যাডমিন পাসওয়ার্ড অ্যাপ্লিকেশন লগে লিখত।
Seed:AdminPasswordছাড়া 0.1.x চালিয়ে থাকলে ওই অ্যাডমিনের পাসওয়ার্ড বদলান এবং সংরক্ষিত লগ থেকে লাইনটি সরান। - প্রোডাকশন: খালি ডাটাবেসে প্রথম স্টার্টের আগে
SuperAdmin:Seed:AdminPasswordসেট করুন (বাsuperadmin seed-adminচালান)। - ম্যানেজমেন্ট সার্ভিস নিজে তৈরি করলে (DI ছাড়া), নতুন কনস্ট্রাক্টর আর্গুমেন্ট দিন।
0.1.0.1, 0.1.0
প্রথম রিলিজ। দুটোই তৈরি হওয়া অ্যাডমিন পাসওয়ার্ড লগে লেখে; 0.2.0 বা পরের ভার্সন ব্যবহার করুন। 0.1.0.1 চার-অংশের ভার্সন; পরের রিলিজগুলো তিন-অংশের SemVer ব্যবহার করে।