https://github.com/dmdevgo/epicpredictor

https://github.com/dmdevgo/epicpredictor

Last synced: 17 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/dmdevgo/epicpredictor
• Owner: dmdevgo
• License: mit
• Created: 2023-11-21T00:15:33.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2023-11-28T22:51:30.000Z (about 1 year ago)
• Last Synced: 2024-11-06T15:58:02.788Z (2 months ago)
• Language: Kotlin
• Size: 98.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.MD
  • License: LICENSE

Awesome Lists containing this project

README

        
# Epic Predictor

Epic Predictor is a small REST client for Jira that allows you to forecast the completion of epics.

## Model

The forecast is based on cumulative issues flow ([NoEstimates](https://youtu.be/QVBlnCTu9Ms?feature=shared)).

Calculate the average velocity for the last few sprints and and assuming how quickly the backlog will grow, you can draw a cumulative flow diagram.

The weak point of the calculation is the choice of the backlog growth rate factor.

This tool is a predictor, but you can be a corrector. Think about how you can increase a velocity or reduce backlog to improve the forecast.

## Usage

### Configuration

Set parameters in `local.properties`:

- `jira.url` - Jira base url (scheme + host + port).

- `jira.token` - personal access token.

- `jira.epicKeys` - epic ids or keys separated by commas.

### Launch App

Run the desktop application:

```shell

./gradlew :composeApp:run

```

### Calculation Parameters

Choose calculation parameters:

- `Last Sprints Count` - The number of sprints used to calculate the average velocity.

- `Backlog Growth Rate Factor` - Used to predict the growth of the backlog. Measured in fractions of velocity.

## License

This tool is licensed under [MIT](LICENSE).