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

RBAC আর্কিটেকচার: রোল, পারমিশন ও মেনু ভিজিবিলিটি

উদ্দেশ্য: এই ডকুমেন্টে Super Admin-এ ব্যবহৃত সম্পূর্ণ রোল-ভিত্তিক অ্যাক্সেস কন্ট্রোল (RBAC) আর্কিটেকচার বর্ণনা করা হয়েছে। এটি একটি প্ল্যাটফর্ম-নিরপেক্ষ স্পেসিফিকেশন হিসেবে লেখা হয়েছে, যাতে সিস্টেমটি ASP.NET C#, Node.js, Python (Django/Flask), Java (Spring Boot), বা অন্য যেকোনো ফ্রেমওয়ার্কে পুনরায় ইমপ্লিমেন্ট করা যায়।


সূচিপত্র​

  1. সিস্টেম ওভারভিউ
  2. ডাটাবেস স্কিমা
  3. এনটিটি রিলেশনশিপ (ERD)
  4. কোর এনটিটি
  5. অথেনটিকেশন ফ্লো
  6. পারমিশন রেজোলিউশন অ্যালগরিদম
  7. মেনু ভিজিবিলিটি অ্যালগরিদম
  8. মিডলওয়্যার পাইপলাইন
  9. পারমিশন চেকিং মেথড
  10. অ্যাক্সেস প্রদান ও প্রত্যাহার
  11. অপারেশন অডিট লগ
  12. কনফিগারেশন ফ্ল্যাগ
  13. ডিফল্ট সিড ডেটা
  14. পোর্টিংয়ের জন্য API রেফারেন্স
  15. প্ল্যাটফর্ম অনুযায়ী ইমপ্লিমেন্টেশন চেকলিস্ট

1. সিস্টেম ওভারভিউ​

Super Admin নিম্নলিখিত বৈশিষ্ট্যসহ একটি ক্লাসিক RBAC (রোল-ভিত্তিক অ্যাক্সেস কন্ট্রোল) মডেল ব্যবহার করে:

  • পৃথক অথ সিস্টেম: অ্যাডমিন ইউজাররা ফ্রন্ট-এন্ড অ্যাপ্লিকেশন ইউজারদের থেকে সম্পূর্ণরূপে আলাদা। তাদের নিজস্ব ডাটাবেস টেবিল, অথেনটিকেশন গার্ড, সেশন এবং লগইন পেজ রয়েছে।
  • দ্বি-পথ পারমিশন অ্যাসাইনমেন্ট: একজন ইউজারকে সরাসরি অথবা রোলের মাধ্যমে (পরোক্ষভাবে) পারমিশন অ্যাসাইন করা যায়। অ্যাক্সেস মূল্যায়নের সময় উভয় পথই একত্রিত করা হয়।
  • রাউট-ভিত্তিক পারমিশন: প্রতিটি পারমিশন এক বা একাধিক HTTP রাউট প্যাটার্নের (মেথড + পাথ) সাথে বাঁধা থাকে। সিস্টেমটি প্রতিটি রিকোয়েস্ট ইন্টারসেপ্ট করে এবং বর্তমান ইউজারের রিজলভড পারমিশন রিকোয়েস্টকৃত রাউটের সাথে মেলে কিনা তা যাচাই করে।
  • রোল-ভিত্তিক মেনু ভিজিবিলিটি: সাইডবার মেনু আইটেমগুলো নির্দিষ্ট রোলের জন্য সীমাবদ্ধ করা যায়। মেনু আইটেমগুলো ঐচ্ছিক ডিরেক্ট পারমিশন বাইন্ডিংও সাপোর্ট করে।
  • সুপার-অ্যাডমিনিস্ট্রেটর বাইপাস: administrator রোল স্লাগযুক্ত ইউজাররা স্বয়ংক্রিয়ভাবে সমস্ত পারমিশন চেক বাইপাস করে।

হাই-লেভেল আর্কিটেকচার​

┌─────────────┐ ┌─────────────┐ ┌─────────────────┐
│ Request │────▶│ Middleware │────▶│ Controller │
│ (HTTP) │ │ Pipeline │ │ (CRUD Page) │
└─────────────┘ └──────┬──────┘ └─────────────────┘
│
┌────────────┼────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Auth │ │Permission│ │ Log │
│ Check │ │ Check │ │Operation │
└──────────┘ └────┬─────┘ └──────────┘
│
┌─────┴─────┐
▼ ▼
┌──────────┐ ┌──────────┐
│ Direct │ │ Role │
│ Perms │ │ Perms │
└──────────┘ └──────────┘

2. ডাটাবেস স্কিমা​

সিস্টেমের জন্য 9টি টেবিল প্রয়োজন। সব টেবিলের নাম একটি কনফিগ ফাইলের মাধ্যমে কনফিগারযোগ্য।

2.1 প্রাইমারি টেবিল​

admin_users — অ্যাডমিনিস্ট্রেটর অ্যাকাউন্ট​

কলামটাইপকনস্ট্রেইন্টবিবরণ
idINT (PK)অটো-ইনক্রিমেন্টপ্রাইমারি কী
usernameVARCHAR(190)ইউনিক, নট নাললগইন ইউজারনেম
passwordVARCHAR(60)নট নালBcrypt দিয়ে হ্যাশ করা পাসওয়ার্ড
nameVARCHAR(255)নট নালপ্রদর্শনের নাম
avatarVARCHAR(255)নালযোগ্যঅ্যাভাটার ইমেজের পাথ অথবা URL
remember_tokenVARCHAR(100)নালযোগ্যসেশনের "remember me" টোকেন
created_atTIMESTAMP
updated_atTIMESTAMP

admin_roles — রোল​

কলামটাইপকনস্ট্রেইন্টবিবরণ
idINT (PK)অটো-ইনক্রিমেন্টপ্রাইমারি কী
nameVARCHAR(50)ইউনিক, নট নালমানুষের পড়ার উপযোগী নাম (যেমন, "Editor")
slugVARCHAR(50)ইউনিক, নট নালমেশিন-রিডেবল কী (যেমন, "editor")
created_atTIMESTAMP
updated_atTIMESTAMP

