create-windy 0.1.0

package/template/apps/web/src/pages/system/components/SystemResourceTable.vue

@@ -0,0 +1,242 @@
+<script setup lang="ts">
+import { computed } from "vue";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Switch } from "@/components/ui/switch";
+import { Skeleton } from "@/components/ui/skeleton";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import type { ResourceColumn, ResourceInlineToggle } from "../resource-config";
+import type { SystemRecord } from "@/services/system-api";
+import { formatDateTime } from "@/lib/date-time";
+import { AUDIT_ACTION_DEFINITIONS } from "@windy/shared";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
+// @windy-module system.audit begin
+import AuditActionCell from "./AuditActionCell.vue";
+// @windy-module system.audit end
+
+const props = defineProps<{
+  columns: ResourceColumn[];
+  items: readonly SystemRecord[];
+  editable?: boolean;
+  deletable?: boolean;
+  inlineToggle?: ResourceInlineToggle;
+  togglePendingId?: string;
+  loading?: boolean;
+  page?: number;
+  pageSize?: number;
+}>();
+
+const emit = defineEmits<{
+  edit: [item: SystemRecord];
+  editLicense: [item: SystemRecord];
+  remove: [item: SystemRecord];
+  toggle: [item: SystemRecord, checked: boolean];
+}>();
+
+const hasRows = computed(() => props.items.length > 0);
+
+function formatValue(item: SystemRecord, column: ResourceColumn): string {
+  if (column.format === "license-policy") return formatLicensePolicy(item);
+  const value = item[column.key];
+  if (column.format === "audit-action")
+    return auditAction(value)?.label || String(value || "-");
+  if (column.format === "date-time") return formatDateTime(value);
+  if (column.format === "governed-value") return formatGovernedValue(value);
+  if (typeof value === "boolean") return value ? "是" : "否";
+  if (Array.isArray(value)) return value.join(", ");
+  if (value && typeof value === "object") {
+    const objectValue = value as Record<string, unknown>;
+    return String(
+      objectValue.display ||
+        objectValue.name ||
+        objectValue.id ||
+        JSON.stringify(value),
+    );
+  }
+  return value ? String(value) : "-";
+}
+
+function formatGovernedValue(value: unknown): string {
+  if (value === undefined || value === null || value === "") return "-";
+  if (typeof value !== "object" || Array.isArray(value)) return String(value);
+
+  const governedValue = value as Record<string, unknown>;
+  if (governedValue.kind === "masked") {
+    return typeof governedValue.display === "string" && governedValue.display
+      ? governedValue.display
+      : "-";
+  }
+  if (governedValue.kind === "plaintext") {
+    const plaintext = governedValue.value;
+    return plaintext === undefined || plaintext === null || plaintext === ""
+      ? "-"
+      : String(plaintext);
+  }
+  return "-";
+}
+
+function auditAction(value: unknown) {
+  return AUDIT_ACTION_DEFINITIONS.find(({ key }) => key === value);
+}
+
+function formatLicensePolicy(item: SystemRecord): string {
+  const versions = item.allowedLicenseVersions;
+  if (Array.isArray(versions) && versions.length) {
+    return versions
+      .map((version) => licenseVersionLabel(String(version)))
+      .join("、");
+  }
+  return item.requiredEntitlement
+    ? `授权项：${String(item.requiredEntitlement)}`
+    : "基础能力";
+}
+
+function licenseVersionLabel(version: string): string {
+  return { standard: "标准版", advanced: "高级版" }[version] || version;
+}
+</script>
+
+<template>
+  <TooltipProvider :delay-duration="0">
+    <div class="overflow-hidden rounded-md border">
+      <Table>
+        <TableHeader>
+          <TableRow>
+            <TableHead class="w-16">序号</TableHead>
+            <TableHead v-for="column in columns" :key="column.key">
+              <Tooltip v-if="column.headerDescription">
+                <TooltipTrigger as-child>
+                  <button
+                    type="button"
+                    class="cursor-help underline decoration-dotted underline-offset-4"
+                  >
+                    {{ column.label }}
+                  </button>
+                </TooltipTrigger>
+                <TooltipContent>{{ column.headerDescription }}</TooltipContent>
+              </Tooltip>
+              <template v-else>{{ column.label }}</template>
+            </TableHead>
+            <TableHead class="w-64 text-right">操作</TableHead>
+          </TableRow>
+        </TableHeader>
+        <TableBody>
+          <template v-if="loading">
+            <TableRow
+              v-for="row in 5"
+              :key="row"
+              data-testid="resource-skeleton-row"
+            >
+              <TableCell><Skeleton class="h-4 w-8" /></TableCell>
+              <TableCell v-for="column in columns" :key="column.key">
+                <Skeleton class="h-4 w-full max-w-32" />
+              </TableCell>
+              <TableCell><Skeleton class="ml-auto h-8 w-20" /></TableCell>
+            </TableRow>
+          </template>
+          <TableRow v-else-if="!hasRows">
+            <TableCell
+              :colspan="columns.length + 2"
+              class="h-24 text-center text-muted-foreground"
+            >
+              暂无数据
+            </TableCell>
+          </TableRow>
+          <TableRow v-for="(item, index) in items" v-else :key="item.id">
+            <TableCell>{{
+              ((page || 1) - 1) * (pageSize || 10) + index + 1
+            }}</TableCell>
+            <TableCell v-for="column in columns" :key="column.key">
+              <Badge v-if="column.key === 'status'" variant="secondary">
+                {{ formatValue(item, column) }}
+              </Badge>
+              <!-- @windy-module system.audit begin -->
+              <AuditActionCell
+                v-else-if="column.format === 'audit-action'"
+                :item="item"
+                :action-key="item[column.key]"
+              />
+              <!-- @windy-module system.audit end -->
+              <Tooltip
+                v-else-if="column.descriptionKey && item[column.descriptionKey]"
+              >
+                <TooltipTrigger as-child>
+                  <button
+                    type="button"
+                    class="cursor-help text-left underline decoration-dotted underline-offset-4"
+                  >
+                    {{ formatValue(item, column) }}
+                  </button>
+                </TooltipTrigger>
+                <TooltipContent>
+                  {{ String(item[column.descriptionKey]) }}
+                </TooltipContent>
+              </Tooltip>
+              <span v-else>{{ formatValue(item, column) }}</span>
+            </TableCell>
+            <TableCell class="text-right">
+              <div
+                v-if="inlineToggle"
+                class="flex items-center justify-end gap-2"
+              >
+                <Button
+                  v-if="editable"
+                  variant="outline"
+                  size="sm"
+                  @click="emit('editLicense', item)"
+                >
+                  License 范围
+                </Button>
+                <span class="text-xs text-muted-foreground">
+                  {{ item[inlineToggle.key] ? "已启用" : "已停用" }}
+                </span>
+                <Switch
+                  :model-value="Boolean(item[inlineToggle.key])"
+                  :disabled="!editable || togglePendingId === item.id"
+                  :aria-label="`${inlineToggle.label}：${String(item.label || item.id)}`"
+                  @update:model-value="emit('toggle', item, $event)"
+                />
+              </div>
+              <div v-else class="flex justify-end gap-2">
+                <Button
+                  v-if="editable"
+                  variant="outline"
+                  size="sm"
+                  @click="emit('edit', item)"
+                >
+                  编辑
+                </Button>
+                <Button
+                  v-if="deletable"
+                  variant="destructive"
+                  size="sm"
+                  @click="emit('remove', item)"
+                >
+                  删除
+                </Button>
+                <span
+                  v-if="!editable && !deletable"
+                  class="text-sm text-muted-foreground"
+                >
+                  只读
+                </span>
+              </div>
+            </TableCell>
+          </TableRow>
+        </TableBody>
+      </Table>
+    </div>
+  </TooltipProvider>
+</template>

