moyan-mfw-base 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moyan MFW
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# moyan-mfw-base
+
+墨焱 MFW 核心框架包，为后台管理系统提供开箱即用的全栈能力。
+
+## 安装
+
+```bash
+npm install moyan-mfw-base
+# or
+pnpm add moyan-mfw-base
+```
+
+## 入口模块
+
+| 入口 | 路径 | 说明 |
+|------|------|------|
+| `moyan-mfw-base/backend` | NestJS 后端框架 | Guards、Interceptors、Filters、Decorators、Entities、Services |
+| `moyan-mfw-base/frontend` | Vue 3 前端框架 | 组件库、Store、Composables、Directives、主题系统 |
+| `moyan-mfw-base/shared` | 共享层 | 字典框架、类型定义 |
+
+## 快速开始
+
+### 后端
+
+```typescript
+import { createBaseBackendApp } from 'moyan-mfw-base/backend';
+
+const app = await createBaseBackendApp({
+  modules: [],          // 业务模块
+  providers: [],        // 自定义 Provider
+  permissions: {},      // 权限编码
+  appTypesConfig: {},   // 应用类型配置
+  swagger: { title: 'My API', version: '1.0' },
+});
+
+await app.listen(3000);
+```
+
+### 前端
+
+```typescript
+import { createBaseAdminApp } from 'moyan-mfw-base/frontend';
+
+const app = createBaseAdminApp({
+  pageConfigs: {},      // 页面路由配置
+  permissions: {},      // 前端权限编码
+  theme: 'default',     // 主题包
+  modules: [],          // 业务模块
+});
+
+app.mount('#app');
+```
+
+### 共享层（字典）
+
+```typescript
+import { DictMeta, DictEntry, toItems } from 'moyan-mfw-base/shared';
+
+@DictMeta({ name: 'gender' })
+class Gender {
+  @DictEntry({ label: '男', value: 1 })
+  static MALE: number;
+
+  @DictEntry({ label: '女', value: 2 })
+  static FEMALE: number;
+}
+
+const items = toItems(Gender); // [{ label: '男', value: 1 }, { label: '女', value: 2 }]
+```
+
+## 核心特性
+
+- **权限体系**：RBAC + BigInt 位运算，支持到按钮级别的细粒度控制
+- **多租户**：应用类型 / 应用实例 / 角色三级隔离
+- **审计日志**：`@AuditLog` 装饰器自动记录操作日志
+- **分页查询**：`PaginationX` 链式 API，TypeORM 原生集成
+- **前端路由**：`import.meta.glob` 自动扫描页面配置，零手动注册
+- **主题系统**：9 套内置主题（`getTheme` / `useColorMode` / `useThemeSwitch`）
+- **字典框架**：装饰器式定义，前后端同构渲染
+- **软删除**：Base 实体自带 `createdAt` / `updatedAt` / `deletedAt`
+
+## 文档
+
+- [后端 API 参考](../../docs/api-reference/backend/README.md)
+- [前端 API 参考](../../docs/api-reference/frontend/README.md)
+- [共享层 API 参考](../../docs/api-reference/shared/README.md)
+- [开发规范](../../docs/development-standards/README.md)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "moyan-mfw-base",
+  "version": "1.0.0",
+  "description": "墨焱MFW核心框架",
+  "main": "./src/shared/dist/index.js",
+  "types": "./src/shared/dist/index.d.ts",
+  "exports": {
+    "./backend": {
+      "import": "./src/backend/dist/index.js",
+      "require": "./src/backend/dist/index.js",
+      "types": "./src/backend/dist/index.d.ts"
+    },
+    "./backend/*": {
+      "import": "./src/backend/dist/*.js",
+      "require": "./src/backend/dist/*",
+      "types": "./src/backend/dist/*.d.ts"
+    },
+    "./frontend": {
+      "import": "./src/frontend/dist/index.mjs",
+      "require": "./src/frontend/dist/index.js",
+      "types": "./src/frontend/dist/index.d.ts"
+    },
+    "./frontend/*": {
+      "import": "./src/frontend/dist/*",
+      "require": "./src/frontend/dist/*",
+      "types": "./src/frontend/dist/*.d.ts"
+    },
+    "./shared": {
+      "import": "./src/shared/dist/index.js",
+      "require": "./src/shared/dist/index.js",
+      "types": "./src/shared/dist/index.d.ts"
+    },
+    "./shared/*": {
+      "import": "./src/shared/dist/*",
+      "require": "./src/shared/dist/*",
+      "types": "./src/shared/dist/*.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": ["./src/*/dist/*.d.ts", "./src/*/dist/index.d.ts"]
+    }
+  },
+  "scripts": {
+    "build:shared": "pnpm --filter @internal/base-shared build",
+    "build:backend": "pnpm --filter @internal/base-backend build",
+    "build:frontend": "pnpm --filter @internal/base-frontend build",
+    "build": "pnpm run build:shared && pnpm run build:backend && pnpm run build:frontend",
+    "dev:backend": "pnpm --filter @internal/base-backend dev",
+    "dev:frontend": "pnpm --filter @internal/base-frontend dev",
+    "typecheck:shared": "pnpm --filter @internal/base-shared typecheck",
+    "typecheck:backend": "pnpm --filter @internal/base-backend typecheck",
+    "typecheck:frontend": "pnpm --filter @internal/base-frontend typecheck",
+    "typecheck": "pnpm run typecheck:shared && pnpm run typecheck:backend && pnpm run typecheck:frontend"
+  },
+  "license": "MIT",
+  "keywords": ["moyan", "mfw", "admin", "framework", "nestjs", "vue3"],
+  "files": [
+    "src/backend/dist",
+    "src/frontend/dist",
+    "src/shared/dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/src/backend/dist/app.module.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview 根模块
+ * @description 应用的根模块，导入和配置所有功能模块
+ */
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { TypeOrmModuleOptions } from '@nestjs/typeorm';
+import { DataSource } from 'typeorm';
+import { User } from './modules/sys/user/entities/user.entity';
+import { Role } from './modules/sys/role/entities/role.entity';
+import { UserRole } from './modules/sys/role/entities/user-role.entity';
+import { Permission } from './modules/sys/permission/entities/permission.entity';
+import { RolePermission } from './modules/sys/role/entities/role-permission.entity';
+import { AppType } from './modules/sys/app-type/entities/app-type.entity';
+import { AppTypePermissionEntity } from './modules/sys/app-type/entities/app-type-permission.entity';
+import { App } from './modules/sys/app/entities/app.entity';
+import { AppMember } from './modules/sys/app/entities/app-member.entity';
+import { AuditLog } from './modules/sys/audit-log/entities/audit-log.entity';
+import { PermissionValue } from './modules/sys/permission/entities/permission-value.entity';
+declare const entities: (typeof Permission | typeof Role | typeof RolePermission | typeof UserRole | typeof User | typeof AuditLog | typeof AppType | typeof AppTypePermissionEntity | typeof App | typeof AppMember | typeof PermissionValue)[];
+/**
+ * 数据库连接健康检查服务
+ */
+export declare class DatabaseHealthService implements OnModuleInit, OnModuleDestroy {
+    private dataSource;
+    private healthCheckInterval;
+    private readonly healthCheckIntervalMs;
+    constructor(dataSource: DataSource);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+}
+/**
+ * 数据库配置工厂函数
+ */
+declare function createTypeOrmOptions(configService: ConfigService): TypeOrmModuleOptions;
+/**
+ * 根模块
+ */
+export declare class AppModule {
+}
+export { createTypeOrmOptions, entities };
+//# sourceMappingURL=app.module.d.ts.map

package/src/backend/dist/app.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.d.ts","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAU,YAAY,EAAE,eAAe,EAAc,MAAM,gBAAgB,CAAC;AAInF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMrC,OAAO,EAAE,IAAI,EAAE,MAAM,yCAAyC,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,yCAAyC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,iDAAiD,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AACrG,OAAO,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,8CAA8C,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,mDAAmD,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,2DAA2D,CAAC;AAW5F,QAAA,MAAM,QAAQ,0NAAkI,CAAC;AAEjJ;;GAEG;AACH,qBACa,qBAAsB,YAAW,YAAY,EAAE,eAAe;IAKvE,OAAO,CAAC,UAAU;IAJpB,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAGrC,UAAU,EAAE,UAAU;IAG1B,YAAY;IAuBZ,eAAe;CAOtB;AAED;;GAEG;AACH,iBAAS,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAG,oBAAoB,CAoDhF;AAED;;GAEG;AACH,qBAsDa,SAAS;CAAG;AAGzB,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC"}

package/src/backend/dist/app.module.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * @fileoverview 根模块
+ * @description 应用的根模块，导入和配置所有功能模块
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entities = exports.AppModule = exports.DatabaseHealthService = void 0;
+exports.createTypeOrmOptions = createTypeOrmOptions;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const typeorm_1 = require("@nestjs/typeorm");
+const jwt_1 = require("@nestjs/jwt");
+const config_2 = require("@nestjs/config");
+const core_1 = require("@nestjs/core");
+const typeorm_2 = require("typeorm");
+// 配置
+const config_3 = require("./config");
+// 实体 - 直接导入确保打包后可用
+const user_entity_1 = require("./modules/sys/user/entities/user.entity");
+const role_entity_1 = require("./modules/sys/role/entities/role.entity");
+const user_role_entity_1 = require("./modules/sys/role/entities/user-role.entity");
+const permission_entity_1 = require("./modules/sys/permission/entities/permission.entity");
+const role_permission_entity_1 = require("./modules/sys/role/entities/role-permission.entity");
+const app_type_entity_1 = require("./modules/sys/app-type/entities/app-type.entity");
+const app_type_permission_entity_1 = require("./modules/sys/app-type/entities/app-type-permission.entity");
+const app_entity_1 = require("./modules/sys/app/entities/app.entity");
+const app_member_entity_1 = require("./modules/sys/app/entities/app-member.entity");
+const audit_log_entity_1 = require("./modules/sys/audit-log/entities/audit-log.entity");
+const permission_value_entity_1 = require("./modules/sys/permission/entities/permission-value.entity");
+// 业务模块
+const sys_module_1 = require("./modules/sys/sys.module");
+const health_module_1 = require("./modules/health/health.module");
+// 守卫
+const auth_guard_1 = require("./common/guards/auth.guard");
+const permission_guard_1 = require("./common/guards/permission.guard");
+// 所有实体数组
+const entities = [user_entity_1.User, role_entity_1.Role, user_role_entity_1.UserRole, permission_entity_1.Permission, role_permission_entity_1.RolePermission, app_type_entity_1.AppType, app_type_permission_entity_1.AppTypePermissionEntity, app_entity_1.App, app_member_entity_1.AppMember, audit_log_entity_1.AuditLog, permission_value_entity_1.PermissionValue];
+exports.entities = entities;
+/**
+ * 数据库连接健康检查服务
+ */
+let DatabaseHealthService = class DatabaseHealthService {
+    dataSource;
+    healthCheckInterval = null;
+    healthCheckIntervalMs = 30000; // 30 秒
+    constructor(dataSource) {
+        this.dataSource = dataSource;
+    }
+    async onModuleInit() {
+        console.log('[DatabaseHealth] Starting database connection health check...');
+        // 定期检测连接状态
+        this.healthCheckInterval = setInterval(async () => {
+            try {
+                await this.dataSource.query('SELECT 1');
+            }
+            catch (error) {
+                console.error('[DatabaseHealth] Connection health check failed, attempting to reconnect...', error);
+                // 尝试重新建立连接
+                try {
+                    if (this.dataSource.isInitialized) {
+                        await this.dataSource.destroy();
+                    }
+                    await this.dataSource.initialize();
+                    console.log('[DatabaseHealth] Reconnected successfully');
+                }
+                catch (reconnectError) {
+                    console.error('[DatabaseHealth] Reconnection failed:', reconnectError);
+                }
+            }
+        }, this.healthCheckIntervalMs);
+    }
+    async onModuleDestroy() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+            console.log('[DatabaseHealth] Stopped health check');
+        }
+    }
+};
+exports.DatabaseHealthService = DatabaseHealthService;
+exports.DatabaseHealthService = DatabaseHealthService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [typeorm_2.DataSource])
+], DatabaseHealthService);
+/**
+ * 数据库配置工厂函数
+ */
+function createTypeOrmOptions(configService) {
+    // 尝试从配置服务获取，如果失败则使用环境变量
+    const dbConfig = configService.get('databaseConfig') || configService.get('database') || {};
+    console.log('Database config loaded from service:', dbConfig?.database);
+    console.log('DB_NAME from env:', process.env.DB_NAME);
+    return {
+        type: 'mysql',
+        host: dbConfig?.host || process.env.DB_HOST || '127.0.0.1',
+        port: dbConfig?.port || parseInt(process.env.DB_PORT || '3306', 10),
+        username: dbConfig?.username || process.env.DB_USERNAME || 'moyan_mfw',
+        password: dbConfig?.password || process.env.DB_PASSWORD || 'moyan_mfw',
+        database: dbConfig?.database || process.env.DB_NAME || 'moyan_mfw',
+        charset: dbConfig?.charset || 'utf8mb4',
+        timezone: dbConfig?.timezone || '+08:00',
+        poolSize: dbConfig?.poolSize || 100,
+        // 测试环境启用 synchronize 以自动创建表（不 dropSchema，由 global-setup 管理）
+        synchronize: dbConfig?.synchronize ?? (process.env.NODE_ENV === 'test' || process.env.NODE_ENV === 'development'),
+        dropSchema: false,
+        logging: dbConfig?.logging ?? false,
+        // 使用直接导入的实体数组，而不是 glob 模式
+        entities: entities,
+        migrations: [__dirname + '/database/migrations/*{.ts,.js}'],
+        // 数据库连接重试机制
+        connectTimeout: 60000, // 连接超时 60 秒
+        acquireTimeout: 60000, // 获取连接超时 60 秒
+        // 空闲连接回收
+        idleTimeoutMillis: 60000, // 空闲连接 60 秒后回收
+        // 启用日志
+        logger: 'advanced-console',
+        extra: {
+            connectionLimit: dbConfig?.poolSize || 100,
+            waitForConnections: true,
+            queueLimit: 0,
+            // 连接池心跳配置（mysql2 原生支持）
+            enableKeepAlive: true,
+            keepAliveInitialDelay: 30000, // 30 秒发送一次心跳
+            // 支持大数字
+            supportBigNumbers: true,
+            bigNumberStrings: false,
+            // 时区配置
+            timezone: 'Z',
+            // 允许多条 SQL 语句执行
+            multipleStatements: true,
+        },
+        // 自动重连
+        autoLoadEntities: false,
+        keepConnectionAlive: true,
+        // 错误重试
+        retryAttempts: 10,
+        retryDelay: 3000, // 3 秒
+    };
+}
+/**
+ * 根模块
+ */
+let AppModule = class AppModule {
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            // 配置模块
+            config_1.ConfigModule.forRoot({
+                isGlobal: true,
+                envFilePath: [`.env.${process.env.NODE_ENV || 'development'}`, '.env.local', '.env'],
+                load: [config_3.databaseConfig, config_3.appConfig, config_3.redisConfig, config_3.userConfig],
+                ignoreEnvFile: false,
+            }),
+            // TypeORM 配置
+            typeorm_1.TypeOrmModule.forRootAsync({
+                imports: [config_1.ConfigModule],
+                useFactory: createTypeOrmOptions,
+                inject: [config_2.ConfigService],
+            }),
+            // JWT 配置
+            jwt_1.JwtModule.registerAsync({
+                global: true,
+                imports: [config_1.ConfigModule],
+                useFactory: (configService) => ({
+                    secret: configService.get('JWT_SECRET', 'default_jwt_secret'),
+                    signOptions: {
+                        expiresIn: configService.get('JWT_EXPIRES_IN', 7200),
+                    },
+                }),
+                inject: [config_2.ConfigService],
+            }),
+            // 业务模块
+            sys_module_1.SysModule,
+            health_module_1.HealthModule,
+        ],
+        providers: [
+            DatabaseHealthService,
+            {
+                provide: core_1.APP_GUARD,
+                useFactory: (jwtService, reflector) => {
+                    return new auth_guard_1.AuthGuard(jwtService, reflector);
+                },
+                inject: [jwt_1.JwtService, core_1.Reflector],
+            },
+            {
+                provide: core_1.APP_GUARD,
+                useFactory: (reflector, dataSource) => {
+                    const rolePermissionRepository = dataSource.getRepository(role_permission_entity_1.RolePermission);
+                    const userRoleRepository = dataSource.getRepository(user_role_entity_1.UserRole);
+                    return new permission_guard_1.PermissionGuard(reflector, rolePermissionRepository, userRoleRepository);
+                },
+                inject: [core_1.Reflector, typeorm_2.DataSource],
+            },
+        ],
+    })
+], AppModule);
+//# sourceMappingURL=app.module.js.map

