= hsadminNg Development

== Setting up the Development Environment

You'll often need to execute `./gradlew`, therefore we suggest to define this alias:

    alias gw='./gradlew'

== Building the Application with Test Execution

gw build

== Starting the Application

Either simply:

    gw bootRun

or with a specific port:

    SERVER_PORT=8081 ./gradlew bootRun

== Running JUnit tests with branch coverage

=== for IntelliJ IDEA

see: https://confluence.jetbrains.com/display/IDEADEV/IDEA+Coverage+Runner

Either apply it to specific test configurations or,
better, delete the previous test configurations and amend the JUnit template.

== Git Workflow

The jhipster-generated git branch tracks the history of the JDL model file
and the generated source code. The project has to be resetted to a clean state
(without any generated entitites) before changes to the JDL file can be imported.

    # Prepare/Cleanup Workspace

    git checkout jhipster-generated
    git reset --hard jdl-base
    git clean -f -d
    git checkout HEAD@{1} src/main/jdl/customer.jdl
    git reset HEAD .

    # Apply changes to the jdl file

    # Invoke JHipster generator

    jhipster import-jdl src/main/jdl/customer.jdl --force

    # Let Git determine change set between most recent commit and the re-generated source

    git reset --soft HEAD@{1}
    git reset HEAD .
    git add .

    # Commit changeset

    git commit -m '...'

    # Merge changeset into master branch

    git checkout master
    git merge jhipster-generated