গুরুত্বপূর্ণ: administrator স্লাগটির একটি বিশেষ অর্থ আছে — এই রোলযুক্ত ইউজাররা সমস্ত পারমিশন চেক বাইপাস করে।

admin_permissions — পারমিশন​

কলামটাইপকনস্ট্রেইন্টবিবরণ
idINT (PK)অটো-ইনক্রিমেন্টপ্রাইমারি কী
nameVARCHAR(50)ইউনিক, নট নালমানুষের পড়ার উপযোগী নাম (যেমন, "Manage Posts")
slugVARCHAR(50)ইউনিক, নট নালমেশিন-রিডেবল কী (যেমন, "manage-posts")
http_methodVARCHAR(255)নালযোগ্যকমা দ্বারা পৃথক করা HTTP মেথড (যেমন, "GET,POST")
http_pathTEXTনালযোগ্যনিউলাইন দ্বারা পৃথক করা রাউট প্যাটার্ন (যেমন, "/posts*")
created_atTIMESTAMP
updated_atTIMESTAMP

বিশেষ মান:

  • slug = '*' → ওয়াইল্ডকার্ড পারমিশন (সবকিছুর সাথে মেলে)
  • http_path = '*' → সব পাথের সাথে মেলে
  • http_method = '' (খালি) → সমস্ত HTTP মেথডের সাথে মেলে
  • http_path ইনলাইন মেথড ওভাররাইড সাপোর্ট করে: GET,POST:/specific-path

admin_menu — সাইডবার মেনু আইটেম​

কলামটাইপকনস্ট্রেইন্টবিবরণ
idINT (PK)অটো-ইনক্রিমেন্টপ্রাইমারি কী
parent_idINTডিফল্ট 0প্যারেন্ট মেনু আইটেম ID (0 = রুট লেভেল)
orderINTডিফল্ট 0একই প্যারেন্টের মধ্যে সর্ট অর্ডার
titleVARCHAR(50)নট নালপ্রদর্শনের টাইটেল
iconVARCHAR(50)নট নালআইকন CSS ক্লাস (যেমন, "icon-users")
uriVARCHAR(255)নালযোগ্যরাউট URI (null/খালি = প্যারেন্ট ফোল্ডার, কোনো লিংক নেই)
permissionVARCHAR(255)নালযোগ্যডিরেক্ট পারমিশন স্লাগ বাইন্ডিং (ঐচ্ছিক)
created_atTIMESTAMP
updated_atTIMESTAMP

2.2 পিভট টেবিল (Many-to-Many জয়েন)​

admin_role_users — ইউজার ↔ রোল​

কলামটাইপইনডেক্স
role_idINTকম্পোজিট: (role_id, user_id)
user_idINTকম্পোজিট: (role_id, user_id)

admin_role_permissions — রোল ↔ পারমিশন​

কলামটাইপইনডেক্স
role_idINTকম্পোজিট: (role_id, permission_id)
permission_idINTকম্পোজিট: (role_id, permission_id)

admin_user_permissions — ইউজার ↔ পারমিশন (ডিরেক্ট)​

কলামটাইপইনডেক্স
user_idINTকম্পোজিট: (user_id, permission_id)
permission_idINTকম্পোজিট: (user_id, permission_id)

admin_role_menu — রোল ↔ মেনু​

কলামটাইপইনডেক্স
role_idINTকম্পোজিট: (role_id, menu_id)
menu_idINTকম্পোজিট: (role_id, menu_id)

admin_operation_log — অডিট ট্রেইল​

কলামটাইপকনস্ট্রেইন্টবিবরণ
idINT (PK)অটো-ইনক্রিমেন্টপ্রাইমারি কী
user_idINTইনডেক্সডযে অ্যাডমিন ইউজার অ্যাকশনটি সম্পাদন করেছেন
pathVARCHAR(255)নট নালরিকোয়েস্ট পাথ
methodVARCHAR(10)নট নালHTTP মেথড
ipVARCHAR(255)নট নালক্লায়েন্ট IP অ্যাড্রেস
inputTEXTনট নালJSON-এনকোডেড রিকোয়েস্ট পেলোড
created_atTIMESTAMP
updated_atTIMESTAMP

3. এনটিটি রিলেশনশিপ (ERD)​

admin_users ──M:N──▶ admin_roles ──M:N──▶ admin_permissions
│ │
│ │
└──M:N──▶ admin_permissions (direct user-permission)
│
admin_menu ──M:N──▶ admin_roles (menu visibility by role)
│
└──────▶ permission (column) (menu visibility by permission slug)

admin_operation_log ──N:1──▶ admin_users (audit trail)

রিলেশনশিপ সামারি:

রিলেশনশিপটাইপপিভট টেবিলের মাধ্যমে
ইউজার ↔ রোলM:Nadmin_role_users
ইউজার ↔ পারমিশন (ডিরেক্ট)M:Nadmin_user_permissions
রোল ↔ পারমিশনM:Nadmin_role_permissions
রোল ↔ মেনুM:Nadmin_role_menu
মেনু → পারমিশন (ঐচ্ছিক)কলাম রেফারেন্সadmin_menu.permission
OperationLog → ইউজারN:1FK user_id

4. কোর এনটিটি​

4.1 অ্যাডমিনিস্ট্রেটর (ইউজার মডেল)​

অ্যাডমিন ইউজার মডেল যা ইমপ্লিমেন্ট করে:

  • স্ট্যান্ডার্ড অথেনটিকেশন (সেশন + রিমেম্বার টোকেনসহ লগইন/লগআউট)
  • সমস্ত পারমিশন-চেকিং মেথড প্রদানকারী HasPermissions ট্রেইট
  • roles() → BelongsToMany → Role
  • permissions() → BelongsToMany → Permission (ডিরেক্ট অ্যাসাইনমেন্ট)

