moyan-mfw-base 1.0.0

package/src/backend/dist/common/constants/permissions.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * @fileoverview 权限常量定义
+ * @description 定义全局权限位运算常量和工具函数（支持代码扩展）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERMISSION_CONFIG = exports.PERMISSION_VALUES = exports.EXTENSION_PERMISSION_VALUES = exports.DEFAULT_PERMISSION_VALUES = void 0;
+exports.registerPermissionValues = registerPermissionValues;
+exports.getPermissionValues = getPermissionValues;
+exports.buildPerValue = buildPerValue;
+exports.getPermValue = getPermValue;
+exports.parsePerValue = parsePerValue;
+exports.hasPermission = hasPermission;
+exports.getPermissionOptions = getPermissionOptions;
+exports.initPermissionValueCache = initPermissionValueCache;
+exports.getPermissionValueCache = getPermissionValueCache;
+/**
+ * 默认权限配置（基础框架提供�?
+ * 这些权限值在 base-backend �?base-frontend 中已使用，不可覆�?
+ */
+exports.DEFAULT_PERMISSION_VALUES = [
+    '添加', // 0: 1n << 0 = 1n
+    '编辑', // 1: 1n << 1 = 2n
+    '删除', // 2: 1n << 2 = 4n
+    '导出', // 3: 1n << 3 = 8n
+    '导入', // 4: 1n << 4 = 16n
+];
+/**
+ * 扩展权限配置（可选）
+ * 业务项目可以添加更多权限，如�?审批', '拒绝', '发布', '归档'
+ */
+exports.EXTENSION_PERMISSION_VALUES = [
+    '审批', // 5: 1n << 5 = 32n
+    '拒绝', // 6: 1n << 6 = 64n
+    '发布', // 7: 1n << 7 = 128n
+    '归档', // 8: 1n << 8 = 256n
+];
+/**
+ * 业务扩展权限值存�?
+ * 通过 registerPermissionValues 函数注册
+ */
+let customPermissionValues = [];
+/**
+ * 注册业务扩展权限�?
+ * @param values - 业务自定义权限值数�?
+ *
+ * @example
+ * ```typescript
+ * // �?backend/src/permissions.ts 中调�?
+ * registerPermissionValues(['上架', '发货', '退�?]);
+ * ```
+ */
+function registerPermissionValues(values) {
+    customPermissionValues = values;
+}
+/**
+ * 获取完整的权限值列�?
+ * @returns 所有权限值（默认 + 扩展 + 业务自定义）
+ */
+function getPermissionValues() {
+    return [
+        ...exports.DEFAULT_PERMISSION_VALUES,
+        ...exports.EXTENSION_PERMISSION_VALUES,
+        ...customPermissionValues,
+    ];
+}
+/**
+ * 当前生效的权限值列�?
+ */
+exports.PERMISSION_VALUES = getPermissionValues();
+/**
+ * 全局权限配置对象
+ */
+exports.PERMISSION_CONFIG = {
+    values: exports.PERMISSION_VALUES,
+};
+/**
+ * 根据权限名称数组构建位运算权限�?
+ * @param names - 权限名称数组，如 ['添加', '编辑']
+ * @returns bigint 位运算�?
+ *
+ * @example
+ * ```typescript
+ * buildPerValue(['添加']) // 1n
+ * buildPerValue(['添加', '编辑']) // 3n
+ * buildPerValue(['添加', '删除']) // 5n
+ * ```
+ */
+function buildPerValue(names) {
+    let result = 0n;
+    for (const name of names) {
+        const value = permissionValueCache.get(name);
+        if (value === undefined) {
+            throw new Error(`未知的权限名称：${name}`);
+        }
+        result |= typeof value === 'bigint' ? value : BigInt(value);
+    }
+    return result;
+}
+/**
+ * 根据权限名称获取单个权限位�?
+ * @param name - 权限名称
+ * @returns bigint 单个权限位�?
+ *
+ * @example
+ * ```typescript
+ * getPermValue('添加') // 1n
+ * getPermValue('编辑') // 2n
+ * ```
+ */
+function getPermValue(name) {
+    const values = getPermissionValues();
+    const index = values.indexOf(name);
+    if (index === -1) {
+        throw new Error(`未知的权限名称：${name}`);
+    }
+    return 1n << BigInt(index);
+}
+/**
+ * 根据位运算值解析为权限名称数组
+ * @param value - 位运算�?
+ * @returns 权限名称数组
+ *
+ * @example
+ * ```typescript
+ * parsePerValue(3n) // ['添加', '编辑']
+ * parsePerValue(5n) // ['添加', '删除']
+ * ```
+ */
+function parsePerValue(value) {
+    const values = getPermissionValues();
+    const result = [];
+    for (let i = 0; i < values.length; i++) {
+        if ((value & (1n << BigInt(i))) !== 0n) {
+            result.push(values[i]);
+        }
+    }
+    return result;
+}
+/**
+ * 检查是否包含指定权�?
+ * @param value - 位运算�?
+ * @param name - 权限名称
+ * @returns boolean 是否包含
+ *
+ * @example
+ * ```typescript
+ * hasPermission(3n, '添加') // true
+ * hasPermission(3n, '删除') // false
+ * ```
+ */
+function hasPermission(value, name) {
+    const values = getPermissionValues();
+    const index = values.indexOf(name);
+    if (index === -1) {
+        return false;
+    }
+    return (value & (1n << BigInt(index))) !== 0n;
+}
+/**
+ * 获取所有权限选项（用�?UI 展示�?
+ * @returns 权限选项数组 {name, label, value}
+ */
+function getPermissionOptions() {
+    const values = getPermissionValues();
+    return values.map((name, index) => ({
+        name,
+        label: name,
+        value: 1n << BigInt(index),
+    }));
+}
+/**
+ * 运行时权限值缓存（name → bitValue）
+ * 由 PermissionValueSyncService 在 onDatabaseReady 后填充
+ */
+let permissionValueCache = new Map();
+function initPermissionValueCache(values) {
+    permissionValueCache = new Map(values.map((v) => [v.name, typeof v.bitValue === 'bigint' ? v.bitValue : BigInt(v.bitValue)]));
+}
+function getPermissionValueCache() {
+    return permissionValueCache;
+}
+//# sourceMappingURL=permissions.js.map

