create-windy 0.2.34 → 0.3.0

package/template/apps/web/src/pages/errors/error-page-extension.ts

@@ -0,0 +1,26 @@
+import type { Component } from "vue";
+
+export type ErrorPageKind =
+  | "not-found"
+  | "internal"
+  | "maintenance"
+  | "network";
+
+export interface ErrorPageProps {
+  kind: ErrorPageKind;
+  from: string;
+  requestId?: string;
+}
+
+export interface ErrorPageComponents {
+  notFound: Component;
+  internal: Component;
+  maintenance: Component;
+  network: Component;
+}
+
+export function defineErrorPageComponents(
+  components: ErrorPageComponents,
+): ErrorPageComponents {
+  return components;
+}

package/template/apps/web/src/pages/system/SystemNotificationsPage.vue

@@ -1,15 +1,16 @@
 <script setup lang="ts">
 import type {
   PlatformNotification,
-  PublishNotificationInput,
+  UpdateNotificationInput,
 } from "@southwind-ai/shared";
 import { DEFAULT_PAGE_SIZE } from "@southwind-ai/shared";
-import { ArchiveIcon, RefreshCwIcon, SendIcon } from "@lucide/vue";
-import { onMounted, shallowRef } from "vue";
+import { RefreshCwIcon, SendIcon } from "@lucide/vue";
+import { computed, onBeforeUnmount, onMounted, shallowRef } from "vue";
+import { onBeforeRouteLeave } from "vue-router";
 import ConfirmDialog from "@/components/common/ConfirmDialog.vue";
 import DataPagination from "@/components/common/DataPagination.vue";
 import FormDialog from "@/components/common/FormDialog.vue";
