Let op: Voor uitgebreide documentatie en details over het project kunt u terecht op de nieuwe directdeal-docs repository. Deze repository bevat alle officiële documentatie, architectuurbeschrijvingen en ontwikkelrichtlijnen van het DirectDeal-project.
DirectDeal is een online direct-handelsplatform voor iedereen. Daar kunnen mensen niet alleen vrij hun spullen verhandelen, maar ook producten kopen die door anderen worden verkocht.
DirectDeal is een online direct-handelsplatform voor iedereen. Daar kunnen mensen niet alleen vrij hun spullen verhandelen, maar ook producten kopen die door anderen worden verkocht.
DirectDeal is mijn vrijetijdsproject dat zich in een gedecentraliseerde omgeving, met name binnen een microservices-architectuur (MSA), richt op het ontwerpen en implementeren van een enterprise Java-omgeving. In dit project heb ik gebruikgemaakt van populaire en veelbelovende technologieën, ontwerppatronen en tools, zoals onder andere Spring Boot, Spring WebFlux, Event Sourcing (Axon Framework), het CQRS-patroon, Kafka, Redis, NoSQL (MongoDB), REST API, Docker, Kubernetes, Java 12, JPA (Hibernate) en Gradle.
Daarnaast heb ik het Domain-Driven Design (DDD) concept als uitgangspunt genomen om de complexe businesslogica goed te modelleren en structureren. Door het systeem op te delen in duidelijke bounded contexts, zoals verkoop, catalogus, chat en accountbeheer, kon ik voor elke microservice een eigen domeinmodel ontwikkelen met consistente terminologie en regels. Dit maakte het eenvoudiger om de businessregels nauwkeurig te implementeren en de services onafhankelijk te houden, wat perfect past bij de microservices-architectuur.
De reden waarom ik dit project ben begonnen, is om mijn gebrek aan ervaring met gedecentraliseerde omgevingen te compenseren. Dankzij dit project heb ik met succes een enterprise Java-omgeving geïmplementeerd binnen een MSA-structuur. Daarom geloof ik dat ik goed voorbereid ben om aan projecten in een gedecentraliseerde omgeving te werken.
Opmerking: Door een recente migratie zijn de gebruikte libraries en tools geüpdatet naar nieuwere versies. Hieronder staan de oude versies doorgestreept, met de nieuwe versies ernaast vermeld.
Meer details: de actuele versies van alle tools en bibliotheken zijn te vinden in de sectie 5. Ontwikkelomgeving van de directdeal-docs.
- Operating System: Linux (Debian/Ubuntu), Windows (WSL)
- JAVA:
1217 - Mysql:
5.75.7.41 - Spring boot:
2.5.03.2.12 - Spring webflux:
5.3.73.2.12 - Spring cloud gateway:
3.0.44.2.1 - Spring cloud kubernetes:
2.0.43.2.0 (Spring Cloud Kubernetes Client Config) - Gradle:
7.47.6.4 - Axon framework:
4.54.9.4 - Hibernate :
5.4.316.4.10 - Mongo DB : 4.0.25
- Kafka: wurstmeister/kafka:2.12-2.4.0
- Vue.js: 2.6.14
- Vuetify: 2.5.4
Opmerking: Een meer gedetailleerde uitleg over de uitvoeringsstappen — zowel voor de lokale omgeving als voor de Google Cloud Platform (GCP)-omgeving — is te vinden in 6. Uitvoeringsmethode van de directdeal-docs.
$> git clone https://github.com/nieuwmijnleven/directdeal.git
$> cd ./directdeal
Volg de instructies om Minikube op Ubuntu te installeren. How to Install Minikube on Ubuntu
$> ./start-direct-deal-service.sh
Let op: dit proces kan langer dan vijf minuten duren. U kunt de status van alle containers bekijken met het commando:
$> kubectl get pods
Meer informatie: Raadpleeg hoofdstuk 8, 9 en 10 van de directdeal-docs voor meer details over de systeemarchitectuur, Domain-Driven Design (DDD) en de opbouw van microservices.
Het systeem bestaat uit zes microservices: direct-deal-account-service, direct-deal-chatting-service, direct-deal-gateway-service, direct-deal-sale-service en direct-deal-sale-catalog-service. Elke microservice vervult een specifieke rol binnen het systeem. Zo is direct-deal-account-service verantwoordelijk voor het beheer van gebruikersaccounts en het in- en uitloggen, terwijl direct-deal-sale-service functionaliteiten biedt voor het registreren, wijzigen en verwijderen van producten door gebruikers.
Opvallend is dat voor direct-deal-sale-service en direct-deal-sale-catalog-service het Event Sourcing- en CQRS-patroon (Command Query Responsibility Segregation) wordt toegepast. Hierdoor wordt de lock-contentie aan de leeszijde (direct-deal-sale-catalog-service) verminderd en is het niet nodig om transacties te gebruiken. Dit stelt het systeem in staat om gebruikers een snellere reactietijd bij het lezen van gegevens te bieden.
- De microservice is verantwoordelijk voor het beheer van gebruikersaccounts en het in- en uitloggen
- Bij het inloggen genereert de service een JWT (JSON Web Token) en stuurt deze naar de gebruiker
- Door het JWT in de authorization-header van de HTTP-aanvraag mee te sturen, krijgen gebruikers toegang tot alle microservices binnen het systeem
- Deze microservice biedt chatfunctionaliteit tussen verkopers en kopers
- Deze microservice fungeert als API Gateway binnen de MSA-omgeving en vormt het centrale toegangspunt voor externe aanvragen richting de achterliggende microservices
- Deze microservice faciliteert functies voor het registreren, aanpassen en verwijderen van producten door gebruikers
- Zowel het Eventsourcing- als CQRS-patroon (Command Query Responsibility Segregation) worden toegepast op deze service
- De service is verantwoordelijk voor het Command-gedeelte van het CQRS-patroon
- Daarnaast beheert deze service de EventStore ten behoeve van Eventsourcing
- Deze microservice voorziet gebruikers van een overzicht van beschikbare producten
- Voor deze service gelden eveneens Eventsourcing en het CQRS-patroon
- De service implementeert het Query-gedeelte van CQRS
- Daarnaast leest deze service uit de EventStore als onderdeel van Eventsourcing
- Deze microservice toont gebruikers een overzicht van afgeronde transacties
Event Sourcing is een benadering waarbij elke wijziging in de status van een domeinobject wordt vastgelegd als een afzonderlijk evenement. In tegenstelling tot de traditionele manier van persistente opslag — waarbij enkel de actuele status van een entiteit wordt bewaard — bewaart Event Sourcing een serie van statuswijzigingen (evenementen) in een event store. De actuele toestand van een entiteit wordt samengesteld door al deze evenementen achtereenvolgens toe te passen ('replayen').
Elke statuswijziging resulteert in een nieuw evenement, dat als een op zichzelf staande operatie wordt opgeslagen; dit maakt het proces intrinsiek atomair. De event store fungeert niet alleen als database voor evenementen, maar vaak ook als message broker. Hierdoor kunnen andere services zich abonneren op relevante evenementen via een aangeboden API. Elk opgeslagen evenement wordt vervolgens doorgestuurd naar alle geïnteresseerde abonnees, wat van de event store de ruggengraat maakt van een event-driven microservice-architectuur.
In deze architectuur worden bewerkingen als volgt afgehandeld: bij een wijzigingsverzoek worden eerst de relevante evenementen uit de event store opgehaald om de actuele status van de entiteit te reconstrueren. Daarna wordt de entiteit bijgewerkt en een nieuw evenement toegevoegd.
CQRS staat voor Command Query Responsibility Segregation, een patroon waarbij lees- en schrijfbewerkingen strikt worden gescheiden. In plaats van complexe join-queries toe te passen op één centrale database, wordt er binnen CQRS een aparte view-database ingericht voor alleen-lezen doeleinden.
Deze aanpak vermindert lock-contentie bij het uitvoeren van join-bewerkingen en maakt het mogelijk om transacties te vermijden voor leesoperaties. Synchronisatie tussen de alleen-lezen en de alleen-schrijven databases vindt plaats in chronologische volgorde van gebeurtenissen, doorgaans via een berichtensysteem zoals Kafka of RabbitMQ. Dit voorkomt samenvoegingsconflicten op domeinniveau in de schrijfdatabank.
Door CQRS te implementeren kunnen prestaties, schaalbaarheid en beveiliging van het systeem significant worden verbeterd.
- Jeon, Cheol