@gadmin2n/schematics 0.0.72 → 0.0.74

package/dist/lib/application/files/gadmin2-game-angle-demo/temporal/worker/src/dsl/node-types.ts

@@ -0,0 +1,57 @@
+/**
+ * Canonical list of all workflow node types.
+ *
+ * This is the SINGLE SOURCE OF TRUTH for node type strings.
+ * When you add a new type here, TypeScript will force you to handle it
+ * in the executeNode() switch — otherwise the build fails.
+ */
+export const ALL_NODE_TYPES = [
+  // TRIGGER
+  'cron_trigger',
+  'webhook_trigger',
+  'event_trigger',
+  'manual_trigger',
+  // ACTION (calls an activity)
+  'http_request',
+  'db_query',
+  'db_execute',
+  'send_notification',
+  'code',
+  // DATA PROCESSING (inline logic)
+  'set_variable',
+  // CONDITION (inline logic)
+  'if_else',
+  'switch',
+  // FLOW CONTROL
+  'for_each',
+  'delay',
+  'parallel',
+  'error_handler',
+  // APPROVAL (Temporal signal)
+  'approval',
+  // SUB WORKFLOW
+  'sub_workflow',
+] as const;
+
+/** Union of all supported node type strings. */
+export type NodeType = (typeof ALL_NODE_TYPES)[number];
+
+/** Node types that require a Temporal activity call. */
+export const ACTIVITY_NODE_TYPES = [
+  'http_request',
+  'db_query',
+  'db_execute',
+  'send_notification',
+  'code',
+] as const satisfies readonly NodeType[];
+
+export type ActivityNodeType = (typeof ACTIVITY_NODE_TYPES)[number];
+
+/**
+ * Compile-time exhaustiveness check.
+ * Place in the `default` of a switch over NodeType — if a case is missing,
+ * TypeScript emits: "Argument of type 'X' is not assignable to parameter of type 'never'."
+ */
+export function assertNever(x: never): never {
+  throw new Error(`Unhandled node type: ${x}`);
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/temporal/worker/src/dsl/types.ts

@@ -0,0 +1,77 @@
+// ─── DSL Types (mirrors frontend WorkflowDSL) ─────────────────────────────────
+
+import type { NodeType } from './node-types';
+
+export interface DslNode {
+  id: string;
+  type: NodeType;
+  label: string;
+  position: { x: number; y: number };
+  config: Record<string, any>;
+}
+
+export interface DslEdge {
+  id: string;
+  source: string;
+  target: string;
+  sourceHandle?: string; // for condition branches: "true"/"false" or case labels
+  label?: string;
+}
+
+export interface WorkflowDSL {
+  nodes: DslNode[];
+  edges: DslEdge[];
+}
+
+// ─── Workflow Execution Types ──────────────────────────────────────────────────
+
+export interface WorkflowInput {
+  instanceId: number;
+  workflowId: number;
+  versionId: number;
+  dsl: WorkflowDSL;
+  context: Record<string, any>;
+}
+
+export interface WorkflowResult {
+  status: 'COMPLETED' | 'FAILED' | 'CANCELLED';
+  context: Record<string, any>;
+  error?: string;
+}
+
+// ─── Node Execution Context ───────────────────────────────────────────────────
+
+export interface NodeExecutionResult {
+  output: Record<string, any>;
+  branch?: string; // For condition nodes: which branch to take
+}
+
+export type NodeStatus = 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
+
+// ─── Activity Input Types ─────────────────────────────────────────────────────
+
+export interface ReportNodeStatusInput {
+  instanceId: number;
+  nodeId: string;
+  nodeType: string;
+  nodeLabel?: string;
+  status: NodeStatus;
+  input?: Record<string, any>;
+  output?: Record<string, any>;
+  error?: Record<string, any>;
+}
+
+export interface ReportWorkflowStatusInput {
+  instanceId: number;
+  status: 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
+  result?: Record<string, any>;
+}
+
+// ─── Signals ──────────────────────────────────────────────────────────────────
+
+export interface ApprovalSignalPayload {
+  nodeId: string;
+  approved: boolean;
+  comment?: string;
+  approvedBy: string;
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/temporal/worker/src/index.ts

@@ -0,0 +1,36 @@
+import { NativeConnection, Worker } from '@temporalio/worker';
+import * as activities from './activities';
+import { config } from './config';
+import { startOutboxPoller } from './outbox-poller';
+
+async function run() {
+  console.log(`[Worker] Connecting to Temporal at ${config.temporal.address}...`);
+
+  const connection = await NativeConnection.connect({
+    address: config.temporal.address,
+  });
+
+  const worker = await Worker.create({
+    connection,
+    namespace: config.temporal.namespace,
+    taskQueue: config.temporal.taskQueue,
+    workflowsPath: require.resolve('./workflows/dsl-workflow'),
+    activities,
+  });
+
+  console.log(`[Worker] Started. Polling task queue: ${config.temporal.taskQueue}`);
+  console.log(`[Worker] Namespace: ${config.temporal.namespace}`);
+
+  // Start outbox poller for event_trigger workflows
+  startOutboxPoller().catch((err) => {
+    console.error('[OutboxPoller] Failed to start:', err.message);
+  });
+
+  // Start polling for workflow tasks
+  await worker.run();
+}
+
+run().catch((err) => {
+  console.error('[Worker] Fatal error:', err);
+  process.exit(1);
+});

package/dist/lib/application/files/gadmin2-game-angle-demo/temporal/worker/src/outbox-poller.ts

@@ -0,0 +1,226 @@
+import { Client as PgClient } from "pg";
+import { Client, Connection } from "@temporalio/client";
+import { config } from "./config";
+
+const POLL_INTERVAL = Number(process.env.EVENT_POLL_INTERVAL_MS) || 10_000; // 默认 10 秒
+const BATCH_SIZE = 50;
+const MAX_RETRIES = Number(process.env.OUTBOX_MAX_RETRIES) || 5;
+
+/**
+ * Outbox Poller — 定时扫描 t_workflow_event_outbox 未处理事件，匹配并触发 workflow。
+ *
+ * 工作原理：
+ * 1. 业务表的 AFTER 触发器写入 outbox 行（同一事务，保证不丢）
+ * 2. 本轮询器每 N 秒扫描未处理行
+ * 3. 匹配 event_trigger workflow → 启动 Temporal 执行
+ * 4. 标记行为已处理
+ */
+export async function startOutboxPoller() {
+  const pg = new PgClient({ connectionString: config.database.url });
+  await pg.connect();
+
+  const temporalConn = await Connection.connect({
+    address: config.temporal.address,
+  });
+  const temporalClient = new Client({
+    connection: temporalConn,
+    namespace: config.temporal.namespace,
+  });
+
+  console.log(`[OutboxPoller] Started. Polling every ${POLL_INTERVAL}ms, max retries: ${MAX_RETRIES}`);
+
+  const poll = async () => {
+    try {
+      // 用 FOR UPDATE SKIP LOCKED 保证多实例不重复消费
+      const { rows } = await pg.query(
+        `UPDATE t_workflow_event_outbox
+        SET processed = TRUE, processed_at = NOW()
+        WHERE id IN (
+          SELECT id FROM t_workflow_event_outbox
+            WHERE processed = FALSE
+            ORDER BY created_at
+            LIMIT $1
+            FOR UPDATE SKIP LOCKED
+        )
+        RETURNING id, event_name, payload, retry_count`,
+        [BATCH_SIZE],
+      );
+
+      if (rows.length === 0) return;
+      console.log(`[OutboxPoller] Processing ${rows.length} events`);
+
+      for (const row of rows) {
+        try {
+          const matched = await matchAndTrigger(
+            pg,
+            temporalClient,
+            row.event_name,
+            row.payload,
+          );
+          if (matched === 0) {
+            console.warn(
+              `[OutboxPoller] No workflow matched event "${row.event_name}" (id=${row.id}). Event consumed without action.`,
+            );
+          }
+        } catch (err: any) {
+          const nextRetry = (row.retry_count ?? 0) + 1;
+          const errMsg = String(err?.message ?? err);
+          if (nextRetry >= MAX_RETRIES) {
+            // 终态失败：保持 processed=true，仅记录 retry_count + last_error，不再重试
+            console.error(
+              `[OutboxPoller] Event ${row.id} (${row.event_name}) failed ${nextRetry} times. Marking as terminal failure: ${errMsg}`,
+            );
+            await pg.query(
+              `UPDATE t_workflow_event_outbox
+                SET retry_count = $1, last_error = $2
+                WHERE id = $3`,
+              [nextRetry, errMsg, row.id],
+            );
+          } else {
+            console.error(
+              `[OutboxPoller] Event ${row.id} (${row.event_name}) failed (retry ${nextRetry}/${MAX_RETRIES}): ${errMsg}`,
+            );
+            // 标记回未处理，下次重试
+            await pg.query(
+              `UPDATE t_workflow_event_outbox
+                SET processed = FALSE, processed_at = NULL, retry_count = $1, last_error = $2
+                WHERE id = $3`,
+              [nextRetry, errMsg, row.id],
+            );
+          }
+        }
+      }
+    } catch (err: any) {
+      console.error("[OutboxPoller] Poll error:", err.message);
+    }
+  };
+
+  // 自调度循环：每次 poll 完成后再排下一次，避免 setInterval 在 poll 慢于 POLL_INTERVAL 时重叠调用
+  const loop = async () => {
+    try {
+      await poll();
+    } finally {
+      setTimeout(loop, POLL_INTERVAL);
+    }
+  };
+  loop();
+}
+
+/**
+ * 查找监听该 eventName 的 workflow 并启动执行。
+ *
+ * @returns 实际匹配并启动的 workflow 数量；0 表示无人订阅。
+ */
+async function matchAndTrigger(
+  pg: PgClient,
+  temporalClient: Client,
+  eventName: string,
+  payload: Record<string, any>,
+): Promise<number> {
+  // 查询所有已发布且启用的 workflow 的最新版本 DSL
+  const result = await pg.query(`
+    SELECT w.id AS workflow_id, wv.id AS version_id, wv.dsl
+    FROM t_workflow w
+    JOIN t_workflow_version wv ON wv.workflow_id = w.id
+    WHERE w.status = 'PUBLISHED'
+      AND w.is_enabled = true
+      AND wv.version = (
+        SELECT MAX(wv2.version)
+        FROM t_workflow_version wv2
+        WHERE wv2.workflow_id = w.id
+      )
+  `);
+
+  let matchedCount = 0;
+
+  for (const row of result.rows) {
+    const dsl = row.dsl;
+    if (!dsl?.nodes) continue;
+
+    // 找 event_trigger 节点且 eventName 匹配
+    const trigger = dsl.nodes.find(
+      (n: any) =>
+        n.type === "event_trigger" &&
+        matchEventName(n.config?.eventName, eventName),
+    );
+    if (!trigger) continue;
+
+    // 可选: filterExpression 过滤
+    if (trigger.config?.filterExpression) {
+      if (!evaluateFilter(trigger.config.filterExpression, payload)) continue;
+    }
+
+    // 创建 WorkflowInstance
+    const instance = await pg.query(
+      `INSERT INTO t_workflow_instance (workflow_id, version_id, status, context, creator, created_at, updated_at)
+       VALUES ($1, $2, 'PENDING', $3, 'event_trigger', NOW(), NOW())
+       RETURNING id`,
+      [row.workflow_id, row.version_id, JSON.stringify(payload)],
+    );
+    const instanceId = Number(instance.rows[0].id);
+
+    // 启动 Temporal workflow
+    const workflowId = `wf-${row.workflow_id}-${instanceId}`;
+    const handle = await temporalClient.workflow.start("dslWorkflow", {
+      taskQueue: config.temporal.taskQueue,
+      workflowId,
+      args: [
+        {
+          instanceId,
+          workflowId: Number(row.workflow_id),
+          versionId: Number(row.version_id),
+          dsl,
+          context: payload,
+        },
+      ],
+    });
+
+    // 回写 temporal_run_id
+    await pg.query(
+      `UPDATE t_workflow_instance SET temporal_run_id = $1 WHERE id = $2`,
+      [handle.workflowId, instanceId],
+    );
+
+    console.log(
+      `[OutboxPoller] Triggered workflow ${row.workflow_id} for event "${eventName}", instance=${instanceId}`,
+    );
+    matchedCount++;
+  }
+
+  return matchedCount;
+}
+
+/**
+ * 匹配事件名，支持通配符：
+ * - "t_order.insert" 精确匹配
+ * - "t_order.*" 匹配该表所有操作
+ * - "*.insert" 匹配所有表的 insert
+ */
+function matchEventName(pattern: string | undefined, actual: string): boolean {
+  if (!pattern) return false;
+  if (pattern === actual) return true;
+  if (pattern === "*") return true;
+
+  const [patTable, patOp] = pattern.split(".");
+  const [actTable, actOp] = actual.split(".");
+
+  const tableMatch = patTable === "*" || patTable === actTable;
+  const opMatch = !patOp || patOp === "*" || patOp === actOp;
+
+  return tableMatch && opMatch;
+}
+
+/**
+ * 简单的 filter 表达式求值。
+ */
+function evaluateFilter(
+  expression: string,
+  payload: Record<string, any>,
+): boolean {
+  try {
+    const fn = new Function("data", `return ${expression}`);
+    return !!fn(payload);
+  } catch {
+    return true;
+  }
+}