create-windy 0.2.7 → 0.2.9

package/template/apps/server/src/system/repository.ts

@@ -1,5 +1,5 @@
 import { randomUUIDv7 } from "bun";
-import type { LifecycleStatus, PageResult, SortRule } from "@windy/shared";
+import type { LifecycleStatus, PageResult, SortRule } from "@southwind-ai/shared";
 import type { RequestActor } from "../guards.js";
 import type { ManagedEntity } from "./entities.js";
 

package/template/apps/server/src/system/resource-route-support.ts

@@ -1,4 +1,4 @@
-import type { FeatureFlagDefinition, HttpMethod } from "@windy/shared";
+import type { FeatureFlagDefinition, HttpMethod } from "@southwind-ai/shared";
 import type { RequestGuardContext } from "../guards.js";
 import { evaluateRouteGuards, findSystemFeature } from "../route-guards.js";
 import type { createServerRuntime } from "../runtime.js";

package/template/apps/server/src/system/route-helpers.ts

@@ -1,5 +1,5 @@
 import { randomUUIDv7 } from "bun";
-import type { AuditEvent, LifecycleStatus } from "@windy/shared";
+import type { AuditEvent, LifecycleStatus } from "@southwind-ai/shared";
 import type { RequestGuardContext } from "../guards.js";
 import type { ManagedEntity } from "./entities.js";
 import { parsePagination } from "../pagination.js";

package/template/apps/server/src/system/route-types.ts

@@ -1,4 +1,4 @@
-import type { FeatureFlagDefinition } from "@windy/shared";
+import type { FeatureFlagDefinition } from "@southwind-ai/shared";
 import type { ManagedEntity } from "./entities.js";
 import type { EntityRepository, MaybePromise } from "./repository.js";
 import type { ScopedResourceAccess } from "../data-access/scoped-resource.js";

package/template/apps/server/src/system/routes.test.ts

@@ -4,7 +4,7 @@ import {
   entitlementKey,
   // @windy-module system.license end
   type FeatureFlagDefinition,
-} from "@windy/shared";
+} from "@southwind-ai/shared";
 import { createFoundationSnapshot } from "../foundation.js";
 import { createServerRuntime, type AuditEventWriter } from "../runtime.js";
 import { FakeRouteApp } from "./route-test-app.js";

package/template/apps/server/src/system/routes.ts

@@ -1,4 +1,4 @@
-import type { FeatureFlagDefinition } from "@windy/shared";
+import type { FeatureFlagDefinition } from "@southwind-ai/shared";
 import { recordMutationAudit } from "../audit/policy.js";
 import { registerFeatureFlagRoutes } from "../feature/routes.js";
 import { findSystemFeature } from "../route-guards.js";

package/template/apps/server/src/system/user-projection.ts

