Skip to content
A playful approach to refactoring code smells
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.metadata/.plugins
avatar New avatars for FedEx-Day Jul 4, 2018
docs Screenshot of avatar page renewed Dec 17, 2018
sonarQuest-backend Userlogic (#246) May 22, 2019
sonarQuest-frontend error message removed (#247) May 22, 2019
.gitignore Dropped spring repo reference, ignore logfiles. Apr 25, 2018
.travis.yml Merge branch 'add-travis-for-sonarcloud' Jul 16, 2018
AvatarCards.pdf Documentation and predefined avatars cards added Jul 19, 2018
CONTRIBUTING.md
LICENSE GmbH -> AG. Jul 16, 2018
README.md Badges Apr 30, 2019
_config.yml Set theme jekyll-theme-time-machine Feb 1, 2019
docker-compose.yml refactor dockerfiles and nginx setup to get it ready to be deployed o… Jan 25, 2019
installation.md Update installation.md (#179) Jan 25, 2019
sonarQubeSimulationServer.md Replaced sonarQubeSimulationServer with command-line switch (use --si… Mar 23, 2018

README.md

SonarQuest

Build Status

A tool for extending SonarQube by a gamification system. Handle your code quality issues in a playful way by solving quests and adventures, earning rewards for refactoring code smells and optimization.

Goal

Reduce technical debts in your code project by converting the refactoring process into a game. Create quests from SonarQube issues and write your own story.

An example: a team defines the solvation of issues with priority levels "blocker" and "critical" as goals on a fictious adventure map in a game they call "travel through the wild Codeistan". They can reach the respective targets in the adventure by decreasing the number of code smells, bugs and security vulnerabilities detected by SonarQube.

Example

Jump-start for users

The quickest way to get a running SonarQuest and to start playing is to use Docker, see INSTALLATION.md or if you do not have Docker, just do the following:

Backend

Frontend

  • check out the sonarquest-frontend folder from github
  • Install Node.js. Please follow the instructions on the Node.js website.
  • Install Angular-Cli globally with npm install -g @angular/cli

After that you can start the SonarQuest client:

  1. switch to the directory: cd sonarQuest-frontend
  2. install the node modules: npm install
  3. start the test server with the SonarQuest client: ng serve You can access the SonarQuest client in a browser at http://localhost:4200

10 steps into your SonarQuest game

  1. Log in as admin with password test
  2. Check the connection to the SonarQube server
  3. Get all the projects on SonarQube into SonarQuest and make a single project playable as a "world"
  4. Assign a gm and players to this world
  5. Log in as gm with password test
  6. Get all issues aka tasks for the current world
  7. Create quests by writing a short story and add tasks to make them solvable
  8. (Optionally) create an adventure and add quests to it to support a story arc
  9. Get your players to log in (all pre-made avatars have the password test and their username as login) and take on your quests by selecting to "fight" in a quest and to "fight" issues in the quests
  10. Login in as a gm from time to time to synchronize SonarQuest with the SonarQube project to have SonarQuest pay out rewards to your players!

Have fun!

Getting Started

See INSTALLATION.md for instruction to get started with SonarQuest. These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Used technologies and projects

The SonarQuest client is an Angular application on the basis of TypeScript. Angular Material, Teradata Covalent and RPG-Awesome (Icons) are used for the UI. You need Node.js for your development environment.

Contributing

Interested in helping out? Welcome! Check out the guide CONTRIBUTING.md to get started.

License

This project is licensed under the BSD 3-Clause "New" or "Revised" License - see the LICENSE file for details. The licenses of the reused components of the SonarQuest server can be found in Licenses SonarQuestServer.

User Guidelines

Player and Avatars

A user can choose an individual avatar with a name, a class (e.g. warrior or magician) and a race (e.g. dwarf or elf). A set of predefined avatars is available here in PDF format. Please note the username (login) is the character's name by default (first letter is always uppercase!) and the standard password is test for all accounts.

During an adventure the party (which may be represented by a project team) takes on quests and every avatar has several possibilities to gain experience points (XP) and get to the next level. Besides, some quests and tasks contain a reward in form of gold -- which can be used to purchase items and improvements in the marketplace.

The levels are determined based on experience points (XP) as follows:

Levels

Level 1 2 3 4 5 6 7 8
XP 0 10 30 60 100 150 210 280

Levels 1 to 100 are included in the standard game data. In case you want to add some extra levels, consider reading the level calculation documentation.

Rating system

Every issue is assessed in experience points and gold. The higher the severity of a issue the more experience points that a user gets.

  • Blocker = 10 XP
  • Critical = 7 XP
  • Major = 5 XP
  • Minor = 2 XP
  • Info = 1 XP

The number of gold is calculated depending on the effort (minutes/10), e.g. approximately 30 minutes = 3 gold, 2 hours = 12 gold. Thus issues with a low severity and a high effort are also attractive for a user.

Quests and Administration

A "Game-Master" is responsible for the administration of quests and adventures and assigning issues from SonarQube to them. This process is supported by automatic generation: The results from the previous SonarQube-Build are being loaded and evaluated using the severity the effort to solve them. Subsequently, the issues are randomly grouped to predefined quests. These can be assigned to team adventures. When a quest is solved, i.e. the related SonarQube issues don't exist anymore, the avatar receives the reward.

Additionally, a Game Master is able to manually create "special tasks" which are rewarded by bonus experience points or bonus gold, such as:

  • Increase the coverage of a changed class for 10%
  • Increase the documentation quality of a changed class
  • Apply the DRY principle in one class
You can’t perform that action at this time.