package/template/apps/web/src/pages/system/components/SystemResourceTable.webtest.ts

@@ -0,0 +1,196 @@
+import { describe, expect, test } from "vitest";
+import { mount } from "@vue/test-utils";
+import { Switch } from "@/components/ui/switch";
+import { systemResourceConfigs } from "../resource-config";
+import SystemResourceTable from "./SystemResourceTable.vue";
+
+describe("SystemResourceTable", () => {
+  test("跨页序号从当前页偏移量连续计算", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "name", label: "名称" }],
+        items: [
+          { id: "row_1", name: "第一条" },
+          { id: "row_2", name: "第二条" },
+        ],
+        page: 3,
+        pageSize: 10,
+      },
+    });
+
+    expect(wrapper.text()).toContain("序号");
+    expect(wrapper.findAll("tbody tr")[0]?.text()).toContain("21");
+    expect(wrapper.findAll("tbody tr")[1]?.text()).toContain("22");
+  });
+
+  test("加载时保留表头并显示带动画的骨架行", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "label", label: "名称" }],
+        items: [],
+        loading: true,
+      },
+    });
+
+    expect(wrapper.text()).toContain("名称");
+    expect(
+      wrapper.findAll('[data-testid="resource-skeleton-row"]'),
+    ).toHaveLength(5);
+    expect(wrapper.get('[data-slot="skeleton"]').classes()).toContain(
+      "animate-pulse",
+    );
+    expect(wrapper.text()).not.toContain("暂无数据");
+  });
+
+  test("只读访问不渲染编辑或删除按钮", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "label", label: "名称" }],
+        items: [{ id: "system.audit", label: "审计日志" }],
+        editable: false,
+        deletable: false,
+      },
+    });
+
+    expect(wrapper.text()).toContain("只读");
+    expect(wrapper.text()).not.toContain("编辑");
+    expect(wrapper.text()).not.toContain("删除");
+  });
+
+  test("获得更新能力后仅渲染编辑按钮", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "label", label: "名称" }],
+        items: [{ id: "system.audit", label: "审计日志" }],
+        editable: true,
+        deletable: false,
+      },
+    });
+
+    expect(wrapper.text()).toContain("编辑");
+    expect(wrapper.text()).not.toContain("删除");
+  });
+
+  test("行内开关显示在操作栏并发出目标状态", async () => {
+    const item = { id: "system.audit", label: "审计日志", enabled: true };
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "label", label: "名称" }],
+        items: [item],
+        editable: true,
+        inlineToggle: { key: "enabled", label: "启用功能" },
+      },
+    });
+
+    expect(wrapper.text()).not.toContain("编辑");
+    wrapper.getComponent(Switch).vm.$emit("update:modelValue", false);
+    await wrapper.vm.$nextTick();
+
+    expect(wrapper.emitted("toggle")).toEqual([[item, false]]);
+    await wrapper
+      .findAll("button")
+      .find((button) => button.text() === "License 范围")
+      ?.trigger("click");
+    expect(wrapper.emitted("editLicense")).toEqual([[item]]);
+  });
+
+  test("只读访问保留开关状态但禁止操作", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "label", label: "名称" }],
+        items: [{ id: "system.audit", label: "审计日志", enabled: false }],
+        editable: false,
+        inlineToggle: { key: "enabled", label: "启用功能" },
+      },
+    });
+
+    expect(wrapper.getComponent(Switch).props("disabled")).toBe(true);
+    expect(wrapper.text()).toContain("已停用");
+  });
+
+  test("功能名称提供说明且 License 范围使用产品化表达", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [
+          { key: "label", label: "名称", descriptionKey: "description" },
+          {
+            key: "licensePolicy",
+            label: "License 范围",
+            format: "license-policy",
+          },
+        ],
+        items: [
+          {
+            id: "system.bulk-data",
+            label: "批量数据任务",
+            description: "受控的大批量导入导出。",
+            allowedLicenseVersions: ["advanced"],
+          },
+        ],
+      },
+    });
+
+    expect(wrapper.text()).toContain("批量数据任务");
+    expect(wrapper.text()).toContain("高级版");
+    expect(wrapper.get('button[type="button"]').attributes("class")).toContain(
+      "cursor-help",
+    );
+    expect(
+      wrapper.get('button[type="button"]').attributes("title"),
+    ).toBeUndefined();
+  });
+
+  test("审计时间使用统一的年月日时分秒格式", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "occurredAt", label: "时间", format: "date-time" }],
+        items: [
+          {
+            id: "audit_1",
+            occurredAt: "2026-07-14T01:05:06.000Z",
+          },
+        ],
+      },
+    });
+
+    expect(wrapper.text()).toContain("2026-07-14 09:05:06");
+  });
+
+  // @windy-module system.audit begin
+  test("审计动作显示稳定中文名称和说明而不是内部 code", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: [{ key: "action", label: "动作", format: "audit-action" }],
+        items: [{ id: "audit_1", action: "feature.update" }],
+      },
+    });
+
+    expect(wrapper.text()).toContain("功能开关更新");
+    expect(wrapper.text()).not.toContain("feature.update");
+    expect(
+      wrapper.get('button[type="button"]').attributes("title"),
+    ).toBeUndefined();
+  });
+  // @windy-module system.audit end
+
+  test("受治理的空手机号显示占位符而不是 JSON", () => {
+    const wrapper = mount(SystemResourceTable, {
+      props: {
+        columns: systemResourceConfigs.users.columns,
+        items: [
+          {
+            id: "user_1",
+            phone: {
+              kind: "masked",
+              classification: "sensitive",
+              display: "",
+            },
+          },
+        ],
+      },
+    });
+
+    expect(wrapper.findAll("tbody td")[3]?.text()).toBe("-");
+    expect(wrapper.text()).not.toContain('"kind":"masked"');
+  });
+});