@@ -1,4 +1,4 @@
-import { maskGovernedValue, type GovernedFieldPolicy } from "@windy/shared";
+import { maskGovernedValue, type GovernedFieldPolicy } from "@southwind-ai/shared";
 import type { ManagedUser } from "./entities.js";
 
 export const userMaskFields: readonly GovernedFieldPolicy[] = [

package/template/apps/server/src/work-order/data-scope.integration.test.ts

@@ -7,7 +7,7 @@ import {
   test,
 } from "bun:test";
 import { resolve } from "node:path";
-import type { WorkOrder } from "@windy/example-work-order";
+import type { WorkOrder } from "@southwind-ai/example-work-order";
 import { drizzle } from "drizzle-orm/node-postgres";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
 import { Pool } from "pg";

package/template/apps/server/src/work-order/drizzle-repository.integration.test.ts

@@ -1,6 +1,6 @@
 import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 import { resolve } from "node:path";
-import type { WorkOrder } from "@windy/example-work-order";
+import type { WorkOrder } from "@southwind-ai/example-work-order";
 import { drizzle } from "drizzle-orm/node-postgres";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
 import { Pool } from "pg";

package/template/apps/server/src/work-order/drizzle-repository.ts

@@ -1,5 +1,5 @@
-import { workOrders } from "@windy/database";
-import type { WorkOrder } from "@windy/example-work-order";
+import { workOrders } from "@southwind-ai/database";
+import type { WorkOrder } from "@southwind-ai/example-work-order";
 import type { NodePgDatabase } from "drizzle-orm/node-postgres";
 import {
   DrizzleScopedEntityRepository,

package/template/apps/server/src/work-order/foundation-modules.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { featureKey } from "@windy/shared";
+import { featureKey } from "@southwind-ai/shared";
 import {
   createFoundationSnapshot,
   loadFoundationModules,
@@ -29,6 +29,16 @@ describe("平台模块 composition root", () => {
       "work-order.ticket.manage",
     );
     expect(snapshot.menus.map(({ key }) => key)).not.toContain("work-order");
+    expect(snapshot.auditActionCatalog).toContainEqual({
+      key: "crud.create",
+      label: "数据新增",
+      description: "新增业务记录。",
+    });
+    expect(snapshot.licenseCatalog.map(({ key }) => String(key))).toEqual([
+      "free-trial",
+      "standard",
+      "advanced",
+    ]);
     const workOrder = modules.find(({ name }) => name === "work-order");
     expect(workOrder?.adminRoutes).toEqual([]);
     expect(workOrder?.apiPermissions).toHaveLength(5);
@@ -52,14 +62,14 @@ describe("平台模块 composition root", () => {
     );
 
     expect(serverPackage.dependencies).toMatchObject({
-      "@windy/example-work-order": "workspace:*",
+      "@southwind-ai/example-work-order": "workspace:*",
     });
-    expect(serverPackage.dependencies).not.toHaveProperty("@windy/web");
+    expect(serverPackage.dependencies).not.toHaveProperty("@southwind-ai/web");
     expect(serverPackage.dependencies).not.toHaveProperty("vue");
-    expect(businessPackage.dependencies).not.toHaveProperty("@windy/web");
+    expect(businessPackage.dependencies).not.toHaveProperty("@southwind-ai/web");
     expect(businessPackage.dependencies).not.toHaveProperty("vue");
     expect(webPackage.dependencies).not.toHaveProperty(
-      "@windy/example-work-order",
+      "@southwind-ai/example-work-order",
     );
   });
 

package/template/apps/server/src/work-order/repository.ts

@@ -1,4 +1,4 @@
-import type { WorkOrder } from "@windy/example-work-order";
+import type { WorkOrder } from "@southwind-ai/example-work-order";
 import {
   InMemoryScopedEntityRepository,
   type EntityDataScopeBinding,

package/template/apps/server/src/work-order/routes.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
-import type { WorkOrder } from "@windy/example-work-order";
-import { licenseVersionKey } from "@windy/shared";
+import type { WorkOrder } from "@southwind-ai/example-work-order";
+import { licenseVersionKey } from "@southwind-ai/shared";
 import { InMemoryEntityRepository } from "../system/repository.js";
 import { InMemoryScopedEntityRepository } from "../data-access/scoped-repository.js";
 import { buildScopeContext } from "../data-access/context.js";

package/template/apps/server/src/work-order/routes.ts

@@ -2,8 +2,8 @@ import {
   createWorkOrderSchema,
   updateWorkOrderSchema,
   workOrderModule,
-} from "@windy/example-work-order";
-import type { ApiPermissionBinding } from "@windy/shared";
+} from "@southwind-ai/example-work-order";
+import type { ApiPermissionBinding } from "@southwind-ai/shared";
 import { recordMutationAudit } from "../audit/policy.js";
 import { accessCall } from "../system/resource-access-response.js";
 import { evaluateRouteGuards } from "../route-guards.js";

package/template/apps/server/src/work-order/search-api.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, test } from "bun:test";
-import { workOrderModule, type WorkOrder } from "@windy/example-work-order";
-import { systemFoundationModule, type ModuleManifest } from "@windy/modules";
-import { licenseVersionKey } from "@windy/shared";
+import { workOrderModule, type WorkOrder } from "@southwind-ai/example-work-order";
+import { systemFoundationModule, type ModuleManifest } from "@southwind-ai/modules";
+import { licenseVersionKey } from "@southwind-ai/shared";
 import { buildScopeContext } from "../data-access/context.js";
 import { InMemoryScopedEntityRepository } from "../data-access/scoped-repository.js";
 import { createServerRuntime } from "../runtime.js";

package/template/apps/server/src/work-order/search-provider.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, test } from "bun:test";
-import { workOrderModule, type WorkOrder } from "@windy/example-work-order";
-import type { ModuleManifest } from "@windy/modules";
-import { licenseVersionKey } from "@windy/shared";
+import { workOrderModule, type WorkOrder } from "@southwind-ai/example-work-order";
+import type { ModuleManifest } from "@southwind-ai/modules";
+import { licenseVersionKey } from "@southwind-ai/shared";
 import { buildScopeContext } from "../data-access/context.js";
 import { InMemoryScopedEntityRepository } from "../data-access/scoped-repository.js";
 import type { DataScopeQuerySpecification } from "../data-access/query-specification.js";

package/template/apps/server/src/work-order/service.ts

@@ -3,7 +3,7 @@ import type {
   UpdateWorkOrderInput,
   WorkOrder,
   WorkOrderListQuery,
-} from "@windy/example-work-order";
+} from "@southwind-ai/example-work-order";
 import { DataScopedResourceService } from "../data-access/scoped-resource.js";
 import { departmentDescendantResolver } from "../data-access/department-tree.js";
 import type { RequestActor } from "../guards.js";