package/src/backend/dist/common/constants/permissions.js.map

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

package/src/backend/dist/common/decorators/api-paginated-response.decorator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview 分页响应装饰器
+ * @description 用于简化分页接口的 Swagger 文档配置
+ */
+import { Type } from '@nestjs/common';
+/**
+ * 分页响应装饰器
+ * @description 自动生成分页接口的 Swagger 响应文档
+ * @param dataDto 数据 DTO 类
+ *
+ * @example
+ * ```typescript
+ * @Get()
+ * @ApiPaginatedResponse(UserResponseDto)
+ * async findAll(@Query() query: QueryUserDto) {
+ *   return this.userService.findAll(query);
+ * }
+ * ```
+ */
+export declare class PageResponseDto {
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export declare function ApiPaginatedResponse<T>(dataDto: Type<T>): <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+//# sourceMappingURL=api-paginated-response.decorator.d.ts.map

package/src/backend/dist/common/decorators/api-paginated-response.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-paginated-response.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/api-paginated-response.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAmB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGvD;;;;;;;;;;;;;GAaG;AAEH,qBAAa,eAAe;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,OAAO,CAAC;IAEjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,+IA8CvD"}

package/src/backend/dist/common/decorators/api-paginated-response.decorator.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * @fileoverview 分页响应装饰器
+ * @description 用于简化分页接口的 Swagger 文档配置
+ */
+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.PageResponseDto = void 0;
+exports.ApiPaginatedResponse = ApiPaginatedResponse;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+/**
+ * 分页响应装饰器
+ * @description 自动生成分页接口的 Swagger 响应文档
+ * @param dataDto 数据 DTO 类
+ *
+ * @example
+ * ```typescript
+ * @Get()
+ * @ApiPaginatedResponse(UserResponseDto)
+ * async findAll(@Query() query: QueryUserDto) {
+ *   return this.userService.findAll(query);
+ * }
+ * ```
+ */
+class PageResponseDto {
+    total;
+    page;
+    pageSize;
+    totalPages;
+    hasNext;
+    hasPrev;
+}
+exports.PageResponseDto = PageResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '总数量' }),
+    __metadata("design:type", Number)
+], PageResponseDto.prototype, "total", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '当前页码' }),
+    __metadata("design:type", Number)
+], PageResponseDto.prototype, "page", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '每页数量' }),
+    __metadata("design:type", Number)
+], PageResponseDto.prototype, "pageSize", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '总页数' }),
+    __metadata("design:type", Number)
+], PageResponseDto.prototype, "totalPages", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '是否有下一页' }),
+    __metadata("design:type", Boolean)
+], PageResponseDto.prototype, "hasNext", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '是否有上一页' }),
+    __metadata("design:type", Boolean)
+], PageResponseDto.prototype, "hasPrev", void 0);
+function ApiPaginatedResponse(dataDto) {
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiExtraModels)(dataDto), (0, swagger_1.ApiExtraModels)(PageResponseDto), 
+    // ApiResponse({
+    //   status: 200,
+    //   description: '查询成功',
+    //   schema: {
+    //     type: 'object',
+    //     properties: {
+    //       list: {
+    //         type: 'array',
+    //         items: { $ref: `#/components/schemas/${dataDto.name}` },
+    //       },
+    //       total: { type: 'number', description: '总数量' },
+    //       page: { type: 'number', description: '当前页码' },
+    //       pageSize: { type: 'number', description: '每页数量' },
+    //       totalPages: { type: 'number', description: '总页数' },
+    //       hasNext: { type: 'boolean', description: '是否有下一页' },
+    //       hasPrev: { type: 'boolean', description: '是否有上一页' },
+    //     },
+    //   },
+    // }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: '查询成功',
+        schema: {
+            type: 'object',
+            allOf: [
+                { $ref: `#/components/schemas/${PageResponseDto.name}` },
+                {
+                    properties: {
+                        list: {
+                            type: 'array',
+                            items: { $ref: `#/components/schemas/${dataDto.name}` },
+                        },
+                    },
+                    required: ['list'],
+                }
+            ],
+        },
+    }));
+}
+//# sourceMappingURL=api-paginated-response.decorator.js.map

