directdeal-docs is de officiële documentatie- en rapportopslagplaats van het DirectDeal-project.
Dit document heeft als doel het volledige proces – van planning, ontwerp, implementatie, uitvoering tot toekomstige verbeteringen – systematisch vast te leggen.
DirectDeal is een online direct-handelsplatform dat gebruikers in staat stelt vrij producten te registreren en te verhandelen.
In het bijzonder neemt dit project de uitdaging aan om een Enterprise Java-omgeving op te bouwen op basis van een microservices-architectuur (MSA).
Binnen het DirectDeal-project zijn verschillende moderne technologie-stacks toegepast, waaronder Spring Boot, Spring WebFlux, Kafka, MongoDB, Docker en Kubernetes.
Hiermee zijn service-ontwerpen in gedistribueerde omgevingen, evenals geavanceerde architectuurpatronen zoals CQRS en Event Sourcing, uitgeprobeerd en gevalideerd.
Dit document gaat verder dan een eenvoudige functiebeschrijving en omvat de visie en doelstellingen van het project, de ontwerpmethodologie (DDD), het proces van het bouwen van microservices, de redenen voor technologische keuzes, en de uitvoerings- en implementatiestappen.
Zo helpt dit document de lezer om het volledige verloop en de structuur van het DirectDeal-project te begrijpen, te reproduceren of verder uit te breiden.
Dit document is als volgt opgebouwd:
- Introductie
- Inhoudspgave
- Introductie van het project – onderwerp en achtergrond, ontwikkelingsdoelen, visie en kernwaarden, projectomvang
- Projectdoelstellingen – functionele/technische doelstellingen en prestatie-indicatoren
- Ontwikkelomgeving – IDE, libraries, databases, frameworks, testtools
- Uitvoeringsmethode – lokale omgeving en GCP GKE, scripts, beheer van omgevingsvariabelen
- Functie-overzicht – beschrijving van functies, scenario’s, gebruikerservaring
- Beschrijving van de systeemarchitectuur – systeemdiagrammen, MSA-ontwerp, technische keuzes
- Ontwerp met de DDD (Domain-Driven Design) – domeinmodellering, Bounded Context, Aggregates, Entities, Value Objects, UML-diagrammen
- Opbouw van microservices (met Spring Boot) – service-ontwerp en implementatie, API, service-communicatie, logging/monitoring
- Conclusie en toekomstige verbeteringen – resultaten, geleerde lessen, verbeter- en uitbreidingsmogelijkheden
- Bijlage – codelijsten, DB-schema, referentiemateriaal
Door dit document kan het DirectDeal-project zich positioneren als meer dan enkel een codebase:
het wordt een referentie waarin architectonische benaderingen, technologische keuzes en ontwerpfilosofieën zijn vastgelegd.
Daarnaast kan dit rapport dienen als basisdocument voor toekomstige projecten of uitbreidingen met een soortgelijke scope.
✍️ Auteur: Cheol Jeon
📅 Datum: 13-09-2025