qgraphflow 0.0.6 → 0.0.7

package/examples/jeepay/README.md

@@ -0,0 +1,23 @@
+# Jeepay source corpus
+
+The only business dataset used by CI, Pages and package smoke tests is the public [Jeepay repository](https://github.com/jeequan/jeepay). `source.json` records the exact revision and SHA-256 of every referenced source file. No Java source, credentials or developer machine paths are distributed here.
+
+The collection contains eleven views: platform capabilities, engineering layers, component relationships, unified-order flowchart and sequence, payment ER, Compose deployment, payment classes, order states, API use cases and unified-order data flow. All inputs contain facts and source anchors; generated coordinates and routing snapshots are deliberately excluded.
+
+CI checks out the revision declared in `source.json`, verifies every node source and relationship site, and computes fresh layouts. Assertions cover preserved facts, valid notation and geometry, export, saving, cancellation and selected-view isolation. They do not lock a particular diagram's dimensions, node count, crossing count, candidate count or solver strategy.
+
+For local checks, select the source explicitly:
+
+```bash
+export JEEPAY_REPO_ROOT="<local Jeepay repository root>"
+node --test tests/*.test.mjs skills/q-flow/scripts/*.test.mjs
+node skills/q-flow/scripts/generate-viewer.mjs examples/jeepay/collection.graph.json output/jeepay --repo-root "$JEEPAY_REPO_ROOT"
+```
+
+To refresh the corpus after reviewing updated Jeepay source and updating its eleven diagrams under `docs/qgraphflow/`, run:
+
+```bash
+node scripts/refresh-jeepay-fixtures.mjs "$JEEPAY_REPO_ROOT"
+```
+
+Review the changed facts, evidence and `source.json` together. No saved geometry baseline needs replacing. Schema tests may mutate a copy of a Jeepay graph to exercise invalid input; those mutations are never presented as repository facts. Pure geometry, text, notation and localization unit parameters are separate from the business corpus.

package/examples/jeepay/capabilities.graph.json

@@ -0,0 +1,270 @@
+{
+  "meta": {
+    "title": "Jeepay 平台能力架构",
+    "subtitle": "Jeepay 源码与配置证据",
+    "sourceRef": "jeequan/jeepay@e1ac9086d679826bab593f20431b7ecd292eb685",
+    "scope": "项目核心支付能力",
+    "diagramType": "architecture",
+    "locale": "zh-CN",
+    "notes": [
+      "能力卡片以源码中的控制器和服务为准；退款、转账和分账是独立入口。",
+      "本图呈现能力与关键支撑，不代表所有能力均在同一请求链路中。"
+    ],
+    "architectureView": "capabilities",
+    "viewId": "jeepay-capabilities"
+  },
+  "nodes": [
+    {
+      "id": "unified",
+      "label": "UnifiedOrderController",
+      "kind": "business",
+      "module": "payment",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/UnifiedOrderController.java",
+        "lineStart": 44,
+        "lineEnd": 44,
+        "kind": "source"
+      },
+      "subtitle": "统一下单入口",
+      "tags": [
+        "core"
+      ],
+      "overviewText": [
+        "校验商户签名后选择支付方式，生成支付订单。"
+      ]
+    },
+    {
+      "id": "refund",
+      "label": "RefundOrderController",
+      "kind": "business",
+      "module": "refund",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/refund/RefundOrderController.java",
+        "lineStart": 57,
+        "lineEnd": 57,
+        "kind": "source"
+      },
+      "subtitle": "退款订单入口",
+      "overviewText": [
+        "面向已支付订单发起渠道退款。"
+      ]
+    },
+    {
+      "id": "transfer",
+      "label": "TransferOrderController",
+      "kind": "business",
+      "module": "transfer",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/transfer/TransferOrderController.java",
+        "lineStart": 55,
+        "lineEnd": 55,
+        "kind": "source"
+      },
+      "subtitle": "转账订单入口",
+      "overviewText": [
+        "向渠道发起转账。"
+      ]
+    },
+    {
+      "id": "division",
+      "label": "PayOrderDivisionExecController",
+      "kind": "business",
+      "module": "division",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/division/PayOrderDivisionExecController.java",
+        "lineStart": 57,
+        "lineEnd": 57,
+        "kind": "source"
+      },
+      "subtitle": "分账执行入口",
+      "overviewText": [
+        "按商户请求执行支付订单分账。"
+      ]
+    },
+    {
+      "id": "process",
+      "label": "PayOrderProcessService",
+      "kind": "component",
+      "module": "payment",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/service/PayOrderProcessService.java",
+        "lineStart": 40,
+        "lineEnd": 40,
+        "kind": "source"
+      },
+      "subtitle": "支付成功后的订单处理",
+      "overviewText": [
+        "确认支付成功后处理订单业务。"
+      ]
+    },
+    {
+      "id": "notify",
+      "label": "PayMchNotifyService",
+      "kind": "component",
+      "module": "notification",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/service/PayMchNotifyService.java",
+        "lineStart": 45,
+        "lineEnd": 45,
+        "kind": "source"
+      },
+      "subtitle": "保存并推送商户通知",
+      "overviewText": [
+        "保存通知记录并推送消息。"
+      ]
+    },
+    {
+      "id": "channel",
+      "label": "IPaymentService",
+      "kind": "component",
+      "module": "channel",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/IPaymentService.java",
+        "lineStart": 30,
+        "lineEnd": 30,
+        "kind": "source"
+      },
+      "subtitle": "渠道支付接口契约",
+      "overviewText": [
+        "定义渠道支付检查与支付调用。"
+      ]
+    },
+    {
+      "id": "orderdb",
+      "label": "PayOrderService",
+      "kind": "data",
+      "module": "payment",
+      "source": {
+        "file": "jeepay-service/src/main/java/com/jeequan/jeepay/service/impl/PayOrderService.java",
+        "lineStart": 49,
+        "lineEnd": 49,
+        "kind": "source"
+      },
+      "subtitle": "支付订单持久化与条件更新",
+      "overviewText": [
+        "持久化并按原状态条件更新订单。"
+      ]
+    }
+  ],
+  "edges": [
+    {
+      "id": "c1",
+      "source": "unified",
+      "target": "channel",
+      "kind": "call",
+      "label": "调起渠道支付",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/AbstractPayOrderController.java",
+        "lineStart": 205,
+        "lineEnd": 205
+      }
+    },
+    {
+      "id": "c2",
+      "source": "unified",
+      "target": "orderdb",
+      "kind": "data",
+      "label": "保存支付订单",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/AbstractPayOrderController.java",
+        "lineStart": 201,
+        "lineEnd": 201
+      }
+    },
+    {
+      "id": "c3",
+      "source": "unified",
+      "target": "process",
+      "kind": "call",
+      "label": "处理支付结果",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/AbstractPayOrderController.java",
+        "lineStart": 383,
+        "lineEnd": 383
+      }
+    },
+    {
+      "id": "c4",
+      "source": "process",
+      "target": "notify",
+      "kind": "call",
+      "label": "通知商户",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/service/PayOrderProcessService.java",
+        "lineStart": 60,
+        "lineEnd": 60
+      }
+    },
+    {
+      "id": "c5",
+      "source": "process",
+      "target": "orderdb",
+      "kind": "data",
+      "label": "查询订单",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/service/PayOrderProcessService.java",
+        "lineStart": 51,
+        "lineEnd": 51
+      }
+    }
+  ],
+  "layout": {
+    "sections": [
+      {
+        "id": "entry",
+        "title": "业务能力入口",
+        "mode": "grid",
+        "columns": 4,
+        "tone": "blue",
+        "items": [
+          {
+            "nodeId": "unified"
+          },
+          {
+            "nodeId": "refund"
+          },
+          {
+            "nodeId": "transfer"
+          },
+          {
+            "nodeId": "division"
+          }
+        ]
+      },
+      {
+        "id": "core",
+        "title": "支付处理",
+        "mode": "row",
+        "tone": "green",
+        "items": [
+          {
+            "nodeId": "channel"
+          },
+          {
+            "nodeId": "process"
+          }
+        ]
+      },
+      {
+        "id": "support",
+        "title": "订单与通知支撑",
+        "mode": "row",
+        "tone": "subtle",
+        "items": [
+          {
+            "nodeId": "orderdb"
+          },
+          {
+            "nodeId": "notify"
+          }
+        ]
+      }
+    ],
+    "direction": "down"
+  }
+}

