moyan-mfw-base 1.2.0-beta.3 → 1.2.0-beta.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moyan-mfw-base",
-  "version": "1.2.0-beta.3",
+  "version": "1.2.0-beta.30",
   "description": "墨焱MFW核心框架",
   "main": "./src/shared/dist/index.js",
   "types": "./src/shared/dist/index.d.ts",
@@ -74,6 +74,10 @@
   "peerDependencies": {
     "moyan-api": "^2.1.19"
   },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
   "engines": {
     "node": ">=20.0.0"
   },

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

@@ -1 +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;AAarC,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;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAWlF,QAAA,MAAM,QAAQ,kPAAkJ,CAAC;AAEjK;;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,qBA6Da,SAAS;CAAG;AAGzB,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC"}
+{"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;AAarC,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;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAWlF,QAAA,MAAM,QAAQ,kPAAkJ,CAAC;AAEjK;;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;IAgCZ,eAAe;CAOtB;AAED;;GAEG;AACH,iBAAS,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAG,oBAAoB,CAoDhF;AAED;;GAEG;AACH,qBA6Da,SAAS;CAAG;AAGzB,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC"}

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

@@ -68,17 +68,24 @@ let DatabaseHealthService = class DatabaseHealthService {
                 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();
+                console.error('[DatabaseHealth] Connection health check failed:', error);
+                // 注意：不要在 isInitialized 时主动 destroy DataSource。
+                // destroy 后到 initialize 完成之间存在"Pool is closed"窗口期，
+                // 期间所有请求（含 /api/install/status）都会 500，
+                // 前端 guard 会误判为"未初始化"并跳转 install 页面 → 重新初始化会清空数据。
+                // mysql2 连接池本身具备自动重连/重试能力，这里仅在 DataSource 完全未初始化时尝试初始化。
+                if (!this.dataSource.isInitialized) {
+                    try {
+                        await this.dataSource.initialize();
+                        console.log('[DatabaseHealth] Reconnected successfully');
+                    }
+                    catch (reconnectError) {
+                        console.error('[DatabaseHealth] Reconnection failed:', reconnectError);
                     }
-                    await this.dataSource.initialize();
-                    console.log('[DatabaseHealth] Reconnected successfully');
                 }
-                catch (reconnectError) {
-                    console.error('[DatabaseHealth] Reconnection failed:', reconnectError);
+                else {
+                    console.warn('[DatabaseHealth] DataSource still initialized, rely on pool auto-reconnect. ' +
+                        'Do not destroy to avoid "Pool is closed" window.');
                 }
             }
         }, this.healthCheckIntervalMs);
