# hoon105204/waggleproject architecture

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

- Interactive diagram: https://gitdiagram.com/hoon105204/waggleproject
- Repository: https://github.com/hoon105204/waggleproject

## Overview

##### Project type and purpose
- This is a monolithic full-stack web application built on Spring Boot, using JSP for the view layer, Spring MVC for request handling, MyBatis (mappers) for data access, and a relational database at the persistence layer.
- Purpose: “Waggle” lets users request in-person property visits (real estate) from other users, share details via chat, and fetch external property data via crawlers and OCR.

##### File structure
- Top-level:
- Servers/… – Eclipse/Tomcat server configs
- Waggle/ and Waggle2/ – two nearly identical Maven Spring Boot projects
- Waggle/src/main/java/com/probee/waggle:
- model/component – crawler (JsoupCrawler, SeleniumCrawler), OCR, FileSaver, security & web config
- model/controller – HTTP controllers (BoardController, ChatController, ChatbotController, MapController, etc.) + WebSocketConfig
- model/service – service interfaces & implementations
- model/mapper – MyBatis mapper interfaces for DB CRUD
- model/dto – data-transfer objects for request/response
- Waggle/src/main/webapp/WEB-INF/views – JSP pages for each feature
- static resources – CSS, images, CSV data
- application.properties – DB & security configuration

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Client["Browser/Mobile"]:::client
        JSPViews["JSP Views"]:::presentation
        StaticAssets["Static Assets"]:::presentation
    end

    %% Backend Entry
    Tomcat["Embedded Tomcat"]:::backend

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        WaggleApp["WaggleApplication"]:::app
        WebSecurity["WebSecurityConfig"]:::config
        WebConfigNode["WebConfig"]:::config
        Dispatcher["DispatcherServlet & WebSocketConfig"]:::app

        subgraph Controllers
            direction TB
            BoardCtrl["BoardController"]:::controller
            ChatCtrl["ChatController"]:::controller
            ChatbotCtrl["ChatbotController"]:::controller
            MapCtrl["MapController"]:::controller
            OtherCtrls["Other Controllers"]:::controller
        end

        subgraph Services
            direction TB
            BoardSvc["BoardServiceImpl"]:::service
            ChatSvc["ChatServiceImpl"]:::service
            MapSvc["MapServiceImpl"]:::service
            OtherSvcs["Other Services"]:::service
        end

        subgraph Mappers
            direction TB
            BoardMap["BoardMapper"]:::dao
            ChatMap["ChatMapper"]:::dao
            MapMap["MapMapper"]:::dao
            OtherMaps["Other Mappers"]:::dao
        end

        subgraph Components
            direction TB
            Jsoup["JsoupCrawler"]:::component
            Selenium["SeleniumCrawler"]:::component
            OCRDemo["OCRGeneralAPIDemo"]:::component
            OCRKey["OCRkey"]:::component
            OCRInt["OCR"]:::component
            FileSave["FileSaver"]:::component
            DTOs["DTOs"]:::dto
        end

        AppProps["application.properties"]:::config
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        DB["Database"]:::db
    end

    %% External Integrations
    subgraph "External Services"
        direction TB
        ExtCrawler["Web Crawlers"]:::external
        ExtOCRAPI["OCR API"]:::external
        ExtMapAPI["Map API"]:::external
        ExtChatbotAPI["Chatbot API"]:::external
    end

    %% Relationships
    Client -->|"HTTP/HTTPS"| Tomcat
    Tomcat -->|loads| JSPViews
    Tomcat -->|serves static| StaticAssets
    Tomcat -->|dispatches| WaggleApp
    WaggleApp --> WebSecurity
    WaggleApp --> WebConfigNode
    WaggleApp --> Dispatcher

    Dispatcher -->|routes| BoardCtrl
    Dispatcher -->|routes| ChatCtrl
    Dispatcher -->|routes| ChatbotCtrl
    Dispatcher -->|routes| MapCtrl
    Dispatcher -->|routes| OtherCtrls

    BoardCtrl -->|calls| BoardSvc
    ChatCtrl -->|calls| ChatSvc
    ChatbotCtrl -->|calls| OtherSvcs
    MapCtrl -->|calls| MapSvc
    OtherCtrls -->|calls| OtherSvcs

    BoardSvc -->|uses| BoardMap
    ChatSvc -->|uses| ChatMap
    MapSvc -->|uses| MapMap
    OtherSvcs -->|uses| OtherMaps

    BoardMap -->|JDBC| DB
    ChatMap -->|JDBC| DB
    MapMap -->|JDBC| DB
    OtherMaps -->|JDBC| DB

    Controllers -->|renders| JSPViews
    Controllers -->|reads| StaticAssets

    Services -->|invoke| Jsoup
    Services -->|invoke| Selenium
    Services -->|invoke| OCRDemo
    Services -->|invoke| FileSave

    Jsoup -->|template method| ExtCrawler
    Selenium -->|template method| ExtCrawler
    OCRDemo -->|calls| ExtOCRAPI

    MapSvc -->|REST API| ExtMapAPI
    ChatbotCtrl -->|REST API| ExtChatbotAPI

    %% WebSocket real-time
    Client <-->|WebSocket| Dispatcher

    %% Click Events
    click WaggleApp "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/WaggleApplication.java"
    click WebSecurity "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/WebSecurityConfig.java"
    click WebConfigNode "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/WebConfig.java"
    click Dispatcher "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/controller/WebSocketConfig.java"
    click BoardCtrl "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/controller/BoardController.java"
    click ChatCtrl "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/controller/ChatController.java"
    click ChatbotCtrl "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/controller/ChatbotController.java"
    click MapCtrl "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/controller/MapController.java"
    click BoardSvc "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/service/BoardServiceImpl.java"
    click ChatSvc "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/service/ChatServiceImpl.java"
    click MapSvc "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/service/MapServiceImpl.java"
    click BoardMap "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/mapper/BoardMapper.java"
    click ChatMap "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/mapper/ChatMapper.java"
    click MapMap "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/mapper/MapMapper.java"
    click Jsoup "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/JsoupCrawler.java"
    click Selenium "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/SeleniumCrawler.java"
    click OCRDemo "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/OCRGeneralAPIDemo.java"
    click OCRKey "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/OCRkey.java"
    click OCRInt "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/OCR.java"
    click FileSave "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/java/com/probee/waggle/model/component/FileSaver.java"
    click DTOs "https://github.com/hoon105204/waggleproject/tree/master/Waggle/src/main/java/com/probee/waggle/model/dto"
    click JSPViews "https://github.com/hoon105204/waggleproject/tree/master/Waggle/src/main/webapp/WEB-INF/views"
    click StaticAssets "https://github.com/hoon105204/waggleproject/tree/master/Waggle/src/main/resources/static"
    click AppProps "https://github.com/hoon105204/waggleproject/blob/master/Waggle/src/main/resources/application.properties"

    %% Styles
    classDef client fill:#e1f5fe,stroke:#0277bd,color:#01579b
    classDef presentation fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
    classDef backend fill:#fff3e0,stroke:#ef6c00,color:#e65100
    classDef app fill:#e3f2fd,stroke:#42a5f5,color:#0d47a1
    classDef config fill:#f3e5f5,stroke:#8e24aa,color:#4a148c
    classDef controller fill:#bbdefb,stroke:#1e88e5,color:#0d47a1
    classDef service fill:#c8e6c9,stroke:#43a047,color:#1b5e20
    classDef dao fill:#ffe0b2,stroke:#fb8c00,color:#e65100
    classDef component fill:#fce4ec,stroke:#d81b60,color:#880e4f
    classDef dto fill:#d1c4e9,stroke:#5e35b1,color:#311b92
    classDef db fill:#c5e1a5,stroke:#558b2f,color:#33691e
    classDef external fill:#ffccbc,stroke:#d84315,color:#bf360c
```
