# lj19950508/ddd-demo-java architecture

> Architecture diagram of the GitHub repository lj19950508/ddd-demo-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lj19950508/ddd-demo-java
- Repository: https://github.com/lj19950508/ddd-demo-java

## Overview

##### Project type and purpose
- This is a Java multi‑module microservice built using the Hexagonal (Ports & Adapters) architecture combined with CQRS.
- Modules:
- start – Spring Boot bootstrap & configuration
- adapter – inbound (REST/gRPC) & outbound (persistence, RPC) adapters
- application – orchestration layer (commands & queries)
- domain – business logic (aggregates, entities, value objects, domain services)
- provider – RPC server/client definitions for other services
- Purpose: expose user‑related functionality over REST/gRPC, orchestrate domain operations, persist data to MySQL/Redis/MQ, and offer an RPC interface for peer services.

##### File structure
- Top‑level POM aggregates sub‑modules.
- start/: SpringBoot entry point + YAML configs for MySQL, Redis, web.
- adapter/:
– in/http/rest/api/UserController.java
– out/persistent/UserRepositoryImpl.java
– out/rpc/grpc (RPC client stubs)
- application/:
– command/… (CommandService, factories to build domain objects)
– query/… (QueryService, query params/results)
– service/UserService.java
- domain/:
– biz1/entity/User.java (Aggregate Root)
– biz1/valueobject/Address.java
– biz1/repository/IUserRepository (port)
– biz1/service (domain services)
- provider/: definitions for exposing this service’s RPC interface.

