使用 Nest.js 設計 RBAC 權限系統：逐步指南-js教程-PHP中文網

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide

前言

對於後端管理系統，存取控制和個人化使用者介面等功能至關重要。例如，超級管理員可以查看所有頁面，一般使用者可以造訪A、B頁面，VIP使用者可以查看A、B、C、D頁面。這些功能背後的邏輯是基於三個關鍵概念的設計：

使用者：基本單位，如Alice、Bob、Charlie。
角色：使用者可以擁有一個或多個角色。例如，Alice 可能同時擁有普通用戶和 VIP 的角色。
權限：一個角色關聯多個權限。例如，VIP角色可能具有檢視、編輯和新增的權限，而超級管理員可以檢視、編輯、新增和刪除。

關係可以用下圖來說明：

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide

接下來，我們將使用Nest從頭開始實現這樣一個系統的基礎－權限設計。

建立資料庫

首先，我們需要建立資料庫。我們將使用 MySQL 資料庫並執行以下命令來建立它：

CREATE DATABASE `nest-database` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

登入後複製

專案初始化

我們將透過執行以下命令啟動一個新的 Nest 專案：

nest new nest-project

登入後複製

然後，安裝必要的資料庫依賴項，主要是 typeorm 和 mysql2：

npm install --save @nestjs/typeorm typeorm mysql2

登入後複製

接下來，在app.module.ts中配置typeorm：

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { TypeOrmModule } from '@nestjs/typeorm';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'mysql',
      host: 'localhost',
      port: 3306,
      username: 'root',
      password: 'password',
      database: 'nest-database',
      synchronize: true,
      logging: true,
      entities: [__dirname + '/**/*.entity{.ts,.js}'],
      poolSize: 10,
      connectorPackage: 'mysql2',
    }),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

登入後複製

桌子設計

通常，RBAC（基於角色的存取控制）系統將有 5 個表，如下所示：

使用者表（使用者）：儲存使用者基本訊息，如使用者名稱、密碼和電子郵件。
角色表（角色）：儲存角色詳細信息，例如角色名稱和角色代碼。
權限表（權限）：儲存權限詳細信息，例如權限名稱和權限代碼。
使用者角色關係表（user_role_relation）：追蹤使用者和角色之間的關係。
角色權限關係表（role_permission_relation）：追蹤角色和權限之間的關係。

領域模型可以視覺化如下：

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide

接下來，我們將在 Nest 中建立三個非關係表並定義它們的關係。

使用者.實體.ts：

CREATE DATABASE `nest-database` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

登入後複製

在User表中，定義了roles欄位來連接user_role_relation表。關係邏輯為：user.id === userRoleRelation.userId 和 role.id === userRoleRelation.roleId。匹配的角色記錄會自動連結到使用者。

角色.實體.ts：

nest new nest-project

登入後複製

角色表中的權限欄位的工作原理類似。它使用以下邏輯與 role_permission_relation 表連接： role.id === rolePermissionRelation.roleId 和permission.id === rolePermissionRelation.permissionId。

權限.entity.ts:

npm install --save @nestjs/typeorm typeorm mysql2

登入後複製

權限表沒有關係；它只是記錄可用的權限。

資料初始化

這是一個用來初始化一些測試資料的服務：

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { TypeOrmModule } from '@nestjs/typeorm';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'mysql',
      host: 'localhost',
      port: 3306,
      username: 'root',
      password: 'password',
      database: 'nest-database',
      synchronize: true,
      logging: true,
      entities: [__dirname + '/**/*.entity{.ts,.js}'],
      poolSize: 10,
      connectorPackage: 'mysql2',
    }),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

登入後複製

透過瀏覽器或Postman執行initData服務，資料將填入資料庫。

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide