Skip to content

grip-on-software/process-flow

Repository files navigation

Process flow

This visualization produces a flow diagram that indicates how long stories remain at a certain status/resolution before changing to another state, and how many do so.

Configuration

Copy the file lib/config.json to config.json and adjust environmental settings in that file. The following configuration items are known:

  • visualization_url: The URL to the visualization hub. This may include a protocol and domain name, but does not need to in case all the visualizations and the process flow are hosted on the same domain (for example in a development environment). The remainder is a path to the root of the visualizations, where the dashboard is found and every other visualization has sub-paths below it.
  • path: The relative path at which the process flow is made available on the server. This can remain the default . to work just fine.

Data

The data for the process flow can be analyzed and output through runs of scripts from the data-analysis repository upon a collection of Scrum data in a Grip on Software database. The story_flow analysis report from that repository provides the data in a proper structure, including DOT files which the visualization can dynamically display as a Graphviz diagram. The entire data collection must be placed in the public/data directory.

Running

The visualization can be built using Node.js and npm by running npm install and then either npm run watch to start a development server that also refreshes browsers upon code changes, or npm run production to create a minimized bundle. The resulting HTML, CSS and JavaScript is made available in the public directory.

This repository also contains a Dockerfile specification for a Docker image that can perform the installation of the app and dependencies, which allows building the visualization within there. Also, a Jenkinsfile contains appropriate steps for a Jenkins CI deployment, including data collection and visualization building.