Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 3 commits ahead, 106 commits behind spring-projects:main.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Spring PetClinic Sample Application with integrated jQAssistant

With this software project, we demonstrate the usage of jQAssistant and Neo4j.

We've integrated jQAssistant in the Maven build of the Spring PetClinic sample application. By doing this, jQAssistant scans various software structures (Java ByteCode, Git commits, JUnit test results and so on) during the build process and stores this information into the Neo4j graph database.

This README shows you, how you can setup this software project by yourself. If you want to integrated jQAssistant in your own project, take a look at out 101 guide).


Minimum requirements


  • To produce nice looking diagrams, install GraphViz (download)

Installing and getting to know the sample application

Hint: Preferable, you use the Git bash command line or any Unix-like shell for these tasks.

Understanding the Spring Petclinic application with a few diagrams

The sample application itself is a simple demo for organizing visits of pet owners to vets in a clinic.

Downloading and running the petclinic web application

First, we want to download the source code of the application with Git, build it with Maven (using mvnw) and running the embedded web application server tomcat7:

git clone
cd spring-petclinic
./mvnw clean install
java -jar target/*.jar

You can then access the petclinic web application with your browser here: http://localhost:9966/petclinic/

This is what it looks like:

To shutdown the server, press Ctrl + c on the command line.

Running jQAssistant / Neo4j locally

After shutting down the web application server, you can start jQAssistant's embedded Neo4j database server with this Maven command:

./mvnw jqassistant:server

You should see the following on the command line:

You can then access the Neo4j browser frontend with the scanned data here: http://localhost:7474

This is what it should look like after clicking the button in the upper left corner (symbol may differ):

Next steps

Next, you can click on the various labels in the drawer to explore the scanned software data. You can also use the Neo4j guide for jQAssistant (beta) by executing the following command


or by simply clicking this link: http://localhost:7474/browser?cmd=play&arg= The guide will show you some first steps with jQAssistant/Neo4j.

More information e.g. about the scanned Java code can be found in the documentation of jQAssistant:

Taking a look at the self-validating, living architecture documentation

After the build, you can find the complete architecture documentation in target/html/index.html. The documentation is written in AsciiDoc and

  • defines the architecture rules in plain text
  • translates those rules into Cypher (Neo4j's query language)
  • validates the rules by executing the Cypher queries against the actual software
  • reports the results back directly into the document.

Please find more information about the various artifacts in the /docs directory or online.

Have fun!


A sample Spring-based application






No releases published


No packages published


  • Java 77.9%
  • HTML 14.2%
  • Less 7.9%