package/template/apps/server/src/work-order/task.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import type { WorkOrder } from "@windy/example-work-order";
+import type { WorkOrder } from "@southwind-ai/example-work-order";
 import { createFoundationSnapshot } from "../foundation.js";
 import { createServerRuntime } from "../runtime.js";
 import { InMemorySchedulerRepository } from "../scheduler/repository.js";

package/template/apps/server/src/work-order/task.ts

@@ -1,5 +1,5 @@
-import { workOrderModule } from "@windy/example-work-order";
-import type { FeatureFlagDefinition } from "@windy/shared";
+import { workOrderModule } from "@southwind-ai/example-work-order";
+import type { FeatureFlagDefinition } from "@southwind-ai/shared";
 import type { ScheduledTaskDefinition } from "../scheduler/types.js";
 import type { WorkOrderService } from "./service.js";
 import { platformDataActor } from "../data-access/platform-actor.js";

package/template/apps/server/src/workflow/drizzle-repository.integration.test.ts

@@ -1,12 +1,12 @@
 import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 import { resolve } from "node:path";
-import type { WorkflowActor } from "@windy/shared";
+import { DurableHandlerRegistry } from "@southwind-ai/jobs";
+import type { WorkflowActor } from "@southwind-ai/shared";
 import { drizzle } from "drizzle-orm/node-postgres";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
 import { Pool } from "pg";
 import { DrizzleDurableExecutionRepository } from "../jobs/drizzle-execution-repository.js";
 import { DrizzleDurableJobRepository } from "../jobs/drizzle-repository.js";
-import { DurableHandlerRegistry } from "../jobs/handler-registry.js";
 import { DurableJobService } from "../jobs/service.js";
 import { DurableJobWorker } from "../jobs/worker.js";
 import { DrizzleWorkflowRepository } from "./drizzle-repository.js";

package/template/apps/server/src/workflow/drizzle-repository.ts

