A restful banking system built in hexagonal architecture with CQRS light (with one DB). the primary use cases are internal money transfer, external money transfer, opening and closing an account, adding and deleting a beneficiary, retrieving various info on an account (its balance, iban, bic, beneficiaries and transactions). There is also an identity and access modules who is in charge of authorizations,login and signup features.
- You need your own openexchangerates api key to replace in the application properties file, you also need to make your own env.properties file.
- You need to set up the database there is some sql scripts in the resources packages to help you with that.
mvn spring-boot:run
Some integration test use test container, so you need to have docker installed on your machine.
mvn test
if you are not familiar with strategic domain driven design let me redirect you toward this article: https://blog-clement-gombauld.vercel.app/article/6458fa505f21517ea8ef0e81
The domain is of course a Banking domain who is composed of 4 subdomains.
- Account who is the core domain.
- Identity and access who is a generic subdomain.
- Country who is an external generic subdomain.
- Currency who is also an external generic subdomain.
- ACL (Anti-corruption layer )
- OHS (Open host service)
- PL (Published Language)
- U (Upstream)
- D (Downstream)
I also use DDD tactical patterns (aggregate,entity,value object, domain service and repository) specially in the account bounded context.
This project is a monolith composed of two 3 modules Account, Identity and Access and Common. it has been built with decoupling in mind Account and Identity and Access can't share Database tables. In fact if the project needs to scale it's easy to split each module in a microservice. Common module contains shared code for the two modules (Account and Identity and Access).
This module use Hexagonal architecture and CQRS light(with one DB) and domain model (aggregate, entity value object, domain service etc...).
This module use Hexagonal architecture the business logic is quite simple, so it mostly uses transaction script over domain model.