4.2 রোল​

  • administrators() → BelongsToMany → Administrator
  • permissions() → BelongsToMany → Permission
  • menus() → BelongsToMany → Menu
  • can(slug) → রোলের নির্দিষ্ট পারমিশন আছে কিনা তা যাচাই করে
  • ডিলিটের সময়: স্বয়ংক্রিয়ভাবে সমস্ত অ্যাডমিনিস্ট্রেটর ও পারমিশন থেকে ডিট্যাচ হয়ে যায়

4.3 পারমিশন​

  • roles() → BelongsToMany → Role
  • shouldPassThrough(request) → বর্তমান HTTP রিকোয়েস্টটি এই পারমিশনের মেথড+পাথ প্যাটার্নের সাথে মেলে কিনা তা মূল্যায়ন করে
  • http_method কমা দ্বারা পৃথক করা স্ট্রিং হিসেবে সংরক্ষিত হয়, অ্যারে হিসেবে অ্যাক্সেস করা যায়
  • http_path নিউলাইন দ্বারা পৃথক করা প্যাটার্ন হিসেবে সংরক্ষিত হয়
  • ডিলিটের সময়: স্বয়ংক্রিয়ভাবে সমস্ত রোল থেকে ডিট্যাচ হয়ে যায়

4.4 মেনু​

  • ট্রি স্ট্রাকচার ব্যবহার করে (parent_id সেলফ-রেফারেন্সিং)
  • roles() → BelongsToMany → Role
  • permission কলাম → ঐচ্ছিক ডিরেক্ট পারমিশন স্লাগ
  • allNodes() → সমস্ত মেনু আইটেম রিট্রিভ করে, ঐচ্ছিকভাবে রোল eager-load করে
  • toTree() → ফ্ল্যাট রো থেকে নেস্টেড অ্যারে তৈরি করে
  • withPermission() → menu_bind_permission কনফিগ সক্রিয় আছে কিনা তা রিটার্ন করে

5. অথেনটিকেশন ফ্লো​

5.1 লগইন প্রক্রিয়া​

1. User visits /admin/auth/login
2. Submits username + password
3. AuthController validates input
4. Calls Auth::guard('admin')->attempt(credentials, remember)
5. On success: regenerate session, redirect to admin dashboard
6. On failure: increment rate limiter, show error

5.2 গার্ড কনফিগারেশন​

অ্যাডমিন প্যানেল তার নিজস্ব অথেনটিকেশন গার্ড ব্যবহার করে, যা মূল অ্যাপ্লিকেশন থেকে সম্পূর্ণ আলাদা:

Guard name: "admin"
Driver: session
Provider: "admin" (Eloquent provider using Administrator model)

এটি config/admin.php → auth.guards-এ কনফিগার করা থাকে এবং বুট টাইমে অ্যাপ্লিকেশনের auth.php কনফিগে মার্জ হয়ে যায়।

5.3 লগইন থ্রটলিং​

  • auth.throttle_logins (boolean) এর মাধ্যমে কনফিগারযোগ্য
  • auth.throttle_attempts → সর্বোচ্চ ব্যর্থ চেষ্টার সংখ্যা (ডিফল্ট: 5)
  • auth.throttle_timeout → লকআউট সময়কাল সেকেন্ডে (ডিফল্ট: 900)

6. পারমিশন রেজোলিউশন অ্যালগরিদম​

এটিই মূল অ্যালগরিদম যা নির্ধারণ করে একজন ইউজারের নির্দিষ্ট একটি রাউটে অ্যাক্সেস আছে কিনা।

6.1 মিডলওয়্যার এক্সিকিউশন অর্ডার​

প্রতিটি অ্যাডমিন রিকোয়েস্ট এই মিডলওয়্যার পাইপলাইনের মধ্য দিয়ে যায় (ক্রমানুসারে):

1. admin.auth → Is user logged in? If not, redirect to login.
2. admin.throttle → Rate limiting for requests.
3. admin.pjax → PJAX support (partial page loads).
4. admin.log → Log the operation to audit trail.
5. admin.bootstrap → Run admin bootstrap file.
6. admin.permission → CHECK PERMISSIONS (described below).

6.2 পারমিশন চেক অ্যালগরিদম (সিউডোকোড)​

function handlePermissionCheck(request):
// Step 1: Global disable check
IF config('check_route_permission') is FALSE:
RETURN pass // All permissions disabled globally

// Step 2: Skip if no authenticated user, or if route has explicit middleware args
IF no authenticated user OR route has explicit permission middleware args:
RETURN pass

// Step 3: Check exempted routes
IF request.path matches any exempt route:
RETURN pass

// Exempt routes (always accessible):
// - auth/login
// - auth/logout
// - _handle_action_
// - _handle_form_
// - _handle_selectable_
// - _handle_renderable_
// - Any paths in config('auth.excepts')

// Step 4: Check route-level middleware permission
IF route has middleware starting with "admin.permission:":
Extract method and args from middleware string
// e.g., "admin.permission:allow,administrator,editor"
// method = "allow", args = ["administrator", "editor"]
// e.g., "admin.permission:check,manage-posts"
// method = "check", args = ["manage-posts"]
// e.g., "admin.permission:deny,guest"
// method = "deny", args = ["guest"]
Call Permission::{method}(args)
RETURN pass (method throws 403 on failure)

// Step 5: Resolve ALL user permissions and match against request
allPermissions = getUserAllPermissions(user)
// This merges:
// a) Direct user permissions (admin_user_permissions pivot)
// b) Role-inherited permissions (user → roles → permissions)

FOR EACH permission IN allPermissions:
IF permission.shouldPassThrough(request):
RETURN pass

// Step 6: No matching permission found
RETURN 403 error page

6.3 allPermissions() রেজোলিউশন​

function getUserAllPermissions(user):
// Get permissions from all user's roles
rolePermissions = user.roles
.eagerLoad('permissions')
.flatMap(role => role.permissions)