package/src/backend/dist/common/decorators/api-paginated-response.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-paginated-response.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/api-paginated-response.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;AAqCH,oDA8CC;AAjFD,2CAAuD;AACvD,6CAA2E;AAE3E;;;;;;;;;;;;;GAaG;AAEH,MAAa,eAAe;IAE1B,KAAK,CAAS;IAEd,IAAI,CAAS;IAEb,QAAQ,CAAS;IAEjB,UAAU,CAAS;IAEnB,OAAO,CAAU;IAEjB,OAAO,CAAU;CAClB;AAbD,0CAaC;AAXC;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;;8CACtB;AAEd;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;;6CACxB;AAEb;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;;iDACpB;AAEjB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;;mDACjB;AAEnB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;;gDACtB;AAEjB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;;gDACtB;AAKnB,SAAgB,oBAAoB,CAAI,OAAgB;IACtD,OAAO,IAAA,wBAAe,EACpB,IAAA,wBAAc,EAAC,OAAO,CAAC,EACvB,IAAA,wBAAc,EAAC,eAAe,CAAC;IAC/B,gBAAgB;IAChB,iBAAiB;IACjB,yBAAyB;IACzB,cAAc;IACd,sBAAsB;IACtB,oBAAoB;IACpB,gBAAgB;IAChB,yBAAyB;IACzB,mEAAmE;IACnE,WAAW;IACX,uDAAuD;IACvD,uDAAuD;IACvD,2DAA2D;IAC3D,4DAA4D;IAC5D,6DAA6D;IAC7D,6DAA6D;IAC7D,SAAS;IACT,OAAO;IACP,MAAM;IACN,IAAA,qBAAW,EAAC;QACV,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE;gBACL,EAAE,IAAI,EAAE,wBAAwB,eAAe,CAAC,IAAI,EAAE,EAAE;gBACxD;oBACE,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,wBAAwB,OAAO,CAAC,IAAI,EAAE,EAAE;yBACxD;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;SACF;KACF,CAAC,CACH,CAAC;AAIJ,CAAC"}

