@guanlin4924/devflow-pi 0.1.40 → 0.1.47

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_model_render.py

@@ -0,0 +1,131 @@
+#!/usr/bin/env python3
+"""Render a deterministic, human-readable business model view."""
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+from typing import Any
+
+
+def text(value: Any) -> str:
+    return str(value if value is not None else "")
+
+
+def md(value: Any) -> str:
+    return text(value).replace("|", "\\|").replace("\r", "").replace("\n", "<br>")
+
+
+def mermaid(value: Any) -> str:
+    return text(value).replace('"', "&quot;").replace("[", "&#91;").replace("]", "&#93;").replace("\r", "").replace("\n", " ")
+
+
+def cell_list(values: Any) -> str:
+    return ", ".join(md(item) for item in values) if isinstance(values, list) else md(values)
+
+
+def action_map(model: dict[str, Any]) -> dict[str, dict[str, Any]]:
+    return {text(item.get("id")): item for item in model.get("actions", []) if isinstance(item, dict)}
+
+
+def render_flow(model: dict[str, Any]) -> list[str]:
+    actions = action_map(model)
+    lines = ["```mermaid", "flowchart LR"]
+    for action_id, action in actions.items():
+        lines.append(f'  {action_id.replace("-", "_")}["{mermaid(action.get("name", action_id))}"]')
+    for action_id, action in actions.items():
+        routing = action.get("routing") if isinstance(action.get("routing"), dict) else {}
+        for target in routing.get("next_action_refs", []) or []:
+            if text(target) in actions:
+                lines.append(f'  {action_id.replace("-", "_")} -->|next| {text(target).replace("-", "_")}')
+        decision = routing.get("decision_rule_ref")
+        if decision:
+            lines.append(f'  {action_id.replace("-", "_")} -. decision .-> {text(decision).replace("-", "_")}')
+    for rule in model.get("rules", []):
+        if isinstance(rule, dict):
+            lines.append(f'  {text(rule.get("id")).replace("-", "_")}{{"{mermaid(rule.get("name", rule.get("id")))}"}}')
+    lines.append("```")
+    return lines
+
+
+def render(model: dict[str, Any]) -> str:
+    actors = {text(item.get("id")): item for item in model.get("actors", []) if isinstance(item, dict)}
+    actions = action_map(model)
+    entities = {text(item.get("id")): item for item in model.get("entities", []) if isinstance(item, dict)}
+    resources = {text(item.get("id")): item for item in model.get("resources", []) if isinstance(item, dict)}
+    lines = [f"# 业务模型视图：{md(model.get('feature'))}", "", "> 本文件由 canonical.json 确定性生成，仅供阅读和评审；不是事实源。", ""]
+    lines += ["## 业务流程", ""] + render_flow(model) + [""]
+
+    lines += ["## Actor × Action 覆盖矩阵", "", "| Actor | Action | Owner | Requirement |", "|---|---|---|---|"]
+    for action in model.get("actions", []):
+        if not isinstance(action, dict):
+            continue
+        actor = actors.get(text(action.get("actor_ref")), {})
+        lines.append(f"| {md(actor.get('name', action.get('actor_ref')))} | {md(action.get('name', action.get('id')))} | {md(action.get('owner_ref'))} | {cell_list(action.get('requirement_refs', []))} |")
+    lines.append("")
+
+    lines += ["## 状态迁移", "", "| Entity | From | Action | To |", "|---|---|---|---|"]
+    for action in model.get("actions", []):
+        if not isinstance(action, dict) or not action.get("from_state_ref"):
+            continue
+        entity = entities.get(text(action.get("entity_ref")), {})
+        states = {text(item.get("id")): item for item in entity.get("states", []) if isinstance(item, dict)}
+        lines.append(f"| {md(entity.get('name', action.get('entity_ref')))} | {md(states.get(text(action.get('from_state_ref')), {}).get('name', action.get('from_state_ref')))} | {md(action.get('name', action.get('id')))} | {md(states.get(text(action.get('to_state_ref')), {}).get('name', action.get('to_state_ref')))} |")
+    lines.append("")
+
+    lines += ["## 决策表", "", "| Rule | Branch | Default | Next action |", "|---|---|---|---|"]
+    for rule in model.get("rules", []):
+        if not isinstance(rule, dict):
+            continue
+        for branch in rule.get("branches", []) or []:
+            if not isinstance(branch, dict):
+                continue
+            lines.append(f"| {md(rule.get('name', rule.get('id')))} | {md(branch.get('id'))} | {md(branch.get('default', False))} | {cell_list(branch.get('next_action_refs', []))} |")
+    lines.append("")
+
+    lines += ["## Resource producer / consumer", "", "| Resource | Origin | Producers | Consumers | Boundary |", "|---|---|---|---|---|"]
+    for resource_id, resource in resources.items():
+        producers = [text(a.get("id")) for a in actions.values() if resource_id in (a.get("produces") or [])]
+        consumers = [text(a.get("id")) for a in actions.values() if resource_id in (a.get("consumes") or [])]
+        origin = resource.get("origin") if isinstance(resource.get("origin"), dict) else {}
+        lines.append(f"| {md(resource.get('name', resource_id))} | {md(origin.get('kind'))} | {cell_list(producers)} | {cell_list(consumers)} | {md(origin.get('boundary_ref'))} |")
+    lines.append("")
+
+    lines += ["## Swimlane projection", "", "| Owner | Action | Trigger | Next |", "|---|---|---|---|"]
+    for action in model.get("actions", []):
+        if isinstance(action, dict):
+            routing = action.get("routing") if isinstance(action.get("routing"), dict) else {}
+            next_actions = routing.get("next_action_refs", []) or []
+            lines.append(f"| {md(action.get('owner_ref'))} | {md(action.get('name', action.get('id')))} | {md(action.get('trigger'))} | {cell_list(next_actions)} |")
+    lines.append("")
+
+    lines += ["## Data flow", "", "| Action | Consumes | Produces |", "|---|---|---|"]
+    for action in model.get("actions", []):
+        if isinstance(action, dict):
+            lines.append(f"| {md(action.get('name', action.get('id')))} | {cell_list(action.get('consumes', []))} | {cell_list(action.get('produces', []))} |")
+    lines.append("")
+
+    assumptions = model.get("assumptions", []) or []
+    lines += ["## Assumptions", "", "| ID | Statement | Status |", "|---|---|---|"]
+    for item in assumptions:
+        if isinstance(item, dict):
+            lines.append(f"| {md(item.get('id'))} | {md(item.get('statement'))} | {md(item.get('status'))} |")
+    lines.append("")
+    lines += ["## Requirement refs", "", ", ".join(f"`{md(item)}`" for item in model.get("requirement_refs", [])), ""]
+    return "\n".join(lines)
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--canonical", type=Path, required=True)
+    parser.add_argument("--output", type=Path, required=True)
+    args = parser.parse_args()
+    model = json.loads(args.canonical.read_text(encoding="utf-8"))
+    args.output.parent.mkdir(parents=True, exist_ok=True)
+    args.output.write_text(render(model), encoding="utf-8")
+    print(json.dumps({"ok": True, "path": str(args.output), "bytes": args.output.stat().st_size}, ensure_ascii=False))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())