package/examples/jeepay/class.graph.json

@@ -0,0 +1,237 @@
+{
+  "meta": {
+    "title": "Jeepay 统一支付类图",
+    "subtitle": "Jeepay 源码与配置证据",
+    "sourceRef": "jeequan/jeepay@e1ac9086d679826bab593f20431b7ecd292eb685",
+    "scope": "控制器与渠道支付接口",
+    "diagramType": "class",
+    "locale": "zh-CN",
+    "notes": [
+      "类成员仅展示与统一下单有关的源码声明；省略其他方法。",
+      "IPaymentService 实现由通道模块扩展，图中以支付宝和微信实现为例。"
+    ],
+    "viewId": "jeepay-class"
+  },
+  "nodes": [
+    {
+      "id": "api",
+      "label": "ApiController",
+      "kind": "abstract",
+      "module": "payment",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/ApiController.java",
+        "lineStart": 39,
+        "lineEnd": 39,
+        "kind": "source"
+      },
+      "methods": [
+        "#getRQByWithMchSign(Class<T>): T"
+      ]
+    },
+    {
+      "id": "base",
+      "label": "AbstractPayOrderController",
+      "kind": "abstract",
+      "module": "payment",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/AbstractPayOrderController.java",
+        "lineStart": 64,
+        "lineEnd": 64,
+        "kind": "source"
+      },
+      "methods": [
+        "#unifiedOrder(String, UnifiedOrderRQ): ApiRes",
+        "-processChannelMsg(ChannelRetMsg, PayOrder): void"
+      ]
+    },
+    {
+      "id": "unified",
+      "label": "UnifiedOrderController",
+      "kind": "class",
+      "module": "payment",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/UnifiedOrderController.java",
+        "lineStart": 44,
+        "lineEnd": 44,
+        "kind": "source"
+      },
+      "methods": [
+        "+unifiedOrder(): ApiRes"
+      ]
+    },
+    {
+      "id": "iface",
+      "label": "IPaymentService",
+      "kind": "interface",
+      "module": "channel",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/IPaymentService.java",
+        "lineStart": 30,
+        "lineEnd": 30,
+        "kind": "source"
+      },
+      "methods": [
+        "+getIfCode(): String",
+        "+preCheck(UnifiedOrderRQ, PayOrder): String",
+        "+pay(UnifiedOrderRQ, PayOrder, MchAppConfigContext): AbstractRS"
+      ]
+    },
+    {
+      "id": "abstractPayment",
+      "label": "AbstractPaymentService",
+      "kind": "abstract",
+      "module": "channel",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/AbstractPaymentService.java",
+        "lineStart": 35,
+        "lineEnd": 35,
+        "kind": "source"
+      },
+      "methods": [
+        "+customPayOrderId(UnifiedOrderRQ, PayOrder, MchAppConfigContext): String"
+      ]
+    },
+    {
+      "id": "alipay",
+      "label": "AlipayPaymentService",
+      "kind": "class",
+      "module": "channel",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/alipay/AlipayPaymentService.java",
+        "lineStart": 36,
+        "lineEnd": 36,
+        "kind": "source"
+      },
+      "methods": [
+        "+pay(UnifiedOrderRQ, PayOrder, MchAppConfigContext): AbstractRS"
+      ]
+    },
+    {
+      "id": "wxpay",
+      "label": "WxpayPaymentService",
+      "kind": "class",
+      "module": "channel",
+      "source": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/wxpay/WxpayPaymentService.java",
+        "lineStart": 46,
+        "lineEnd": 46,
+        "kind": "source"
+      },
+      "methods": [
+        "+pay(UnifiedOrderRQ, PayOrder, MchAppConfigContext): AbstractRS"
+      ]
+    },
+    {
+      "id": "orders",
+      "label": "PayOrderService",
+      "kind": "class",
+      "module": "payment",
+      "source": {
+        "file": "jeepay-service/src/main/java/com/jeequan/jeepay/service/impl/PayOrderService.java",
+        "lineStart": 49,
+        "lineEnd": 49,
+        "kind": "source"
+      },
+      "methods": [
+        "+updateInit2Ing(String, PayOrder): boolean",
+        "+updateIng2Success(String, String, String): boolean"
+      ]
+    }
+  ],
+  "edges": [
+    {
+      "id": "cl1",
+      "source": "unified",
+      "target": "base",
+      "kind": "inheritance",
+      "label": "extends",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/UnifiedOrderController.java",
+        "lineStart": 44,
+        "lineEnd": 44
+      }
+    },
+    {
+      "id": "cl2",
+      "source": "base",
+      "target": "api",
+      "kind": "inheritance",
+      "label": "extends",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/AbstractPayOrderController.java",
+        "lineStart": 64,
+        "lineEnd": 64
+      }
+    },
+    {
+      "id": "cl3",
+      "source": "abstractPayment",
+      "target": "iface",
+      "kind": "implementation",
+      "label": "implements",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/AbstractPaymentService.java",
+        "lineStart": 35,
+        "lineEnd": 35
+      }
+    },
+    {
+      "id": "cl4",
+      "source": "alipay",
+      "target": "abstractPayment",
+      "kind": "inheritance",
+      "label": "extends",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/alipay/AlipayPaymentService.java",
+        "lineStart": 36,
+        "lineEnd": 36
+      }
+    },
+    {
+      "id": "cl5",
+      "source": "wxpay",
+      "target": "abstractPayment",
+      "kind": "inheritance",
+      "label": "extends",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/channel/wxpay/WxpayPaymentService.java",
+        "lineStart": 46,
+        "lineEnd": 46
+      }
+    },
+    {
+      "id": "cl6",
+      "source": "base",
+      "target": "iface",
+      "kind": "dependency",
+      "label": "调用渠道接口",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/AbstractPayOrderController.java",
+        "lineStart": 205,
+        "lineEnd": 205
+      }
+    },
+    {
+      "id": "cl7",
+      "source": "base",
+      "target": "orders",
+      "kind": "association",
+      "label": "持有 PayOrderService",
+      "evidence": "source",
+      "site": {
+        "file": "jeepay-payment/src/main/java/com/jeequan/jeepay/pay/ctrl/payorder/AbstractPayOrderController.java",
+        "lineStart": 67,
+        "lineEnd": 67
+      }
+    }
+  ],
+  "layout": {
+    "direction": "down"
+  }
+}