package/src/backend/dist/common/decorators/app-id.decorator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview 应用实例 ID 装饰器
+ * @description 从请求中提取当前应用实例 ID
+ *
+ * 优先级：路由 params > 请求 body > 请求 query > 请求头 X-App-Id
+ */
+/**
+ * 应用实例 ID 装饰器
+ * @description 自动从请求中解析当前操作的应用实例 ID
+ *
+ * @example
+ * ```typescript
+ * @Get(':appId/members')
+ * async getMembers(@AppId() appId: string) {
+ *   return this.service.getMembers(appId);
+ * }
+ *
+ * @Post('create')
+ * async create(@Body() dto: CreateDto, @AppId() appId: string) {
+ *   return this.service.create(appId, dto);
+ * }
+ * ```
+ */
+export declare const AppId: (...dataOrPipes: unknown[]) => ParameterDecorator;
+export declare function resolveAppId(request: any): string | undefined;
+//# sourceMappingURL=app-id.decorator.d.ts.map

package/src/backend/dist/common/decorators/app-id.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-id.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/app-id.decorator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK,mDAKjB,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAM7D"}

package/src/backend/dist/common/decorators/app-id.decorator.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * @fileoverview 应用实例 ID 装饰器
+ * @description 从请求中提取当前应用实例 ID
+ *
+ * 优先级：路由 params > 请求 body > 请求 query > 请求头 X-App-Id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppId = void 0;
+exports.resolveAppId = resolveAppId;
+const common_1 = require("@nestjs/common");
+/**
+ * 应用实例 ID 装饰器
+ * @description 自动从请求中解析当前操作的应用实例 ID
+ *
+ * @example
+ * ```typescript
+ * @Get(':appId/members')
+ * async getMembers(@AppId() appId: string) {
+ *   return this.service.getMembers(appId);
+ * }
+ *
+ * @Post('create')
+ * async create(@Body() dto: CreateDto, @AppId() appId: string) {
+ *   return this.service.create(appId, dto);
+ * }
+ * ```
+ */
+exports.AppId = (0, common_1.createParamDecorator)((_data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    return resolveAppId(request);
+});
+function resolveAppId(request) {
+    return request.params?.appId
+        || request.body?.appId
+        || request.query?.appId
+        || request.headers?.['x-app-id']
+        || undefined;
+}
+//# sourceMappingURL=app-id.decorator.js.map

package/src/backend/dist/common/decorators/app-id.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-id.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/app-id.decorator.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA4BH,oCAMC;AAhCD,2CAAwE;AAExE;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,KAAK,GAAG,IAAA,6BAAoB,EACvC,CAAC,KAAc,EAAE,GAAqB,EAAsB,EAAE;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;IAChD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC,CACF,CAAC;AAEF,SAAgB,YAAY,CAAC,OAAY;IACvC,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK;WACvB,OAAO,CAAC,IAAI,EAAE,KAAK;WACnB,OAAO,CAAC,KAAK,EAAE,KAAK;WACpB,OAAO,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC;WAC7B,SAAS,CAAC;AACjB,CAAC"}

package/src/backend/dist/common/decorators/audit-log.decorator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview 审计日志装饰器
+ * @description 标记需要记录审计日志的接口
+ */
+/**
+ * 审计日志标识键
+ */
+export declare const AUDIT_LOG = "audit_log";
+/**
+ * 审计日志模块枚举
+ */
+export declare enum AuditModule {
+    AUTH = "AUTH",
+    USER = "USER",
+    ROLE = "ROLE",
+    PERMISSION = "PERMISSION",
+    APP = "APP",
+    APP_TYPE = "APP_TYPE",
+    MEMBER = "MEMBER",
+    SYSTEM = "SYSTEM",
+    UPLOAD = "UPLOAD"
+}
+/**
+ * 审计日志选项接口
+ */
+export interface AuditLogOptions {
+    /** 所属模块 */
+    module: AuditModule | string;
+    /** 事件名称 */
+    event: string;
+    /** 事件描述 */
+    description?: string;
+}
+/**
+ * 审计日志装饰器
+ * @description 标记控制器方法需要记录审计日志
+ *
+ * @param options - 审计日志选项
+ * @returns 装饰器函数
+ *
+ * @example
+ * ```typescript
+ * @Controller('users')
+ * export class UserController {
+ *   @AuditLog({ module: AuditModule.USER, event: 'CREATE_USER', description: '创建用户' })
+ *   @Post()
+ *   async create(@Body() dto: CreateUserDto) {}
+ * }
+ * ```
+ */
+export declare const AuditLog: (options: AuditLogOptions) => import("@nestjs/common").CustomDecorator<string>;
+//# sourceMappingURL=audit-log.decorator.d.ts.map

