create-windy 0.1.0

package/template/apps/web/src/pages/configuration/components/ModuleConfigurationEditor.vue

@@ -0,0 +1,126 @@
+<script setup lang="ts">
+import type {
+  ModuleConfigSummary,
+  ModuleConfigValue,
+  ModuleConfigValues,
+} from "@windy/shared";
+import { Button } from "@/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Switch } from "@/components/ui/switch";
+
+const props = defineProps<{
+  summary: ModuleConfigSummary;
+  values: ModuleConfigValues;
+  reason: string;
+  canManage: boolean;
+  dirty: boolean;
+  saving: boolean;
+}>();
+
+const emit = defineEmits<{
+  "update:values": [value: ModuleConfigValues];
+  "update:reason": [value: string];
+  save: [];
+}>();
+
+function update(path: string, value: ModuleConfigValue) {
+  emit("update:values", { ...props.values, [path]: value });
+}
+
+function updateInteger(path: string, event: Event) {
+  const value = Number((event.currentTarget as HTMLInputElement).value);
+  if (Number.isSafeInteger(value)) update(path, value);
+}
+</script>
+
+<template>
+  <Card>
+    <CardHeader>
+      <CardTitle>{{ summary.label }}</CardTitle>
+      <CardDescription>
+        当前来源：{{
+          summary.effectiveSource === "version" ? "配置版本" : "环境变量"
+        }}
+        <template v-if="summary.effectiveVersion">
+          · 生效版本 v{{ summary.effectiveVersion }}
+        </template>
+      </CardDescription>
+    </CardHeader>
+    <CardContent class="space-y-5">
+      <div
+        v-for="field in summary.fields"
+        :key="field.path"
+        class="grid gap-2 rounded-lg border p-4"
+      >
+        <div class="flex items-start justify-between gap-4">
+          <div class="space-y-1">
+            <label :for="`config-${field.path}`" class="text-sm font-medium">
+              {{ field.label }}
+            </label>
+            <p class="text-xs text-muted-foreground">
+              {{ field.description }}
+            </p>
+          </div>
+          <Switch
+            v-if="field.input === 'boolean'"
+            :id="`config-${field.path}`"
+            :model-value="Boolean(values[field.path])"
+            :disabled="!canManage || saving"
+            @update:model-value="update(field.path, $event)"
+          />
+        </div>
+        <Input
+          v-if="field.input === 'integer'"
+          :id="`config-${field.path}`"
+          type="number"
+          :min="field.minimum"
+          :max="field.maximum"
+          :model-value="String(values[field.path] ?? '')"
+          :disabled="!canManage || saving"
+          @input="updateInteger(field.path, $event)"
+        />
+        <Input
+          v-if="field.input === 'text'"
+          :id="`config-${field.path}`"
+          :model-value="String(values[field.path] ?? '')"
+          :disabled="!canManage || saving"
+          @update:model-value="update(field.path, String($event))"
+        />
+      </div>
+
+      <label v-if="canManage" class="grid gap-2 text-sm font-medium">
+        <span>变更原因（可选）</span>
+        <textarea
+          :value="reason"
+          maxlength="500"
+          rows="3"
+          class="min-h-20 w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm outline-none focus-visible:ring-2 focus-visible:ring-ring"
+          placeholder="说明本次配置调整的背景"
+          :disabled="saving"
+          @input="
+            emit(
+              'update:reason',
+              ($event.currentTarget as HTMLTextAreaElement).value,
+            )
+          "
+        />
+      </label>
+    </CardContent>
+    <CardFooter class="justify-end gap-3 border-t pt-5">
+      <p v-if="!canManage" class="text-sm text-muted-foreground">
+        当前账号只有查看权限。
+      </p>
+      <Button v-else :disabled="saving || !dirty" @click="emit('save')">
+        {{ saving ? "应用中…" : "创建并应用新版本" }}
+      </Button>
+    </CardFooter>
+  </Card>
+</template>

package/template/apps/web/src/pages/configuration/components/ModuleConfigurationEditor.webtest.ts

@@ -0,0 +1,73 @@
+import { mount } from "@vue/test-utils";
+import { describe, expect, test } from "vitest";
+import type { ModuleConfigSummary } from "@windy/shared";
+import ModuleConfigurationEditor from "./ModuleConfigurationEditor.vue";
+
+const summary: ModuleConfigSummary = {
+  moduleKey: "platform.runtime",
+  label: "平台运行配置",
+  fields: [
+    {
+      path: "enableAI",
+      label: "AI 能力总开关",
+      description: "控制平台 AI 能力声明。",
+      input: "boolean",
+    },
+    {
+      path: "cache.healthTimeoutMs",
+      label: "Redis 探活超时",
+      description: "控制探活总等待时间。",
+      input: "integer",
+      minimum: 50,
+      maximum: 10_000,
+    },
+  ],
+  effectiveValues: {
+    enableAI: false,
+    "cache.healthTimeoutMs": 1_500,
+  },
+  effectiveSource: "environment",
+};
+
+describe("模块配置编辑器", () => {
+  test("只呈现注册字段并提交类型化整数值", async () => {
+    const wrapper = mount(ModuleConfigurationEditor, {
+      props: {
+        summary,
+        values: { ...summary.effectiveValues },
+        reason: "",
+        canManage: true,
+        dirty: true,
+        saving: false,
+      },
+    });
+
+    expect(wrapper.text()).toContain("AI 能力总开关");
+    expect(wrapper.text()).toContain("Redis 探活超时");
+    expect(wrapper.text()).not.toContain("SecretRef");
+    expect(wrapper.text()).not.toContain("数据库连接");
+
+    const timeout = wrapper.get('input[type="number"]');
+    await timeout.setValue("2200");
+    expect(wrapper.emitted("update:values")?.at(-1)?.[0]).toMatchObject({
+      "cache.healthTimeoutMs": 2_200,
+    });
+  });
+
+  test("只读账号不能编辑或创建版本", () => {
+    const wrapper = mount(ModuleConfigurationEditor, {
+      props: {
+        summary,
+        values: { ...summary.effectiveValues },
+        reason: "",
+        canManage: false,
+        dirty: false,
+        saving: false,
+      },
+    });
+
+    expect(wrapper.text()).toContain("当前账号只有查看权限");
+    expect(wrapper.find("textarea").exists()).toBe(false);
+    expect(wrapper.text()).not.toContain("创建并应用新版本");
+  });
+});

package/template/apps/web/src/pages/configuration/components/ModuleConfigurationWorkbench.vue