-import { Badge } from "@/components/ui/badge";
+import UnsavedChangesDialog from "@/components/common/UnsavedChangesDialog.vue";
 import { Button } from "@/components/ui/button";
 import {
   Card,
@@ -23,34 +24,62 @@ import {
   TooltipContent,
   TooltipTrigger,
 } from "@/components/ui/tooltip";
-import { formatDateTime } from "@/lib/date-time";
+import { useUnsavedChangesConfirmation } from "@/composables/useUnsavedChangesConfirmation";
 import {
   archiveNotification,
   listManagedNotifications,
-  publishNotification,
+  updateNotification,
 } from "@/services/notification-api";
+import NotificationHistoryDialog from "./components/NotificationHistoryDialog.vue";
+import NotificationManagementCard from "./components/NotificationManagementCard.vue";
+import NotificationPublishDialog from "./components/NotificationPublishDialog.vue";
 import NotificationPublishForm from "./components/NotificationPublishForm.vue";
+import { useNotificationPermissions } from "./composables/useNotificationPermissions";
 
-const emptyForm = (): PublishNotificationInput => ({
+const emptyForm = (): UpdateNotificationInput => ({
   title: "",
   summary: "",
   content: "",
   category: "系统",
 });
-const form = shallowRef(emptyForm());
 const notifications = shallowRef<PlatformNotification[]>([]);
 const loading = shallowRef(false);
-const publishing = shallowRef(false);
 const error = shallowRef("");
 const resultMessage = shallowRef("");
 const confirmOpen = shallowRef(false);
 const publishOpen = shallowRef(false);
 const pendingArchive = shallowRef<PlatformNotification>();
+const editingNotification = shallowRef<PlatformNotification>();
+const editForm = shallowRef<UpdateNotificationInput>(emptyForm());
+const editBaseline = shallowRef<UpdateNotificationInput>(emptyForm());
+const editOpen = shallowRef(false);
+const editing = shallowRef(false);
+const historyNotification = shallowRef<PlatformNotification>();
+const historyOpen = shallowRef(false);
+const confirmation = useUnsavedChangesConfirmation();
+const { canUpdate } = useNotificationPermissions();
 const page = shallowRef(1);
 const pageSize = shallowRef(DEFAULT_PAGE_SIZE);
 const total = shallowRef(0);
 
-onMounted(loadNotifications);
+const editDirty = computed(
+  () =>
+    editOpen.value &&
+    (editForm.value.title !== editBaseline.value.title ||
+      editForm.value.summary !== editBaseline.value.summary ||
+      editForm.value.content !== editBaseline.value.content ||
+      editForm.value.category !== editBaseline.value.category),
+);
+onMounted(() => {
+  window.addEventListener("beforeunload", preventDirtyUnload);
+  void loadNotifications();
+});
+onBeforeUnmount(() =>
+  window.removeEventListener("beforeunload", preventDirtyUnload),
+);
+onBeforeRouteLeave(() =>
+  editDirty.value ? confirmation.request(saveEdit) : true,
+);
 
 async function loadNotifications() {
   loading.value = true;
@@ -68,34 +97,65 @@ async function loadNotifications() {
   }
 }
 
-async function publish() {
-  if (publishing.value) return;
-  publishing.value = true;
+function onPublished(notification: PlatformNotification) {
+  page.value = 1;
+  notifications.value = [notification, ...notifications.value].slice(
+    0,
+    pageSize.value,
+  );
+  total.value += 1;
+  resultMessage.value =
+    notification.status === "scheduled"
+      ? "通知已进入定时发布队列。"
+      : "通知已发布，用户现在可以在右上角通知中心阅读。";
+}
+
+function openEdit(notification: PlatformNotification) {
+  editingNotification.value = notification;
+  editForm.value = editableContent(notification);
+  editBaseline.value = editableContent(notification);
+  editOpen.value = true;
+}
+
+async function saveEdit(): Promise<boolean> {
+  const notification = editingNotification.value;
+  if (!notification || editing.value) return false;
+  editing.value = true;
   error.value = "";
-  resultMessage.value = "";
   try {
-    const notification = await publishNotification({ ...form.value });
-    page.value = 1;
-    notifications.value = [notification, ...notifications.value].slice(
-      0,
-      pageSize.value,
+    const result = await updateNotification(notification.id, {
+      ...editForm.value,
+    });
+    notifications.value = notifications.value.map((item) =>
+      item.id === result.notification.id ? result.notification : item,
     );
-    total.value += 1;
-    form.value = emptyForm();
-    publishOpen.value = false;
-    resultMessage.value = "通知已发布，用户现在可以在右上角通知中心阅读。";
+    editBaseline.value = editableContent(result.notification);
+    editForm.value = editableContent(result.notification);
+    editOpen.value = false;
+    resultMessage.value = result.changed
+      ? `公告已更新为 v${result.notification.revision}。`
+      : "公告内容没有变化。";
+    return true;
   } catch (currentError) {
     error.value = message(currentError);
+    return false;
   } finally {
-    publishing.value = false;
+    editing.value = false;
   }
 }
 
+function beforeEditClose() {
+  return editDirty.value ? confirmation.request(saveEdit) : true;
+}
+function openHistory(notification: PlatformNotification) {
+  historyNotification.value = notification;
+  historyOpen.value = true;
+}
+
 function setPage(value: number) {
   page.value = value;
   void loadNotifications();
 }
-
 function setPageSize(value: number) {
   pageSize.value = value;
   page.value = 1;
@@ -129,6 +189,21 @@ async function confirmArchive() {
 function message(errorValue: unknown) {
   return errorValue instanceof Error ? errorValue.message : String(errorValue);
 }
+
+const editableContent = (
+  notification: PlatformNotification,
+): UpdateNotificationInput => ({
+  title: notification.title,
+  summary: notification.summary,
+  content: notification.content,
+  category: notification.category,
+});
+
+function preventDirtyUnload(event: BeforeUnloadEvent) {
+  if (!editDirty.value) return;
+  event.preventDefault();
+  event.returnValue = "";
+}
 </script>
 
 <template>
@@ -139,7 +214,7 @@ function message(errorValue: unknown) {
       <div class="space-y-2">
         <h1 class="text-2xl font-semibold text-foreground">通知管理</h1>
         <p class="text-sm text-muted-foreground">
-          发布站内通知、管理生命周期，并与用户已读回执形成闭环。
+          发布和修改站内公告、查看不可变版本历史，并管理通知生命周期。
         </p>
       </div>
       <Button @click="publishOpen = true">
@@ -183,43 +258,16 @@ function message(errorValue: unknown) {
         </Tooltip>
       </CardHeader>
       <CardContent class="space-y-3">
-        <article
+        <NotificationManagementCard
           v-for="(notification, index) in notifications"
           :key="notification.id"
-          class="flex flex-col gap-3 rounded-md border p-4 md:flex-row md:items-start md:justify-between"
-        >
-          <div class="min-w-0 space-y-2">
-            <div class="flex flex-wrap items-center gap-2">
-              <h2 class="font-medium text-foreground">
-                {{ (page - 1) * pageSize + index + 1 }}.
-                {{ notification.title }}
-              </h2>
-              <Badge
-                :variant="
-                  notification.status === 'published' ? 'default' : 'secondary'
-                "
-              >
-                {{ notification.status === "published" ? "已发布" : "已归档" }}
-              </Badge>
-              <Badge variant="outline">{{ notification.category }}</Badge>
-            </div>
-            <p class="text-sm text-muted-foreground">
-              {{ notification.summary }}
-            </p>
-            <p class="text-xs text-muted-foreground">
-              发布时间 {{ formatDateTime(notification.publishedAt) }}
-            </p>
-          </div>
-          <Button
-            v-if="notification.status === 'published'"
-            variant="outline"
-            size="sm"
-            @click="requestArchive(notification)"
-          >
-            <ArchiveIcon data-icon="inline-start" />
-            归档
-          </Button>
-        </article>
+          :notification="notification"
+          :sequence="(page - 1) * pageSize + index + 1"
+          :can-edit="canUpdate"
+          @archive="requestArchive"
+          @edit="openEdit"
+          @history="openHistory"
+        />
         <p
           v-if="!loading && notifications.length === 0"
           class="py-8 text-center text-sm text-muted-foreground"
@@ -246,17 +294,37 @@ function message(errorValue: unknown) {
       @confirm="confirmArchive"
     />
 
-    <FormDialog
+    <NotificationPublishDialog
       v-model:open="publishOpen"
-      title="发布新通知"
-      description="发布后立即进入所有已授权用户的通知中心。"
-      submit-text="确认发布"
-      :loading="publishing"
+      @published="onPublished"
+      @error="error = $event"
+    />
+
+    <FormDialog
+      v-model:open="editOpen"
+      title="修改公告"
+      :description="`当前 v${editingNotification?.revision || 1}，保存后生成新版本。`"
+      submit-text="保存修改"
+      :loading="editing"
+      :before-close="beforeEditClose"
       prevent-outside-close
       content-class="sm:max-w-2xl"
-      @submit="publish"
+      @submit="saveEdit"
     >
-      <NotificationPublishForm v-model="form" />
+      <NotificationPublishForm v-model="editForm" />
     </FormDialog>
+
+    <NotificationHistoryDialog
+      v-model:open="historyOpen"
+      :notification="historyNotification"
+    />
+
+    <UnsavedChangesDialog
+      :open="confirmation.open.value"
+      :saving="confirmation.saving.value"
+      description="公告修改尚未保存。取消会留在编辑状态；保存成功后才会继续关闭或离开。"
+      @cancel="confirmation.cancel"
+      @save="confirmation.save"
+    />
   </div>
 </template>

package/template/apps/web/src/pages/system/SystemNotificationsPage.webtest.ts

@@ -1,31 +1,62 @@
 import { flushPromises, mount } from "@vue/test-utils";
-import { describe, expect, test, vi } from "vitest";
+import type { PlatformNotification } from "@southwind-ai/shared";
+import { beforeEach, describe, expect, test, vi } from "vitest";
 import SystemNotificationsPage from "./SystemNotificationsPage.vue";
 import FormDialog from "@/components/common/FormDialog.vue";
 import NotificationPublishForm from "./components/NotificationPublishForm.vue";
 
 const mocks = vi.hoisted(() => ({
-  list: vi.fn(async () => ({ items: [], total: 0, page: 1, pageSize: 10 })),
-  publish: vi.fn(async (input) => ({
-    id: "notice_1",
-    ...input,
-    status: "published",
-    publishedAt: "2026-07-14T08:00:00.000Z",
-    createdAt: "2026-07-14T08:00:00.000Z",
-    createdBy: "admin",
-    updatedAt: "2026-07-14T08:00:00.000Z",
-    updatedBy: "admin",
-  })),
+  items: [] as PlatformNotification[],
+  list: vi.fn(),
+  publish: vi.fn(),
+  update: vi.fn(),
+  history: vi.fn(),
   archive: vi.fn(),
+  audience: vi.fn(),
+  permissionKeys: ["system.notification.update"],
+}));
+
+vi.mock("@/composables/useAccessSnapshot", () => ({
+  useAccessSnapshot: () => ({
+    snapshot: {
+      value: { actor: { permissionKeys: mocks.permissionKeys } },
+    },
+  }),
 }));
 
 vi.mock("@/services/notification-api", () => ({
   listManagedNotifications: mocks.list,
   publishNotification: mocks.publish,
+  updateNotification: mocks.update,
+  listNotificationRevisions: mocks.history,
   archiveNotification: mocks.archive,
+  getNotificationAudienceOptions: mocks.audience,
 }));
 
 describe("通知管理", () => {
+  beforeEach(() => {
+    mocks.items = [];
+    mocks.list.mockReset();
+    mocks.publish.mockReset();
+    mocks.update.mockReset();
+    mocks.history.mockReset();
+    mocks.archive.mockReset();
+    mocks.audience.mockReset();
+    mocks.audience.mockResolvedValue({
+      users: [],
+      roles: [],
+      departments: [],
+    });
+    mocks.permissionKeys = ["system.notification.update"];
+    mocks.list.mockImplementation(async () => ({
+      items: mocks.items,
+      total: mocks.items.length,
+      page: 1,
+      pageSize: 10,
+    }));
+    mocks.publish.mockImplementation(async (input) => notification(input));
+  });
+
   test("已发布通知使用右上角纯图标按钮刷新", async () => {
     const wrapper = mountPage();
     await flushPromises();
@@ -68,11 +99,165 @@ describe("通知管理", () => {
       summary: "今晚进行例行维护",
       content: "请提前保存工作。",
       category: "系统",
+      recipientUserIds: [],
+      recipientRoleCodes: [],
+      recipientDepartmentIds: [],
+      deliveryChannels: [],
+      includeChildDepartments: false,
     });
     expect(wrapper.text()).toContain("维护通知");
     expect(wrapper.text()).toContain("已发布");
     expect(wrapper.getComponent(FormDialog).props("open")).toBe(false);
   });
+
+  test("管理员修改公告后生成新版本并保留修改时间", async () => {
+    const original = notification({
+      title: "初始公告",
+      summary: "初始摘要",
+      content: "初始正文",
+      category: "系统",
+    });
+    mocks.items = [original];
+    mocks.update.mockImplementation(async (_id, input) => ({
+      changed: true,
+      notification: {
+        ...original,
+        ...input,
+        revision: 2,
+        updatedAt: "2026-07-14T09:00:00.000Z",
+      },
+    }));
+    const wrapper = mountPage();
+    await flushPromises();
+
+    await buttonByText(wrapper, "编辑").trigger("click");
+    const forms = wrapper.findAllComponents(NotificationPublishForm);
+    const editForm = forms.at(-1)!;
+    await editForm.get('[name="title"]').setValue("修改公告");
+    wrapper.findAllComponents(FormDialog).at(-1)!.vm.$emit("submit");
+    await flushPromises();
+
+    expect(mocks.update).toHaveBeenCalledWith("notice_1", {
+      title: "修改公告",
+      summary: "初始摘要",
+      content: "初始正文",
+      category: "系统",
+    });
+    expect(wrapper.text()).toContain("v2");
+    expect(wrapper.text()).toContain("公告已更新为 v2");
+  });
+
+  test("角色未获修改权限时不显示编辑入口", async () => {
+    mocks.permissionKeys = ["system.notification.manage"];
+    mocks.items = [
+      notification({
+        title: "只读管理公告",
+        summary: "只读摘要",
+        content: "只读正文",
+        category: "系统",
+      }),
+    ];
+    const wrapper = mountPage();
+    await flushPromises();
+
+    expect(
+      wrapper
+        .findAll("button")
+        .some((button) => button.text().includes("编辑")),
+    ).toBe(false);
+    expect(
+      wrapper
+        .findAll("button")
+        .some((button) => button.text().includes("历史")),
+    ).toBe(true);
+    expect(mocks.update).not.toHaveBeenCalled();
+  });
+
+  test("定时通知显示计划时间并可在到期前归档取消", async () => {
+    mocks.items = [
+      {
+        ...notification({
+          title: "定时公告",
+          summary: "定时摘要",
+          content: "定时正文",
+          category: "系统",
+        }),
+        status: "scheduled",
+        scheduledFor: "2030-01-01T00:00:00.000Z",
+        publishedAt: "2030-01-01T00:00:00.000Z",
+      },
+    ];
+    const wrapper = mountPage();
+    await flushPromises();
+
+    expect(wrapper.text()).toContain("已定时");
+    expect(wrapper.text()).toContain("计划发布");
+    expect(
+      wrapper
+        .findAll("button")
+        .some((button) => button.text().includes("归档")),
+    ).toBe(true);
+  });
+
+  test("历史入口展示版本、修改人和修改时间", async () => {
+    const original = notification({
+      title: "历史公告",
+      summary: "历史摘要",
+      content: "历史正文",
+      category: "系统",
+    });
+    mocks.items = [original];
+    mocks.history.mockResolvedValue({
+      items: [
+        {
+          notificationId: original.id,
+          revision: 1,
+          title: original.title,
+          summary: original.summary,
+          content: original.content,
+          category: original.category,
+          editedAt: original.publishedAt,
+          editedBy: "admin",
+        },
+      ],
+      total: 1,
+      page: 1,
+      pageSize: 10,
+    });
+    const wrapper = mountPage();
+    await flushPromises();
+
+    await buttonByText(wrapper, "历史").trigger("click");
+    await flushPromises();
+
+    expect(mocks.history).toHaveBeenCalledWith("notice_1", 1, 10);
+    expect(document.body.textContent).toContain("公告修改历史");
+    expect(document.body.textContent).toContain("admin");
+    expect(document.body.textContent).toContain("v1");
+    wrapper.unmount();
+  });
+
+  test("编辑草稿触发浏览器离开保护", async () => {
+    mocks.items = [
+      notification({
+        title: "保护公告",
+        summary: "保护摘要",
+        content: "保护正文",
+        category: "系统",
+      }),
+    ];
+    const wrapper = mountPage();
+    await flushPromises();
+    await buttonByText(wrapper, "编辑").trigger("click");
+    const editForm = wrapper.findAllComponents(NotificationPublishForm).at(-1)!;
+    await editForm.get('[name="title"]').setValue("尚未保存");
+    const event = new Event("beforeunload", { cancelable: true });
+
+    window.dispatchEvent(event);
+
+    expect(event.defaultPrevented).toBe(true);
+    wrapper.unmount();
+  });
 });
 
 function mountPage() {
@@ -86,3 +271,30 @@ function mountPage() {
     },
   });
 }
+
+function notification(
+  input: Pick<
+    PlatformNotification,
+    "title" | "summary" | "content" | "category"
+  >,
+): PlatformNotification {
+  return {
+    id: "notice_1",
+    ...input,
+    status: "published",
+    publishedAt: "2026-07-14T08:00:00.000Z",
+    createdAt: "2026-07-14T08:00:00.000Z",
+    createdBy: "admin",
+    updatedAt: "2026-07-14T08:00:00.000Z",
+    updatedBy: "admin",
+    revision: 1,
+  };
+}
+
+function buttonByText(wrapper: ReturnType<typeof mountPage>, text: string) {
+  const button = wrapper
+    .findAll("button")
+    .find((candidate) => candidate.text().includes(text));
+  if (!button) throw new Error(`缺少按钮 ${text}`);
+  return button;
+}

package/template/apps/web/src/pages/system/audit-log-presenter.ts

@@ -0,0 +1,86 @@
+import type { SystemRecord } from "@/services/system-api";
+
+const OUTCOME_LABELS: Record<string, string> = {
+  attempted: "已尝试",
+  success: "成功",
+  failure: "失败",
+  denied: "已拒绝",
+};
+
+export function auditRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === "object" && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : {};
+}
+
+export function auditText(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+
+export function auditOutcomeLabel(value: unknown): string {
+  const key = auditText(value);
+  return key ? OUTCOME_LABELS[key] || key : "未记录";
+}
+
+export function auditTargetLabel(item: SystemRecord): string {
+  const target = auditRecord(item.target);
+  const type = auditText(target.type);
+  const id = auditText(target.id);
+  const label = auditText(target.label);
+  if (!type && !id && !label) return "未记录";
+  const primary = label || type || "未标注对象";
+  const identity = [type && type !== primary ? type : undefined, id]
+    .filter(Boolean)
+    .join(" / ");
+  return identity ? `${primary}（${identity}）` : primary;
+}
+
+export function auditActorLabel(item: SystemRecord): string {
+  const actor = auditRecord(item.actor);
+  const name = auditText(actor.name);
+  const id = auditText(actor.id);
+  if (!name && !id) return "未记录";
+  return name && id && name !== id ? `${name}（${id}）` : name || id || "未记录";
+}
+
+export function auditOperationSummary(
+  item: SystemRecord,
+  actionLabel?: string,
+): string {
+  const message = auditText(item.message);
+  const target = auditTargetLabel(item);
+  if (message) return target === "未记录" ? message : `${message}；对象：${target}`;
+
+  const action = auditText(item.action) || "unknown";
+  const metadata = auditRecord(item.metadata);
+  const targetSuffix = target === "未记录" ? "" : ` ${target}`;
+  if (action === "crud.create") return `新增${targetSuffix || "记录"}`;
+  if (action === "crud.update") return `更新${targetSuffix || "记录"}`;
+  if (action === "crud.delete") return `删除${targetSuffix || "记录"}`;
+  if (action === "data.search" || action === "search.query") {
+    const query = auditText(metadata.query);
+    return query
+      ? `搜索${targetSuffix || "已记录资源"}：${query}`
+      : `搜索${targetSuffix || "已记录资源"}`;
+  }
+  if (action === "feature.update") {
+    const enabled = metadata.enabled;
+    const verb =
+      typeof enabled === "boolean" ? (enabled ? "启用" : "停用") : "更新";
+    return `${verb}${targetSuffix || "功能开关"}`;
+  }
+  if (target !== "未记录") {
+    return `${actionLabel || action}：${target}`;
+  }
+  const module = auditText(item.module);
+  return module
+    ? `${actionLabel || action}（模块：${module}）`
+    : `${actionLabel || action}（未记录操作对象）`;
+}
+
+export function formatAuditMetadata(value: unknown): string {
+  const metadata = auditRecord(value);
+  return Object.keys(metadata).length
+    ? JSON.stringify(metadata, null, 2)
+    : "未记录";
+}