// Get direct user permissions
directPermissions = user.permissions

// Merge both sources
RETURN rolePermissions.merge(directPermissions)

6.4 shouldPassThrough(request) — পারমিশন-থেকে-রিকোয়েস্ট ম্যাচিং​

function shouldPassThrough(permission, request):
// If permission has no method AND no path, it passes everything
IF permission.http_method is EMPTY AND permission.http_path is EMPTY:
RETURN true

// Parse each path line
FOR EACH path_line IN permission.http_path.split("\n"):
method = permission.http_method // e.g., ["GET", "POST"]
path = path_line

// Check for inline method override (e.g., "GET,POST:/users")
IF path contains ":":
[method_override, path] = path.split(":")
method = method_override.split(",")

// Prepend the admin route prefix
full_path = config('route.prefix') + path // e.g., "admin/users*"

// Match request path using wildcard matching
IF request.pathMatches(full_path):
// If no methods specified, any method matches
IF method is EMPTY:
RETURN true
// Otherwise, check the HTTP method matches
IF request.method IN method.map(uppercase):
RETURN true

RETURN false

6.5 সুপার-অ্যাডমিনিস্ট্রেটর বাইপাস​

কোনো পারমিশন চেক করার আগে, সিস্টেম যাচাই করে:

function isAdministrator(user):
RETURN user.roles.any(role => role.slug == "administrator")

যদি true হয়, তাহলে সমস্ত পারমিশন চেক স্কিপ করা হয় — অ্যাডমিনিস্ট্রেটরের অবাধ অ্যাক্সেস থাকে।


7. মেনু ভিজিবিলিটি অ্যালগরিদম​

সাইডবার মেনু একটি ট্রি স্ট্রাকচার থেকে রেন্ডার করা হয়। প্রদর্শিত হওয়ার আগে প্রতিটি মেনু আইটেমকে দুটি ভিজিবিলিটি চেক পার হতে হয়।

7.1 মেনু বিল্ডিং প্রক্রিয়া​

1. Load all menu items from admin_menu table, ordered by (parent_id, order)
2. If config('check_menu_roles') is true, eager-load roles relationship
3. Build nested tree array from flat rows using parent_id
4. Render tree recursively; for each item, apply visibility filter

7.2 ভিজিবিলিটি চেক (প্রতি মেনু আইটেমে)​

প্রতিটি মেনু আইটেম একটি ভিজিবিলিটি চেকের মধ্যে র‍্যাপ করা থাকে:

function isMenuItemVisible(user, menuItem):
// Check 1: Role-based visibility
IF NOT user.visible(menuItem.roles):
RETURN false

// Check 2: Permission-based visibility
IF NOT user.can(menuItem.permission):
RETURN false

RETURN true

7.3 user.visible(roles) অ্যালগরিদম​

function visible(user, roles):
// If no roles are assigned to the menu item, it's visible to everyone
IF roles is EMPTY:
RETURN true

// Extract role slugs
roleSlugs = roles.map(r => r.slug)

// User sees it if they have ANY of the required roles, OR if they're admin
RETURN user.inRoles(roleSlugs) OR user.isAdministrator()

7.4 user.can(permission) অ্যালগরিদম​

function can(user, permissionSlug):
// Empty/null permission means no restriction
IF permissionSlug is EMPTY:
RETURN true

// Administrators bypass all checks
IF user.isAdministrator():
RETURN true

// Check direct user permissions
IF user.permissions.any(p => p.slug == permissionSlug):
RETURN true

// Check role-inherited permissions
IF user.roles.flatMap(r => r.permissions).any(p => p.slug == permissionSlug):
RETURN true

RETURN false

7.5 চাইল্ডসহ মেনু আইটেম​

যখন একটি মেনু আইটেমের চাইল্ড থাকে, তখন এটি একটি কোলাপসিবল ফোল্ডার হিসেবে কাজ করে। প্যারেন্টের ভিজিবিলিটি পুরো গ্রুপকে নিয়ন্ত্রণ করে। রিকার্সিভ রেন্ডারিংয়ের মাধ্যমে প্রতিটি চাইল্ডেরও নিজস্ব স্বতন্ত্র ভিজিবিলিটি চেক থাকে।

Render each menu item:
IF isMenuItemVisible(user, item):
IF item has children:
Render as collapsible parent
FOR EACH child IN item.children:
Recursively render child (with its own visibility check)
ELSE:
Render as clickable link

7.6 মেনু পারমিশন বাইন্ডিং​

কনফিগে menu_bind_permission true থাকলে, মেনু ম্যানেজমেন্ট UI-তে একটি পারমিশন ড্রপডাউন দেখানো হয়, যা অ্যাডমিনদের একটি পারমিশন স্লাগ সরাসরি মেনু আইটেমের সাথে বাইন্ড করতে দেয়। এটি দুই-স্তরের নিয়ন্ত্রণ প্রদান করে:

  • স্তর 1 (রোল): কোন কোন রোল এই মেনু আইটেমটি দেখতে পারবে? (admin_role_menu পিভটের মাধ্যমে)
  • স্তর 2 (পারমিশন): ইউজারের কাছে কি এই নির্দিষ্ট পারমিশনটিও আছে? (admin_menu.permission কলামের মাধ্যমে)

মেনু আইটেমটি প্রদর্শিত হওয়ার জন্য উভয় চেকই পাস করতে হবে।


8. মিডলওয়্যার পাইপলাইন​

8.1 সম্পূর্ণ মিডলওয়্যার স্ট্যাক​

admin মিডলওয়্যার গ্রুপ সমস্ত অ্যাডমিন রাউটে চলে:

ক্রমমিডলওয়্যারঅ্যালিয়াসউদ্দেশ্য
1Authenticateadmin.authগেস্টদের লগইন পেজে রিডাইরেক্ট করে
2Throttleadmin.throttleরিকোয়েস্ট রেট-লিমিট করে
3Pjaxadmin.pjaxPJAX পার্শিয়াল পেজ লোড হ্যান্ডেল করে
4LogOperationadmin.logoperation_log টেবিলে লেখে
5Bootstrapadmin.bootstrapঅ্যাডমিন বুটস্ট্র্যাপ ফাইল এক্সিকিউট করে
6Permissionadmin.permissionরাউট পারমিশন চেক করে (মূল RBAC)

8.2 অথেনটিকেশন মিডলওয়্যার বিস্তারিত​

function authenticate(request):
Set default auth guard to "admin"

IF user is guest AND request is not in exempt list:
Redirect to login page

RETURN next(request)

অব্যাহতিপ্রাপ্ত রাউট (লগইনের প্রয়োজন নেই):

  • config('auth.excepts')-এ তালিকাভুক্ত রাউট — ডিফল্ট: auth/login, auth/logout

8.3 অপারেশন লগ মিডলওয়্যার বিস্তারিত​

function logOperation(request):
IF logging is enabled
AND request path is not in except list
AND request method is in allowed methods
AND user is authenticated:

Record to admin_operation_log:
user_id, path, method, ip, input (JSON)

Filter sensitive fields from input:
token → "*****-filtered-out-*****"
password → "*****-filtered-out-*****"

RETURN next(request)

9. পারমিশন চেকিং মেথড​

সিস্টেমটি তিনটি হাই-লেভেল পারমিশন চেকিং মেথড প্রদান করে, যেগুলো মিডলওয়্যার অথবা কন্ট্রোলার কোডে ব্যবহার করা যায়:

9.1 Permission::check(slugs) — পারমিশন স্লাগ চেক করা​

Verifies user holds specific permission slug(s).
If user doesn't have the permission → 403 error.
Administrator role → always passes.

Usage in middleware: admin.permission:check,manage-posts
Usage in controller: Permission::check('manage-posts')
Usage with multiple: Permission::check(['manage-posts', 'view-users'])

9.2 Permission::allow(roles) — নির্দিষ্ট রোল অনুমোদন করা​

Allows only users with specific role slug(s).
If user doesn't have any of the roles → 403 error.
Administrator role → always passes.

Usage in middleware: admin.permission:allow,administrator,editor
Usage in controller: Permission::allow(['editor', 'writer'])

9.3 Permission::deny(roles) — নির্দিষ্ট রোল প্রত্যাখ্যান করা​

Blocks users with specific role slug(s).
If user HAS any of the roles → 403 error.
Administrator role → always passes (even if listed in deny).

Usage in middleware: admin.permission:deny,guest
Usage in controller: Permission::deny(['guest', 'viewer'])

9.4 Permission::free() — কোনো পারমিশন চেক নেই​

Explicitly marks a route as free from permission checking.

Usage in middleware: admin.permission:free
Always returns true.

9.5 ইউজার-লেভেল চেক মেথড​

ইউজার মডেল ইনস্ট্যান্সে উপলব্ধ:

মেথডরিটার্ন করেবিবরণ
user.can(slug)boolইউজারের কি এই পারমিশনটি আছে (ডিরেক্ট বা রোলের মাধ্যমে)?
user.cannot(slug)boolcan()-এর বিপরীত
user.isRole(slug)boolইউজারের কি এই রোলটি আছে?
user.inRoles([slugs])boolইউজারের কি এই রোলগুলোর যেকোনো একটি আছে?
user.isAdministrator()boolইউজার কি "administrator" রোলে আছেন?
user.visible(roles[])boolইউজার কি এই রোলগুলোর জন্য দৃশ্যমান? (খালি = সবার জন্য দৃশ্যমান)
user.allPermissions()listডিরেক্ট + রোল-ইনহেরিটেড থেকে একত্রিত সমস্ত পারমিশন

10. অ্যাক্সেস প্রদান ও প্রত্যাহার​

10.1 অ্যাডমিন UI-এর মাধ্যমে — বিল্ট-ইন ম্যানেজমেন্ট পেজ​

অ্যাডমিন প্যানেল Auth মেনু সেকশনের অধীনে চারটি CRUD পেজ প্রদান করে:

ইউজার ম্যানেজমেন্ট (/admin/auth/users)​

  • অ্যাডমিন ইউজার অ্যাকাউন্ট তৈরি/এডিট করুন
  • মাল্টি-সিলেক্ট ড্রপডাউনের মাধ্যমে রোল অ্যাসাইন করুন
  • মাল্টি-সিলেক্ট ড্রপডাউনের মাধ্যমে ডিরেক্ট পারমিশন অ্যাসাইন করুন
  • সংরক্ষণের আগে পাসওয়ার্ড bcrypt দিয়ে হ্যাশ করা হয়
  • প্রথম ইউজার (ID=1) ডিলিট করা যায় না (সুরক্ষা)

রোল ম্যানেজমেন্ট (/admin/auth/roles)​

  • নাম ও স্লাগসহ রোল তৈরি/এডিট করুন
  • লিস্টবক্সের (ডুয়াল-পেন সিলেক্টর) মাধ্যমে রোলে পারমিশন অ্যাসাইন করুন
  • "administrator" রোল ডিলিট করা যায় না (সুরক্ষা)
  • একটি রোল ডিলিট করলে তা স্বয়ংক্রিয়ভাবে সমস্ত ইউজার ও পারমিশন থেকে ডিট্যাচ হয়ে যায়

পারমিশন ম্যানেজমেন্ট (/admin/auth/permissions)​

  • নাম, স্লাগ, HTTP মেথড এবং HTTP পাথসহ পারমিশন তৈরি/এডিট করুন
  • HTTP মেথড: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD থেকে মাল্টি-সিলেক্ট
  • HTTP পাথ: নিউলাইন দ্বারা পৃথক করা প্যাটার্নের জন্য টেক্সটএরিয়া
  • প্রতি পাথে ইনলাইন মেথড ওভাররাইড সাপোর্ট করে: GET,POST:/specific-path
  • একটি পারমিশন ডিলিট করলে তা স্বয়ংক্রিয়ভাবে সমস্ত রোল থেকে ডিট্যাচ হয়ে যায়

