create-windy 0.3.19 → 0.4.1

package/template/apps/web/src/pages/settings/WatermarkSettingsSection.webtest.ts

@@ -0,0 +1,115 @@
+import { flushPromises, mount } from "@vue/test-utils";
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import WatermarkSettingsSection from "./WatermarkSettingsSection.vue";
+
+const state = vi.hoisted(() => {
+  const actor = {
+    id: "user_settings",
+    type: "user" as const,
+    name: "张三",
+    username: "zhangsan",
+    displayName: "张三",
+    email: "zs@example.com",
+    roleCodes: ["admin"],
+    permissionKeys: ["system.watermark.read", "system.watermark.manage"],
+  };
+  return {
+    actor: { value: actor },
+    access: {
+      value: {
+        actor,
+        menus: [],
+        permissions: [],
+        features: [
+          {
+            key: "system.watermark",
+            enabled: true,
+            visible: "visible" as const,
+            allowed: true,
+            reason: "enabled",
+          },
+        ],
+      },
+    },
+    policy: {
+      value: {
+        enabled: true,
+        businessPagesEnabled: true,
+        density: "medium" as const,
+        contentFields: ["username", "displayName"] as const,
+        customContent: "",
+        opacityPercent: 8,
+        fontSize: 14,
+      },
+    },
+    loadManaged: vi.fn(),
+    save: vi.fn(),
+  };
+});
+
+vi.mock("@/composables/useAccessSnapshot", () => ({
+  useAccessSnapshot: () => ({
+    snapshot: state.access,
+    ensureLoaded: vi.fn(async () => state.access.value),
+  }),
+}));
+
+vi.mock("@/composables/useAuthSession", () => ({
+  useAuthSession: () => ({ actor: state.actor }),
+}));
+
+vi.mock("@/composables/useAppToast", () => ({
+  useAppToast: () => ({
+    success: vi.fn(),
+    error: vi.fn(),
+  }),
+}));
+
+vi.mock("@/composables/useWatermarkSettings", () => ({
+  useWatermarkSettings: () => ({
+    policy: state.policy,
+    loading: { value: false },
+    loadManaged: state.loadManaged,
+    save: state.save,
+  }),
+}));
+
+beforeEach(() => {
+  state.loadManaged.mockReset();
+  state.loadManaged.mockResolvedValue(state.policy.value);
+  state.save.mockReset();
+});
+
+describe("水印设置表单", () => {
+  test("只呈现一个开关且外观草稿立即更新预览", async () => {
+    const wrapper = mount(WatermarkSettingsSection);
+    await flushPromises();
+
+    expect(wrapper.text()).not.toContain("覆盖业务页面");
+    expect(wrapper.findAll('[aria-label="显示页面水印"]')).toHaveLength(1);
+
+    await wrapper.get('input[aria-label="水印不透明度"]').setValue("20");
+    await wrapper.get('input[aria-label="水印字体大小"]').setValue("24");
+
+    const previewStyle =
+      wrapper
+        .get('[data-testid="watermark-preview-pattern"]')
+        .attributes("style") ?? "";
+    expect(previewStyle).toContain("opacity: 0.2");
+    expect(decodeURIComponent(previewStyle)).toContain('font-size="24"');
+    expect(state.save).not.toHaveBeenCalled();
+  });
+
+  test("任意勾选身份字段后立即进入预览内容", async () => {
+    const wrapper = mount(WatermarkSettingsSection);
+    await flushPromises();
+
+    await wrapper.get('[aria-label="邮箱"]').trigger("click");
+
+    const previewStyle =
+      wrapper
+        .get('[data-testid="watermark-preview-pattern"]')
+        .attributes("style") ?? "";
+    expect(decodeURIComponent(previewStyle)).toContain("zs@example.com");
+  });
+});

package/template/apps/web/src/pages/work-orders/WorkOrderListPage.vue