##### README for additional insights
- Dependency flow: infrastructure → adapter → application → domain
- Inbound adapters handle protocol translation (PO ↔ DO ↔ VO)
- Application layer orchestrates domain logic, command/query segregation (CQRS)
- Domain is “pure”: no external dependencies, uses DI only for wiring interfaces
- Infrastructure provides actual implementations for persistence, MQ, RPC clients

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Start Module
    subgraph "Start Module"
        direction TB
        DemoApplication["DemoApplication"]:::start
        Configs["YAML Configurations"]:::start
    end

    %% Inbound Adapters
    subgraph "Inbound Adapters" 
        direction TB
        REST["UserController (REST)"]:::adapter
        GRPC_IN["gRPC Inbound (Placeholder)"]:::adapter
    end

    %% Application Layer
    subgraph "Application Layer" 
        direction TB
        subgraph "Commands" 
            direction TB
            CommandServices["CommandService Modules"]:::application
            Factories["Factory Modules"]:::application
        end
        subgraph "Queries"
            direction TB
            QueryServices["QueryService Modules"]:::application
            QueryParams["QueryParam Modules"]:::application
            QueryResults["QueryResult Modules"]:::application
        end
        UserService["UserService (Facade)"]:::application
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        UserEntity["User (Aggregate Root)"]:::domain
        AddressVO["Address (Value Object)"]:::domain
        IUserRepo["IUserRepository (Port)"]:::domain
        DomainServices["Domain Services"]:::domain
    end

    %% Outbound Adapters
    subgraph "Outbound Adapters"
        direction TB
        Persistence["UserRepositoryImpl (MySQL)"]:::adapter
        QueryAdapter["QueryAdapter Impl"]:::adapter
        RPC_Out["gRPC Client Stubs"]:::adapter
    end

    %% Provider Module
    subgraph "Provider Module"
        direction TB
        ProviderRPC["gRPC Provider Definitions"]:::adapter
    end

    %% External Systems
    subgraph "External Systems"
        direction TB
        MySQL["MySQL"]:::external
        Redis["Redis"]:::external
        MQ["Message Queue"]:::external
        Peer["Peer Services (gRPC)"]:::external
    end

    %% Flows
    Client["Client"]:::external
    Client -->|"HTTP/gRPC Request"| REST
    Client -->|"gRPC Request"| GRPC_IN

    REST -->|"DTO->DO"| UserService
    GRPC_IN -->|"DTO->DO"| UserService

    UserService -->|"invoke Commands"| CommandServices
    UserService -->|"invoke Queries"| QueryServices

    CommandServices -->|"calls Domain"| DomainServices
    CommandServices -->|"use Aggregate"| UserEntity

    QueryServices -->|"read via Port"| IUserRepo

    DomainServices -->|"access Port"| IUserRepo
    UserEntity -->|"uses VO"| AddressVO

    IUserRepo -->|"adapt to Persistence"| Persistence
    Persistence -->|"write"| MySQL

    QueryAdapter -->|"read"| MySQL
    UserService -->|"publish Event"| MQ
    RPC_Out -->|"call"| Peer

    ProviderRPC -->|"expose gRPC"| Peer

    %% Returns
    Persistence -->|"PO->DO->DTO"| UserService
    QueryAdapter -->|"VO->DTO"| UserService

    %% Click Events
    click DemoApplication "https://github.com/lj19950508/ddd-demo-java/blob/main/start/src/main/java/com/demo/start/DemoApplication.java"
    click Configs "https://github.com/lj19950508/ddd-demo-java/blob/main/start/src/main/resources/application.yml"
    click REST "https://github.com/lj19950508/ddd-demo-java/blob/main/adapter/src/main/java/com/demo/adapter/in/http/rest/api/UserController.java"
    click GRPC_IN "https://github.com/lj19950508/ddd-demo-java/tree/main/adapter/src/main/java/com/demo/adapter/in/rpc/grpc/"
    click Persistence "https://github.com/lj19950508/ddd-demo-java/blob/main/adapter/src/main/java/com/demo/adapter/out/persistent/UserRepositoryImpl.java"
    click QueryAdapter "https://github.com/lj19950508/ddd-demo-java/tree/main/adapter/src/main/java/com/demo/adapter/out/queryimpl/"
    click RPC_Out "https://github.com/lj19950508/ddd-demo-java/tree/main/adapter/src/main/java/com/demo/adapter/out/rpc/grpc/"
    click CommandServices "https://github.com/lj19950508/ddd-demo-java/tree/main/application/src/main/java/com/demo/application/command/commandservice/"
    click Factories "https://github.com/lj19950508/ddd-demo-java/tree/main/application/src/main/java/com/demo/application/factory/"
    click QueryServices "https://github.com/lj19950508/ddd-demo-java/tree/main/application/src/main/java/com/demo/application/query/queryservice/"
    click QueryParams "https://github.com/lj19950508/ddd-demo-java/tree/main/application/src/main/java/com/demo/application/query/queryparam/"
    click QueryResults "https://github.com/lj19950508/ddd-demo-java/tree/main/application/src/main/java/com/demo/application/query/queryresult/"
    click UserService "https://github.com/lj19950508/ddd-demo-java/blob/main/application/src/main/java/com/demo/application/service/UserService.java"
    click UserEntity "https://github.com/lj19950508/ddd-demo-java/blob/main/domain/src/main/java/com/demo/domain/biz1/entity/User.java"
    click AddressVO "https://github.com/lj19950508/ddd-demo-java/blob/main/domain/src/main/java/com/demo/domain/biz1/valueobject/Address.java"
    click IUserRepo "https://github.com/lj19950508/ddd-demo-java/blob/main/domain/src/main/java/com/demo/domain/biz1/repository/IUserRepository.java"
    click DomainServices "https://github.com/lj19950508/ddd-demo-java/tree/main/domain/src/main/java/com/demo/domain/biz1/service/"
    click ProviderRPC "https://github.com/lj19950508/ddd-demo-java/blob/main/provider/src/main/java/com/example/package.file"

    %% Styles
    classDef start fill:#cce5ff,stroke:#004085,color:#004085;
    classDef adapter fill:#d4edda,stroke:#155724,color:#155724;
    classDef application fill:#fff3cd,stroke:#856404,color:#856404;
    classDef domain fill:#ffe5b4,stroke:#b35f00,color:#b35f00;
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
```