মেনু ম্যানেজমেন্ট (/admin/auth/menu)​

  • স্প্লিট-পেন: ট্রি ভিউ (বাম) + ক্রিয়েট ফর্ম (ডান)
  • ট্রির মধ্যে ড্র্যাগ-অ্যান্ড-ড্রপ রিঅর্ডারিং
  • প্রতিটি মেনু আইটেমে অ্যাসাইন করা যায়:
    • প্যারেন্ট (নেস্টিংয়ের জন্য)
    • টাইটেল + আইকন + URI
    • রোল (মাল্টি-সিলেক্ট: কোন কোন রোল এই আইটেমটি দেখতে পারবে)
    • পারমিশন (ড্রপডাউন: ঐচ্ছিক পারমিশন স্লাগ বাইন্ডিং, শুধু menu_bind_permission সক্রিয় থাকলে)

10.2 প্রোগ্রাম্যাটিক অ্যাক্সেস ম্যানেজমেন্ট​

একজন ইউজারকে রোল প্রদান করা​

user.roles().attach(roleId)
// or
user.roles().sync([roleId1, roleId2]) // replaces all

একজন ইউজার থেকে রোল প্রত্যাহার করা​

user.roles().detach(roleId)

একটি রোলকে পারমিশন প্রদান করা​

role.permissions().attach(permissionId)

একটি রোল থেকে পারমিশন প্রত্যাহার করা​

role.permissions().detach(permissionId)

একজন ইউজারকে ডিরেক্ট পারমিশন প্রদান করা​

user.permissions().attach(permissionId)

একজন ইউজার থেকে ডিরেক্ট পারমিশন প্রত্যাহার করা​

user.permissions().detach(permissionId)

একটি মেনু আইটেম নির্দিষ্ট রোলে অ্যাসাইন করা​

menu.roles().sync([roleId1, roleId2])

একটি মেনু আইটেম থেকে রোল সীমাবদ্ধতা সরানো​

menu.roles().detach() // visible to all roles again

10.3 ডিলিটের সময় ক্যাসকেড বিহেভিয়ার​

ডিলিটকৃত এনটিটিস্বয়ংক্রিয় ক্লিনআপ
ইউজারসমস্ত রোল ডিট্যাচ, সমস্ত ডিরেক্ট পারমিশন ডিট্যাচ
রোলসমস্ত ইউজার ডিট্যাচ, সমস্ত পারমিশন ডিট্যাচ
পারমিশনসমস্ত রোল ডিট্যাচ
মেনুসমস্ত রোল ডিট্যাচ

11. অপারেশন অডিট লগ​

প্রতিটি অ্যাডমিন অ্যাকশন admin_operation_log-এ লগ করা হয়:

কী কী লগ করা হয়​

  • user_id — কে অ্যাকশনটি সম্পাদন করেছেন
  • path — রিকোয়েস্ট URI (255 অক্ষরে ট্রাংকেটেড)
  • method — HTTP মেথড (GET, POST, PUT, DELETE, ইত্যাদি)
  • ip — ক্লায়েন্ট IP অ্যাড্রেস (X-Forwarded-For প্রক্সি হেডার মেনে চলে)
  • input — সংবেদনশীল ফিল্ড ফিল্টার করা JSON-এনকোডেড রিকোয়েস্ট বডি

কনফিগারেশন​

operation_log:
enable: true/false
allowed_methods: [GET, POST, PUT, DELETE, ...] # Which methods to log
except: ["admin/auth/logs*"] # Paths to exclude from logging
filter_input: # Fields to mask in logged input
token: "*****-filtered-out-*****"
password: "*****-filtered-out-*****"

লগ কোয়েরি ফরম্যাট​

except কনফিগে মেথড প্রিফিক্স ফিল্টারিং সাপোর্ট করে:

  • admin/auth/logs* → admin/auth/logs* প্যাটার্নের সাথে মেলা পাথের সমস্ত মেথড বাদ দেয়
  • get:admin/dashboard → শুধুমাত্র admin/dashboard-এ GET রিকোয়েস্ট বাদ দেয়

12. কনফিগারেশন ফ্ল্যাগ​

সমস্ত কনফিগারেশন একটি একক কনফিগ ফাইলে (config/admin.php) থাকে:

কনফিগ কীটাইপডিফল্টবিবরণ
check_route_permissionbooltrueরাউট পারমিশন মিডলওয়্যার সম্পূর্ণভাবে সক্রিয়/নিষ্ক্রিয় করে
check_menu_rolesbooltrueভিজিবিলিটি ফিল্টারিংয়ের জন্য মেনু আইটেমে রোল eager-load করে
menu_bind_permissionbooltrueমেনু ম্যানেজমেন্ট পেজে পারমিশন বাইন্ডিং ড্রপডাউন দেখায়
auth.guardstringadminঅথেনটিকেশন গার্ডের নাম
auth.throttle_loginsbooltrueলগইন ব্রুট-ফোর্স সুরক্ষা সক্রিয় করে
auth.throttle_attemptsint5লকআউটের আগে সর্বোচ্চ ব্যর্থ লগইন চেষ্টা
auth.throttle_timeoutint900লকআউট সময়কাল সেকেন্ডে
auth.rememberbooltrueলগইন ফর্মে "remember me" চেকবক্স দেখায়
auth.redirect_tostringauth/loginঅননুমোদিত ইউজারদের কোথায় রিডাইরেক্ট করা হবে
auth.exceptsarray[auth/login, auth/logout]অথ চেক থেকে অব্যাহতিপ্রাপ্ত রাউট
operation_log.enablebooltrueঅপারেশন অডিট লগিং সক্রিয় করে
route.prefixstringadminসমস্ত অ্যাডমিন রাউটের জন্য URL প্রিফিক্স

13. ডিফল্ট সিড ডেটা​