@@ -0,0 +1,202 @@
+<script setup lang="ts">
+import type {
+  WorkOrder,
+  WorkOrderPriority,
+  WorkOrderWorkflowStatus,
+} from "@southwind-ai/example-work-order/contract";
+import { DEFAULT_PAGE_SIZE } from "@southwind-ai/shared";
+import { RefreshCwIcon, SearchIcon } from "@lucide/vue";
+import { onMounted, shallowRef } from "vue";
+import DataPagination from "@/components/common/DataPagination.vue";
+import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableEmpty,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import { formatDateTime } from "@/lib/date-time";
+import { listWorkOrders } from "@/services/work-order-api";
+
+const items = shallowRef<WorkOrder[]>([]);
+const page = shallowRef(1);
+const pageSize = shallowRef(DEFAULT_PAGE_SIZE);
+const total = shallowRef(0);
+const query = shallowRef("");
+const loading = shallowRef(false);
+const error = shallowRef("");
+
+onMounted(() => void load());
+
+async function load() {
+  if (loading.value) return;
+  loading.value = true;
+  error.value = "";
+  try {
+    const result = await listWorkOrders({
+      page: page.value,
+      pageSize: pageSize.value,
+      q: query.value,
+    });
+    items.value = result.items;
+    page.value = result.page;
+    pageSize.value = result.pageSize;
+    total.value = result.total;
+  } catch (currentError) {
+    error.value =
+      currentError instanceof Error ? currentError.message : "工单加载失败";
+  } finally {
+    loading.value = false;
+  }
+}
+
+function search() {
+  page.value = 1;
+  void load();
+}
+
+function setPage(value: number) {
+  page.value = value;
+  void load();
+}
+
+function setPageSize(value: number) {
+  pageSize.value = value;
+  page.value = 1;
+  void load();
+}
+
+const priorityLabels: Record<WorkOrderPriority, string> = {
+  low: "低",
+  medium: "中",
+  high: "高",
+};
+const workflowLabels: Record<WorkOrderWorkflowStatus, string> = {
+  open: "待处理",
+  "in-progress": "处理中",
+  resolved: "已解决",
+};
+</script>
+
+<template>
+  <main class="space-y-5">
+    <header class="space-y-2">
+      <h1 class="text-2xl font-semibold text-foreground">工单管理</h1>
+      <p class="text-sm text-muted-foreground">
+        示例业务模块提供的工单列表，入口、权限和功能开关均来自 Module Manifest。
+      </p>
+    </header>
+
+    <Alert v-if="error" variant="destructive">
+      <AlertTitle>无法加载工单</AlertTitle>
+      <AlertDescription>{{ error }}</AlertDescription>
+    </Alert>
+
+    <Card>
+      <CardHeader>
+        <CardTitle>工单列表</CardTitle>
+        <CardDescription>
+          按当前账号的数据范围查看工单，可使用标题或描述搜索。
+        </CardDescription>
+      </CardHeader>
+      <CardContent class="space-y-4">
+        <form class="flex flex-col gap-2 sm:flex-row" @submit.prevent="search">
+          <Input
+            v-model="query"
+            aria-label="搜索工单"
+            placeholder="搜索标题或描述"
+            class="sm:max-w-sm"
+          />
+          <Button type="submit" :disabled="loading">
+            <SearchIcon data-icon="inline-start" />
+            搜索
+          </Button>
+          <Button
+            type="button"
+            variant="outline"
+            :disabled="loading"
+            @click="load"
+          >
+            <RefreshCwIcon
+              data-icon="inline-start"
+              :class="{ 'animate-spin': loading }"
+            />
+            刷新
+          </Button>
+        </form>
+
+        <div class="overflow-hidden rounded-md border">
+          <Table>
+            <TableHeader>
+              <TableRow>
+                <TableHead>工单</TableHead>
+                <TableHead>优先级</TableHead>
+                <TableHead>进度</TableHead>
+                <TableHead>负责人</TableHead>
+                <TableHead>最近更新</TableHead>
+              </TableRow>
+            </TableHeader>
+            <TableBody>
+              <TableEmpty v-if="!loading && items.length === 0" :colspan="5">
+                暂无符合条件的工单
+              </TableEmpty>
+              <TableRow v-for="item in items" :key="item.id">
+                <TableCell>
+                  <div class="space-y-1">
+                    <p class="font-medium text-foreground">{{ item.title }}</p>
+                    <p class="line-clamp-2 text-xs text-muted-foreground">
+                      {{ item.description }}
+                    </p>
+                  </div>
+                </TableCell>
+                <TableCell>
+                  <Badge
+                    :variant="
+                      item.priority === 'high' ? 'destructive' : 'outline'
+                    "
+                  >
+                    {{ priorityLabels[item.priority] }}
+                  </Badge>
+                </TableCell>
+                <TableCell>
+                  <Badge
+                    :variant="
+                      item.workflowStatus === 'resolved'
+                        ? 'secondary'
+                        : 'default'
+                    "
+                  >
+                    {{ workflowLabels[item.workflowStatus] }}
+                  </Badge>
+                </TableCell>
+                <TableCell>{{ item.ownerId }}</TableCell>
+                <TableCell>{{ formatDateTime(item.updatedAt) }}</TableCell>
+              </TableRow>
+            </TableBody>
+          </Table>
+        </div>
+
+        <DataPagination
+          :page="page"
+          :page-size="pageSize"
+          :total="total"
+          @update:page="setPage"
+          @update:page-size="setPageSize"
+        />
+      </CardContent>
+    </Card>
+  </main>
+</template>