@@ -1,4 +1,4 @@
-import { workflowTransitions, workflowWorkItems } from "@windy/database";
+import { workflowTransitions, workflowWorkItems } from "@southwind-ai/database";
 import type {
   CreateWorkItemInput,
   PageResult,
@@ -6,8 +6,8 @@ import type {
   WorkItemCommand,
   WorkItemTransition,
   WorkflowActor,
-} from "@windy/shared";
-import { createWorkItem, transitionWorkItem } from "@windy/shared";
+} from "@southwind-ai/shared";
+import { createWorkItem, transitionWorkItem } from "@southwind-ai/shared";
 import { and, desc, eq, or, sql, type SQL } from "drizzle-orm";
 import type { NodePgDatabase } from "drizzle-orm/node-postgres";
 import {

package/template/apps/server/src/workflow/effects.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { createWorkItem } from "@windy/shared";
+import { createWorkItem } from "@southwind-ai/shared";
 import type { RequestActor } from "../guards.js";
 import { InMemoryNotificationRepository } from "../notification/repository.js";
 import { NotificationWorkflowPort } from "./effects.js";

package/template/apps/server/src/workflow/effects.ts

@@ -1,4 +1,4 @@
-import type { WorkItem, WorkItemTransition } from "@windy/shared";
+import type { WorkItem, WorkItemTransition } from "@southwind-ai/shared";
 import type { RequestActor } from "../guards.js";
 import type { NotificationRepository } from "../notification/repository.js";
 import type { WorkflowEffects } from "./service.js";

package/template/apps/server/src/workflow/repository.ts

@@ -5,8 +5,8 @@ import type {
   WorkItemCommand,
   WorkItemTransition,
   WorkflowActor,
-} from "@windy/shared";
-import { createWorkItem, transitionWorkItem } from "@windy/shared";
+} from "@southwind-ai/shared";
+import { createWorkItem, transitionWorkItem } from "@southwind-ai/shared";
 
 export type WorkflowHistoryEntry = WorkItemTransition["fact"] & { id: string };
 

package/template/apps/server/src/workflow/routes.ts

@@ -1,6 +1,6 @@
-import { systemModuleManifest } from "@windy/modules";
-import type { ApiPermissionBinding, AuditActionType } from "@windy/shared";
-import { WorkflowInvariantError } from "@windy/shared";
+import { systemModuleManifest } from "@southwind-ai/modules";
+import type { ApiPermissionBinding, AuditActionType } from "@southwind-ai/shared";
+import { WorkflowInvariantError } from "@southwind-ai/shared";
 import { z } from "zod";
 import { evaluateRouteGuards } from "../route-guards.js";
 import type { createServerRuntime } from "../runtime.js";

package/template/apps/server/src/workflow/service.ts

@@ -5,7 +5,7 @@ import type {
   WorkflowActor,
   WorkItem,
   WorkItemTransition,
-} from "@windy/shared";
+} from "@southwind-ai/shared";
 import type { RequestActor } from "../guards.js";
 import type { WorkflowListQuery, WorkflowRepository } from "./repository.js";
 

package/template/apps/server/src/workflow/timeout-runtime.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
+import { DurableHandlerRegistry } from "@southwind-ai/jobs";
 import type { RequestActor } from "../guards.js";
-import { DurableHandlerRegistry } from "../jobs/handler-registry.js";
 import { InMemoryDurableExecutionRepository } from "../jobs/in-memory-execution.js";
 import { DurableJobService } from "../jobs/service.js";
 import { DurableJobWorker } from "../jobs/worker.js";

package/template/apps/server/src/workflow/timeout-runtime.ts

@@ -1,5 +1,5 @@
-import type { WorkItem } from "@windy/shared";
-import type { DurableHandlerRegistry } from "../jobs/handler-registry.js";
+import type { DurableHandlerRegistry } from "@southwind-ai/jobs";
+import type { WorkItem } from "@southwind-ai/shared";
 import type { DurableJobService } from "../jobs/service.js";
 import type { DurableJobWorker } from "../jobs/worker.js";
 import type { WorkflowTimeoutScheduler } from "./effects.js";

package/template/apps/web/Dockerfile