ইনস্টলেশনের সময়, সিস্টেম তৈরি করে:

ডিফল্ট ইউজার​

ফিল্ডমান
usernameadmin
passwordadmin (হ্যাশ)
nameAdministrator

ডিফল্ট রোল​

ফিল্ডমান
nameAdministrator
slugadministrator

ডিফল্ট ইউজারকে administrator রোল অ্যাসাইন করা হয়।

ডিফল্ট পারমিশন​

নামস্লাগHTTP মেথডHTTP পাথ
All permission*(যেকোনো)*
DashboarddashboardGET/
Loginauth.login(যেকোনো)/auth/login + /auth/logout
User settingauth.settingGET,PUT/auth/setting
Auth managementauth.management(যেকোনো)/auth/roles + /auth/permissions + /auth/menu + /auth/logs

administrator রোলকে * (All permission) পারমিশন অ্যাসাইন করা হয়।

ডিফল্ট মেনু আইটেম​

টাইটেলপ্যারেন্টআইকনURIঅর্ডার
Dashboard(রুট)icon-chart-bar/1
Admin(রুট)icon-server(কোনোটি নেই — ফোল্ডার)2
UsersAdminicon-usersauth/users3
RolesAdminicon-userauth/roles4
PermissionAdminicon-banauth/permissions5
MenuAdminicon-barsauth/menu6
Operation logAdminicon-historyauth/logs7

"Admin" মেনু ফোল্ডারটি administrator রোলে অ্যাসাইন করা হয়।


14. পোর্টিংয়ের জন্য API রেফারেন্স​

অন্য কোনো ভাষা/ফ্রেমওয়ার্কে এই সিস্টেমটি ইমপ্লিমেন্ট করার সময়, আপনাকে এই কোর ইন্টারফেসগুলো ইমপ্লিমেন্ট করতে হবে:

14.1 ইউজার মডেল ইন্টারফেস​

interface IAdminUser:
// Relationships
roles() → ManyToMany<Role>
permissions() → ManyToMany<Permission> // direct

// Permission checks
can(slug: string) → bool
cannot(slug: string) → bool
isRole(slug: string) → bool
inRoles(slugs: string[]) → bool
isAdministrator() → bool
visible(roles: Role[]) → bool
allPermissions() → Permission[]

14.2 রোল মডেল ইন্টারফেস​

interface IRole:
// Relationships
administrators() → ManyToMany<User>
permissions() → ManyToMany<Permission>
menus() → ManyToMany<Menu>

// Permission checks
can(slug: string) → bool
cannot(slug: string) → bool

14.3 পারমিশন মডেল ইন্টারফেস​

interface IPermission:
// Properties
slug: string
http_method: string[] // stored as comma-separated, accessed as array
http_path: string // newline-separated patterns

// Relationships
roles() → ManyToMany<Role>

// Route matching
shouldPassThrough(request: HttpRequest) → bool

14.4 মেনু মডেল ইন্টারফেস​

interface IMenu:
// Properties
parent_id: int // 0 = root
order: int
title: string
icon: string
uri: string?
permission: string? // permission slug

// Relationships
roles() → ManyToMany<Role>

// Tree operations
allNodes() → MenuNode[]
toTree() → NestedMenuNode[]
withPermission() → bool

14.5 পারমিশন মিডলওয়্যার ইন্টারফেস​

interface IPermissionMiddleware:
handle(request, next):
// Implement the algorithm from Section 6.2

static check(slugs: string[]) → void | throw 403
static allow(roles: string[]) → void | throw 403
static deny(roles: string[]) → void | throw 403
static free() → true

14.6 অপারেশন লগ ইন্টারফেস​

interface IOperationLog:
user_id: int
path: string
method: string
ip: string
input: string // JSON

15. প্ল্যাটফর্ম অনুযায়ী ইমপ্লিমেন্টেশন চেকলিস্ট​

RBAC সিস্টেম পোর্ট করার সময় এই চেকলিস্টটি ব্যবহার করুন:

ডাটাবেস লেয়ার​

  • সমস্ত 9টি ডাটাবেস টেবিল তৈরি করুন (4টি প্রাইমারি + 4টি পিভট + 1টি লগ)
  • কনফিগারযোগ্য টেবিল নাম ইমপ্লিমেন্ট করুন
  • সিড ডেটা তৈরি করুন (ডিফল্ট ইউজার, রোল, পারমিশন, মেনু)
  • এনটিটি ডিলিটের সময় ক্যাসকেড ক্লিনআপ ইমপ্লিমেন্ট করুন

মডেল / এনটিটি​

  • রোল/পারমিশন রিলেশনশিপ এবং HasPermissions ট্রেইটসহ AdminUser
  • ইউজার/পারমিশন/মেনু রিলেশনশিপসহ Role
  • রোল রিলেশনশিপ এবং রাউট-ম্যাচিং লজিকসহ Permission
  • রোল রিলেশনশিপ এবং ট্রি-বিল্ডিং লজিকসহ Menu
  • ইউজার রিলেশনশিপসহ OperationLog

অথেনটিকেশন​

  • অ্যাডমিনের জন্য পৃথক অথ গার্ড/প্রোভাইডার (অ্যাপ ইউজারদের থেকে আলাদা)
  • "remember me" সাপোর্টসহ সেশন-ভিত্তিক অথ
  • লগইন থ্রটলিং / ব্রুট-ফোর্স সুরক্ষা
  • লগইন, লগআউট এবং ইউজার সেটিংস পেজ

অথরাইজেশন মিডলওয়্যার​

  • অথ মিডলওয়্যার (গেস্টদের লগইনে রিডাইরেক্ট করে)
  • সম্পূর্ণ রেজোলিউশন অ্যালগরিদম ইমপ্লিমেন্ট করা পারমিশন মিডলওয়্যার
  • রাউট-লেভেল মিডলওয়্যার প্যারামিটারের (allow, deny, check, free) সাপোর্ট
  • কনফিগারযোগ্য অব্যাহতিপ্রাপ্ত রাউট (পারমিশন চেকিং বাইপাস করে)
  • অ্যাডমিনিস্ট্রেটর রোল সমস্ত চেক বাইপাস করে