package/template/apps/web/src/pages/system/components/dictionary-bulk/DictionaryBulkActions.vue

@@ -0,0 +1,142 @@
+<script setup lang="ts">
+import { shallowRef } from "vue";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { DICTIONARY_BULK_LIMITS } from "@/services/bulk-data-api";
+
+withDefaults(
+  defineProps<{
+    submitting?: boolean;
+  }>(),
+  { submitting: false },
+);
+
+const emit = defineEmits<{
+  import: [
+    payload: {
+      mode: "create" | "upsert";
+      content: string;
+    },
+  ];
+  export: [];
+}>();
+
+const importMode = shallowRef<"create" | "upsert">("upsert");
+const selectedFile = shallowRef<File>();
+const validationError = shallowRef("");
+
+function selectFile(event: Event) {
+  selectedFile.value = (event.target as HTMLInputElement).files?.[0];
+  validationError.value = "";
+}
+
+async function submitImport() {
+  if (!selectedFile.value) {
+    validationError.value = "请选择 UTF-8 NDJSON 文件。";
+    return;
+  }
+  if (selectedFile.value.size > DICTIONARY_BULK_LIMITS.maxBytes) {
+    validationError.value = "文件超过 10 MiB，未提交后台任务。";
+    return;
+  }
+  const content = await selectedFile.value.text();
+  validationError.value = validateNdjsonLimits(content);
+  if (validationError.value) return;
+  emit("import", {
+    mode: importMode.value,
+    content,
+  });
+}
+
+function submitExport() {
+  validationError.value = "";
+  emit("export");
+}
+
+function validateNdjsonLimits(content: string) {
+  const encoder = new TextEncoder();
+  const nonEmptyLines = content.split(/\r?\n/).filter((line) => line.trim());
+  if (nonEmptyLines.length > DICTIONARY_BULK_LIMITS.maxRows) {
+    return "文件超过 50,000 个非空逻辑行，未提交后台任务。";
+  }
+  if (
+    nonEmptyLines.some(
+      (line) =>
+        encoder.encode(line).byteLength > DICTIONARY_BULK_LIMITS.maxLineBytes,
+    )
+  ) {
+    return "文件包含超过 256 KiB 的单行，未提交后台任务。";
+  }
+  return "";
+}
+</script>
+
+<template>
+  <div class="grid gap-4 xl:grid-cols-2">
+    <section class="space-y-3 rounded-md border p-4">
+      <div>
+        <h3 class="text-sm font-medium">后台导入</h3>
+        <p class="mt-1 text-xs text-muted-foreground">
+          仅支持字典 UTF-8 NDJSON；最多 10 MiB、50,000 行，单行不超过 256 KiB。
+        </p>
+      </div>
+      <div class="flex flex-col gap-2 sm:flex-row">
+        <Select v-model="importMode">
+          <SelectTrigger class="w-full sm:w-44" aria-label="导入模式">
+            <SelectValue />
+          </SelectTrigger>
+          <SelectContent>
+            <SelectItem value="upsert">新增或更新</SelectItem>
+            <SelectItem value="create">仅新增</SelectItem>
+          </SelectContent>
+        </Select>
+        <Input
+          data-testid="bulk-import-file"
+          type="file"
+          accept="application/x-ndjson,.ndjson,text/plain"
+          aria-label="字典 NDJSON 文件"
+          @change="selectFile"
+        />
+      </div>
+      <Button
+        data-testid="bulk-import-submit"
+        :disabled="submitting"
+        @click="submitImport"
+      >
+        {{ submitting ? "提交中..." : "提交导入任务" }}
+      </Button>
+    </section>
+
+    <section class="space-y-3 rounded-md border p-4">
+      <div>
+        <h3 class="text-sm font-medium">后台导出</h3>
+        <p class="mt-1 text-xs text-muted-foreground">
+          导出结果为字典 NDJSON。系统会自动防止网络重试产生重复任务。
+        </p>
+      </div>
+      <Button
+        data-testid="bulk-export-submit"
+        :disabled="submitting"
+        @click="submitExport"
+      >
+        {{ submitting ? "提交中..." : "提交导出任务" }}
+      </Button>
+    </section>
+
+    <p
+      v-if="validationError"
+      data-testid="bulk-validation-error"
+      class="text-sm text-destructive xl:col-span-2"
+      role="alert"
+    >
+      {{ validationError }}
+    </p>
+  </div>
+</template>