@@ -13,8 +13,10 @@ COPY packages/create-windy/package.json packages/create-windy/package.json
 COPY packages/crud-generator/package.json packages/crud-generator/package.json
 COPY packages/database/package.json packages/database/package.json
 COPY packages/example-work-order/package.json packages/example-work-order/package.json
+COPY packages/jobs/package.json packages/jobs/package.json
 COPY packages/license-sdk/package.json packages/license-sdk/package.json
 COPY packages/modules/package.json packages/modules/package.json
+COPY packages/server-sdk/package.json packages/server-sdk/package.json
 COPY packages/shared/package.json packages/shared/package.json
 COPY packages/storage/package.json packages/storage/package.json
 RUN bun install --frozen-lockfile

package/template/apps/web/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@windy/web",
+  "name": "@southwind-ai/web",
   "version": "0.1.0",
   "private": true,
   "type": "module",
@@ -18,8 +18,8 @@
     "@tanstack/vue-form": "^1.33.0",
     "@tanstack/vue-table": "^8.21.3",
     "@vueuse/core": "^14.3.0",
-    "@windy/license-sdk": "workspace:*",
-    "@windy/shared": "workspace:*",
+    "@southwind-ai/license": "workspace:*",
+    "@southwind-ai/shared": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "pinia": "^3.0.4",
@@ -34,7 +34,7 @@
   "devDependencies": {
     "@vitejs/plugin-vue": "^6.0.7",
     "@vue/test-utils": "^2.4.11",
-    "@windy/modules": "workspace:*",
+    "@southwind-ai/modules": "workspace:*",
     "happy-dom": "^20.10.6",
     "tw-animate-css": "^1.4.0",
     "vite": "^8.1.4",

package/template/apps/web/runtime-server.ts

@@ -1,5 +1,5 @@
 import { extname, join, normalize } from "node:path";
-import { correlationId } from "@windy/shared";
+import { correlationId } from "@southwind-ai/shared";
 
 export interface WebFetchHandlerOptions {
   distDir: string;

package/template/apps/web/src/app/layouts/AppLayout.vue

@@ -1,10 +1,16 @@
 <script setup lang="ts">
 import { Toaster } from "@/components/ui/sonner";
+// @windy-module system.settings begin
+import GlobalWatermark from "@/layout/GlobalWatermark.vue";
+// @windy-module system.settings end
 </script>
 
 <template>
   <div class="min-h-svh bg-muted/30 text-foreground">
     <slot />
+    <!-- @windy-module system.settings begin -->
+    <GlobalWatermark scope="business" />
+    <!-- @windy-module system.settings end -->
     <Toaster />
   </div>
 </template>

package/template/apps/web/src/components/auth/PasswordChangeForm.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { computed, shallowRef } from "vue";
 import { KeyRoundIcon, LoaderCircleIcon } from "@lucide/vue";
-import { PASSWORD_POLICY } from "@windy/shared";
+import { PASSWORD_POLICY } from "@southwind-ai/shared";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
 import type { PasswordChangeInput } from "@/services/auth-api";

package/template/apps/web/src/components/common/DataPagination.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { computed, shallowRef, watch } from "vue";
-import { MAX_PAGE_SIZE } from "@windy/shared";
+import { MAX_PAGE_SIZE } from "@southwind-ai/shared";
 import { Button } from "@/components/ui/button";
 
 const props = defineProps<{

package/template/apps/web/src/components/license/LicenseActivationCodeForm.vue

@@ -4,7 +4,7 @@ import {
   decodeOfflineActivationCode,
   offlineActivationCodeErrorMessage,
   splitOfflineActivationCode,
-} from "@windy/license-sdk/offline-code";
+} from "@southwind-ai/license/offline-code";
 import { KeyRoundIcon, LoaderCircleIcon } from "@lucide/vue";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";

package/template/apps/web/src/components/license/LicenseFlow.webtest.ts

@@ -1,7 +1,7 @@
 import { flushPromises, mount } from "@vue/test-utils";
 import { describe, expect, test } from "vitest";
-import { licenseVersionKey, type SignedLicenseV1 } from "@windy/shared";
-import { encodeOfflineActivationCode } from "@windy/license-sdk/offline-code";
+import { licenseVersionKey, type SignedLicenseV1 } from "@southwind-ai/shared";
+import { encodeOfflineActivationCode } from "@southwind-ai/license/offline-code";
 import type {
   LicenseReminderLevel,
   PlatformLicenseSnapshot,

package/template/apps/web/src/composables/useModuleConfigurations.ts

@@ -1,5 +1,5 @@
 import { computed, readonly, shallowReadonly, shallowRef } from "vue";
-import type { ModuleConfigValues, ModuleConfigVersion } from "@windy/shared";
+import type { ModuleConfigValues, ModuleConfigVersion } from "@southwind-ai/shared";
 import {
   createModuleConfigVersion,
   listModuleConfigurations,

package/template/apps/web/src/composables/useWatermarkSettings.ts

@@ -22,6 +22,7 @@ export function useWatermarkSettings(
   function update(next: WatermarkSettings) {
     settings.value = {
       enabled: next.enabled,
+      businessPagesEnabled: next.businessPagesEnabled,
       customContent: next.customContent.trim().slice(0, 80),
     };
     persistSettings(settings.value);

package/template/apps/web/src/composables/watermark-settings.ts

@@ -2,11 +2,13 @@ import type { WebAccessActor } from "@/layout/navigation";
 
 export interface WatermarkSettings {
   enabled: boolean;
+  businessPagesEnabled: boolean;
   customContent: string;
 }
 
 export const defaultWatermarkSettings: WatermarkSettings = {
   enabled: true,
+  businessPagesEnabled: false,
   customContent: "",
 };
 
@@ -34,6 +36,10 @@ export function parseWatermarkSettings(
         typeof parsed.enabled === "boolean"
           ? parsed.enabled
           : defaultWatermarkSettings.enabled,
+      businessPagesEnabled:
+        typeof parsed.businessPagesEnabled === "boolean"
+          ? parsed.businessPagesEnabled
+          : defaultWatermarkSettings.businessPagesEnabled,
       customContent:
         typeof parsed.customContent === "string"
           ? parsed.customContent.slice(0, 80)

package/template/apps/web/src/composables/watermark-settings.webtest.ts

@@ -27,12 +27,38 @@ describe("水印设置", () => {
   test("损坏或越界的浏览器设置安全回退", () => {
     expect(parseWatermarkSettings("broken")).toEqual({
       enabled: true,
+      businessPagesEnabled: false,
       customContent: "",
     });
     expect(
       parseWatermarkSettings(
         JSON.stringify({ enabled: false, customContent: "x".repeat(100) }),
       ),
-    ).toEqual({ enabled: false, customContent: "x".repeat(80) });
+    ).toEqual({
+      enabled: false,
+      businessPagesEnabled: false,
+      customContent: "x".repeat(80),
+    });
+  });
+
+  test("业务页面覆盖默认关闭并兼容已保存的范围开关", () => {
+    expect(parseWatermarkSettings(null)).toEqual({
+      enabled: true,
+      businessPagesEnabled: false,
+      customContent: "",
+    });
+    expect(
+      parseWatermarkSettings(
+        JSON.stringify({
+          enabled: true,
+          businessPagesEnabled: true,
+          customContent: "内部资料",
+        }),
+      ),
+    ).toEqual({
+      enabled: true,
+      businessPagesEnabled: true,
+      customContent: "内部资料",
+    });
   });
 });

package/template/apps/web/src/layout/AppSidebar.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import type { MenuNode } from "@windy/shared";
+import type { MenuNode } from "@southwind-ai/shared";
 import {
   ActivityIcon,
   BellIcon,
@@ -9,6 +9,7 @@ import {
   ChevronDownIcon,
   ClipboardListIcon,
   FlagIcon,
+  HouseIcon,
   KeyRoundIcon,
   LayoutDashboardIcon,
   PanelLeftIcon,
@@ -241,9 +242,9 @@ function findMenu(menus: MenuNode[], key: string): MenuNode | undefined {
         </SidebarGroupContent>
       </SidebarGroup>
     </SidebarContent>
-    <SidebarFooter v-if="settingsMenu?.path" class="border-t">
+    <SidebarFooter class="border-t">
       <SidebarMenu>
-        <SidebarMenuItem>
+        <SidebarMenuItem v-if="settingsMenu?.path">
           <SidebarMenuButton
             as-child
             :is-active="route.path === settingsMenu.path"
@@ -255,6 +256,14 @@ function findMenu(menus: MenuNode[], key: string): MenuNode | undefined {
             </RouterLink>
           </SidebarMenuButton>
         </SidebarMenuItem>
+        <SidebarMenuItem>
+          <SidebarMenuButton as-child tooltip="访问首页">
+            <a href="/" target="_blank" rel="noopener noreferrer">
+              <HouseIcon />
+              <span>访问首页</span>
+            </a>
+          </SidebarMenuButton>
+        </SidebarMenuItem>
       </SidebarMenu>
     </SidebarFooter>
     <SidebarRail />

package/template/apps/web/src/layout/AppSidebar.webtest.ts

@@ -140,6 +140,17 @@ describe("AppSidebar", () => {
     expect(router.currentRoute.value.path).toBe("/admin/system/roles");
     wrapper.unmount();
   });
+
+  test("左下角始终提供新标签页访问业务首页的入口", async () => {
+    state.access.value.menus = [];
+    const { wrapper } = await mountSidebar(true);
+    const homeLink = wrapper.get('a[href="/"]');
+
+    expect(homeLink.text()).toContain("访问首页");
+    expect(homeLink.attributes("target")).toBe("_blank");
+    expect(homeLink.attributes("rel")).toBe("noopener noreferrer");
+    wrapper.unmount();
+  });
 });
 
 async function mountSidebar(defaultOpen: boolean) {

package/template/apps/web/src/layout/GlobalWatermark.vue

@@ -5,23 +5,40 @@ import { useAccessSnapshot } from "@/composables/useAccessSnapshot";
 import { useWatermarkSettings } from "@/composables/useWatermarkSettings";
 import { evaluateWebAccess } from "./navigation";
 
+const props = withDefaults(
+  defineProps<{
+    scope?: "admin" | "business";
+  }>(),
+  {
+    scope: "admin",
+  },
+);
 const auth = useAuthSession();
 const access = useAccessSnapshot();
 const watermark = useWatermarkSettings(auth.actor);
-const allowed = computed(() =>
-  access.snapshot.value
-    ? evaluateWebAccess(access.snapshot.value, {
-        permissionKey: "system.watermark.read",
-        featureKey: "system.watermark",
-      }).allowed
-    : false,
+const allowed = computed(
+  () =>
+    props.scope === "business" ||
+    (access.snapshot.value
+      ? evaluateWebAccess(access.snapshot.value, {
+          permissionKey: "system.watermark.read",
+          featureKey: "system.watermark",
+        }).allowed
+      : false),
+);
+const scopeEnabled = computed(
+  () =>
+    props.scope === "admin" || watermark.settings.value.businessPagesEnabled,
 );
 </script>
 
 <template>
   <div
     v-if="
-      allowed && watermark.settings.value.enabled && watermark.content.value
+      allowed &&
+      scopeEnabled &&
+      watermark.settings.value.enabled &&
+      watermark.content.value
     "
     class="pointer-events-none fixed inset-0 z-30 grid grid-cols-3 grid-rows-6 overflow-hidden opacity-[0.075] dark:opacity-[0.11]"
     aria-hidden="true"