https://github.com/citerus/dddsample-core

This is the new home of the original DDD Sample app (previously hosted at sf.net)..
https://github.com/citerus/dddsample-core

Last synced: about 2 months ago
JSON representation

This is the new home of the original DDD Sample app (previously hosted at sf.net)..

• Host: GitHub
• URL: https://github.com/citerus/dddsample-core
• Owner: citerus
• License: mit
• Created: 2015-01-31T23:21:37.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-22T19:09:02.000Z (2 months ago)
• Last Synced: 2024-04-22T20:31:53.620Z (2 months ago)
• Language: Java
• Homepage:
• Size: 8.15 MB
• Stars: 4,824
• Watchers: 261
• Forks: 1,448
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Lists

• awesome-ddd - DDDSample - Sample DDD project using Spring Boot (originally hosted in http://dddsample.sourceforge.net/) (Sample Projects / JVM languages)
• awesome-clean-code - Cargo
• awesome-stars - dddsample-core
• awesome-stars - citerus/dddsample-core - This is the new home of the original DDD Sample app (previously hosted at sf.net).. (Java)

README

        
# DDDSample

[![Java CI with Maven](https://github.com/citerus/dddsample-core/actions/workflows/pipeline.yml/badge.svg)](https://github.com/citerus/dddsample-core/actions/workflows/pipeline.yml)

This is the new home of the original DDD Sample app hosted at SourceForge. 

Our intention is to move everything from SourceForge to GitHub in due time while starting upgrading both the technical aspects as well as the DDD aspects of the DDD Sample.

This project is a joint effort by Eric Evans' company [Domain Language](https://www.domainlanguage.com/) and the [Swedish software consulting company Citerus](https://www.citerus.se/).

The application uses Spring Boot. To start it go to the root directory and type `mvn spring-boot:run` or run the `main` method of the `Application` class from your IDE.  

Then open http://localhost:8080/dddsample in your browser (and make sure that no firewall is blocking the communication and that Javascript for localhost is not blocked).

Discussion group: https://groups.google.com/forum/#!forum/dddsample

Development blog: https://citerus.github.io/dddsample-core/

Trello board: https://trello.com/b/PTDFRyxd

## How to build

Using Maven (we recommend using the included Maven wrapper), run this command to compile and run all the tests:

    ./mvnw verify

    

If you want to compile without running the tests, run the following command:

    ./mvnw compile

    

For Windows users, use the included `mvnw.cmd` file instead, without the `./` but using the same arguments.

    

## How to run

To start the app using the included application server and in-process HSQL database, run this command:

    ./mvnw spring-boot:run

    

For Windows users, use the included `mvnw.cmd` file instead, without the `./` but using the same arguments.

## Entity relationships

![](./dddsample.drawio.png)

The diagram was created with diagrams.net (formerly draw.io).

## Using the HandlingReport REST API

The HandlingReport API has one endpoint that takes a JSON request body:

    POST /dddsample/handlingReport

You can use cURL to send the request using an JSON file for the body:

    curl --data-binary "@/path/to/project/src/test/resources/sampleHandlingReport.json" \

    -H 'Content-Type: application/json;charset=UTF-8' \

    http://localhost:8080/dddsample/handlingReport

See the [api-docs.yaml](/api-docs.yaml) file for a complete API definition.