package/src/backend/dist/common/decorators/audit-log.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/audit-log.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC;;GAEG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,eAAe,qDAChB,CAAC"}

package/src/backend/dist/common/decorators/audit-log.decorator.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * @fileoverview 审计日志装饰器
+ * @description 标记需要记录审计日志的接口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLog = exports.AuditModule = exports.AUDIT_LOG = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 审计日志标识键
+ */
+exports.AUDIT_LOG = 'audit_log';
+/**
+ * 审计日志模块枚举
+ */
+var AuditModule;
+(function (AuditModule) {
+    AuditModule["AUTH"] = "AUTH";
+    AuditModule["USER"] = "USER";
+    AuditModule["ROLE"] = "ROLE";
+    AuditModule["PERMISSION"] = "PERMISSION";
+    AuditModule["APP"] = "APP";
+    AuditModule["APP_TYPE"] = "APP_TYPE";
+    AuditModule["MEMBER"] = "MEMBER";
+    AuditModule["SYSTEM"] = "SYSTEM";
+    AuditModule["UPLOAD"] = "UPLOAD";
+})(AuditModule || (exports.AuditModule = AuditModule = {}));
+/**
+ * 审计日志装饰器
+ * @description 标记控制器方法需要记录审计日志
+ *
+ * @param options - 审计日志选项
+ * @returns 装饰器函数
+ *
+ * @example
+ * ```typescript
+ * @Controller('users')
+ * export class UserController {
+ *   @AuditLog({ module: AuditModule.USER, event: 'CREATE_USER', description: '创建用户' })
+ *   @Post()
+ *   async create(@Body() dto: CreateUserDto) {}
+ * }
+ * ```
+ */
+const AuditLog = (options) => (0, common_1.SetMetadata)(exports.AUDIT_LOG, options);
+exports.AuditLog = AuditLog;
+//# sourceMappingURL=audit-log.decorator.js.map

package/src/backend/dist/common/decorators/audit-log.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/audit-log.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAA6C;AAE7C;;GAEG;AACU,QAAA,SAAS,GAAG,WAAW,CAAC;AAErC;;GAEG;AACH,IAAY,WAUX;AAVD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,wCAAyB,CAAA;IACzB,0BAAW,CAAA;IACX,oCAAqB,CAAA;IACrB,gCAAiB,CAAA;IACjB,gCAAiB,CAAA;IACjB,gCAAiB,CAAA;AACnB,CAAC,EAVW,WAAW,2BAAX,WAAW,QAUtB;AAcD;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAE,EAAE,CACnD,IAAA,oBAAW,EAAC,iBAAS,EAAE,OAAO,CAAC,CAAC;AADrB,QAAA,QAAQ,YACa"}

package/src/backend/dist/common/decorators/public.decorator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview 公共接口装饰器
+ * @description 标记接口为公共接口，无需认证即可访问
+ */
+/**
+ * 公共接口标识键
+ * @description 用于 Reflector 获取公共接口标识
+ */
+export declare const IS_PUBLIC_KEY = "isPublic";
+/**
+ * 公共接口装饰器
+ * @description 标记控制器方法为公共接口，无需认证即可访问
+ *
+ * @example
+ * ```typescript
+ * @Controller('auth')
+ * export class AuthController {
+ *   @Public()
+ *   @Post('login')
+ *   async login(@Body() dto: LoginDto) {}
+ * }
+ * ```
+ */
+export declare const Public: () => import("@nestjs/common").CustomDecorator<string>;
+//# sourceMappingURL=public.decorator.d.ts.map