package/template/apps/web/src/pages/work-orders/WorkOrderListPage.webtest.ts

@@ -0,0 +1,51 @@
+import { flushPromises, mount } from "@vue/test-utils";
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import WorkOrderListPage from "./WorkOrderListPage.vue";
+
+const mocks = vi.hoisted(() => ({
+  list: vi.fn(),
+}));
+
+vi.mock("@/services/work-order-api", () => ({
+  listWorkOrders: mocks.list,
+}));
+
+describe("WorkOrderListPage", () => {
+  beforeEach(() => {
+    mocks.list.mockReset();
+    mocks.list.mockResolvedValue({
+      items: [
+        {
+          id: "ticket_1",
+          title: "登录异常",
+          description: "用户无法进入工作台",
+          priority: "high",
+          workflowStatus: "in-progress",
+          ownerId: "user_1",
+          status: "active",
+          createdAt: "2026-07-29T01:00:00.000Z",
+          createdBy: "user_1",
+          updatedAt: "2026-07-29T02:00:00.000Z",
+          updatedBy: "user_1",
+        },
+      ],
+      page: 1,
+      pageSize: 10,
+      total: 1,
+    });
+  });
+
+  test("加载并呈现当前数据范围内的工单", async () => {
+    const wrapper = mount(WorkOrderListPage);
+    await flushPromises();
+
+    expect(mocks.list).toHaveBeenCalledWith({
+      page: 1,
+      pageSize: 10,
+      q: "",
+    });
+    expect(wrapper.text()).toContain("登录异常");
+    expect(wrapper.text()).toContain("高");
+    expect(wrapper.text()).toContain("处理中");
+  });
+});

package/template/apps/web/src/router/admin-extension-loader.ts

@@ -0,0 +1,44 @@
+import { defineComponent, h, type Component } from "vue";
+import type { AdminPageBinding } from "./admin-ui-composition";
+
+export function isolateAdminPageLoader(
+  moduleName: string,
+  routeKey: string,
+  load: AdminPageBinding["load"],
+): AdminPageBinding["load"] {
+  return async () => {
+    try {
+      const loaded = await load();
+      if (!loaded?.default) {
+        throw new Error("模块页面缺少 default export");
+      }
+      return loaded;
+    } catch (error) {
+      console.error("Admin Extension 页面加载失败", {
+        moduleName,
+        routeKey,
+        error,
+      });
+      return {
+        default: failureComponent(moduleName, routeKey),
+      };
+    }
+  };
+}
+
+function failureComponent(moduleName: string, routeKey: string): Component {
+  return defineComponent({
+    name: "AdminExtensionLoadFailure",
+    setup() {
+      return () =>
+        h("main", { class: "space-y-3 p-6" }, [
+          h("h1", { class: "text-xl font-semibold" }, "模块页面暂不可用"),
+          h(
+            "p",
+            { class: "text-sm text-muted-foreground" },
+            `模块 ${moduleName} 的页面 ${routeKey} 加载失败。其他管理功能仍可继续使用。`,
+          ),
+        ]);
+    },
+  });
+}