@@ -0,0 +1,236 @@
+<script setup lang="ts">
+import type { ModuleConfigValues, ModuleConfigVersion } from "@windy/shared";
+import { computed, onBeforeUnmount, onMounted, shallowRef } from "vue";
+import { onBeforeRouteLeave } from "vue-router";
+import UnsavedChangesDialog from "@/components/common/UnsavedChangesDialog.vue";
+import { useAccessSnapshot } from "@/composables/useAccessSnapshot";
+import { useAppToast } from "@/composables/useAppToast";
+import { useModuleConfigurations } from "@/composables/useModuleConfigurations";
+import { useUnsavedChangesConfirmation } from "@/composables/useUnsavedChangesConfirmation";
+import ModuleConfigRollbackDialog from "./ModuleConfigRollbackDialog.vue";
+import ModuleConfigVersionList from "./ModuleConfigVersionList.vue";
+import ModuleConfigurationEditor from "./ModuleConfigurationEditor.vue";
+
+const configurations = useModuleConfigurations();
+const access = useAccessSnapshot();
+const toast = useAppToast();
+const confirmation = useUnsavedChangesConfirmation();
+const values = shallowRef<ModuleConfigValues>({});
+const baseline = shallowRef(serialize({}));
+const reason = shallowRef("");
+const rollbackOpen = shallowRef(false);
+const rollbackTarget = shallowRef<ModuleConfigVersion>();
+const canManage = computed(() =>
+  Boolean(
+    access.snapshot.value?.actor.permissionKeys.includes(
+      "system.config.manage",
+    ),
+  ),
+);
+const dirty = computed(
+  () =>
+    canManage.value &&
+    (serialize(values.value) !== baseline.value ||
+      Boolean(reason.value.trim())),
+);
+
+onMounted(async () => {
+  window.addEventListener("beforeunload", handleBeforeUnload);
+  try {
+    await Promise.all([access.ensureLoaded(), configurations.load()]);
+    resetDraft();
+  } catch {
+    // The inline error keeps the page actionable after a manual refresh.
+  }
+});
+
+onBeforeRouteLeave(() => confirmChanges());
+
+onBeforeUnmount(() => {
+  window.removeEventListener("beforeunload", handleBeforeUnload);
+});
+
+async function refresh() {
+  if (!(await confirmChanges())) return;
+  try {
+    await configurations.load();
+    resetDraft();
+  } catch {
+    toast.error("配置版本刷新失败");
+  }
+}
+
+async function requestModule(event: Event) {
+  const moduleKey = (event.currentTarget as HTMLSelectElement).value;
+  if (moduleKey === configurations.selectedModuleKey.value) return;
+  if (!(await confirmChanges())) return;
+  try {
+    await configurations.select(moduleKey);
+    resetDraft();
+  } catch {
+    toast.error("配置模块加载失败");
+  }
+}
+
+async function save(): Promise<boolean> {
+  const summary = configurations.selected.value;
+  if (!summary || !dirty.value) return true;
+  try {
+    const version = await configurations.save(
+      { ...values.value },
+      reason.value.trim() || undefined,
+    );
+    if (version.applyStatus !== "effective") {
+      toast.error("新版本未能生效", {
+        description: version.applyError || "请查看版本状态后重试。",
+      });
+      return false;
+    }
+    resetDraft();
+    toast.success(`配置版本 v${version.version} 已生效`);
+    return true;
+  } catch {
+    toast.error("配置版本应用失败", {
+      description: configurations.error.value || "请稍后重试。",
+    });
+    return false;
+  }
+}
+
+async function requestRollback(version: ModuleConfigVersion) {
+  if (!(await confirmChanges())) return;
+  rollbackTarget.value = version;
+  rollbackOpen.value = true;
+}
+
+async function confirmRollback(rollbackReason: string) {
+  const target = rollbackTarget.value;
+  if (!target) return;
+  try {
+    const version = await configurations.rollback(
+      target.version,
+      rollbackReason,
+    );
+    if (version.applyStatus !== "effective") {
+      toast.error("回滚版本未能生效", {
+        description: version.applyError || "请查看版本状态后重试。",
+      });
+      return;
+    }
+    rollbackOpen.value = false;
+    rollbackTarget.value = undefined;
+    resetDraft();
+    toast.success(`回滚版本 v${version.version} 已生效`);
+  } catch {
+    toast.error("创建回滚版本失败", {
+      description: configurations.error.value || "请稍后重试。",
+    });
+  }
+}
+
+function resetDraft() {
+  values.value = { ...(configurations.selected.value?.effectiveValues || {}) };
+  baseline.value = serialize(values.value);
+  reason.value = "";
+}
+
+function confirmChanges(): Promise<boolean> {
+  return dirty.value ? confirmation.request(save) : Promise.resolve(true);
+}
+
+function handleBeforeUnload(event: BeforeUnloadEvent) {
+  if (!dirty.value) return;
+  event.preventDefault();
+  event.returnValue = "";
+}
+
+function serialize(current: ModuleConfigValues): string {
+  return JSON.stringify(
+    Object.fromEntries(
+      Object.entries(current).sort(([left], [right]) =>
+        left.localeCompare(right),
+      ),
+    ),
+  );
+}
+</script>
+
+<template>
+  <section class="space-y-5">
+    <div
+      class="flex flex-col gap-3 rounded-lg border bg-card p-4 md:flex-row md:items-end md:justify-between"
+    >
+      <label class="grid min-w-72 gap-2 text-sm font-medium">
+        <span>配置模块</span>
+        <select
+          class="h-9 rounded-md border border-input bg-background px-3 text-sm"
+          :value="configurations.selectedModuleKey.value"
+          :disabled="configurations.loading.value"
+          @change="requestModule"
+        >
+          <option
+            v-for="summary in configurations.summaries.value"
+            :key="summary.moduleKey"
+            :value="summary.moduleKey"
+          >
+            {{ summary.label }}（{{ summary.moduleKey }}）
+          </option>
+        </select>
+      </label>
+      <button
+        type="button"
+        class="text-sm font-medium text-primary disabled:opacity-50"
+        :disabled="configurations.loading.value"
+        @click="refresh"
+      >
+        {{ configurations.loading.value ? "刷新中…" : "刷新配置状态" }}
+      </button>
+    </div>
+
+    <div
+      v-if="configurations.error.value"
+      class="rounded-md border border-destructive/30 bg-destructive/5 p-4 text-sm text-destructive"
+    >
+      {{ configurations.error.value }}
+    </div>
+
+    <template v-if="configurations.selected.value">
+      <ModuleConfigurationEditor
+        :summary="configurations.selected.value"
+        :values="values"
+        :reason="reason"
+        :can-manage="canManage"
+        :dirty="dirty"
+        :saving="configurations.saving.value"
+        @update:values="values = $event"
+        @update:reason="reason = $event"
+        @save="save"
+      />
+      <ModuleConfigVersionList
+        :versions="configurations.versions.value"
+        :can-manage="canManage"
+        :saving="configurations.saving.value"
+        @rollback="requestRollback"
+      />
+    </template>
+    <p
+      v-else-if="!configurations.loading.value"
+      class="rounded-lg border p-8 text-center text-sm text-muted-foreground"
+    >
+      当前没有注册可在线管理的非敏感模块配置。
+    </p>
+
+    <ModuleConfigRollbackDialog
+      v-model:open="rollbackOpen"
+      :version="rollbackTarget"
+      :loading="configurations.saving.value"
+      @confirm="confirmRollback"
+    />
+    <UnsavedChangesDialog
+      :open="confirmation.open.value"
+      :saving="confirmation.saving.value"
+      @cancel="confirmation.cancel"
+      @save="confirmation.save"
+    />
+  </section>
+</template>

package/template/apps/web/src/pages/dashboard/DashboardPage.vue

@@ -0,0 +1,39 @@
+<script setup lang="ts">
+import { computed } from "vue";
+import { useAccessSnapshot } from "@/composables/useAccessSnapshot";
+// @windy-module system.license begin
+import { useLicenseRuntime } from "@/composables/useLicenseRuntime";
+// @windy-module system.license end
+import DashboardAttention from "./components/DashboardAttention.vue";
+import DashboardMetricCards from "./components/DashboardMetricCards.vue";
+import { buildDashboardModel } from "./dashboard-presenter";
+
+const access = useAccessSnapshot();
+// @windy-module system.license begin
+const license = useLicenseRuntime();
+// @windy-module system.license end
+const model = computed(() =>
+  buildDashboardModel(
+    access.snapshot.value,
+    // @windy-module system.license begin
+    license.snapshot.value,
+    // @windy-module system.license end
+  ),
+);
+</script>
+
+<template>
+  <div class="flex flex-col gap-6">
+    <section>
+      <h1 class="text-2xl font-semibold tracking-normal text-foreground">
+        管理工作台
+      </h1>
+      <p class="mt-2 text-sm leading-6 text-muted-foreground">
+        从这里确认平台可用状态，并处理需要关注的事项。
+      </p>
+    </section>
+
+    <DashboardMetricCards :items="model.metrics" />
+    <DashboardAttention :items="model.alerts" />
+  </div>
+</template>

