# urvan-nomads/ggi architecture

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

- Interactive diagram: https://gitdiagram.com/urvan-nomads/ggi
- Repository: https://github.com/urvan-nomads/ggi

## Overview

##### Project Type and Purpose
- Urban Nomad Server is a full-stack, server-rendered web application built with Spring Boot (Java 17) and Thymeleaf.

##### File Structure Analysis
- **Top-level**
- build.gradle, settings.gradle, gradlew scripts → Gradle-based Spring Boot project
- HELP.md, README.md → documentation
- **Source (src/main/java)**
- urbanNomadServer/UrbanNomadServerApplication.java → application entry point
- config/SecurityConfig.java → security setup
- controller/RouteController.java → REST endpoints (/departure, /waypoint, /done)
- service/RouteService.java → business logic (Tour API calls, Greedy+Haversine route algorithm)
- dto/*.java → data transfer objects for Tour API and geocode responses
- **Resources (src/main/resources)**
- application.yml/properties → external config (API keys, endpoints)
- static/ → CSS, JS (naver-map.js, travel-data.js, travel-map.js)
- templates/result.html → Thymeleaf template for SSR result page
- **Tests**
- UrbanNomadServerApplicationTests.java

##### README Insights
- **Architecture**: LLM Playground (chat) uses Function Calling/API Connector to invoke backend endpoints.
- **External Dependencies**:
- KoreanTourAPI (tourapi.service-key)
- Naver Maps API (client_id, secret)
- Wanted LaaS platform
- **Business Flow**:
1. User enters travel request in chat
2. LLM selects API Connector → calls /departure, /waypoint, /done sequentially
3. Backend fetches data, computes optimal route, generates SSR page
4. User views page in browser; map JS renders on page

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client Layer"
        User["User"]:::client
        ChatUI["Chat UI"]:::client
    end

    User -->|"interact"| ChatUI
    ChatUI -->|"user input"| Playground

    subgraph "LLM Platform"
        Playground["Playground"]:::llm
        APIConnector["API Connector"]:::llm
        FunctionCalling["Function Calling"]:::llm
    end

    ChatUI --> Playground
    Playground --> APIConnector
    APIConnector --> FunctionCalling
    FunctionCalling -->|"calls GET /departure,/waypoint,/done"| RouteController

    subgraph "Spring Boot Backend"
        UrbanNomadServerApplication["UrbanNomadServerApplication"]:::backend
        SecurityConfig["SecurityConfig"]:::backend
        RouteController["RouteController"]:::backend
        RouteService["RouteService"]:::backend
        subgraph "DTOs"
            TourApiResponse["TourApiResponse"]:::backend
            NaverGeocodeResponse["NaverGeocodeResponse"]:::backend
        end
        subgraph "Configuration"
            applicationYml["application.yml"]:::backend
            applicationProperties["application.properties"]:::backend
        end
        subgraph "Templates & Static Assets"
            resultHtml["result.html"]:::backend
            naverMapJs["naver-map.js"]:::backend
            travelDataJs["travel-data.js"]:::backend
            travelMapJs["travel-map.js"]:::backend
            styleCss["style.css"]:::backend
        end
        AppTests["UrbanNomadServerApplicationTests"]:::backend
        buildGradle["build.gradle"]:::backend
        settingsGradle["settings.gradle"]:::backend
        readme["README.md"]:::backend
        helpMd["HELP.md"]:::backend
    end

    FunctionCalling --> RouteController
    RouteController -->|"delegates to"| RouteService
    RouteService -->|"uses DTO"| TourApiResponse
    RouteService -->|"uses DTO"| NaverGeocodeResponse
    RouteService -->|"loads config"| applicationYml
    RouteService -->|"loads config"| applicationProperties
    RouteService -->|"generates SSR page"| resultHtml

    subgraph "External APIs"
        KoreanTourAPI["Korean Tourism API"]:::external
        NaverMapsREST["Naver Maps REST API"]:::external
    end

    RouteService -->|"REST call"| KoreanTourAPI
    RouteService -->|"REST call"| NaverMapsREST

    resultHtml -->|"render SSR"| Browser["Browser UI"]:::client
    Browser -->|"loads"| naverMapJs
    Browser -->|"loads"| travelDataJs
    Browser -->|"loads"| travelMapJs
    Browser -->|"loads"| styleCss
    Browser -->|"requests tiles"| NaverMapsREST

    click UrbanNomadServerApplication "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/java/urbanNomadServer/UrbanNomadServerApplication.java"
    click SecurityConfig "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/java/urbanNomadServer/config/SecurityConfig.java"
    click RouteController "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/java/urbanNomadServer/controller/RouteController.java"
    click RouteService "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/java/urbanNomadServer/service/RouteService.java"
    click TourApiResponse "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/java/urbanNomadServer/dto/TourApiResponse.java"
    click NaverGeocodeResponse "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/java/urbanNomadServer/dto/NaverGeocodeResponse.java"
    click applicationYml "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/resources/application.yml"
    click applicationProperties "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/resources/application.properties"
    click resultHtml "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/resources/templates/result.html"
    click naverMapJs "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/resources/static/js/naver-map.js"
    click travelDataJs "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/resources/static/js/travel-data.js"
    click travelMapJs "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/resources/static/js/travel-map.js"
    click styleCss "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/main/resources/static/css/style.css"
    click AppTests "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/src/test/java/urbanNomadServer/UrbanNomadServerApplicationTests.java"
    click buildGradle "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/build.gradle"
    click settingsGradle "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/settings.gradle"
    click readme "https://github.com/urvan-nomads/ggi/blob/main/README.md"
    click helpMd "https://github.com/urvan-nomads/ggi/blob/main/urban-nomad-server/HELP.md"

    classDef client fill:#A9DFBF,stroke:#2E7D32,stroke-width:2px
    classDef backend fill:#D6EAF8,stroke:#1B4F72,stroke-width:2px
    classDef external fill:#FAD7A0,stroke:#B9770E,stroke-width:2px
    classDef llm fill:#F5B7B1,stroke:#922B21,stroke-width:2px
```
