@nocobase/client-v2 2.1.0-beta.33 → 2.1.0-beta.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocobase/client-v2",
-  "version": "2.1.0-beta.33",
+  "version": "2.1.0-beta.34",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.mjs",
@@ -20,14 +20,16 @@
   },
   "dependencies": {
     "@ant-design/icons": "^5.6.1",
+    "@dnd-kit/core": "^6.0.0",
+    "@dnd-kit/sortable": "^7.0.0",
     "@emotion/css": "^11.7.1",
     "@formily/antd-v5": "1.2.3",
     "@formily/react": "^2.2.27",
     "@formily/shared": "^2.2.27",
-    "@nocobase/evaluators": "2.1.0-beta.33",
-    "@nocobase/flow-engine": "2.1.0-beta.33",
-    "@nocobase/sdk": "2.1.0-beta.33",
-    "@nocobase/shared": "2.1.0-beta.33",
+    "@nocobase/evaluators": "2.1.0-beta.34",
+    "@nocobase/flow-engine": "2.1.0-beta.34",
+    "@nocobase/sdk": "2.1.0-beta.34",
+    "@nocobase/shared": "2.1.0-beta.34",
     "ahooks": "^3.7.2",
     "antd": "5.24.2",
     "antd-style": "3.7.1",
@@ -41,5 +43,5 @@
     "react-i18next": "^11.15.1",
     "react-router-dom": "^6.30.1"
   },
-  "gitHead": "4815c394e80a264fa8ed619246280923c47aeb72"
+  "gitHead": "ca804833299c547f8d49f8d58f73273a4bfcd03c"
 }

package/src/APIClient.ts

@@ -0,0 +1,68 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import { APIClient as APIClientSDK, type APIClientOptions, hasHeaderValue } from '@nocobase/sdk';
+
+function offsetToTimeZone(offset: number) {
+  const hours = Math.floor(Math.abs(offset));
+  const minutes = Math.abs((offset % 1) * 60);
+  const formattedHours = String(hours).padStart(2, '0');
+  const formattedMinutes = String(minutes).padStart(2, '0');
+  const sign = offset >= 0 ? '+' : '-';
+  return `${sign}${formattedHours}:${formattedMinutes}`;
+}
+
+function getCurrentTimezone() {
+  return offsetToTimeZone(new Date().getTimezoneOffset() / -60);
+}
+
+export class APIClient extends APIClientSDK {
+  appName?: string;
+
+  constructor(options?: APIClientOptions) {
+    super(options);
+    if (options && typeof options !== 'function') {
+      this.appName = options.appName;
+    }
+  }
+
+  getHostname() {
+    if (process.env.API_BASE_URL) {
+      try {
+        return new URL(process.env.API_BASE_URL).hostname;
+      } catch {
+        // fall through to window.location.hostname
+      }
+    }
+    return window?.location?.hostname;
+  }
+
+  getHeaders() {
+    const headers = super.getHeaders();
+    if (this.appName) {
+      headers['X-App'] = this.appName;
+    }
+    headers['X-Timezone'] = getCurrentTimezone();
+    headers['X-Hostname'] = this.getHostname();
+    return headers;
+  }
+
+  interceptors() {
+    this.axios.interceptors.request.use((config) => {
+      const headers = this.getHeaders();
+      Object.keys(headers).forEach((key) => {
+        if (!hasHeaderValue(config.headers, key)) {
+          config.headers[key] = headers[key];
+        }
+      });
+      return config;
+    });
+    super.interceptors();
+  }
+}

package/src/Application.tsx

@@ -7,10 +7,11 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 
-import { APIClient, type APIClientOptions } from '@nocobase/sdk';
+import { type APIClientOptions, getSubAppName } from '@nocobase/sdk';
 import { createInstance, type i18n as i18next } from 'i18next';
 import { initReactI18next } from 'react-i18next';
 
+import { APIClient } from './APIClient';
 import { BaseApplication, type BaseApplicationOptions } from './BaseApplication';
 import { CollectionFieldInterfaceManager } from './collection-field-interface/CollectionFieldInterfaceManager';
 import type { PluginType } from './PluginManager';