package/template/apps/web/src/router/admin-extension-loader.webtest.ts

@@ -0,0 +1,49 @@
+import { describe, expect, test, vi } from "vitest";
+import { isolateAdminPageLoader } from "./admin-extension-loader";
+
+describe("Admin Extension 页面隔离", () => {
+  test("正常 loader 原样返回页面组件", async () => {
+    const page = { name: "CasePage" };
+    const load = isolateAdminPageLoader("case", "case.record", async () => ({
+      default: page,
+    }));
+
+    expect(await load()).toEqual({ default: page });
+  });
+
+  test("loader 失败时返回 Admin 壳内故障页而不是抛出", async () => {
+    const error = vi.spyOn(console, "error").mockImplementation(() => {});
+    const load = isolateAdminPageLoader("case", "case.record", async () => {
+      throw new Error("secret stack");
+    });
+
+    const result = await load();
+
+    expect(result.default).toMatchObject({
+      name: "AdminExtensionLoadFailure",
+    });
+    expect(error).toHaveBeenCalledOnce();
+  });
+
+  test("loader 缺少 default export 时同样隔离为故障页", async () => {
+    const error = vi.spyOn(console, "error").mockImplementation(() => {});
+    const load = isolateAdminPageLoader(
+      "case",
+      "case.record",
+      async () => ({}) as never,
+    );
+
+    const result = await load();
+
+    expect(result.default).toMatchObject({
+      name: "AdminExtensionLoadFailure",
+    });
+    expect(error).toHaveBeenCalledWith(
+      "Admin Extension 页面加载失败",
+      expect.objectContaining({
+        moduleName: "case",
+        routeKey: "case.record",
+      }),
+    );
+  });
+});

package/template/apps/web/src/router/admin-ui-composition-plugin.ts

@@ -0,0 +1,33 @@
+export interface AdminUiCompositionValidationPluginOptions {
+  readonly validate?: () => void;
+  readonly validatorEntry?: string;
+  readonly runValidator?: (entry: string) => number;
+}
+
+export interface AdminUiCompositionValidationPlugin {
+  readonly name: string;
+  readonly apply: "build";
+  buildStart(): void;
+}
+
+export function adminUiCompositionValidationPlugin(
+  options: AdminUiCompositionValidationPluginOptions,
+): AdminUiCompositionValidationPlugin {
+  return {
+    name: "windy-admin-ui-composition-validation",
+    apply: "build",
+    buildStart() {
+      if (options.validate) {
+        options.validate();
+        return;
+      }
+      if (!options.validatorEntry || !options.runValidator) {
+        throw new Error("Admin UI 组合构建门禁缺少 validatorEntry 或执行器");
+      }
+      const exitCode = options.runValidator(options.validatorEntry);
+      if (exitCode !== 0) {
+        throw new Error(`Admin UI 组合构建校验失败（exit ${exitCode}）`);
+      }
+    },
+  };
+}

package/template/apps/web/src/router/admin-ui-composition-plugin.webtest.ts

@@ -0,0 +1,20 @@
+import { describe, expect, test } from "vitest";
+import { validateProjectModuleAssembly } from "@southwind-ai/modules/admin-ui";
+import { adminUiCompositionValidationPlugin } from "./admin-ui-composition-plugin";
+
+describe("Admin UI 组合构建门禁", () => {
+  test("Vite buildStart 使用运行时同一解析器并 fail closed", () => {
+    const plugin = adminUiCompositionValidationPlugin({
+      validate: () =>
+        validateProjectModuleAssembly({ schemaVersion: 2, modules: [] }),
+    });
+
+    expect(typeof plugin.buildStart).toBe("function");
+    expect(() => {
+      if (typeof plugin.buildStart !== "function") {
+        throw new Error("buildStart 未注册");
+      }
+      plugin.buildStart.call(undefined as never);
+    }).toThrow("schemaVersion 不受支持");
+  });
+});