package/template/apps/web/src/pages/dashboard/DashboardPage.webtest.ts

@@ -0,0 +1,37 @@
+import { mount } from "@vue/test-utils";
+import { describe, expect, it, vi } from "vitest";
+
+import DashboardPage from "./DashboardPage.vue";
+
+vi.mock("@/composables/useAccessSnapshot", () => ({
+  useAccessSnapshot: () => ({ snapshot: { value: undefined } }),
+}));
+
+// @windy-module system.license begin
+vi.mock("@/composables/useLicenseRuntime", () => ({
+  useLicenseRuntime: () => ({ snapshot: { value: undefined } }),
+}));
+// @windy-module system.license end
+
+describe("DashboardPage", () => {
+  it("keeps status and alerts without duplicating navigation or account entries", () => {
+    const wrapper = mount(DashboardPage, {
+      global: {
+        stubs: {
+          DashboardAttention: {
+            template: '<section data-testid="dashboard-alerts" />',
+          },
+          DashboardMetricCards: {
+            template: '<section data-testid="dashboard-metrics" />',
+          },
+        },
+      },
+    });
+
+    expect(wrapper.get('[data-testid="dashboard-metrics"]')).toBeDefined();
+    expect(wrapper.get('[data-testid="dashboard-alerts"]')).toBeDefined();
+    expect(wrapper.text()).not.toContain("常用管理入口");
+    expect(wrapper.text()).not.toContain("当前账号");
+    expect(wrapper.findComponent({ name: "RouterLink" }).exists()).toBe(false);
+  });
+});

package/template/apps/web/src/pages/dashboard/components/DashboardAttention.vue

@@ -0,0 +1,36 @@
+<script setup lang="ts">
+import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert";
+import { CircleCheckIcon, InfoIcon, TriangleAlertIcon } from "@lucide/vue";
+import type { DashboardAlert } from "../dashboard-presenter";
+
+defineProps<{
+  items: DashboardAlert[];
+}>();
+</script>
+
+<template>
+  <section class="space-y-3">
+    <div>
+      <h2 class="text-base font-semibold text-foreground">需要关注</h2>
+      <p class="mt-1 text-sm text-muted-foreground">
+        优先处理会影响平台访问和交付的事项。
+      </p>
+    </div>
+    <Alert v-if="!items.length">
+      <CircleCheckIcon />
+      <AlertTitle>当前没有阻塞事项</AlertTitle>
+      <AlertDescription>权限快照与 License 状态均已正常加载。</AlertDescription>
+    </Alert>
+    <Alert
+      v-for="item in items"
+      v-else
+      :key="item.key"
+      :variant="item.level === 'critical' ? 'destructive' : 'default'"
+    >
+      <InfoIcon v-if="item.level === 'info'" />
+      <TriangleAlertIcon v-else />
+      <AlertTitle>{{ item.title }}</AlertTitle>
+      <AlertDescription>{{ item.description }}</AlertDescription>
+    </Alert>
+  </section>
+</template>

package/template/apps/web/src/pages/dashboard/components/DashboardMetricCards.vue

@@ -0,0 +1,28 @@
+<script setup lang="ts">
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import type { DashboardMetric } from "../dashboard-presenter";
+
+defineProps<{
+  items: DashboardMetric[];
+}>();
+</script>
+
+<template>
+  <div class="grid gap-4 md:grid-cols-3">
+    <Card v-for="item in items" :key="item.label">
+      <CardHeader class="gap-2">
+        <CardDescription>{{ item.label }}</CardDescription>
+        <CardTitle class="text-2xl text-foreground">{{ item.value }}</CardTitle>
+      </CardHeader>
+      <CardContent>
+        <p class="text-sm text-muted-foreground">{{ item.description }}</p>
+      </CardContent>
+    </Card>
+  </div>
+</template>