package/template/apps/web/src/pages/system/components/dictionary-bulk/DictionaryBulkJobDetail.vue

@@ -0,0 +1,109 @@
+<script setup lang="ts">
+import { computed } from "vue";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import type { BulkArtifactKind, BulkDataJob } from "@/services/bulk-data-api";
+import {
+  bulkKindLabel,
+  bulkStatusLabel,
+  canDownloadFailures,
+  canDownloadResult,
+  formatBulkTime,
+} from "../../dictionary-bulk-presenter";
+
+const props = defineProps<{
+  job?: BulkDataJob;
+  downloading?: BulkArtifactKind;
+}>();
+
+const emit = defineEmits<{
+  download: [kind: BulkArtifactKind];
+}>();
+
+const detail = computed(() => {
+  if (!props.job) return undefined;
+  return {
+    kind: bulkKindLabel(props.job),
+    status: bulkStatusLabel(props.job.status),
+    createdAt: formatBulkTime(props.job.createdAt),
+    startedAt: formatBulkTime(props.job.startedAt),
+    finishedAt: formatBulkTime(props.job.finishedAt),
+    retryAt: formatBulkTime(props.job.nextAttemptAt),
+    resultAvailable: canDownloadResult(props.job),
+    failuresAvailable: canDownloadFailures(props.job),
+  };
+});
+</script>
+
+<template>
+  <aside class="space-y-4 rounded-md border p-4">
+    <div v-if="!job" class="py-8 text-center text-sm text-muted-foreground">
+      从本人任务列表中选择一项查看详情。
+    </div>
+    <template v-else-if="detail">
+      <div class="flex flex-wrap items-start justify-between gap-2">
+        <div>
+          <h3 class="font-medium">{{ detail.kind }}任务</h3>
+          <p class="mt-1 break-all font-mono text-xs text-muted-foreground">
+            {{ job.id }}
+          </p>
+        </div>
+        <Badge variant="secondary">{{ detail.status }}</Badge>
+      </div>
+      <dl class="grid gap-3 text-sm sm:grid-cols-2">
+        <div>
+          <dt class="text-muted-foreground">尝试次数</dt>
+          <dd class="mt-1">{{ job.attempt }} / {{ job.maxAttempts }}</dd>
+        </div>
+        <div>
+          <dt class="text-muted-foreground">行处理结果</dt>
+          <dd class="mt-1">
+            成功 {{ job.succeededRows }}，失败 {{ job.failedRows }}，共
+            {{ job.totalRows }}
+          </dd>
+        </div>
+        <div>
+          <dt class="text-muted-foreground">创建 / 完成</dt>
+          <dd class="mt-1">{{ detail.createdAt }} / {{ detail.finishedAt }}</dd>
+        </div>
+        <div v-if="job.status === 'retry-pending'">
+          <dt class="text-muted-foreground">下次重试</dt>
+          <dd class="mt-1">{{ detail.retryAt }}</dd>
+        </div>
+      </dl>
+      <details class="rounded-md bg-muted/50 p-3 text-xs">
+        <summary class="cursor-pointer font-medium">技术信息</summary>
+        <p class="mt-2 text-muted-foreground">
+          防重复令牌由浏览器自动生成，同一次网络重试会复用，避免重复创建任务。
+        </p>
+        <p class="mt-2 break-all font-mono">{{ job.idempotencyKey }}</p>
+      </details>
+      <p v-if="job.error" class="rounded-md bg-muted p-3 text-sm">
+        最近一次系统错误：{{ job.error }}
+      </p>
+      <div class="flex flex-wrap gap-2">
+        <Button
+          v-if="detail.resultAvailable"
+          data-testid="bulk-download-result"
+          variant="outline"
+          :disabled="Boolean(downloading)"
+          @click="emit('download', 'result')"
+        >
+          {{ downloading === "result" ? "下载中..." : "下载任务结果" }}
+        </Button>
+        <Button
+          v-if="detail.failuresAvailable"
+          data-testid="bulk-download-failures"
+          variant="outline"
+          :disabled="Boolean(downloading)"
+          @click="emit('download', 'failures')"
+        >
+          {{ downloading === "failures" ? "下载中..." : "下载失败行明细" }}
+        </Button>
+      </div>
+      <p v-if="detail.failuresAvailable" class="text-xs text-muted-foreground">
+        失败明细仅含行号、错误分类、安全消息和输入摘要，不回显原始输入行。
+      </p>
+    </template>
+  </aside>
+</template>