@@ -43,7 +44,10 @@ export class Application extends BaseApplication<
   public declare dataSourceManager: any;
 
   protected createApiClient(options: ApplicationOptions) {
-    return new APIClient(options.apiClient);
+    return new APIClient({
+      ...options.apiClient,
+      appName: options.name || getSubAppName(options.publicPath),
+    });
   }
 
   protected configureRuntimeAdapters() {

package/src/__tests__/authRedirect.test.ts

@@ -8,11 +8,10 @@
  */
 
 import {
-  buildLegacySigninHref,
-  convertV2AdminPathToLegacy,
+  buildV2SigninHref,
   getCurrentV2RedirectPath,
-  redirectToLegacySignin,
-  resolveLegacySigninRedirect,
+  redirectToV2Signin,
+  resolveV2SigninRedirect,
 } from '../authRedirect';
 
 describe('auth redirect helpers', () => {
@@ -60,7 +59,7 @@ describe('auth redirect helpers', () => {
     ).toBe('/nocobase/v2/admin/7vu4c2sdk6h?from=menu#tab-1');
   });
 
-  it('should derive legacy signin href from root public path', () => {
+  it('should derive v2 signin href from v2 public path', () => {
     const app = {
       getPublicPath: () => '/nocobase/v2/',
       router: {
@@ -68,12 +67,12 @@ describe('auth redirect helpers', () => {
       },
     } as any;
 
-    expect(buildLegacySigninHref(app, '/nocobase/v2/admin/7vu4c2sdk6h')).toBe(
-      '/nocobase/signin?redirect=%2Fnocobase%2Fv2%2Fadmin%2F7vu4c2sdk6h',
+    expect(buildV2SigninHref(app, '/nocobase/v2/admin/7vu4c2sdk6h')).toBe(
+      '/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin%2F7vu4c2sdk6h',
     );
   });
 
-  it('should convert v2 admin path to legacy root-relative path', () => {
+  it('should derive v2 signin href when root public path is "/"', () => {
     const app = {
       getPublicPath: () => '/v2/',
       router: {
@@ -81,53 +80,7 @@ describe('auth redirect helpers', () => {
       },
     } as any;
 
-    expect(convertV2AdminPathToLegacy(app, '/v2/admin/page-1')).toBe('/admin/page-1');
-    expect(convertV2AdminPathToLegacy(app, '/v2/admin/page-1/tab/tab-1')).toBe('/admin/page-1/tabs/tab-1');
-    expect(convertV2AdminPathToLegacy(app, '/v2/admin/page-1/view/detail')).toBe('/admin/page-1/popups/detail');
-    expect(convertV2AdminPathToLegacy(app, '/v2/admin/page-1/tab/tab-1/view/detail')).toBe(
-      '/admin/page-1/tabs/tab-1/popups/detail',
-    );
-  });
-
-  it('should preserve basename search and hash when converting current legacy path', () => {
-    const app = {
-      getPublicPath: () => '/nocobase/v2/',
-      router: {
-        getBasename: () => '/nocobase/v2',
-      },
-    } as any;
-
-    expect(
-      convertV2AdminPathToLegacy(app, {
-        pathname: '/nocobase/v2/admin/page-1/tab/tab-1/view/detail',
-        search: '?from=menu',
-        hash: '#dialog',
-      }),
-    ).toBe('/nocobase/admin/page-1/tabs/tab-1/popups/detail?from=menu#dialog');
-  });
-
-  it('should normalize duplicated slashes during legacy path conversion', () => {
-    const app = {
-      getPublicPath: () => '/nocobase/v2/',
-      router: {
-        getBasename: () => '/nocobase/v2/',
-      },
-    } as any;
-
-    expect(convertV2AdminPathToLegacy(app, '/nocobase//v2//admin//page-1//tab//tab-1')).toBe(
-      '/nocobase/admin/page-1/tabs/tab-1',
-    );
-  });
-
-  it('should return null for non-admin runtime paths', () => {
-    const app = {
-      getPublicPath: () => '/v2/',
-      router: {
-        getBasename: () => '/v2',
-      },
-    } as any;
-
-    expect(convertV2AdminPathToLegacy(app, '/v2/settings')).toBeNull();
+    expect(buildV2SigninHref(app, '/v2/admin/7vu4c2sdk6h')).toBe('/v2/signin?redirect=%2Fv2%2Fadmin%2F7vu4c2sdk6h');
   });
 
   it('should redirect with window.location.replace by default', () => {
@@ -147,12 +100,12 @@ describe('auth redirect helpers', () => {
       },
     } as any;
 
-    redirectToLegacySignin(app, '/v2/admin/7vu4c2sdk6h');
+    redirectToV2Signin(app, '/v2/admin/7vu4c2sdk6h');
 
-    expect(replace).toHaveBeenCalledWith('/signin?redirect=%2Fv2%2Fadmin%2F7vu4c2sdk6h');
+    expect(replace).toHaveBeenCalledWith('/v2/signin?redirect=%2Fv2%2Fadmin%2F7vu4c2sdk6h');
   });
 
-  it('should accept same-origin legacy signin urls only', () => {
+  it('should accept same-origin v2 signin urls only', () => {
     Object.defineProperty(globalThis.window, 'location', {
       configurable: true,
       value: {
@@ -168,14 +121,167 @@ describe('auth redirect helpers', () => {
       },
     } as any;
 
-    expect(resolveLegacySigninRedirect('/nocobase/signin?redirect=%2Fnocobase%2Fv2%2Fadmin#hash', app)).toBe(
-      'http://localhost:20000/nocobase/signin?redirect=%2Fnocobase%2Fv2%2Fadmin#hash',
+    expect(resolveV2SigninRedirect('/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin#hash', app)).toBe(
+      'http://localhost:20000/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin#hash',
     );
-    expect(resolveLegacySigninRedirect('/signin?redirect=%2Fv2%2Fadmin', app)).toBe(
+    expect(resolveV2SigninRedirect('/signin?redirect=%2Fv2%2Fadmin', app)).toBe(
       'http://localhost:20000/signin?redirect=%2Fv2%2Fadmin',
     );
-    expect(resolveLegacySigninRedirect('/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin', app)).toBeNull();
-    expect(resolveLegacySigninRedirect('https://evil.example.com/signin?redirect=%2Fv2%2Fadmin', app)).toBeNull();
-    expect(resolveLegacySigninRedirect('/nocobase/admin', app)).toBeNull();
+    expect(resolveV2SigninRedirect('/nocobase/signin?redirect=%2Fnocobase%2Fv2%2Fadmin', app)).toBeNull();
+    expect(resolveV2SigninRedirect('https://evil.example.com/signin?redirect=%2Fv2%2Fadmin', app)).toBeNull();
+    expect(resolveV2SigninRedirect('/nocobase/admin', app)).toBeNull();
+  });
+
+  describe('v2 sub-app context (router basename contains /apps/<id>/)', () => {
+    it('should preserve sub-app segment when building current redirect path under simple public path', () => {
+      const app = {
+        getPublicPath: () => '/v2/',
+        router: {
+          getBasename: () => '/v2/apps/test-app/',
+        },
+      } as any;
+
+      expect(
+        getCurrentV2RedirectPath(app, {
+          pathname: '/v2/apps/test-app/admin/7vu4c2sdk6h',
+          search: '?tab=overview',
+          hash: '#section-a',
+        }),
+      ).toBe('/v2/apps/test-app/admin/7vu4c2sdk6h?tab=overview#section-a');
+    });
+
+    it('should preserve sub-app segment when building current redirect path under nested public path', () => {
+      const app = {
+        getPublicPath: () => '/nocobase/v2/',
+        router: {
+          getBasename: () => '/nocobase/v2/apps/test-app/',
+        },
+      } as any;
+
+      expect(
+        getCurrentV2RedirectPath(app, {
+          pathname: '/nocobase/v2/apps/test-app/admin/al5yj9t81of',
+          search: '?from=menu',
+          hash: '#tab-1',
+        }),
+      ).toBe('/nocobase/v2/apps/test-app/admin/al5yj9t81of?from=menu#tab-1');
+    });
+
+    it('should derive sub-app signin href under nested public path', () => {
+      const app = {
+        getPublicPath: () => '/nocobase/v2/',
+        router: {
+          getBasename: () => '/nocobase/v2/apps/test-app/',
+        },
+      } as any;
+
+      expect(buildV2SigninHref(app, '/nocobase/v2/apps/test-app/admin/al5yj9t81of')).toBe(
+        '/nocobase/v2/apps/test-app/signin?redirect=%2Fnocobase%2Fv2%2Fapps%2Ftest-app%2Fadmin%2Fal5yj9t81of',
+      );
+    });
+
+    it('should derive sub-app signin href under simple public path', () => {
+      const app = {
+        getPublicPath: () => '/v2/',
+        router: {
+          getBasename: () => '/v2/apps/test-app/',
+        },
+      } as any;
+
+      expect(buildV2SigninHref(app, '/v2/apps/test-app/admin/7vu4c2sdk6h')).toBe(
+        '/v2/apps/test-app/signin?redirect=%2Fv2%2Fapps%2Ftest-app%2Fadmin%2F7vu4c2sdk6h',
+      );
+    });
+
+    it('should redirect to sub-app signin with window.location.replace', () => {
+      const replace = vi.fn();
+      Object.defineProperty(globalThis.window, 'location', {
+        configurable: true,
+        value: {
+          ...originalLocation,
+          replace,
+        },
+      });
+
+      const app = {
+        getPublicPath: () => '/nocobase/v2/',
+        router: {
+          getBasename: () => '/nocobase/v2/apps/test-app/',
+        },
+      } as any;
+
+      redirectToV2Signin(app, '/nocobase/v2/apps/test-app/admin/al5yj9t81of');
+
+      expect(replace).toHaveBeenCalledWith(
+        '/nocobase/v2/apps/test-app/signin?redirect=%2Fnocobase%2Fv2%2Fapps%2Ftest-app%2Fadmin%2Fal5yj9t81of',
+      );
+    });
+
+    it('should whitelist sub-app signin only and reject main / other-app / v1 signin urls', () => {
+      Object.defineProperty(globalThis.window, 'location', {
+        configurable: true,
+        value: {
+          ...originalLocation,
+          origin: 'http://localhost:20000',
+        },
+      });
+
+      const app = {
+        getPublicPath: () => '/nocobase/v2/',
+        router: {
+          getBasename: () => '/nocobase/v2/apps/test-app/',
+        },
+      } as any;
+
+      // own sub-app signin: accepted
+      expect(
+        resolveV2SigninRedirect(
+          '/nocobase/v2/apps/test-app/signin?redirect=%2Fnocobase%2Fv2%2Fapps%2Ftest-app%2Fadmin',
+          app,
+        ),
+      ).toBe(
+        'http://localhost:20000/nocobase/v2/apps/test-app/signin?redirect=%2Fnocobase%2Fv2%2Fapps%2Ftest-app%2Fadmin',
+      );
+      // bare /signin: still accepted (universal fallback)
+      expect(resolveV2SigninRedirect('/signin?redirect=%2Fnocobase%2Fv2%2Fapps%2Ftest-app%2Fadmin', app)).toBe(
+        'http://localhost:20000/signin?redirect=%2Fnocobase%2Fv2%2Fapps%2Ftest-app%2Fadmin',
+      );
+      // main v2 signin: rejected (would lose sub-app context)
+      expect(resolveV2SigninRedirect('/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin', app)).toBeNull();
+      // another sub-app signin: rejected (cross-app injection)
+      expect(
+        resolveV2SigninRedirect('/nocobase/v2/apps/other-app/signin?redirect=%2Fnocobase%2Fv2%2Fapps%2Ftest-app', app),
+      ).toBeNull();
+      // v1 root signin: rejected
+      expect(resolveV2SigninRedirect('/nocobase/signin?redirect=%2Fnocobase%2Fv2', app)).toBeNull();
+      // cross-origin: rejected
+      expect(resolveV2SigninRedirect('https://evil.example.com/nocobase/v2/apps/test-app/signin', app)).toBeNull();
+    });
+  });
+
+  describe('fallback when router or basename is missing', () => {
+    it('should fall back to v2 public path when app.router is undefined', () => {
+      const app = {
+        getPublicPath: () => '/nocobase/v2/',
+        router: undefined,
+      } as any;
+
+      expect(buildV2SigninHref(app, '/nocobase/v2/admin/X')).toBe(
+        '/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin%2FX',
+      );
+    });
+
+    it('should fall back to v2 public path when router.getBasename returns undefined', () => {
+      const app = {
+        getPublicPath: () => '/nocobase/v2/',
+        router: {
+          getBasename: () => undefined,
+        },
+      } as any;
+
+      expect(buildV2SigninHref(app, '/nocobase/v2/admin/X')).toBe(
+        '/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin%2FX',
+      );
+    });
   });
 });

package/src/__tests__/globalDeps.test.ts

@@ -26,6 +26,8 @@ describe('client-v2 defineGlobalDeps', () => {
     expect(define).toHaveBeenCalledWith('@nocobase/client-v2', expect.any(Function));
     expect(define).toHaveBeenCalledWith('@nocobase/flow-engine', expect.any(Function));
     expect(define).toHaveBeenCalledWith('@nocobase/evaluators/client', expect.any(Function));
+    expect(define).toHaveBeenCalledWith('@dnd-kit/core', expect.any(Function));
+    expect(define).toHaveBeenCalledWith('@dnd-kit/sortable', expect.any(Function));
     expect(define).toHaveBeenCalledWith('ahooks', expect.any(Function));
     expect(define).toHaveBeenCalledWith('dayjs', expect.any(Function));
     expect(define).toHaveBeenCalledWith('lodash', expect.any(Function));

package/src/__tests__/nocobase-buildin-plugin-auth.test.tsx

@@ -39,7 +39,7 @@ describe('nocobase buildin plugin auth redirect', () => {
     vi.restoreAllMocks();
   });
 
-  it('should redirect unauthenticated admin access to legacy signin with replace', async () => {
+  it('should redirect unauthenticated admin access to v2 signin with replace', async () => {
     const replace = vi.fn();
     Object.defineProperty(globalThis.window, 'location', {
       configurable: true,
@@ -70,11 +70,11 @@ describe('nocobase buildin plugin auth redirect', () => {
     render(<Root />);
 
     await waitFor(() => {
-      expect(replace).toHaveBeenCalledWith('/signin?redirect=%2Fv2%2Fadmin%2F7vu4c2sdk6h');
+      expect(replace).toHaveBeenCalledWith('/v2/signin?redirect=%2Fv2%2Fadmin%2F7vu4c2sdk6h');
     });
   });
 
-  it('should redirect unauthenticated v2 root access to legacy signin with default admin redirect', async () => {
+  it('should redirect unauthenticated v2 root access to v2 signin with default admin redirect', async () => {
     const replace = vi.fn();
     Object.defineProperty(globalThis.window, 'location', {
       configurable: true,
@@ -104,11 +104,11 @@ describe('nocobase buildin plugin auth redirect', () => {
     render(<Root />);
 
     await waitFor(() => {
-      expect(replace).toHaveBeenCalledWith('/nocobase/signin?redirect=%2Fnocobase%2Fv2%2Fadmin');
+      expect(replace).toHaveBeenCalledWith('/nocobase/v2/signin?redirect=%2Fnocobase%2Fv2%2Fadmin');
     });
   });
 
-  it('should render v2 admin root without redirecting to legacy default page', async () => {
+  it('should render v2 admin root without redirecting away', async () => {
     const replace = vi.fn();
     Object.defineProperty(globalThis.window, 'location', {
       configurable: true,
@@ -157,7 +157,7 @@ describe('nocobase buildin plugin auth redirect', () => {
   });
 
   it.each(['/v2/admin/legacy-page/tab/tab-1', '/v2/admin/legacy-page/view/detail'])(
-    'should show 404 for authenticated direct legacy v2 page access: %s',
+    'should show 404 for authenticated direct v1-style v2 page access: %s',
     async (pathname) => {
       const replace = vi.fn();
       Object.defineProperty(globalThis.window, 'location', {

package/src/authRedirect.ts

@@ -21,8 +21,6 @@ type LocationLike = {
   hash?: string;
 };
 
-const V2_PUBLIC_PATH_SUFFIX = '/v2/';
-
 function ensureLeadingSlash(value = '') {
   if (!value) {
     return '/';
@@ -111,18 +109,18 @@ function getV2PublicPath(app: AppLike) {
   return normalizePublicPath(app.getPublicPath());
 }
 
-function getRootPublicPath(app: AppLike) {
-  const publicPath = getV2PublicPath(app);
-  if (!publicPath.endsWith(V2_PUBLIC_PATH_SUFFIX)) {
-    return normalizePublicPath(publicPath.replace(/\/v2\/?$/, '/') || '/');
-  }
-  return normalizePublicPath(publicPath.slice(0, -V2_PUBLIC_PATH_SUFFIX.length) || '/');
-}
-
 function getV2BasePath(app: AppLike) {
   return trimTrailingSlashes(getV2PublicPath(app)) || '/';
 }
 
+export function getV2EffectiveBasePath(app: AppLike): string {
+  const basename = app.router?.getBasename?.();
+  if (basename) {
+    return normalizePublicPath(basename);
+  }
+  return getV2PublicPath(app);
+}
+
 function joinRootRelativePath(basePath: string, pathname: string) {
   const normalizedBasePath = normalizePublicPath(basePath);
   const normalizedPathname = normalizePathname(pathname);
@@ -138,46 +136,8 @@ function joinRootRelativePath(basePath: string, pathname: string) {
   return normalizePathname(`/${trimLeadingSlashes(normalizedBasePath)}/${trimLeadingSlashes(normalizedPathname)}`);
 }
 
-function mapV2AdminPathnameToLegacyPathname(pathname: string) {
-  const normalizedPathname = normalizePathname(pathname);
-
-  if (normalizedPathname === '/admin') {
-    return '/admin';
-  }
-
-  const segments = normalizedPathname.split('/').filter(Boolean);
-  if (segments[0] !== 'admin' || segments.length < 2) {
-    return null;
-  }
-
-  const [, name, ...restSegments] = segments;
-  const legacySegments = ['admin', name];
-  let index = 0;
-
-  while (index < restSegments.length) {
-    const segment = restSegments[index];
-
-    if (segment === 'tab' && restSegments[index + 1]) {
-      legacySegments.push('tabs', restSegments[index + 1]);
-      index += 2;
-      continue;
-    }
-
-    if (segment === 'view') {
-      legacySegments.push('popups', ...restSegments.slice(index + 1));
-      index = restSegments.length;
-      continue;
-    }
-
-    return null;
-  }
-
-  return normalizePathname(`/${legacySegments.join('/')}`);
-}
-
-function getLegacySigninPath(app: AppLike) {
-  const rootPublicPath = trimTrailingSlashes(getRootPublicPath(app));
-  return `${rootPublicPath}/signin`;
+function getV2SigninPath(app: AppLike) {
+  return joinRootRelativePath(getV2EffectiveBasePath(app), '/signin');
 }
 
 function stripCurrentV2Basename(app: AppLike, pathname: string) {
@@ -198,28 +158,7 @@ function stripCurrentV2Basename(app: AppLike, pathname: string) {
 }
 
 function getDefaultV2AdminRedirectPath(app: AppLike) {
-  return joinRootRelativePath(getV2PublicPath(app), '/admin');
-}
-
-/**
- * 将 v2 admin 路径转换为对应的 v1 admin 根相对路径。
- *
- * @param app 当前 v2 应用实例
- * @param value 当前 v2 admin 路径或 location 对象
- * @returns 对应的 v1 admin 根相对路径；若无法安全转换则返回 null
- */
-export function convertV2AdminPathToLegacy(app: AppLike, value: string | LocationLike) {
-  const locationLike = splitPathLike(value);
-  const pathname = stripCurrentV2Basename(app, locationLike.pathname || '/');
-  const legacyPathname = mapV2AdminPathnameToLegacyPathname(pathname);
-
-  if (!legacyPathname) {
-    return null;
-  }
-
-  return `${joinRootRelativePath(getRootPublicPath(app), legacyPathname)}${normalizeSearch(
-    locationLike.search,
-  )}${normalizeHash(locationLike.hash)}`;
+  return joinRootRelativePath(getV2EffectiveBasePath(app), '/admin');
 }
 
 /**
@@ -233,29 +172,29 @@ export function getCurrentV2RedirectPath(app: AppLike, locationLike: LocationLik
   const pathname = stripCurrentV2Basename(app, locationLike?.pathname || '/');
   const search = normalizeSearch(locationLike?.search || '');
   const hash = normalizeHash(locationLike?.hash || '');
-  return `${joinRootRelativePath(getV2PublicPath(app), pathname)}${search}${hash}`;
+  return `${joinRootRelativePath(getV2EffectiveBasePath(app), pathname)}${search}${hash}`;
 }
 
 /**
- * 构造跳转到 v1 登录页的完整 href。
+ * 构造跳转到 v2 登录页的完整 href。
  *
  * @param app 当前 v2 应用实例
  * @param targetPath 登录后回跳地址
- * @returns 指向 v1 登录页的 href
+ * @returns 指向 v2 登录页的 href
  */
-export function buildLegacySigninHref(app: AppLike, targetPath: string) {
-  return `${getLegacySigninPath(app)}?redirect=${encodeURIComponent(targetPath)}`;
+export function buildV2SigninHref(app: AppLike, targetPath: string) {
+  return `${getV2SigninPath(app)}?redirect=${encodeURIComponent(targetPath)}`;
 }
 
 /**
- * 通过整页跳转进入 v1 登录页。
+ * 通过整页跳转进入 v2 登录页。
  *
  * @param app 当前 v2 应用实例
  * @param targetPath 登录后回跳地址
  * @param options 跳转选项
  */
-export function redirectToLegacySignin(app: AppLike, targetPath: string, options?: { replace?: boolean }) {
-  const href = buildLegacySigninHref(app, targetPath);
+export function redirectToV2Signin(app: AppLike, targetPath: string, options?: { replace?: boolean }) {
+  const href = buildV2SigninHref(app, targetPath);
   if (options?.replace === false) {
     window.location.href = href;
     return;
@@ -264,13 +203,13 @@ export function redirectToLegacySignin(app: AppLike, targetPath: string, options
 }
 
 /**
- * 解析并校验服务端返回的 v1 登录页地址。
+ * 解析并校验服务端返回的 v2 登录页地址。
  *
  * @param value 服务端返回的 redirect
  * @param app 当前 v2 应用实例
- * @returns 合法时返回完整同源 URL，否则返回 null
+ * @returns 合法时返回完整同源 URL,否则返回 null
  */
-export function resolveLegacySigninRedirect(value: string | undefined | null, app: AppLike) {
+export function resolveV2SigninRedirect(value: string | undefined | null, app: AppLike) {
   if (!value) {
     return null;
   }
@@ -286,7 +225,7 @@ export function resolveLegacySigninRedirect(value: string | undefined | null, ap
     return null;
   }
 
-  const validPathnames = new Set(['/signin', getLegacySigninPath(app)]);
+  const validPathnames = new Set(['/signin', getV2SigninPath(app)]);
   if (!validPathnames.has(url.pathname)) {
     return null;
   }