package/src/backend/dist/common/decorators/public.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/public.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,wDAAyC,CAAC"}

package/src/backend/dist/common/decorators/public.decorator.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * @fileoverview 公共接口装饰器
+ * @description 标记接口为公共接口，无需认证即可访问
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Public = exports.IS_PUBLIC_KEY = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 公共接口标识键
+ * @description 用于 Reflector 获取公共接口标识
+ */
+exports.IS_PUBLIC_KEY = 'isPublic';
+/**
+ * 公共接口装饰器
+ * @description 标记控制器方法为公共接口，无需认证即可访问
+ *
+ * @example
+ * ```typescript
+ * @Controller('auth')
+ * export class AuthController {
+ *   @Public()
+ *   @Post('login')
+ *   async login(@Body() dto: LoginDto) {}
+ * }
+ * ```
+ */
+const Public = () => (0, common_1.SetMetadata)(exports.IS_PUBLIC_KEY, true);
+exports.Public = Public;
+//# sourceMappingURL=public.decorator.js.map

package/src/backend/dist/common/decorators/public.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/public.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAA6C;AAE7C;;;GAGG;AACU,QAAA,aAAa,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACI,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAA,oBAAW,EAAC,qBAAa,EAAE,IAAI,CAAC,CAAC;AAAhD,QAAA,MAAM,UAA0C"}

package/src/backend/dist/common/decorators/require-permission.decorator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview 权限装饰器
+ * @description 定义接口所需的权限编码和权限值，支持多种调用方式
+ */
+import type { BasePermissionName } from '../constants/permissions';
+/**
+ * 权限装饰器标识键
+ */
+export declare const REQUIRE_PERMISSION = "require_permission";
+/**
+ * 权限选项接口
+ */
+export interface RequirePermissionOptions {
+    /** 权限编码，用于标识具体权限点 */
+    permCode: string;
+    /**
+     * 权限值（位运算）- 必须使用字符串数组
+     * @example ['添加', '编辑']、['删除']
+     */
+    permissionValue?: string[];
+}
+export declare function RequirePermission(optionsOrCode: RequirePermissionOptions | string, permissionValue?: string[]): MethodDecorator & ClassDecorator;
+/**
+ * 创建业务权限装饰器工厂函数
+ * @param businessPermissions - 业务层权限值数组（readonly）
+ * @returns 带有类型推断的业务权限装饰器
+ *
+ * @description 注册业务权限并返回一个带有完整类型推断的装饰器函数。
+ * 业务层只需调用一次此函数，即可在所有控制器中获得类型提示。
+ *
+ * @example
+ * ```typescript
+ * // backend/src/permissions.ts
+ * import { createBusinessPermissionDecorator } from 'moyan-mfw-base/backend';
+ *
+ * export const BUSINESS_PERMISSION_VALUES = ['上架', '发货', '退款'] as const;
+ * export const RequireBusinessPermission = createBusinessPermissionDecorator(BUSINESS_PERMISSION_VALUES);
+ *
+ * // backend/src/modules/supplier/supplier.controller.ts
+ * import { RequireBusinessPermission } from '../permissions';
+ *
+ * @RequireBusinessPermission('supplier:manage', ['上架', '发货', '添加'])  // 有完整类型推断
+ * ```
+ */
+export declare function createBusinessPermissionDecorator<T extends readonly string[]>(businessPermissions: T): (permCode: string, permissionValue?: (BasePermissionName | T[number])[]) => MethodDecorator & ClassDecorator;
+//# sourceMappingURL=require-permission.decorator.d.ts.map

package/src/backend/dist/common/decorators/require-permission.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-permission.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/require-permission.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAoDD,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,wBAAwB,GAAG,MAAM,EAChD,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,eAAe,GAAG,cAAc,CAclC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iCAAiC,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAC3E,mBAAmB,EAAE,CAAC,GACrB,CACD,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,CAAC,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,KACjD,eAAe,GAAG,cAAc,CAoBpC"}