package/template/apps/web/src/pages/dashboard/dashboard-presenter.ts

@@ -0,0 +1,115 @@
+// @windy-module system.license begin
+import type { PlatformLicenseSnapshot } from "@/services/license-api";
+// @windy-module system.license end
+import {
+  authorizedSidebarMenus,
+  type WebAccessSnapshot,
+} from "@/layout/navigation";
+
+export interface DashboardMetric {
+  label: string;
+  value: string;
+  description: string;
+}
+
+export interface DashboardAlert {
+  key: string;
+  title: string;
+  description: string;
+  level: "info" | "warning" | "critical";
+}
+
+export interface DashboardModel {
+  metrics: DashboardMetric[];
+  alerts: DashboardAlert[];
+}
+
+export function buildDashboardModel(
+  snapshot: WebAccessSnapshot | undefined,
+  // @windy-module system.license begin
+  license: PlatformLicenseSnapshot | undefined,
+  // @windy-module system.license end
+): DashboardModel {
+  const features = snapshot?.features || [];
+  const availableMenuCount = snapshot
+    ? authorizedSidebarMenus(snapshot)
+        .flatMap((menu) => (menu.children?.length ? menu.children : [menu]))
+        .filter((menu) => menu.key !== "dashboard" && Boolean(menu.path)).length
+    : 0;
+  const availableFeatures = features.filter(
+    (feature) => feature.allowed,
+  ).length;
+  const permissionCount = snapshot?.actor.permissionKeys.length || 0;
+
+  return {
+    metrics: [
+      {
+        label: "可用能力",
+        value: `${availableFeatures} / ${features.length}`,
+        description: "当前账号和 License 均允许使用的功能",
+      },
+      {
+        label: "管理入口",
+        value: String(availableMenuCount),
+        description: "已按权限和功能开关过滤的页面入口",
+      },
+      {
+        label: "权限点",
+        value: String(permissionCount),
+        description: "当前会话实际生效的 RBAC 权限",
+      },
+    ],
+    alerts: buildAlerts(
+      snapshot,
+      // @windy-module system.license begin
+      license,
+      // @windy-module system.license end
+    ),
+  };
+}
+
+function buildAlerts(
+  snapshot: WebAccessSnapshot | undefined,
+  // @windy-module system.license begin
+  license: PlatformLicenseSnapshot | undefined,
+  // @windy-module system.license end
+): DashboardAlert[] {
+  const alerts: DashboardAlert[] = [];
+  if (!snapshot) {
+    alerts.push({
+      key: "access-loading",
+      title: "正在同步访问权限",
+      description: "权限快照完成后，工作台会显示当前账号可用的管理入口。",
+      level: "info",
+    });
+  }
+  // @windy-module system.license begin
+  if (license?.restricted) {
+    alerts.push({
+      key: "license-restricted",
+      title: "平台处于受限模式",
+      description: "License 当前不可用，请先处理授权状态后再开展管理操作。",
+      level: "critical",
+    });
+  } else if (license && license.reminder.level !== "none") {
+    alerts.push({
+      key: "license-reminder",
+      title: "License 即将到期",
+      description:
+        license.reminder.daysRemaining === undefined
+          ? "请检查当前 License 的有效期。"
+          : `剩余 ${license.reminder.daysRemaining} 天，请提前安排续期。`,
+      level: license.reminder.level === "critical" ? "critical" : "warning",
+    });
+  }
+  // @windy-module system.license end
+  if (snapshot && snapshot.actor.roleCodes.length === 0) {
+    alerts.push({
+      key: "role-missing",
+      title: "当前账号尚未分配角色",
+      description: "请联系平台管理员配置角色与权限，避免管理入口不可用。",
+      level: "warning",
+    });
+  }
+  return alerts;
+}