মেনু সিস্টেম​

  • ট্রি বিল্ডার (parent_id-এর মাধ্যমে ফ্ল্যাট রো → নেস্টেড স্ট্রাকচার)
  • প্রতি মেনু আইটেমে রোল-ভিত্তিক ভিজিবিলিটি ফিল্টারিং
  • প্রতি মেনু আইটেমে ঐচ্ছিক পারমিশন-ভিত্তিক ভিজিবিলিটি
  • ড্র্যাগ-অ্যান্ড-ড্রপ রিঅর্ডারিং (ফ্রন্ট-এন্ড)

অডিট লগিং​

  • operation_log টেবিলে সমস্ত রিকোয়েস্ট লগ করুন
  • কনফিগারযোগ্য মেথড ফিল্টারিং
  • কনফিগারযোগ্য পাথ এক্সক্লুশন
  • রিকোয়েস্ট ইনপুটে সংবেদনশীল ফিল্ড মাস্কিং

অ্যাডমিন UI পেজ​

  • ইউজার CRUD (রোল + ডিরেক্ট পারমিশন অ্যাসাইনমেন্টসহ)
  • রোল CRUD (লিস্টবক্সের মাধ্যমে পারমিশন অ্যাসাইনমেন্টসহ)
  • পারমিশন CRUD (HTTP মেথড + পাথ ফিল্ডসহ)
  • মেনু ম্যানেজমেন্ট (ট্রি ভিউ + ক্রিয়েট/এডিট ফর্ম + রোল অ্যাসাইনমেন্ট)
  • অপারেশন লগ ভিউয়ার

প্ল্যাটফর্ম-নির্দিষ্ট নোট​

ASP.NET C#​

  • পৃথক অ্যাডমিন গার্ডের জন্য ClaimsIdentity / কাস্টম AuthenticationHandler ব্যবহার করুন
  • মিডলওয়্যার পাইপলাইন (IMiddleware) হিসেবে ইমপ্লিমেন্ট করুন
  • many-to-many রিলেশনশিপের জন্য Fluent API-সহ Entity Framework Core ব্যবহার করুন
  • পলিসি-ভিত্তিক চেকের জন্য IAuthorizationHandler + IAuthorizationRequirement ব্যবহার করার কথা বিবেচনা করুন

Node.js (Express/NestJS)​

  • আলাদা অ্যাডমিন অথের জন্য Passport.js অথবা কাস্টম সেশন স্ট্র্যাটেজি ব্যবহার করুন
  • পারমিশন পাইপলাইনের জন্য Express মিডলওয়্যার চেইন
  • M:N through টেবিলসহ ORM-এর জন্য Sequelize অথবা Prisma
  • NestJS: ডিক্লারেটিভ পারমিশন চেকের জন্য Guards + Decorators ব্যবহার করুন

Python (Django)​

  • অ্যাডমিন অথের জন্য একটি কাস্টম AuthenticationBackend ব্যবহার করুন
  • পাইপলাইনের জন্য Django মিডলওয়্যার ক্লাস
  • পিভট টেবিলের জন্য through মডেলসহ Django ORM ManyToManyField
  • ভিউয়ের জন্য কাস্টম @permission_required ডেকোরেটর

Java (Spring Boot)​

  • অ্যাডমিনের জন্য একটি পৃথক AuthenticationProvider এবং SecurityFilterChain ব্যবহার করুন
  • Spring Security ফিল্টার চেইনে OncePerRequestFilter হিসেবে ইমপ্লিমেন্ট করুন
  • পিভট রিলেশনশিপের জন্য @JoinTable-সহ JPA @ManyToMany
  • ডিক্লারেটিভ পারমিশন চেকের জন্য কাস্টম @PreAuthorize অ্যানোটেশন

পরিশিষ্ট: রিকোয়েস্ট ফ্লো ডায়াগ্রাম​

HTTP Request to /admin/posts
│
▼
┌─────────────────────────────┐
│ 1. admin.auth │ → Is user logged in?
│ IF guest → redirect │ No → /admin/auth/login
│ to login page │ Yes → continue
└────────────┬────────────────┘
▼
┌─────────────────────────────┐
│ 2. admin.throttle │ → Rate limit check
└────────────┬────────────────┘
▼
┌─────────────────────────────┐
│ 3. admin.pjax │ → PJAX header handling
└────────────┬────────────────┘
▼
┌─────────────────────────────┐
│ 4. admin.log │ → Write to operation_log
│ {user, path, method, │
│ ip, filtered_input} │
└────────────┬────────────────┘
▼
┌─────────────────────────────┐
│ 5. admin.bootstrap │ → Run bootstrap.php
└────────────┬────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ 6. admin.permission │
│ │
│ IF check_route_permission disabled → PASS │
│ IF route in exempt list → PASS │
│ IF user.isAdministrator() → PASS │
│ │
│ IF route has explicit middleware (e.g., allow/deny): │
│ Execute that specific check │
│ ELSE: │
│ Resolve allPermissions (direct + role-based) │
│ FOR EACH permission: │
│ Match http_method + http_path against request │
│ IF match → PASS │
│ No match found → 403 DENY │
└────────────┬────────────────────────────────────────────┘
▼
┌─────────────────────────────┐
│ Controller Action │ → Render page
│ (with optional in-code │
│ Permission::check()) │
└─────────────────────────────┘

এই ডকুমেন্টটি Super Admin কোডবেসের উপর ভিত্তি করে তৈরি, যা laravel-admin এবং open-admin থেকে তার RBAC আর্কিটেকচার উত্তরাধিকারসূত্রে পেয়েছে। এই ডিজাইনটি হাজার হাজার Laravel অ্যাপ্লিকেশনে প্রোডাকশনে ব্যবহৃত হচ্ছে।