@@ -182,7 +189,7 @@ exports.AppModule = AppModule = __decorate([
                 useFactory: (configService) => ({
                     secret: configService.get('JWT_SECRET', 'default_jwt_secret'),
                     signOptions: {
-                        expiresIn: configService.get('JWT_EXPIRES_IN', 7200),
+                        expiresIn: configService.get('JWT_EXPIRES_IN', '7200'),
                     },
                 }),
                 inject: [config_2.ConfigService],

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

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

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

@@ -1 +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"}
+{"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,+IA2BvD"}

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

@@ -65,38 +65,20 @@ __decorate([
     __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)({
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiExtraModels)(dataDto), (0, swagger_1.ApiExtraModels)(PageResponseDto), (0, swagger_1.ApiResponse)({
         status: 200,
         description: '查询成功',
         schema: {
             type: 'object',
             allOf: [
-                { $ref: `#/components/schemas/${PageResponseDto.name}` },
+                {
+                    $ref: (0, swagger_1.getSchemaPath)(PageResponseDto),
+                },
                 {
                     properties: {
                         list: {
                             type: 'array',
-                            items: { $ref: `#/components/schemas/${dataDto.name}` },
+                            items: { $ref: (0, swagger_1.getSchemaPath)(dataDto) },
                         },
                     },
                     required: ['list'],

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

@@ -1 +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"}
+{"version":3,"file":"api-paginated-response.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/api-paginated-response.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;AAqCH,oDA2BC;AA9DD,2CAAuD;AACvD,6CAAyF;AAEzF;;;;;;;;;;;;;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,EAC/B,IAAA,qBAAW,EAAC;QACV,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE;gBACL;oBACE,IAAI,EAAC,IAAA,uBAAa,EAAC,eAAe,CAAC;iBACpC;gBACD;oBACE,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,OAAO,CAAC,EAAE;yBACxC;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;SACF;KACF,CAAC,CACH,CAAC;AAEJ,CAAC"}

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

@@ -11,6 +11,10 @@ export declare const IS_PUBLIC_KEY = "isPublic";
  * 公共接口装饰器
  * @description 标记控制器方法为公共接口，无需认证即可访问
  *
+ * 行为说明：认证为可选。未携带 Token 时直接放行；携带有效 Token 时，AuthGuard 会
+ * 解析并注入用户信息，此时可配合 @User() 获取当前登录用户。适用于同一接口需要
+ * 同时服务公开访问与登录后个性化数据的场景。
+ *
  * @example
  * ```typescript
  * @Controller('auth')
@@ -19,6 +23,17 @@ export declare const IS_PUBLIC_KEY = "isPublic";
  *   @Post('login')
  *   async login(@Body() dto: LoginDto) {}
  * }
+ *
+ * // 公开与登录均可访问，登录后可获取用户信息
+ * @Controller('article')
+ * export class ArticleController {
+ *   @Public()
+ *   @Get(':id')
+ *   async getArticle(@Param('id') id: string, @User() user?: UserDto) {
+ *     const article = await this.articleService.findById(id);
+ *     return { ...article, isLiked: user ? this.likeService.check(id, user.id) : false };
+ *   }
+ * }
  * ```
  */
 export declare const Public: () => import("@nestjs/common").CustomDecorator<string>;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,MAAM,wDAAyC,CAAC"}

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

@@ -15,6 +15,10 @@ exports.IS_PUBLIC_KEY = 'isPublic';
  * 公共接口装饰器
  * @description 标记控制器方法为公共接口，无需认证即可访问
  *
+ * 行为说明：认证为可选。未携带 Token 时直接放行；携带有效 Token 时，AuthGuard 会
+ * 解析并注入用户信息，此时可配合 @User() 获取当前登录用户。适用于同一接口需要
+ * 同时服务公开访问与登录后个性化数据的场景。
+ *
  * @example
  * ```typescript
  * @Controller('auth')
@@ -23,6 +27,17 @@ exports.IS_PUBLIC_KEY = 'isPublic';
  *   @Post('login')
  *   async login(@Body() dto: LoginDto) {}
  * }
+ *
+ * // 公开与登录均可访问，登录后可获取用户信息
+ * @Controller('article')
+ * export class ArticleController {
+ *   @Public()
+ *   @Get(':id')
+ *   async getArticle(@Param('id') id: string, @User() user?: UserDto) {
+ *     const article = await this.articleService.findById(id);
+ *     return { ...article, isLiked: user ? this.likeService.check(id, user.id) : false };
+ *   }
+ * }
  * ```
  */
 const Public = () => (0, common_1.SetMetadata)(exports.IS_PUBLIC_KEY, true);

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;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/user.decorator.d.ts

@@ -7,6 +7,9 @@ import { UserDto } from '../types/user.dto';
  * 用户装饰器
  * @description 从请求对象中提取用户信息，避免手动从 @Request() 中获取
  *
+ * 可配合 @Public() 使用：在公开接口中，当请求携带有效 Token 时，AuthGuard 会自动
+ * 解析并注入用户信息，此时 @User() 返回 UserDto；未携带 Token 或 Token 无效时返回 undefined。
+ *
  * @example
  * ```typescript
  * // 获取完整用户信息
@@ -26,6 +29,15 @@ import { UserDto } from '../types/user.dto';
  * async getRoles(@User('roleIds') roleIds: string[]) {
  *   return this.roleService.findByIds(roleIds);
  * }
+ *
+ * // 配合 @Public() 使用：登录与未登录均可访问，登录后可获取用户信息
+ * @Public()
+ * @Get('article/:id')
+ * async getArticle(@Param('id') id: string, @User() user?: UserDto) {
+ *   const article = await this.articleService.findById(id);
+ *   // 未登录时 user 为 undefined，登录后可据此返回个性化数据
+ *   return { ...article, isLiked: user ? this.likeService.check(id, user.id) : false };
+ * }
  * ```
  */
 export declare const User: (...dataOrPipes: (keyof UserDto | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>> | undefined)[]) => ParameterDecorator;

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

@@ -1 +1 @@
-{"version":3,"file":"user.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/user.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,IAAI,4MAgBhB,CAAC"}
+{"version":3,"file":"user.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/user.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,IAAI,4MAgBhB,CAAC"}

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

@@ -10,6 +10,9 @@ const common_1 = require("@nestjs/common");
  * 用户装饰器
  * @description 从请求对象中提取用户信息，避免手动从 @Request() 中获取
  *
+ * 可配合 @Public() 使用：在公开接口中，当请求携带有效 Token 时，AuthGuard 会自动
+ * 解析并注入用户信息，此时 @User() 返回 UserDto；未携带 Token 或 Token 无效时返回 undefined。
+ *
  * @example
  * ```typescript
  * // 获取完整用户信息
@@ -29,6 +32,15 @@ const common_1 = require("@nestjs/common");
  * async getRoles(@User('roleIds') roleIds: string[]) {
  *   return this.roleService.findByIds(roleIds);
  * }
+ *
+ * // 配合 @Public() 使用：登录与未登录均可访问，登录后可获取用户信息
+ * @Public()
+ * @Get('article/:id')
+ * async getArticle(@Param('id') id: string, @User() user?: UserDto) {
+ *   const article = await this.articleService.findById(id);
+ *   // 未登录时 user 为 undefined，登录后可据此返回个性化数据
+ *   return { ...article, isLiked: user ? this.likeService.check(id, user.id) : false };
+ * }
  * ```
  */
 exports.User = (0, common_1.createParamDecorator)((data, ctx) => {

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

@@ -1 +1 @@
-{"version":3,"file":"user.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/user.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAAwE;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACU,QAAA,IAAI,GAAG,IAAA,6BAAoB,EACtC,CAAC,IAA+B,EAAE,GAAqB,EAAgD,EAAE;IACvG,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAA2B,CAAC;IAEjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CACF,CAAC"}
+{"version":3,"file":"user.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/user.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAAwE;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACU,QAAA,IAAI,GAAG,IAAA,6BAAoB,EACtC,CAAC,IAA+B,EAAE,GAAqB,EAAgD,EAAE;IACvG,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAA2B,CAAC;IAEjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CACF,CAAC"}

package/src/backend/dist/common/guards/auth.guard.d.ts

@@ -1,6 +1,6 @@
 /**
  * @fileoverview 认证守卫
- * @description 验证用户身份，解析 JWT Token 并注入到请求中
+ * @description 验证用户身份，解析 JWT Token 并注入到请求中。公共接口可选认证，非公共接口强制认证
  */
 import { CanActivate, ExecutionContext } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
@@ -14,12 +14,18 @@ export interface JwtPayload {
     sub: string;
     username: string;
     roleIds?: string[];
+    isDeveloper?: number;
     jti?: string;
 }
 /**
  * 认证守卫
  * @description 验证请求是否携带有效的 JWT Token
  *
+ * 行为说明：
+ * - 普通接口：必须携带有效 Token，否则抛出 UnauthorizedException
+ * - @Public() 公共接口：认证为可选。携带有效 Token 时注入用户信息（配合 @User() 使用），
+ *   无 Token 或 Token 无效时直接放行，不注入用户信息
+ *
  * @example
  * ```typescript
  * // 在模块中注册
@@ -37,6 +43,15 @@ export declare class AuthGuard implements CanActivate {
     private readonly logger;
     constructor(jwtService: JwtService, reflector: Reflector, redis?: IRedisOnlyService | undefined);
     canActivate(context: ExecutionContext): Promise<boolean>;
+    /**
+     * 解析 Token 并注入用户信息到请求对象
+     * @param request - HTTP 请求对象
+     * @param token - JWT Token 字符串
+     * @param options.required - 是否为必需认证。为 true 时 Token 无效或已黑名单将抛出异常；
+     *                           为 false（公共接口）时静默跳过，不注入用户信息
+     * @returns 是否成功注入用户信息
+     */
+    private authenticate;
     /**
      * 从请求头中提取 Token
      * @param request - HTTP 请求对象

package/src/backend/dist/common/guards/auth.guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.guard.d.ts","sourceRoot":"","sources":["../../../src/common/guards/auth.guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,WAAW,EACX,gBAAgB,EAKjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAEnF;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,qBACa,SAAU,YAAW,WAAW;IAIzC,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS;IACuB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IALjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;gBAG3C,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EAC6B,KAAK,CAAC,EAAE,iBAAiB,YAAA;IAG9E,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8C9D;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAI/B"}
+{"version":3,"file":"auth.guard.d.ts","sourceRoot":"","sources":["../../../src/common/guards/auth.guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,WAAW,EACX,gBAAgB,EAKjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAGnF;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,SAAU,YAAW,WAAW;IAIzC,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS;IACuB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IALjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;gBAG3C,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EAC6B,KAAK,CAAC,EAAE,iBAAiB,YAAA;IAG9E,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA0B9D;;;;;;;OAOG;YACW,YAAY;IAwC1B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAI/B"}

package/src/backend/dist/common/guards/auth.guard.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * @fileoverview 认证守卫
- * @description 验证用户身份，解析 JWT Token 并注入到请求中
+ * @description 验证用户身份，解析 JWT Token 并注入到请求中。公共接口可选认证，非公共接口强制认证
  */
 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;
@@ -27,6 +27,11 @@ const cache_module_1 = require("../../cache/cache.module");
  * 认证守卫
  * @description 验证请求是否携带有效的 JWT Token
  *
+ * 行为说明：
+ * - 普通接口：必须携带有效 Token，否则抛出 UnauthorizedException
+ * - @Public() 公共接口：认证为可选。携带有效 Token 时注入用户信息（配合 @User() 使用），
+ *   无 Token 或 Token 无效时直接放行，不注入用户信息
+ *
  * @example
  * ```typescript
  * // 在模块中注册
@@ -52,32 +57,49 @@ let AuthGuard = AuthGuard_1 = class AuthGuard {
             context.getHandler(),
             context.getClass(),
         ]);
-        // 如果是公共接口，直接放行
+        const request = context.switchToHttp().getRequest();
+        const token = this.extractTokenFromHeader(request);
+        // 公共接口：可选认证，有有效 Token 时注入用户信息，无 Token 或 Token 无效时直接放行
         if (isPublic) {
+            if (token) {
+                await this.authenticate(request, token, { required: false });
+            }
             return true;
         }
-        const request = context.switchToHttp().getRequest();
-        const token = this.extractTokenFromHeader(request);
+        // 非公共接口：必须携带有效 Token
         if (!token) {
             throw new common_1.UnauthorizedException('未授权，请先登录');
         }
+        await this.authenticate(request, token, { required: true });
+        return true;
+    }
+    /**
+     * 解析 Token 并注入用户信息到请求对象
+     * @param request - HTTP 请求对象
+     * @param token - JWT Token 字符串
+     * @param options.required - 是否为必需认证。为 true 时 Token 无效或已黑名单将抛出异常；
+     *                           为 false（公共接口）时静默跳过，不注入用户信息
+     * @returns 是否成功注入用户信息
+     */
+    async authenticate(request, token, options) {
         let payload;
         try {
             payload = await this.jwtService.verifyAsync(token);
         }
         catch {
-            throw new common_1.UnauthorizedException('Token 无效或已过期');
+            if (options.required) {
+                throw new common_1.UnauthorizedException('Token 无效或已过期');
+            }
+            return false;
         }
-        request['user'] = {
-            id: payload.sub,
-            username: payload.username,
-            roleIds: payload.roleIds,
-        };
         if (this.redis && payload.jti) {
             try {
                 const blacklisted = await this.redis.isBlacklisted(payload.jti);
                 if (blacklisted) {
-                    throw new common_1.UnauthorizedException('Token 已失效，请重新登录');
+                    if (options.required) {
+                        throw new common_1.UnauthorizedException('Token 已失效，请重新登录');
+                    }
+                    return false;
                 }
             }
             catch (error) {
@@ -86,6 +108,12 @@ let AuthGuard = AuthGuard_1 = class AuthGuard {
                 this.logger.warn('Redis 黑名单检查失败，降级放行', error instanceof Error ? error.message : error);
             }
         }
+        request['user'] = {
+            id: payload.sub,
+            username: payload.username,
+            roleIds: payload.roleIds,
+            isDeveloper: payload.isDeveloper,
+        };
         return true;
     }
     /**

package/src/backend/dist/common/guards/auth.guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.guard.js","sourceRoot":"","sources":["../../../src/common/guards/auth.guard.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,2CAQwB;AACxB,uCAAyC;AACzC,qCAAyC;AAEzC,qEAA+D;AAC/D,2DAA8D;AAc9D;;;;;;;;;;;;;GAaG;AAEI,IAAM,SAAS,iBAAf,MAAM,SAAS;IAIV;IACA;IACiD;IAL1C,MAAM,GAAG,IAAI,eAAM,CAAC,WAAS,CAAC,IAAI,CAAC,CAAC;IAErD,YACU,UAAsB,EACtB,SAAoB,EAC6B,KAAyB;QAF1E,eAAU,GAAV,UAAU,CAAY;QACtB,cAAS,GAAT,SAAS,CAAW;QAC6B,UAAK,GAAL,KAAK,CAAoB;IACjF,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAyB;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAU,gCAAa,EAAE;YACxE,OAAO,CAAC,UAAU,EAAE;YACpB,OAAO,CAAC,QAAQ,EAAE;SACnB,CAAC,CAAC;QAEH,eAAe;QACf,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAEnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,8BAAqB,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,OAAmB,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,8BAAqB,CAAC,cAAc,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,GAAG;YAChB,EAAE,EAAE,OAAO,CAAC,GAAG;YACf,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAChE,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,IAAI,8BAAqB,CAAC,iBAAiB,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,8BAAqB;oBAAE,MAAM,KAAK,CAAC;gBACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACK,sBAAsB,CAAC,OAAgB;QAC7C,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACtE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;CACF,CAAA;AAhEY,8BAAS;oBAAT,SAAS;IADrB,IAAA,mBAAU,GAAE;IAOR,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,iCAAkB,CAAC,CAAA;qCAFnB,gBAAU;QACX,gBAAS;GALnB,SAAS,CAgErB"}
+{"version":3,"file":"auth.guard.js","sourceRoot":"","sources":["../../../src/common/guards/auth.guard.ts"],"names":[],"mappings":"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"}

package/src/backend/dist/common/types/user.dto.d.ts

@@ -19,5 +19,9 @@ export declare class UserDto {
      * 角色 ID 列表
      */
     roleIds?: string[];
+    /**
+     * 是否为开发者（开发者绕过所有权限检查）
+     */
+    isDeveloper?: number;
 }
 //# sourceMappingURL=user.dto.d.ts.map

package/src/backend/dist/common/types/user.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.dto.d.ts","sourceRoot":"","sources":["../../../src/common/types/user.dto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,qBAAa,OAAO;IAClB;;OAEG;IAEH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IAEH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IAEH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}
+{"version":3,"file":"user.dto.d.ts","sourceRoot":"","sources":["../../../src/common/types/user.dto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,qBAAa,OAAO;IAClB;;OAEG;IAEH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IAEH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IAEH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IAEH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/src/backend/dist/common/types/user.dto.js

@@ -32,6 +32,10 @@ class UserDto {
      * 角色 ID 列表
      */
     roleIds;
+    /**
+     * 是否为开发者（开发者绕过所有权限检查）
+     */
+    isDeveloper;
 }
 exports.UserDto = UserDto;
 __decorate([
@@ -46,4 +50,8 @@ __decorate([
     (0, swagger_1.ApiProperty)({ description: '角色 ID 列表', type: [String], required: false }),
     __metadata("design:type", Array)
 ], UserDto.prototype, "roleIds", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '是否为开发者', required: false }),
+    __metadata("design:type", Number)
+], UserDto.prototype, "isDeveloper", void 0);
 //# sourceMappingURL=user.dto.js.map

package/src/backend/dist/common/types/user.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"user.dto.js","sourceRoot":"","sources":["../../../src/common/types/user.dto.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;AAEH,6CAA8C;AAE9C;;;GAGG;AACH,MAAa,OAAO;IAClB;;OAEG;IAEH,EAAE,CAAS;IAEX;;OAEG;IAEH,QAAQ,CAAS;IAEjB;;OAEG;IAEH,OAAO,CAAY;CACpB;AAlBD,0BAkBC;AAbC;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;;mCAC3B;AAMX;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;;yCACnB;AAMjB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;wCACvD"}
+{"version":3,"file":"user.dto.js","sourceRoot":"","sources":["../../../src/common/types/user.dto.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;AAEH,6CAA8C;AAE9C;;;GAGG;AACH,MAAa,OAAO;IAClB;;OAEG;IAEH,EAAE,CAAS;IAEX;;OAEG;IAEH,QAAQ,CAAS;IAEjB;;OAEG;IAEH,OAAO,CAAY;IAEnB;;OAEG;IAEH,WAAW,CAAU;CACtB;AAxBD,0BAwBC;AAnBC;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;;mCAC3B;AAMX;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;;yCACnB;AAMjB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;wCACvD;AAMnB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;4CACnC"}

package/src/backend/dist/config/jwt.config.d.ts

@@ -12,13 +12,13 @@ declare const _default: () => {
          * @type {number}
          * @default 7200 (2 小时)
          */
-        expiresIn: number;
+        expiresIn: string;
         /**
          * Refresh Token 过期时间（秒）
          * @type {number}
          * @default 7200 (2 小时)
          */
-        refreshExpiresIn: number;
+        refreshExpiresIn: string;
         /**
          * JWT 签名密钥
          * @type {string}

package/src/backend/dist/config/jwt.config.js

@@ -14,13 +14,13 @@ exports.default = () => ({
          * @type {number}
          * @default 7200 (2 小时)
          */
-        expiresIn: parseInt(process.env.JWT_EXPIRES_IN || '7200', 10),
+        expiresIn: process.env.JWT_EXPIRES_IN || '7200',
         /**
          * Refresh Token 过期时间（秒）
          * @type {number}
          * @default 7200 (2 小时)
          */
-        refreshExpiresIn: parseInt(process.env.JWT_REFRESH_EXPIRES_IN || process.env.JWT_EXPIRES_IN || '7200', 10),
+        refreshExpiresIn: process.env.JWT_REFRESH_EXPIRES_IN || process.env.JWT_EXPIRES_IN || '7200',
         /**
          * JWT 签名密钥
          * @type {string}

package/src/backend/dist/config/jwt.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.config.js","sourceRoot":"","sources":["../../src/config/jwt.config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,kBAAe,GAAG,EAAE,CAAC,CAAC;IACpB;;OAEG;IACH,GAAG,EAAE;QACH;;;;WAIG;QACH,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC;QAE7D;;;;WAIG;QACH,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC;QAE1G;;;WAGG;QACH,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE;KACrC;CACF,CAAC,CAAC"}
+{"version":3,"file":"jwt.config.js","sourceRoot":"","sources":["../../src/config/jwt.config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,kBAAe,GAAG,EAAE,CAAC,CAAC;IACpB;;OAEG;IACH,GAAG,EAAE;QACH;;;;WAIG;QACH,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM;QAE/C;;;;WAIG;QACH,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM;QAE5F;;;WAGG;QACH,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE;KACrC;CACF,CAAC,CAAC"}

package/src/backend/dist/create-base-backend-app.d.ts

@@ -6,5 +6,5 @@ import { CreateBaseBackendAppOptions, BaseBackendAppInstance } from "./types/app
  * 创建后端应用实例
  */
 export declare function createBaseBackendApp(options?: CreateBaseBackendAppOptions): Promise<BaseBackendAppInstance>;
-export type { CreateBaseBackendAppOptions, BaseBackendAppInstance, AppTypeConfig, RoleConfig, RouteSyncConfig, HookConfig, AppContext, DatabaseConfig, RedisConfig, JwtConfig, SwaggerGroupConfig, } from "./types/app-config.types";
+export type { CreateBaseBackendAppOptions, BaseBackendAppInstance, AppTypeConfig, RoleConfig, HookConfig, AppContext, DatabaseConfig, RedisConfig, JwtConfig, SwaggerGroupConfig, } from "./types/app-config.types";
 //# sourceMappingURL=create-base-backend-app.d.ts.map

package/src/backend/dist/create-base-backend-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-base-backend-app.d.ts","sourceRoot":"","sources":["../src/create-base-backend-app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EAGvB,MAAM,0BAA0B,CAAC;AAyClC;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,sBAAsB,CAAC,CA+JjC;AAsMD,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,eAAe,EACf,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"create-base-backend-app.d.ts","sourceRoot":"","sources":["../src/create-base-backend-app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EAGvB,MAAM,0BAA0B,CAAC;AAyClC;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAkHjC;AAsMD,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}

package/src/backend/dist/create-base-backend-app.js

@@ -137,43 +137,6 @@ async function createBaseBackendApp(options = {}) {
             }
         }
     }
-    // 路由数据自动同步（在应用类型同步之后执行，仅已初始化的系统且配置启用时才执行）
-    if (options.routeSync?.enabled && options.routeSync.menuTrees?.length > 0) {
-        console.log(`\n🔄 [RouteSync] 开始菜单树同步检查...（${options.routeSync.menuTrees.length} 个 AppType）`);
-        try {
-            const appTypeRepo = dataSource.getRepository((await Promise.resolve().then(() => __importStar(require("./modules/sys/app-type/entities/app-type.entity"))))
-                .AppType);
-            const isInitialized = (await appTypeRepo.count()) > 0;
-            if (!isInitialized) {
-                console.log("⏳ [RouteSync] 系统未初始化，跳过");
-            }
-            else {
-                console.log("📡 [RouteSync] 正在获取 RouteSyncService...");
-                const { RouteSyncService } = await Promise.resolve().then(() => __importStar(require("./modules/sys/route-sync/route-sync.service")));
-                const routeSyncService = app.get(RouteSyncService);
-                console.log("✅ [RouteSync] RouteSyncService 获取成功，开始同步...");
-                const result = await routeSyncService.syncMenuTrees(options.routeSync.menuTrees);
-                if (result.skipped) {
-                    console.log("✅ [RouteSync] 菜单树配置未变更，跳过路由数据同步");
-                }
-                else {
-                    console.log(`✅ [RouteSync] 路由数据同步完成：${result.syncedAppTypes.length} 个应用类型，` +
-                        `${result.permissionCount} 个权限变动，${result.poolCount} 个权限池记录，` +
-                        `${result.rolePermCount} 个角色权限记录`);
-                }
-            }
-        }
-        catch (error) {
-            if (error.message?.includes("ER_NO_SUCH_TABLE")) {
-                console.log("⏳ [RouteSync] 数据库表未创建，跳过");
-            }
-            else {
-                console.error("❌ [RouteSync] 路由数据同步失败:");
-                console.error("  错误:", error.message);
-                console.error("  堆栈:", error.stack);
-            }
-        }
-    }
     return {
         app,
         listen: async (port) => {