create-windy 0.2.34 → 0.3.0

package/template/packages/database/drizzle/meta/_journal.json

@@ -246,6 +246,34 @@
       "when": 1784976420447,
       "tag": "0034_funny_mesmero",
       "breakpoints": true
+    },
+    {
+      "idx": 35,
+      "version": "7",
+      "when": 1785008351360,
+      "tag": "0035_material_nightshade",
+      "breakpoints": true
+    },
+    {
+      "idx": 36,
+      "version": "7",
+      "when": 1785009127636,
+      "tag": "0036_hesitant_speed",
+      "breakpoints": true
+    },
+    {
+      "idx": 37,
+      "version": "7",
+      "when": 1785012884328,
+      "tag": "0037_absent_nick_fury",
+      "breakpoints": true
+    },
+    {
+      "idx": 38,
+      "version": "7",
+      "when": 1785013875842,
+      "tag": "0038_uneven_wasp",
+      "breakpoints": true
     }
   ]
 }

package/template/packages/database/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/database",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/database/src/schema/identity.ts

@@ -27,7 +27,14 @@ export const departments = pgTable(
   },
   (table) => [
     uniqueIndex("uk_departments_code").on(table.code),
+    uniqueIndex("uk_departments_single_root")
+      .on(sql`((1))`)
+      .where(sql`${table.parentId} is null and ${table.deletedAt} is null`),
     index("idx_departments_parent").on(table.parentId),
+    check(
+      "departments_parent_not_self",
+      sql`${table.parentId} is null or ${table.parentId} <> ${table.id}`,
+    ),
   ],
 );
 

package/template/packages/database/src/schema/notifications.ts

