cabloy 5.1.50 → 5.1.52

package/vona/src/suite-vendor/a-vona/modules/a-permission/src/bean/bean.permission.ts

@@ -4,87 +4,156 @@ import type {
   IOpenapiPermissions,
   IResourceRecord,
 } from 'vona-module-a-openapi';
-import type {
-  ContextRoute,
-  ContextRouteBase,
-  ContextRouteMetadata,
-  IRecordResourceNameToRoutePathItem,
-} from 'vona-module-a-web';
+import type { IGuardOptionsPassport, IGuardOptionsRoleName } from 'vona-module-a-user';
+import type { ContextRouteMetadata, IRecordResourceNameToRoutePathItem } from 'vona-module-a-web';
 
-import { catchError } from '@cabloy/utils';
 import { appMetadata, appResource, BeanBase, beanFullNameFromOnionName } from 'vona';
 import { Bean } from 'vona-module-a-bean';
 import { Caching } from 'vona-module-a-caching';
 import { SymbolUseOnionOptionsRouteReal } from 'vona-module-a-onion';
-import { composeGuards, recordResourceNameToRoutePath } from 'vona-module-a-web';
+import { recordResourceNameToRoutePath } from 'vona-module-a-web';
+
+const BeanFullNameGuardPassport = beanFullNameFromOnionName('a-user:passport', 'guard');
+const BeanFullNameGuardRoleName = beanFullNameFromOnionName('a-user:roleName', 'guard');
+const BeanFullNameGuardUserName = beanFullNameFromOnionName('a-user:userName', 'guard');
+const BeanFullNamesGuardSupported = new Set<string>([
+  BeanFullNameGuardPassport,
+  BeanFullNameGuardRoleName,
+  BeanFullNameGuardUserName,
+]);
+const GuardOptionsPassportDefault: IGuardOptionsPassport = {
+  public: false,
+  activated: true,
+  checkAuthToken: true,
+};
+
+type TGuardMeta = Record<string, unknown>;
 
 @Bean()
 export class BeanPermission extends BeanBase {
-  public async clearAllCaches() {
-    const cacheOpenapiSchema = this.bean.summer.cache(
+  public async clearAllCaches(): Promise<void> {
+    const cachePermission = this.bean.summer.cache(
       beanFullNameFromOnionName('a-permission:permission', 'summerCache'),
     );
-    await cacheOpenapiSchema.clear();
+    await cachePermission.clear();
   }
 
-  protected retrievePermissionsCacheKey(info: ICachingActionKeyInfo) {
+  protected retrievePermissionsCacheKey(info: ICachingActionKeyInfo): string {
     const resource = info.args[0];
     const userId = this.ctx.passport.user?.id;
-    return `${resource}_${userId}`;
+    return `user:${resource}_${userId}`;
+  }
+
+  protected retrievePermissionsDefaultCacheKey(info: ICachingActionKeyInfo): string {
+    return `default:${this._buildPermissionProfileKey(info.args[0])}`;
   }
 
   @Caching.get({ cacheName: 'a-permission:permission', cacheKeyFn: 'retrievePermissionsCacheKey' })
   async retrievePermissions(resource: keyof IResourceRecord): Promise<IOpenapiPermissions> {
     return await this.scope.event.retrievePermissions.emit({ resource }, async () => {
-      return await this.getPermissionsDefault(resource);
+      return await this.retrievePermissionsDefault(resource);
     });
   }
 
+  @Caching.get({
+    cacheName: 'a-permission:permission',
+    cacheKeyFn: 'retrievePermissionsDefaultCacheKey',
+  })
+  protected async retrievePermissionsDefault(
+    resource: keyof IResourceRecord,
+  ): Promise<IOpenapiPermissions> {
+    return await this.getPermissionsDefault(resource);
+  }
+
   async getPermissionsDefault(resource: keyof IResourceRecord): Promise<IOpenapiPermissions> {
     const routePathInfo: IRecordResourceNameToRoutePathItem =
       recordResourceNameToRoutePath[resource];
     if (!routePathInfo) throw new Error(`not found routePath of resource: ${resource}`);
-    // controller options
     const controller = routePathInfo.controller;
-    // controller options
-    const beanOptions = appResource.getBean(controller);
-    if (!beanOptions) throw new Error('invalid controller');
-    const controllerBeanFullName = beanOptions.beanFullName;
-    // descs
+    if (!appResource.getBean(controller)) throw new Error('invalid controller');
     const descs = Object.getOwnPropertyDescriptors(controller.prototype);
     const actionsIgnore = this.scope.config.permission.actionsIgnore;
     const actionKeys = Object.keys(descs).filter(
-      actionKey => !['constructor'].includes(actionKey) && !actionsIgnore.includes(actionKey),
+      actionKey => actionKey !== 'constructor' && !actionsIgnore.includes(actionKey),
     );
-    // actions
     const permissionsActions: IOpenapiPermissionModeActionActions = {};
     for (const actionKey of actionKeys) {
       const desc = descs[actionKey];
       if (!desc.value || typeof desc.value !== 'function') continue;
-      const routeReal: ContextRouteMetadata = appMetadata.getMetadata(
+      const routeReal: ContextRouteMetadata | undefined = appMetadata.getMetadata(
         SymbolUseOnionOptionsRouteReal,
         controller.prototype,
         actionKey,
-      )!;
-      const route: Partial<ContextRoute> = {
-        controller,
-        controllerBeanFullName,
-        action: actionKey,
-        route: routeReal,
-      };
-      permissionsActions[actionKey] = await this._getPermissionOfAction(route);
+      );
+      permissionsActions[actionKey] = this._getPermissionOfActionByMetadata(routeReal);
     }
     return { actions: permissionsActions };
   }
 
-  private async _getPermissionOfAction(route: Partial<ContextRoute>) {
-    const routePrev = this.ctx.route;
-    this.ctx.route = route as ContextRoute;
-    const composer = composeGuards(this.app, route as ContextRouteBase);
-    const [_, error] = await catchError(() => {
-      return composer(this.ctx);
-    });
-    this.ctx.route = routePrev;
-    return !error;
+  private _buildPermissionProfileKey(resource: keyof IResourceRecord): string {
+    if (!this.bean.passport.isAuthenticated) return `${resource}__anon`;
+    const activated = this.bean.passport.isActivated ? 1 : 0;
+    const roleNames = this._extractCurrentRoleNames();
+    return `${resource}__auth__act:${activated}__roles:${roleNames.join(',')}`;
+  }
+
+  private _extractCurrentRoleNames(): string[] {
+    const roleNames = this.bean.passport.currentRoles?.map(item => item.name) ?? [];
+    return Array.from(new Set(roleNames)).sort();
+  }
+
+  private _getPermissionOfActionByMetadata(routeReal: ContextRouteMetadata | undefined): boolean {
+    if (!routeReal?.meta) return false;
+    return this._evaluatePassportGuardsStatically(routeReal.meta);
+  }
+
+  private _evaluatePassportGuardsStatically(meta: TGuardMeta): boolean {
+    if (this._hasUnknownGuard(meta)) return false;
+    if (this._hasDynamicUserNameGuard(meta)) return false;
+    const passportOptions = this._getPassportOptions(meta);
+    if (!this._matchPassportOptions(passportOptions)) return false;
+    const roleNameOptions = meta[BeanFullNameGuardRoleName] as
+      | Partial<IGuardOptionsRoleName>
+      | undefined;
+    if (!this._matchRoleNameOptions(roleNameOptions)) return false;
+    return true;
+  }
+
+  private _hasUnknownGuard(meta: TGuardMeta): boolean {
+    return Object.keys(meta).some(
+      key => key.includes('.guard.') && !BeanFullNamesGuardSupported.has(key),
+    );
+  }
+
+  private _hasDynamicUserNameGuard(meta: TGuardMeta): boolean {
+    return BeanFullNameGuardUserName in meta;
+  }
+
+  private _getPassportOptions(meta: TGuardMeta): IGuardOptionsPassport {
+    return {
+      ...GuardOptionsPassportDefault,
+      ...(meta[BeanFullNameGuardPassport] as Partial<IGuardOptionsPassport> | undefined),
+    };
+  }
+
+  private _matchPassportOptions(
+    options: Pick<IGuardOptionsPassport, 'public' | 'activated'>,
+  ): boolean {
+    const isAuthenticated = this.bean.passport.isAuthenticated;
+    if (!options.public && !isAuthenticated) return false;
+    if (!isAuthenticated) return true;
+    if (options.activated === true && !this.bean.passport.isActivated) return false;
+    if (options.activated === false && this.bean.passport.isActivated) return false;
+    return true;
+  }
+
+  private _matchRoleNameOptions(options: Partial<IGuardOptionsRoleName> | undefined): boolean {
+    if (!options) return true;
+    if (!options.name) return false;
+    if (options.passWhenMatched === false) return false;
+    if (options.rejectWhenDismatched === false) return false;
+    const roleNamesCurrent = this._extractCurrentRoleNames();
+    const roleNamesRequired = Array.isArray(options.name) ? options.name : [options.name];
+    return roleNamesCurrent.some(roleName => roleNamesRequired.includes(roleName as any));
   }
 }

package/vona/src/suite-vendor/a-vona/modules/a-permission/src/bean/summerCache.permission.ts

@@ -1,13 +1,13 @@
 import type { ISummerCacheGet, TSummerCacheActionOptions } from 'vona-module-a-summer';
 
-import { BeanSummerCacheBase, SummerCache } from 'vona-module-a-summer';
+import { ServiceSummerCacheBase, SummerCache } from 'vona-module-a-summer';
 
 export type TSummerCachePermissionKey = any;
 export type TSummerCachePermissionData = any;
 
 @SummerCache({ preset: 'mem' })
 export class SummerCachePermission
-  extends BeanSummerCacheBase<TSummerCachePermissionKey, TSummerCachePermissionData>
+  extends ServiceSummerCacheBase<TSummerCachePermissionKey, TSummerCachePermissionData>
   implements ISummerCacheGet<TSummerCachePermissionKey, TSummerCachePermissionData>
 {
   async getNative(

package/vona/src/suite-vendor/a-vona/modules/a-startup/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-startup",
-  "version": "5.1.6",
+  "version": "5.1.7",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-startup/src/bean/cacheRedis.startupDebounce.ts

@@ -1,4 +1,4 @@
-import { BeanCacheRedisBase, CacheRedis } from 'vona-module-a-cache';
+import { ServiceCacheRedisBase, CacheRedis } from 'vona-module-a-cache';
 
 export type TCacheRedisStartupDebounceKey = `startupDebounce:${string}`;
 export type TCacheRedisStartupDebounceData = boolean;
@@ -8,7 +8,7 @@ export type TCacheRedisStartupDebounceData = boolean;
   disableTransactionCompensate: true,
   client: 'worker',
 })
-export class CacheRedisStartupDebounce extends BeanCacheRedisBase<
+export class CacheRedisStartupDebounce extends ServiceCacheRedisBase<
   TCacheRedisStartupDebounceKey,
   TCacheRedisStartupDebounceData
 > {}

package/vona/src/suite-vendor/a-vona/modules/a-summer/cli/boilerplate/{{sceneName}}.{{beanName}}.ts_

@@ -1,12 +1,12 @@
 import type { ISummerCacheGet, TSummerCacheActionOptions } from 'vona-module-a-summer';
-import { BeanSummerCacheBase, SummerCache } from 'vona-module-a-summer';
+import { ServiceSummerCacheBase, SummerCache } from 'vona-module-a-summer';
 
 export type TSummerCache<%=argv.beanNameCapitalize%>Key = any;
 export type TSummerCache<%=argv.beanNameCapitalize%>Data = any;
 
 @SummerCache()
 export class SummerCache<%=argv.beanNameCapitalize%>
-  extends BeanSummerCacheBase<TSummerCache<%=argv.beanNameCapitalize%>Key, TSummerCache<%=argv.beanNameCapitalize%>Data>
+  extends ServiceSummerCacheBase<TSummerCache<%=argv.beanNameCapitalize%>Key, TSummerCache<%=argv.beanNameCapitalize%>Data>
   implements ISummerCacheGet<TSummerCache<%=argv.beanNameCapitalize%>Key, TSummerCache<%=argv.beanNameCapitalize%>Data> {
   async getNative(
     _key?: TSummerCache<%=argv.beanNameCapitalize%>Key,

package/vona/src/suite-vendor/a-vona/modules/a-summer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-summer",
-  "version": "5.1.6",
+  "version": "5.1.7",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "Layered Cache",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-summer/src/.metadata/index.ts

@@ -1,7 +1,6 @@
 // eslint-disable
 /** bean: begin */
 export * from '../bean/bean.summer.ts';
-export * from '../bean/bean.summerCacheBase.ts';
 
 import 'vona';
 declare module 'vona' {
@@ -29,6 +28,7 @@ declare module 'vona' {
 export * from '../service/localFetch_.ts';
 export * from '../service/localMem_.ts';
 export * from '../service/localRedis_.ts';
+export * from '../service/summerCacheBase_.ts';
 
 import 'vona-module-a-bean';
 declare module 'vona-module-a-bean' {

package/vona/src/suite-vendor/a-vona/modules/a-summer/src/bean/bean.summer.ts

@@ -3,17 +3,17 @@ import { Bean } from 'vona-module-a-bean';
 
 import type { IDecoratorSummerCacheOptions } from '../types/summerCache.ts';
 
-import { BeanSummerCacheBase } from './bean.summerCacheBase.ts';
+import { ServiceSummerCacheBase } from '../service/summerCacheBase_.ts';
 
 @Bean()
 export class BeanSummer extends BeanBase {
   cache<KEY, DATA>(
     cacheName: string,
     cacheOptions?: IDecoratorSummerCacheOptions,
-  ): BeanSummerCacheBase<KEY, DATA> {
+  ): ServiceSummerCacheBase<KEY, DATA> {
     if (cacheName.includes('.summerCache.')) {
       return this.app.bean._getBeanSelector(cacheName as any, undefined, cacheOptions);
     }
-    return this.app.bean._getBeanSelector(BeanSummerCacheBase, cacheName, cacheOptions);
+    return this.app.bean._getBeanSelector(ServiceSummerCacheBase, cacheName, cacheOptions);
   }
 }

package/vona/src/suite-vendor/a-vona/modules/a-summer/src/service/localMem_.ts

@@ -1,4 +1,4 @@
-import type { BeanCacheMemBase } from 'vona-module-a-cache';
+import type { ServiceCacheMemBase } from 'vona-module-a-cache';
 
 import { Service } from 'vona-module-a-bean';
 
@@ -12,7 +12,7 @@ export class ServiceLocalMem<KEY = any, DATA = any>
   extends CacheBase<KEY, DATA>
   implements ICacheLayeredBase<KEY, DATA>
 {
-  private _cacheMemInstance: BeanCacheMemBase<KEY, DATA> | undefined;
+  private _cacheMemInstance: ServiceCacheMemBase<KEY, DATA> | undefined;
 
   protected async __dispose__() {
     if (this._cacheMemInstance) {
@@ -21,7 +21,7 @@ export class ServiceLocalMem<KEY = any, DATA = any>
     }
   }
 
-  get cacheMem(): BeanCacheMemBase<KEY, DATA> {
+  get cacheMem(): ServiceCacheMemBase<KEY, DATA> {
     if (!this._cacheMemInstance) {
       this._cacheMemInstance = this.app.bean.cache.mem(this._cacheName, this._cacheOptions.mem);
     }

package/vona/src/suite-vendor/a-vona/modules/a-summer/src/service/localRedis_.ts

@@ -1,4 +1,4 @@
-import type { BeanCacheRedisBase } from 'vona-module-a-cache';
+import type { ServiceCacheRedisBase } from 'vona-module-a-cache';
 
 import { Service } from 'vona-module-a-bean';
 
@@ -12,7 +12,7 @@ export class ServiceLocalRedis<KEY = any, DATA = any>
   extends CacheBase<KEY, DATA>
   implements ICacheLayeredBase<KEY, DATA>
 {
-  private _cacheRedisInstance: BeanCacheRedisBase<KEY, DATA> | undefined;
+  private _cacheRedisInstance: ServiceCacheRedisBase<KEY, DATA> | undefined;
 
   protected async __dispose__() {
     if (this._cacheRedisInstance) {
@@ -21,7 +21,7 @@ export class ServiceLocalRedis<KEY = any, DATA = any>
     }
   }
 
-  get cacheRedis(): BeanCacheRedisBase<KEY, DATA> {
+  get cacheRedis(): ServiceCacheRedisBase<KEY, DATA> {
     if (!this._cacheRedisInstance) {
       this._cacheRedisInstance = this.app.bean.cache.redis(
         this._cacheName,

package/vona/src/suite-vendor/a-vona/modules/a-summer/src/{bean/bean.summerCacheBase.ts → service/summerCacheBase_.ts}

@@ -1,5 +1,5 @@
 import { deepExtend, Virtual } from 'vona';
-import { Bean } from 'vona-module-a-bean';
+import { Service } from 'vona-module-a-bean';
 
 import type {
   IDecoratorSummerCacheOptions,
@@ -8,9 +8,9 @@ import type {
 
 import { CacheBase } from '../common/cacheBase.ts';
 
-@Bean()
+@Service()
 @Virtual()
-export class BeanSummerCacheBase<KEY = any, DATA = any> extends CacheBase<KEY, DATA> {
+export class ServiceSummerCacheBase<KEY = any, DATA = any> extends CacheBase<KEY, DATA> {
   protected __init__(cacheName?: string, cacheOptions?: IDecoratorSummerCacheOptions) {
     let _cacheName: string;
     let _cacheOptions: IDecoratorSummerCacheOptions;

package/vona/src/suite-vendor/a-vona/modules/a-swagger/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-swagger",
-  "version": "5.1.5",
+  "version": "5.1.6",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-swagger/src/bean/summerCache.rapidoc.ts

@@ -1,13 +1,13 @@
 import type { ISummerCacheGet, TSummerCacheActionOptions } from 'vona-module-a-summer';
 
-import { BeanSummerCacheBase, SummerCache } from 'vona-module-a-summer';
+import { ServiceSummerCacheBase, SummerCache } from 'vona-module-a-summer';
 
 export type TSummerCacheRapidocKey = any;
 export type TSummerCacheRapidocData = any;
 
 @SummerCache({ preset: 'mem' })
 export class SummerCacheRapidoc
-  extends BeanSummerCacheBase<TSummerCacheRapidocKey, TSummerCacheRapidocData>
+  extends ServiceSummerCacheBase<TSummerCacheRapidocKey, TSummerCacheRapidocData>
   implements ISummerCacheGet<TSummerCacheRapidocKey, TSummerCacheRapidocData>
 {
   async getNative(

package/vona/src/suite-vendor/a-vona/modules/a-swagger/src/bean/summerCache.swagger.ts

@@ -1,13 +1,13 @@
 import type { ISummerCacheGet, TSummerCacheActionOptions } from 'vona-module-a-summer';
 
-import { BeanSummerCacheBase, SummerCache } from 'vona-module-a-summer';
+import { ServiceSummerCacheBase, SummerCache } from 'vona-module-a-summer';
 
 export type TSummerCacheSwaggerKey = any;
 export type TSummerCacheSwaggerData = any;
 
 @SummerCache({ preset: 'mem' })
 export class SummerCacheSwagger
-  extends BeanSummerCacheBase<TSummerCacheSwaggerKey, TSummerCacheSwaggerData>
+  extends ServiceSummerCacheBase<TSummerCacheSwaggerKey, TSummerCacheSwaggerData>
   implements ISummerCacheGet<TSummerCacheSwaggerKey, TSummerCacheSwaggerData>
 {
   async getNative(

package/vona/src/suite-vendor/a-vona/modules/a-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-user",
-  "version": "5.1.10",
+  "version": "5.1.11",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-user/src/bean/cacheRedis.authToken.ts

@@ -1,4 +1,4 @@
-import { BeanCacheRedisBase, CacheRedis } from 'vona-module-a-cache';
+import { ServiceCacheRedisBase, CacheRedis } from 'vona-module-a-cache';
 
 export type TCacheRedisAuthTokenKey = string;
 export type TCacheRedisAuthTokenData = string;
@@ -7,7 +7,7 @@ export type TCacheRedisAuthTokenData = string;
   ttl: 30 * 24 * 60 * 60 * 1000,
   disableTransactionCompensate: true,
 })
-export class CacheRedisAuthToken extends BeanCacheRedisBase<
+export class CacheRedisAuthToken extends ServiceCacheRedisBase<
   TCacheRedisAuthTokenKey,
   TCacheRedisAuthTokenData
 > {}

package/vona/src/suite-vendor/a-vona/modules/a-worker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-worker",
-  "version": "5.1.5",
+  "version": "5.1.6",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-worker/src/bean/cacheRedis.workerAlive.ts

@@ -1,4 +1,4 @@
-import { BeanCacheRedisBase, CacheRedis } from 'vona-module-a-cache';
+import { ServiceCacheRedisBase, CacheRedis } from 'vona-module-a-cache';
 
 export type TCacheRedisWorkerAliveKey = string;
 export type TCacheRedisWorkerAliveData = boolean;
@@ -8,7 +8,7 @@ export type TCacheRedisWorkerAliveData = boolean;
   disableTransactionCompensate: true,
   client: 'worker',
 })
-export class CacheRedisWorkerAlive extends BeanCacheRedisBase<
+export class CacheRedisWorkerAlive extends ServiceCacheRedisBase<
   TCacheRedisWorkerAliveKey,
   TCacheRedisWorkerAliveData
 > {}

package/vona/src/suite-vendor/a-vona/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-suite-a-vona",
-  "version": "5.1.33",
+  "version": "5.1.34",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "author": "",

package/zova/README.md

@@ -1,10 +1,10 @@
-English | [简体中文](./README.zh-CN.md)
+English | [Simplified Chinese](./README.zh-CN.md)
 
 # Zova
 
 Zova: The Intuitive Frontend Framework = Vue3 Reactive + React TSX + Angular IOC
 
-- Built-in out-of-the-box SSR solution, building `SSR/SPA/Website/Admin-Dashboard` in one codebase
+- Built-in out-of-the-box SSR solution, building `SSR/SPA/Web/Admin` in one codebase
 - Supports dual-layer tabs navigation, enabling efficient page switching while maintaining page state
 - Dynamically render CRUD list pages, entry pages, and search forms, while demonstrating best practices for Tanstack Table, Tanstack Form, and Tanstack Query
 
@@ -39,10 +39,10 @@ Zova can be used with any UI library and comes with built-in project templates f
 
 ## Demo Online 2
 
-The Website and Admin-Dashboard of Cabloy Store are built by one codebase
+The Web and Admin of Cabloy Store are built by one codebase
 
-- Website: [https://cabloy.com](https://cabloy.com)
-- Admin-Dashboard: [https://cabloy.com/admin](https://cabloy.com/admin)
+- Web: [https://cabloy.com](https://cabloy.com)
+- Admin: [https://cabloy.com/admin](https://cabloy.com/admin)
 
 ## GIF Demo
 

package/zova/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 Zova: 直观的前端框架 = Vue3 响应式 + React TSX + Angular IOC
 
-- 内置开箱即用的 SSR 解决方案，可在同一个代码库中实现`SSR/SPA/Web网站/Admin中后台`
+- 内置开箱即用的 SSR 解决方案，可在同一个代码库中实现`SSR/SPA/Web/Admin`
 - 支持双层页签导航，实现高效页面切换，并保持页面状态
 - 可动态渲染 CRUD 的列表页、条目页、搜索表单，并且提供了`Tanstack Table/Tanstack Form/Tanstack Query`的最佳实践
 - 提供强大的 IOC + AOP 能力，让系统具有无与伦比的可扩展性和可维护性
@@ -40,10 +40,10 @@ Zova 可以搭配任何 UI 库使用，并且内置了几款 UI 库的项目模
 
 ## 在线演示2
 
-使用同一套代码实现 Cabloy Store 的`Web网站`和`Admin中后台`
+使用同一套代码实现 Cabloy Store 的`Web`和`Admin`
 
-- Web 网站：[https://cabloy.com](https://cabloy.com)
-- Admin 中后台：[https://cabloy.com/admin](https://cabloy.com/admin)
+- Web：[https://cabloy.com](https://cabloy.com)
+- Admin：[https://cabloy.com/admin](https://cabloy.com/admin)
 
 ## 动图演示
 

package/zova/package.original.json

@@ -67,11 +67,11 @@
   "devDependencies": {
     "@cabloy/lint": "^5.1.27",
     "@cabloy/openapi-typescript": "^7.9.2",
-    "@quasar/app-vite": "npm:@cabloy/quasar-app-vite@^2.5.9",
+    "@quasar/app-vite": "npm:@cabloy/quasar-app-vite@^2.5.10",
     "@types/node": "^22.19.17",
     "@vitejs/plugin-vue": "^6.0.7",
     "concurrently": "^8.2.2",
-    "quasar-app-extension-zova": "^1.3.0",
+    "quasar-app-extension-zova": "^1.3.1",
     "sass": "^1.99.0",
     "typescript": "^5.9.3",
     "vite": "^8.0.14",
@@ -91,10 +91,10 @@
   },
   "pnpm": {
     "overrides": {
-      "@quasar/app-vite": "npm:@cabloy/quasar-app-vite@^2.5.9",
+      "@quasar/app-vite": "npm:@cabloy/quasar-app-vite@^2.5.10",
       "@vue/babel-plugin-jsx": "npm:@cabloy/vue-babel-plugin-jsx@^2.0.1",
       "@vue/compiler-sfc": "npm:@cabloy/vue-compiler-sfc@^3.5.14",
-      "@vue/runtime-core": "npm:@cabloy/vue-runtime-core@^3.5.53",
+      "@vue/runtime-core": "npm:@cabloy/vue-runtime-core@^3.5.56",
       "@vue/runtime-dom": "npm:@cabloy/vue-runtime-dom@^3.5.13",
       "@vue/reactivity": "npm:@cabloy/vue-reactivity@^3.5.16",
       "@vue/server-renderer": "npm:@cabloy/vue-server-renderer@^3.5.18",

package/zova/packages-cli/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova-cli",
-  "version": "1.2.73",
+  "version": "1.2.74",
   "gitHead": "6f675a8cc46d596142c591c28a40cc4d82fcc6cc",
   "description": "zova cli",
   "keywords": [
@@ -44,7 +44,7 @@
     "@cabloy/process-helper": "^3.0.0",
     "fs-extra": "^11.3.5",
     "semver": "^7.6.2",
-    "zova-cli-set-front": "^1.2.71"
+    "zova-cli-set-front": "^1.2.72"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",

package/zova/packages-cli/cli-set-front/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova-cli-set-front",
-  "version": "1.2.71",
+  "version": "1.2.72",
   "gitHead": "6f675a8cc46d596142c591c28a40cc4d82fcc6cc",
   "description": "zova cli-set-front",
   "keywords": [
@@ -70,7 +70,7 @@
     "vite": "^8.0.14",
     "yaml": "^2.8.3",
     "zova-openapi": "^1.1.14",
-    "zova-vite": "^1.1.33"
+    "zova-vite": "^1.1.34"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",

package/zova/packages-utils/zova-jsx/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova-jsx",
-  "version": "1.1.54",
+  "version": "1.1.55",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "Zova JSX",
   "keywords": [
@@ -50,7 +50,7 @@
     "@cabloy/word-utils": "^2.1.14",
     "typestyle": "^2.4.0",
     "vue": "^3.5.32",
-    "zova-core": "^5.1.48"
+    "zova-core": "^5.1.49"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",

package/zova/packages-utils/zova-vite/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova-vite",
-  "version": "1.1.33",
+  "version": "1.1.34",
   "gitHead": "09d901d17140a80ee0764211b441cda72fd94663",
   "description": "zova vite",
   "keywords": [
@@ -49,7 +49,7 @@
     "@cabloy/vue-compiler-sfc": "^3.5.14",
     "@cabloy/vue-reactivity": "^3.5.16",
     "@cabloy/vue-router": "^4.4.16",
-    "@cabloy/vue-runtime-core": "^3.5.53",
+    "@cabloy/vue-runtime-core": "^3.5.56",
     "@cabloy/vue-runtime-dom": "^3.5.13",
     "@cabloy/vue-server-renderer": "^3.5.18",
     "@faker-js/faker": "^8.4.1",

package/zova/packages-utils/zova-vite/templates/app/controller.tsx_

@@ -7,11 +7,11 @@ export class ControllerPageApp extends BeanControllerPageBase {
     // app
     const instance = getCurrentInstance();
     const app = instance!.appContext.app!;
-    if (!app.zova) {
-      await this.initApp(app);
-    } else {
+    if (app.zova) {
       await this.updateApp(app.zova);
+      return;
     }
+    await this.initApp(app);
   }
 
   protected render() {