package/src/backend/dist/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":"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"}

package/src/backend/dist/common/constants/permissions.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview 权限常量定义
+ * @description 定义全局权限位运算常量和工具函数（支持代码扩展）
+ */
+/**
+ * 默认权限配置（基础框架提供�?
+ * 这些权限值在 base-backend �?base-frontend 中已使用，不可覆�?
+ */
+export declare const DEFAULT_PERMISSION_VALUES: readonly ["添加", "编辑", "删除", "导出", "导入"];
+/**
+ * 默认权限名称类型（字面量�?
+ */
+export type DefaultPermissionName = (typeof DEFAULT_PERMISSION_VALUES)[number];
+/**
+ * 扩展权限配置（可选）
+ * 业务项目可以添加更多权限，如�?审批', '拒绝', '发布', '归档'
+ */
+export declare const EXTENSION_PERMISSION_VALUES: readonly ["审批", "拒绝", "发布", "归档"];
+/**
+ * 扩展权限名称类型（字面量�?
+ */
+export type ExtensionPermissionName = (typeof EXTENSION_PERMISSION_VALUES)[number];
+/**
+ * 基础权限名称类型（默�?+ 扩展�?
+ */
+export type BasePermissionName = DefaultPermissionName | ExtensionPermissionName;
+/**
+ * 注册业务扩展权限�?
+ * @param values - 业务自定义权限值数�?
+ *
+ * @example
+ * ```typescript
+ * // �?backend/src/permissions.ts 中调�?
+ * registerPermissionValues(['上架', '发货', '退�?]);
+ * ```
+ */
+export declare function registerPermissionValues(values: string[]): void;
+/**
+ * 获取完整的权限值列�?
+ * @returns 所有权限值（默认 + 扩展 + 业务自定义）
+ */
+export declare function getPermissionValues(): readonly string[];
+/**
+ * 当前生效的权限值列�?
+ */
+export declare const PERMISSION_VALUES: readonly string[];
+/**
+ * 权限配置接口
+ */
+export interface PermissionConfig {
+    values: readonly string[];
+}
+/**
+ * 全局权限配置对象
+ */
+export declare const PERMISSION_CONFIG: PermissionConfig;
+/**
+ * 根据权限名称数组构建位运算权限�?
+ * @param names - 权限名称数组，如 ['添加', '编辑']
+ * @returns bigint 位运算�?
+ *
+ * @example
+ * ```typescript
+ * buildPerValue(['添加']) // 1n
+ * buildPerValue(['添加', '编辑']) // 3n
+ * buildPerValue(['添加', '删除']) // 5n
+ * ```
+ */
+export declare function buildPerValue(names: string[]): bigint;
+/**
+ * 根据权限名称获取单个权限位�?
+ * @param name - 权限名称
+ * @returns bigint 单个权限位�?
+ *
+ * @example
+ * ```typescript
+ * getPermValue('添加') // 1n
+ * getPermValue('编辑') // 2n
+ * ```
+ */
+export declare function getPermValue(name: string): bigint;
+/**
+ * 根据位运算值解析为权限名称数组
+ * @param value - 位运算�?
+ * @returns 权限名称数组
+ *
+ * @example
+ * ```typescript
+ * parsePerValue(3n) // ['添加', '编辑']
+ * parsePerValue(5n) // ['添加', '删除']
+ * ```
+ */
+export declare function parsePerValue(value: bigint): string[];
+/**
+ * 检查是否包含指定权�?
+ * @param value - 位运算�?
+ * @param name - 权限名称
+ * @returns boolean 是否包含
+ *
+ * @example
+ * ```typescript
+ * hasPermission(3n, '添加') // true
+ * hasPermission(3n, '删除') // false
+ * ```
+ */
+export declare function hasPermission(value: bigint, name: string): boolean;
+/**
+ * 获取所有权限选项（用�?UI 展示�?
+ * @returns 权限选项数组 {name, label, value}
+ */
+export declare function getPermissionOptions(): Array<{
+    name: string;
+    label: string;
+    value: bigint;
+}>;
+export declare function initPermissionValueCache(values: Array<{
+    name: string;
+    bitValue: bigint | number | string;
+}>): void;
+export declare function getPermissionValueCache(): Map<string, bigint>;
+//# sourceMappingURL=permissions.d.ts.map

package/src/backend/dist/common/constants/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/common/constants/permissions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,yCAM5B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,2BAA2B,mCAK9B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG,uBAAuB,CAAC;AAQjF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAE/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAMvD;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAAwB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAE/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAOD;AAQD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAElH;AAED,wBAAgB,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7D"}