# ddog-org/daengle-server architecture

> Architecture diagram of the GitHub repository ddog-org/daengle-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ddog-org/daengle-server
- Repository: https://github.com/ddog-org/daengle-server

## Overview

##### Project type and purpose
- This is a large-scale, back-end focused, multi-module microservices platform (“댕글”) for dog grooming and health-care mediation.
- It follows Domain-Driven Design (DDD) and Hexagonal Architecture: a central domain module (daengle-domain) and multiple Spring-Boot API microservices (auth, chat, user, groomer, vet, payment, notification), plus dedicated persistence adapters (RDB, NoSQL, queue).

##### File structure
- Top-level Gradle modules:
- daengle-auth: JWT-based authentication/authorization
- daengle-chat-api: WebSocket chat, DynamoDB persistence
- daengle-user-api, daengle-groomer-api, daengle-vet-api: role-specific REST APIs
- daengle-payment-api: integrates with Iamport, AWS SNS/SQS, handles orders and callbacks
- daengle-notification-api: listens on SQS, pushes notifications (Kakao, WebSocket)
- daengle-domain: pure domain model with ports/interfaces
- daengle-persistence-rdb, -nosql, -queue: adapters implementing ports
- CI/CD workflows: under .github/workflows for dev/prod deploy and integration testing.

##### README for additional insights
- The README includes architecture event-flow, multi-module layout, sequence flows for payments, ban-word filtering trie flow, DynamoDB chat flow, ERD for relational data.
- Tech stack: Spring Boot, Gradle, AWS (DynamoDB, RDS, SQS, SNS), WebSocket, Kakao social login, Iamport.

##### Elements
- Clear labels: service names, database names, queue/topic names
- Client → API Gateway → Services
- Service → Persistence → Database
- Service → SNS → SQS → Notification Service
- Microservices (blue rectangles)
- Domain module (green)
- Persistence adapters (orange)
- External systems (grey ovals)

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client"]:::external
    API["API Gateway\n(Load Balancer)"]:::infra
    Client -->|HTTP/WebSocket| API

    subgraph "Microservices"
      direction TB
      AuthService["Auth Service"]:::microservice
      ChatService["Chat Service"]:::microservice
      UserService["User Service"]:::microservice
      GroomerService["Groomer Service"]:::microservice
      VetService["Vet Service"]:::microservice
      PaymentService["Payment Service"]:::microservice
      NotificationService["Notification Service"]:::microservice
    end

    API -->|HTTP| AuthService
    API -->|HTTP| UserService
    API -->|HTTP| GroomerService
    API -->|HTTP| VetService
    API -->|HTTP| PaymentService
    API -->|STOMP/WebSocket| ChatService

    AuthService -->|issues JWT| Client
    AuthService -->|calls ports| DomainModule

    subgraph "Domain & Persistence"
      direction TB
      DomainModule["Domain Module"]:::domain
      RDBAdapter["RDB Adapter"]:::adapter
      NoSQLAdapter["NoSQL Adapter"]:::adapter
      QueueAdapter["Queue Adapter"]:::adapter
    end

    UserService -->|uses domain ports| DomainModule
    GroomerService -->|uses domain ports| DomainModule
    VetService -->|uses domain ports| DomainModule
    ChatService -->|uses domain ports| DomainModule
    PaymentService -->|uses domain ports| DomainModule
    NotificationService -->|uses domain ports| DomainModule

    DomainModule -->|implements via JDBC| RDBAdapter
    DomainModule -->|implements via DynamoDB| NoSQLAdapter
    DomainModule -->|implements via SQS| QueueAdapter

    subgraph "AWS Infrastructure"
      direction TB
      RDS["RDS\n(MySQL/Postgres)"]:::db
      DynamoDB["DynamoDB"]:::db
      SNS["SNS Topic\n(PaymentEvent)"]:::cloud
      SQS["SQS Queues"]:::cloud
    end

    RDBAdapter -->|JDBC| RDS
    NoSQLAdapter -->|AWS SDK| DynamoDB
    QueueAdapter -->|AWS SDK| SQS

    PaymentService -->|publish PaymentEvent| SNS
    SNS -->|fanout| SQS
    SQS -->|consume| NotificationService

    ChatService -->|store messages| DynamoDB

    subgraph "External Systems"
      direction TB
      Kakao["Kakao OAuth & Notification"]:::external
      Iamport["Iamport Payment Gateway"]:::external
    end

    PaymentService -->|HTTP callback| Iamport
    NotificationService -->|HTTP/API| Kakao

    GitHubWorkflows["CI/CD Workflows"]:::infra
    GitHubWorkflows -.-> API

    click AuthService "https://github.com/ddog-org/daengle-server/tree/develop/daengle-auth/src/main/java/ddog/auth"
    click ChatService "https://github.com/ddog-org/daengle-server/tree/develop/daengle-chat-api/src/main/java/ddog/chat"
    click UserService "https://github.com/ddog-org/daengle-server/tree/develop/daengle-user-api/src/main/java/ddog/user"
    click GroomerService "https://github.com/ddog-org/daengle-server/tree/develop/daengle-groomer-api/src/main/java/ddog/groomer"
    click VetService "https://github.com/ddog-org/daengle-server/tree/develop/daengle-vet-api/src/main/java/ddog/vet"
    click PaymentService "https://github.com/ddog-org/daengle-server/tree/develop/daengle-payment-api/src/main/java/ddog/payment"
    click NotificationService "https://github.com/ddog-org/daengle-server/tree/develop/daengle-notification-api/src/main/java/ddog/notification"
    click DomainModule "https://github.com/ddog-org/daengle-server/tree/develop/daengle-domain/src/main/java/ddog/domain"
    click RDBAdapter "https://github.com/ddog-org/daengle-server/tree/develop/daengle-persistence-rdb/src/main/java/ddog/persistence/rdb"
    click NoSQLAdapter "https://github.com/ddog-org/daengle-server/tree/develop/daengle-persistence-nosql/src/main/java/ddog/persistence/nosql"
    click QueueAdapter "https://github.com/ddog-org/daengle-server/tree/develop/daengle-persistence-queue/src/main/java/ddog/persistence/queue"
    click GitHubWorkflows "https://github.com/ddog-org/daengle-server/tree/develop/.github/workflows"

    classDef microservice fill:#D0E8F2,stroke:#036,stroke-width:1px
    classDef domain fill:#E2F0D9,stroke:#2E7D32,stroke-width:1px
    classDef adapter fill:#FFE5B4,stroke:#E65100,stroke-width:1px
    classDef db fill:#FFF2CC,stroke:#BF360C,stroke-width:1px
    classDef cloud fill:#E3F2FD,stroke:#1565C0,stroke-width:1px,stroke-dasharray:5 5
    classDef infra fill:#ECEFF1,stroke:#607D8B,stroke-width:1px
    classDef external fill:#CFD8DC,stroke:#455A64,stroke-width:1px
```
