stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
9d3bed1d0e702171ba6e0b6cb0e9f356d42ec8f9
git.stella-ops.org/docs/modules/ui/restoration-topics/workflow-visualization-and-replay.md

3.6 KiB
Raw Blame History

Workflow Visualization And Replay

Recommendation

Do not restore workflow visualization as a standalone sidebar product.

Restore it as a runtime run-detail capability under Releases, with a secondary entry point from Evidence > Verify & Replay, and a smaller design-time preview inside the workflow editor.

Why

  • The visualizer is about understanding a run, not browsing a separate product area.
  • The feature already has runtime concepts like critical path, timeline, node states, and auto-refresh.
  • Those belong closest to release runs, replay, and evidence.

Primary Placement

  • Menu group: Releases
  • Section: Runs

Primary route family:

  • /releases/runs/:runId/*

Secondary Placement

  • Evidence > Verify & Replay
    • link into the same run graph/replay context

Design-time secondary placement

  • Administration > Workflows
    • workflow editor gets a Preview DAG mode or tab
    • this is authoring-time preview, not runtime run analysis

Product Shape

Release run detail tabs

  • Summary
  • Graph
  • Timeline
  • Critical Path
  • Replay
  • Evidence

The graph/timeline/critical-path experiences should be facets of the same run detail, not separate products.

Merge Map

Into runtime run detail

  • WorkflowVisualizerComponent
  • TimeTravelControlsComponent
  • StepDetailPanelComponent

Into design-time authoring

  • reusable graph-preview subset of WorkflowVisualizerComponent
    • only for Workflow Editor
    • without runtime replay state

Placement For Single Actions And Stray Pages

Step detail

  • Right drawer from the Graph tab
  • Not a full route unless deep-linking to failed step diagnostics becomes necessary

Time-travel controls

  • Toolbar in the Timeline or Replay tab
  • Not its own page

Critical path

  • Toggle or subtab inside Graph
  • Not a separate sidebar item

Replay verify

  • Primary home in Replay
  • Secondary deep link from Evidence > Verify & Replay

Workflow authoring preview

  • Add a Preview DAG tab or toggle in the workflow editor
  • Do not mix authoring preview with live runtime telemetry

Suggested Route Sketch

  • /releases/runs/:runId
  • /releases/runs/:runId/summary
  • /releases/runs/:runId/graph
  • /releases/runs/:runId/timeline
  • /releases/runs/:runId/replay
  • /releases/runs/:runId/evidence
  • /evidence/verify-replay?runId=:runId
  • /administration/workflows/:workflowId?view=preview

What Not To Do

  • Do not create a standalone Workflow Visualization sidebar item.
  • Do not separate graph, replay, and run evidence into unrelated shells.
  • Do not put runtime graph tooling only in workflow authoring; runtime operators need it on run detail first.

Detailed UX And Sprint

  • Detailed UX dossier: ../workflow-visualization-replay/README.md
  • Implementation sprint: ../../../implplan/SPRINT_20260307_028_FE_workflow_visualization_replay.md

Corroborating Inputs

  • docs/modules/release-orchestrator/ui/overview.md
  • docs/modules/release-orchestrator/workflow/evidence-based-release-gates.md
  • docs/modules/ui/architecture-rework.md
  • src/Web/StellaOps.Web/src/app/routes/releases.routes.ts
  • src/Web/StellaOps.Web/src/app/routes/evidence.routes.ts
  • src/Web/StellaOps.Web/src/app/features/workflow-visualization/workflow-visualization.routes.ts
  • src/Web/StellaOps.Web/src/app/features/workflow-visualization/components/workflow-visualizer/workflow-visualizer.component.ts

Final Call

This should become a Release Runs detail capability with graph, timeline, replay, and step-detail views, plus an evidence-side entry point and a smaller workflow-editor preview.