# wlswo/moco architecture

> Architecture diagram of the GitHub repository wlswo/moco, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wlswo/moco
- Repository: https://github.com/wlswo/moco

## Overview

##### Main Components

a. Client Layer:
- Web Browser (HTML5/CSS3/JavaScript)
- Thymeleaf Templates
- Web3.js Integration
- MetaMask Wallet Integration

b. Load Balancer Layer:
- AWS Application Load Balancer
- Nginx (for zero-downtime deployment)

c. Application Layer:
- Spring Boot Application (Multiple instances for blue-green deployment)
- Core Components:
- Security Module (Spring Security)
- OAuth2 Authentication
- Web3 Integration Module
- File Upload Module (AWS S3)
- Board Management
- User Management
- Comment System
- Token System

d. Data Layer:
- MySQL Database (AWS RDS)
- QueryDSL for data access
- JPA/Hibernate

e. External Services:
- AWS S3 (File Storage)
- Ethereum Network (Goerli testnet)
- OAuth Providers
- Kakao Maps API

##### Interaction Flows to Highlight

a. Authentication Flow:
- Traditional Login Path
- OAuth2 Social Login Path
- Session Management

b. Content Management Flow:
- Board CRUD Operations
- Comment System
- File Upload/Download
- Image Processing

c. Blockchain Integration Flow:
- Smart Contract Interaction
- Token Management
- MetaMask Integration

##### Deployment Architecture

a. CI/CD Pipeline:
- GitHub Actions
- Docker Container Flow
- Blue-Green Deployment with Nginx

b. AWS Infrastructure:
- EC2 Instances
- RDS Database
- S3 Storage
- Route 53 DNS
- ACM SSL Certificate

##### Additional Details

- Monitoring components (CloudWatch)
- Security groups and network boundaries
- Public/private subnets
- SSL termination points
- Database replication if applicable

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
        Templates["Thymeleaf Templates"]
        Web3JS["Web3.js Integration"]
        MetaMask["MetaMask Wallet"]
        KakaoMaps["Kakao Maps"]
        StaticAssets["Static Assets"]
    end

    subgraph LoadBalancer
        ALB["AWS Application Load Balancer"]
        Nginx["Nginx"]
    end

    subgraph AppLayer
        subgraph SpringBoot["Spring Boot Application"]
            Security["Security Module"]
            OAuth["OAuth2 Service"]
            AuthHandler["Auth Handler"]
            BoardMgmt["Board Management"]
            UserMgmt["User Management"]
            CommentSys["Comment System"]
            LikeSys["Like System"]
            FileUpload["File Upload Module"]
            Web3Integration["Web3 Integration"]
        end
    end

    subgraph DataLayer
        MySQL[(MySQL/RDS)]
        QueryDSL["QueryDSL"]
        JPA["JPA/Hibernate"]
        Entities["Domain Entities"]
        Repos["Repositories"]
    end

    subgraph ExternalServices
        S3["AWS S3"]
        Ethereum["Ethereum Network"]
        OAuthProviders["OAuth Providers"]
        KakaoAPI["Kakao API"]
    end

    subgraph Deployment
        GitHub["GitHub Actions"]
        Docker["Docker"]
    end

    Browser --> ALB
    ALB --> Nginx
    Nginx --> SpringBoot
    Templates --> Browser
    Web3JS --> MetaMask
    MetaMask --> Ethereum
    
    SpringBoot --> MySQL
    SpringBoot --> S3
    SpringBoot --> Ethereum
    SpringBoot --> OAuthProviders
    SpringBoot --> KakaoAPI

    QueryDSL --> MySQL
    JPA --> MySQL

    classDef external fill:#f9f,stroke:#333
    classDef database fill:#fcf,stroke:#333
    classDef service fill:#cfc,stroke:#333
    classDef client fill:#ccf,stroke:#333
    classDef deployment fill:#fcc,stroke:#333

    class S3,Ethereum,OAuthProviders,KakaoAPI external
    class MySQL database
    class SpringBoot,Security,OAuth,BoardMgmt,UserMgmt service
    class Browser,Templates,Web3JS,MetaMask client
    class GitHub,Docker deployment

    click Templates "https://github.com/wlswo/MoCo/tree/master/src/main/resources/templates"
    click Web3JS "https://github.com/wlswo/MoCo/blob/master/src/main/resources/static/js/web3js/web3js.js"
    click StaticAssets "https://github.com/wlswo/MoCo/tree/master/src/main/resources/static"
    click Security "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/config/SecurityConfig.java"
    click OAuth "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/service/user/CustomOAuth2UserService.java"
    click AuthHandler "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/config/auth/CustomAuthFailureHandler.java"
    click BoardMgmt "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/service/board/BoardService.java"
    click UserMgmt "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/service/user/UserService.java"
    click CommentSys "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/service/board/CommentService.java"
    click LikeSys "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/service/board/LikeService.java"
    click Entities "https://github.com/wlswo/MoCo/tree/master/src/main/java/com/board/board/domain"
    click Repos "https://github.com/wlswo/MoCo/tree/master/src/main/java/com/board/board/repository"
    click QueryDSL "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/config/QuerydslConfig.java"
    click FileUpload "https://github.com/wlswo/MoCo/blob/master/src/main/java/com/board/board/service/aws/AwsS3Service.java"
    click KakaoMaps "https://github.com/wlswo/MoCo/blob/master/src/main/resources/static/js/board/kakaoMap.js"
    click Docker "https://github.com/wlswo/MoCo/tree/master/Dockerfile"
    click GitHub "https://github.com/wlswo/MoCo/blob/master/.github/workflows/gradle.yml"
```