@@ -1,5 +1,7 @@
 import {
+  boolean,
   index,
+  integer,
   pgTable,
   primaryKey,
   text,
@@ -9,6 +11,10 @@ import {
   varchar,
 } from "drizzle-orm/pg-core";
 import type { TargetRef } from "@southwind-ai/shared";
+import type {
+  ExternalNotificationChannel,
+  NotificationDeliveryStatus,
+} from "@southwind-ai/shared";
 import { auditColumns, idColumn, statusColumn } from "./common.js";
 import { users } from "./identity.js";
 
@@ -22,15 +28,32 @@ export const platformNotifications = pgTable(
     category: varchar("category", { length: 40 }).notNull(),
     status: statusColumn().notNull(),
     publishedAt: timestamp("published_at", { withTimezone: true }).notNull(),
+    scheduledFor: timestamp("scheduled_for", { withTimezone: true }),
     archivedAt: timestamp("archived_at", { withTimezone: true }),
     archivedBy: varchar("archived_by", { length: 64 }),
     target: jsonb("target").$type<TargetRef>(),
     recipientUserId: varchar("recipient_user_id", { length: 64 }),
+    recipientUserIds: jsonb("recipient_user_ids")
+      .$type<string[]>()
+      .notNull()
+      .default([]),
     recipientRoleCodes: jsonb("recipient_role_codes")
       .$type<string[]>()
       .notNull()
       .default([]),
+    recipientDepartmentIds: jsonb("recipient_department_ids")
+      .$type<string[]>()
+      .notNull()
+      .default([]),
+    includeChildDepartments: boolean("include_child_departments")
+      .notNull()
+      .default(false),
+    deliveryChannels: jsonb("delivery_channels")
+      .$type<ExternalNotificationChannel[]>()
+      .notNull()
+      .default([]),
     sourceKey: varchar("source_key", { length: 180 }),
+    revision: integer("revision").notNull().default(1),
     ...auditColumns,
   },
   (table) => [
@@ -42,6 +65,96 @@ export const platformNotifications = pgTable(
   ],
 );
 
+export const notificationPreferences = pgTable("notification_preferences", {
+  userId: varchar("user_id", { length: 64 })
+    .primaryKey()
+    .references(() => users.id, { onDelete: "restrict" }),
+  enabledChannels: jsonb("enabled_channels")
+    .$type<ExternalNotificationChannel[]>()
+    .notNull()
+    .default([]),
+  disabledCategories: jsonb("disabled_categories")
+    .$type<string[]>()
+    .notNull()
+    .default([]),
+  updatedAt: timestamp("updated_at", { withTimezone: true })
+    .notNull()
+    .defaultNow(),
+  updatedBy: varchar("updated_by", { length: 64 }).notNull(),
+});
+
+export const notificationDeliveryOutbox = pgTable(
+  "notification_delivery_outbox",
+  {
+    id: idColumn().primaryKey(),
+    notificationId: varchar("notification_id", { length: 64 })
+      .notNull()
+      .references(() => platformNotifications.id, { onDelete: "restrict" }),
+    userId: varchar("user_id", { length: 64 })
+      .notNull()
+      .references(() => users.id, { onDelete: "restrict" }),
+    channel: varchar("channel", { length: 16 })
+      .$type<ExternalNotificationChannel>()
+      .notNull(),
+    status: varchar("status", { length: 16 })
+      .$type<NotificationDeliveryStatus>()
+      .notNull(),
+    subject: varchar("subject", { length: 120 }).notNull(),
+    content: text("content").notNull(),
+    attemptCount: integer("attempt_count").notNull().default(0),
+    nextAttemptAt: timestamp("next_attempt_at", { withTimezone: true })
+      .notNull()
+      .defaultNow(),
+    leaseToken: varchar("lease_token", { length: 64 }),
+    leaseExpiresAt: timestamp("lease_expires_at", { withTimezone: true }),
+    deliveredAt: timestamp("delivered_at", { withTimezone: true }),
+    providerMessageId: varchar("provider_message_id", { length: 180 }),
+    lastErrorCode: varchar("last_error_code", { length: 64 }),
+    createdAt: timestamp("created_at", { withTimezone: true })
+      .notNull()
+      .defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true })
+      .notNull()
+      .defaultNow(),
+  },
+  (table) => [
+    uniqueIndex("uk_notification_delivery_target").on(
+      table.notificationId,
+      table.userId,
+      table.channel,
+    ),
+    index("idx_notification_delivery_claim").on(
+      table.status,
+      table.nextAttemptAt,
+      table.leaseExpiresAt,
+    ),
+    index("idx_notification_delivery_notification").on(table.notificationId),
+  ],
+);
+
+export const notificationRevisions = pgTable(
+  "notification_revisions",
+  {
+    notificationId: varchar("notification_id", { length: 64 })
+      .notNull()
+      .references(() => platformNotifications.id, { onDelete: "restrict" }),
+    revision: integer("revision").notNull(),
+    title: varchar("title", { length: 120 }).notNull(),
+    summary: varchar("summary", { length: 240 }).notNull(),
+    content: text("content").notNull(),
+    category: varchar("category", { length: 40 }).notNull(),
+    editedAt: timestamp("edited_at", { withTimezone: true }).notNull(),
+    editedBy: varchar("edited_by", { length: 64 }).notNull(),
+  },
+  (table) => [
+    primaryKey({ columns: [table.notificationId, table.revision] }),
+    index("idx_notification_revisions_time").on(
+      table.notificationId,
+      table.editedAt,
+    ),
+  ],
+);
+
 export const notificationReads = pgTable(
   "notification_reads",
   {
@@ -58,3 +171,25 @@ export const notificationReads = pgTable(
     index("idx_notification_reads_user").on(table.userId, table.readAt),
   ],
 );
+
+export const notificationFavorites = pgTable(
+  "notification_favorites",
+  {
+    notificationId: varchar("notification_id", { length: 64 })
+      .notNull()
+      .references(() => platformNotifications.id, { onDelete: "restrict" }),
+    userId: varchar("user_id", { length: 64 })
+      .notNull()
+      .references(() => users.id, { onDelete: "restrict" }),
+    favoritedAt: timestamp("favorited_at", { withTimezone: true })
+      .notNull()
+      .defaultNow(),
+  },
+  (table) => [
+    primaryKey({ columns: [table.notificationId, table.userId] }),
+    index("idx_notification_favorites_user").on(
+      table.userId,
+      table.favoritedAt,
+    ),
+  ],
+);

package/template/packages/database/src/schema-notification-delivery.test.ts

@@ -0,0 +1,54 @@
+import { describe, expect, test } from "bun:test";
+import { getTableConfig } from "drizzle-orm/pg-core";
+import {
+  notificationDeliveryOutbox,
+  notificationPreferences,
+  platformNotifications,
+} from "./schema/index.js";
+
+describe("通知策略与投递 schema", () => {
+  test("定时、多受众、偏好与 outbox 使用可迁移的 PostgreSQL 结构", async () => {
+    expect(platformNotifications.scheduledFor).toBeDefined();
+    expect(platformNotifications.recipientUserIds.notNull).toBe(true);
+    expect(platformNotifications.recipientDepartmentIds.notNull).toBe(true);
+    expect(platformNotifications.includeChildDepartments.notNull).toBe(true);
+    expect(platformNotifications.deliveryChannels.notNull).toBe(true);
+
+    expect(getTableConfig(notificationPreferences).name).toBe(
+      "notification_preferences",
+    );
+    expect(notificationPreferences.userId.primary).toBe(true);
+    expect(notificationPreferences.enabledChannels.notNull).toBe(true);
+    expect(notificationPreferences.disabledCategories.notNull).toBe(true);
+
+    const outbox = getTableConfig(notificationDeliveryOutbox);
+    expect(outbox.name).toBe("notification_delivery_outbox");
+    expect(
+      outbox.indexes.some(
+        ({ config }) => config.name === "uk_notification_delivery_target",
+      ),
+    ).toBe(true);
+    expect(
+      outbox.indexes.some(
+        ({ config }) => config.name === "idx_notification_delivery_claim",
+      ),
+    ).toBe(true);
+    expect(
+      outbox.foreignKeys.every(
+        (foreignKey) => foreignKey.onDelete === "restrict",
+      ),
+    ).toBe(true);
+
+    const migration = await Bun.file(
+      new URL("../drizzle/0038_uneven_wasp.sql", import.meta.url),
+    ).text();
+    expect(migration).toContain('CREATE TABLE "notification_preferences"');
+    expect(migration).toContain('CREATE TABLE "notification_delivery_outbox"');
+    expect(migration).toContain(
+      'ALTER TABLE "platform_notifications" ADD COLUMN "scheduled_for"',
+    );
+    expect(migration).toContain(
+      'CREATE INDEX "idx_notification_delivery_claim"',
+    );
+  });
+});

package/template/packages/database/src/schema-workflow-notification.test.ts

@@ -1,7 +1,9 @@
 import { describe, expect, test } from "bun:test";
 import { getTableConfig } from "drizzle-orm/pg-core";
 import {
+  notificationFavorites,
   notificationReads,
+  notificationRevisions,
   platformNotifications,
   workflowTransitions,
   workflowWorkItems,
@@ -30,7 +32,7 @@ describe("审批与通知 schema", () => {
     );
   });
 
-  test("站内通知持久化发布状态、受众、业务目标和用户已读回执", async () => {
+  test("站内通知持久化发布状态、受众、已读与独立收藏回执", async () => {
     expect(getTableConfig(platformNotifications).name).toBe(
       "platform_notifications",
     );
@@ -52,6 +54,21 @@ describe("审批与通知 schema", () => {
         (foreignKey) => foreignKey.onDelete === "restrict",
       ),
     ).toBe(true);
+    expect(getTableConfig(notificationFavorites).name).toBe(
+      "notification_favorites",
+    );
+    expect(getTableConfig(notificationFavorites).primaryKeys).toHaveLength(1);
+    expect(notificationFavorites.favoritedAt.notNull).toBe(true);
+    expect(
+      getTableConfig(notificationFavorites).foreignKeys.every(
+        (foreignKey) => foreignKey.onDelete === "restrict",
+      ),
+    ).toBe(true);
+    expect(getTableConfig(notificationRevisions).name).toBe(
+      "notification_revisions",
+    );
+    expect(getTableConfig(notificationRevisions).primaryKeys).toHaveLength(1);
+    expect(platformNotifications.revision.notNull).toBe(true);
     const migration = await Bun.file(
       new URL("../drizzle/0027_tiny_diamondback.sql", import.meta.url),
     ).text();
@@ -59,5 +76,27 @@ describe("审批与通知 schema", () => {
     expect(migration).toContain(
       'CREATE UNIQUE INDEX "uk_platform_notifications_source_key"',
     );
+    const favoritesMigration = await Bun.file(
+      new URL("../drizzle/0035_material_nightshade.sql", import.meta.url),
+    ).text();
+    expect(favoritesMigration).toContain(
+      'CREATE TABLE "notification_favorites"',
+    );
+    expect(favoritesMigration).toContain(
+      'PRIMARY KEY("notification_id","user_id")',
+    );
+    expect(favoritesMigration).toContain("ON DELETE restrict");
+    const revisionsMigration = await Bun.file(
+      new URL("../drizzle/0036_hesitant_speed.sql", import.meta.url),
+    ).text();
+    expect(revisionsMigration).toContain(
+      'CREATE TABLE "notification_revisions"',
+    );
+    expect(revisionsMigration).toContain(
+      'ALTER TABLE "platform_notifications" ADD COLUMN "revision"',
+    );
+    expect(revisionsMigration).toContain(
+      'INSERT INTO "notification_revisions"',
+    );
   });
 });

package/template/packages/modules/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/modules",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/modules/src/system-api-permissions.ts

@@ -61,6 +61,12 @@ export function systemApiPermissionBindings(): ApiPermissionBinding[] {
       "system.department.create",
       "system.rbac",
     ),
+    binding(
+      "POST",
+      "/api/system/departments/:id/transition",
+      "system.department.manage",
+      "system.rbac",
+    ),
     binding("GET", "/api/system/menus", "system.menu.read", "system.rbac"),
     binding(
       "GET",
@@ -226,12 +232,48 @@ export function systemApiPermissionBindings(): ApiPermissionBinding[] {
       "system.notification.read",
       "system.notification",
     ),
+    binding(
+      "GET",
+      "/api/notifications/preferences",
+      "system.notification.read",
+      "system.notification",
+    ),
+    binding(
+      "PUT",
+      "/api/notifications/preferences",
+      "system.notification.read",
+      "system.notification",
+    ),
     binding(
       "POST",
       "/api/notifications/:id/read",
       "system.notification.read",
       "system.notification",
     ),
+    binding(
+      "PUT",
+      "/api/notifications/:id/favorite",
+      "system.notification.read",
+      "system.notification",
+    ),
+    binding(
+      "DELETE",
+      "/api/notifications/:id/favorite",
+      "system.notification.read",
+      "system.notification",
+    ),
+    binding(
+      "GET",
+      "/api/system/notifications/audience-options",
+      "system.notification.manage",
+      "system.notification",
+    ),
+    binding(
+      "GET",
+      "/api/system/notifications/:id/deliveries",
+      "system.notification.manage",
+      "system.notification",
+    ),
     binding(
       "GET",
       "/api/system/notifications",
@@ -244,6 +286,18 @@ export function systemApiPermissionBindings(): ApiPermissionBinding[] {
       "system.notification.manage",
       "system.notification",
     ),
+    binding(
+      "PUT",
+      "/api/system/notifications/:id",
+      "system.notification.update",
+      "system.notification",
+    ),
+    binding(
+      "GET",
+      "/api/system/notifications/:id/revisions",
+      "system.notification.manage",
+      "system.notification",
+    ),
     binding(
       "DELETE",
       "/api/system/notifications/:id",

package/template/packages/modules/src/system-audit-actions.ts

@@ -22,9 +22,19 @@ export const systemAuditActions: ModuleManifest["auditActions"] = [
   // @windy-module system.license end
   "feature.update",
   "menu.structure.update",
+  {
+    key: "organization.department.transition",
+    label: "处置部门组织",
+    description: "迁移部门关联后停用或删除部门。",
+  },
   // @windy-module system.notification begin
   "notification.publish",
+  "notification.schedule",
+  "notification.preference.update",
+  "notification.update",
   "notification.read",
+  "notification.favorite",
+  "notification.unfavorite",
   "notification.archive",
   // @windy-module system.notification end
   // @windy-module system.workflow begin

package/template/packages/modules/src/system-features.ts

@@ -90,7 +90,7 @@ export const systemFeatures: ModuleManifest["features"] = [
   feature(
     "system.notification",
     "站内通知",
-    "站内通知发布、管理、阅读和已读状态闭环。",
+    "站内通知发布、修改历史、阅读、收藏和已读状态闭环。",
   ),
   // @windy-module system.notification end
   // @windy-module system.workflow begin

package/template/packages/modules/src/system-module-catalog.ts

@@ -124,7 +124,8 @@ export const systemModuleDefinitions = [
     name: "system.notification",
     version: "0.1.0",
     label: "站内通知",
-    description: "通知发布、阅读、归档与状态管理。",
+    description:
+      "通知定向与定时发布、用户偏好、外部渠道投递、修改历史、阅读、收藏和归档。",
     resources: ["notification"],
     featureKeys: ["system.notification"],
   },

package/template/packages/modules/src/system-modules.test.ts

@@ -220,7 +220,7 @@ describe("系统模块能力注册", () => {
     expect(catalogs).toEqual(["组织与权限", "平台配置", "安全与合规", "运维"]);
   });
 
-  test("部门快捷创建使用独立权限并绑定真实 API", () => {
+  test("部门创建与迁移处置绑定独立权限、Feature 和审计动作", () => {
     const manifest = systemFoundationModule();
     expect(
       manifest.permissions.some(
@@ -234,6 +234,18 @@ describe("系统模块能力注册", () => {
       featureKey: "system.rbac",
       anonymous: undefined,
     });
+    expect(manifest.apiPermissions).toContainEqual({
+      method: "POST",
+      path: "/api/system/departments/:id/transition",
+      permissionKey: "system.department.manage",
+      featureKey: "system.rbac",
+      anonymous: undefined,
+    });
+    expect(manifest.auditActions).toContainEqual(
+      expect.objectContaining({
+        key: "organization.department.transition",
+      }),
+    );
   });
 
   test("所有权限都由 Manifest 提供稳定中文分组元数据", () => {

package/template/packages/modules/src/system-modules.ts

@@ -270,6 +270,18 @@ export function systemFoundationModule(): ModuleManifest {
         retryDelaySeconds: 30,
       },
       // @windy-module system.scheduler end
+      // @windy-module system.notification begin
+      {
+        key: "system.notification.dispatch",
+        label: "通知发布与外部投递",
+        description: "发布到期通知并领取持久投递队列，执行渠道重试。",
+        permissionKey: "system.notification.manage",
+        featureKey: "system.notification",
+        intervalSeconds: 5,
+        maxAttempts: 3,
+        retryDelaySeconds: 30,
+      },
+      // @windy-module system.notification end
       // @windy-module system.bulk-data begin
       {
         key: "system.bulk-data.dispatch",

package/template/packages/modules/src/system-permissions.ts

@@ -33,6 +33,7 @@ type SystemAction =
   | "approve"
   | "export"
   | "reveal"
+  | "update"
   | "manage";
 
 function permission(
@@ -54,11 +55,13 @@ function permission(
             ? "新建"
             : action === "approve"
               ? "处理"
-              : action === "reveal"
-                ? "查看明文"
-                : action === "export"
-                  ? "治理导出"
-                  : "管理",
+              : action === "update"
+                ? "修改"
+                : action === "reveal"
+                  ? "查看明文"
+                  : action === "export"
+                    ? "治理导出"
+                    : "管理",
     module: "system",
     moduleLabel: "系统基础设施",
     resource,
@@ -125,6 +128,7 @@ export const systemPermissions: ModuleManifest["permissions"] = [
   // @windy-module system.scheduler end
   // @windy-module system.notification begin
   permission("notification", "read"),
+  permission("notification", "update"),
   permission("notification", "manage"),
   // @windy-module system.notification end
   // @windy-module system.bulk-data begin

package/template/packages/server-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/server-sdk",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/shared",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/shared/src/audit.ts

@@ -145,11 +145,36 @@ export const AUDIT_ACTION_DEFINITIONS = [
     label: "通知发布",
     description: "发布站内通知。",
   },
+  {
+    key: "notification.schedule",
+    label: "通知定时发布",
+    description: "创建等待调度器发布的通知。",
+  },
+  {
+    key: "notification.preference.update",
+    label: "通知偏好更新",
+    description: "用户更新外部通知渠道和分类偏好。",
+  },
+  {
+    key: "notification.update",
+    label: "通知修改",
+    description: "修改已发布通知并保留版本历史。",
+  },
   {
     key: "notification.read",
     label: "通知已读",
     description: "用户阅读站内通知。",
   },
+  {
+    key: "notification.favorite",
+    label: "收藏通知",
+    description: "用户收藏可见的站内通知。",
+  },
+  {
+    key: "notification.unfavorite",
+    label: "取消收藏通知",
+    description: "用户取消收藏可见的站内通知。",
+  },
   {
     key: "notification.archive",
     label: "通知归档",

package/template/packages/shared/src/module-configuration.ts

@@ -5,8 +5,11 @@ export type ModuleConfigApplyStatus =
   | "applying"
   | "effective"
   | "failed"
+  | "pending-restart"
   | "superseded";
 
+export type ModuleConfigApplyMode = "live" | "restart";
+
 export interface ModuleConfigDiffEntry {
   path: string;
   before?: ModuleConfigValue;
@@ -18,6 +21,7 @@ export interface ModuleConfigFieldDescriptor {
   label: string;
   description: string;
   input: "boolean" | "integer" | "text";
+  applyMode?: ModuleConfigApplyMode;
   minimum?: number;
   maximum?: number;
 }
@@ -42,6 +46,7 @@ export interface ModuleConfigSummary {
   label: string;
   fields: ModuleConfigFieldDescriptor[];
   effectiveValues: ModuleConfigValues;
+  pendingValues?: ModuleConfigValues;
   effectiveSource: "environment" | "version";
   effectiveVersion?: number;
   latestVersion?: number;