# in28minutes/docker-interview-guide architecture

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

- Interactive diagram: https://gitdiagram.com/in28minutes/docker-interview-guide
- Repository: https://github.com/in28minutes/docker-interview-guide

## Overview

##### Project type and purpose
- This is a **Docker Interview Guide** repository containing two main categories:
a. **Hello-World Apps** (Java, Node.js, Python) – simple containerized REST examples
b. **Microservices** (Currency Exchange & Currency Conversion) – a two-service Spring Boot demo orchestrated via Docker Compose

##### File structure
- Top level:
- .gitignore, README.md
- hello-world/ (three language demos + its own README)
- microservices/ (two Spring Boot services + docker-compose.yml + its README)
- Under hello-world: each subfolder has a minimal app, a Dockerfile, language-specific source, and a readme.md
- Under microservices:
- 01-currency-exchange-microservice-basic/ (Spring Boot app reading H2 DB, exposing REST endpoints)
- 02-currency-conversion-microservice-basic/ (Spring Boot app that calls the exchange service via a Feign proxy)
- docker-compose.yml to build and run both containers on a shared Docker network

##### Key insights from the README
- Purpose: hands-on Docker/containerization/microservices examples
- Each folder is self-contained: has build instructions + Dockerfile
- Microservices section emphasizes how the two services collaborate and how to bring them up together

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Hello-World Demos
    subgraph "Hello-World Demos"
        direction TB
        subgraph "Java App"
            direction TB
            JSrc["Source & Code"]:::build
            JDocker["Dockerfile"]:::build
        end
        JSrc --> JDocker --> JImage["Docker Image"]:::build --> JContainer["Java Hello-World Container (8080)"]:::container

        subgraph "Node.js App"
            direction TB
            NSrc["Source & Code"]:::build
            NDocker["Dockerfile"]:::build
        end
        NSrc --> NDocker --> NImage["Docker Image"]:::build --> NContainer["Node.js Hello-World Container (8080)"]:::container

        subgraph "Python App"
            direction TB
            PSrc["Source & Code"]:::build
            PDocker["Dockerfile"]:::build
        end
        PSrc --> PDocker --> PImage["Docker Image"]:::build --> PContainer["Python Hello-World Container (8080)"]:::container
    end

    Client["Client (curl/browser)"]:::client
    JContainer -->|"REST"| Client
    NContainer -->|"REST"| Client
    PContainer -->|"REST"| Client

    %% Microservices Demo
    DockerCompose["docker-compose.yml"]:::build

    subgraph "Docker Compose Orchestration"
        direction TB
        DockerCompose -->|"builds & runs"| ExContainer
        DockerCompose -->|"builds & runs"| CoContainer

        subgraph "Docker Network"
            direction TB
            subgraph "Currency Exchange Service"
                direction TB
                ExDocker["Dockerfile"]:::build
                ExEntry["CurrencyExchangeServiceApplicationH2.java"]:::build
                ExController["CurrencyExchangeController.java"]:::build
                ExEntity["ExchangeValue.java"]:::build
                ExRepo["ExchangeValueRepository.java"]:::build
                ExInit["data.sql"]:::build
                ExSecurity["SecurityConfiguration.java"]:::build
                ExDocker --> ExEntry --> ExController --> ExEntity --> ExRepo --> ExInit --> ExSecurity --> ExContainer["Currency Exchange Container (8000)"]:::container
            end

            subgraph "Currency Conversion Service"
                direction TB
                CoDocker["Dockerfile"]:::build
                CoEntry["CurrencyConversionServiceApplication.java"]:::build
                CoController["CurrencyConversionController.java"]:::build
                CoBean["CurrencyConversionBean.java"]:::build
                CoProxy["CurrencyExchangeServiceProxy.java"]:::build
                CoSecurity["SecurityConfiguration.java"]:::build
                CoDocker --> CoEntry --> CoController --> CoBean --> CoProxy --> CoSecurity --> CoContainer["Currency Conversion Container (8100)"]:::container
            end
        end
    end

    %% Microservice interactions
    Client -->|"HTTP GET /currency-conversion"| CoContainer
    CoContainer -->|"Feign GET /currency-exchange"| ExContainer
    ExContainer -->|"JDBC/H2"| H2DB["H2 Database"]:::db

    %% Click Events
    click JSrc "https://github.com/in28minutes/docker-interview-guide/tree/main/hello-world/hello-world-java"
    click NSrc "https://github.com/in28minutes/docker-interview-guide/tree/main/hello-world/hello-world-nodejs"
    click PSrc "https://github.com/in28minutes/docker-interview-guide/tree/main/hello-world/hello-world-python"
    click DockerCompose "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/docker-compose.yml"
    click ExDocker "https://github.com/in28minutes/docker-interview-guide/tree/main/microservices/01-currency-exchange-microservice-basic/Dockerfile"
    click ExEntry "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/01-currency-exchange-microservice-basic/src/main/java/com/in28minutes/microservices/currencyexchangeservice/CurrencyExchangeServiceApplicationH2.java"
    click ExController "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/01-currency-exchange-microservice-basic/src/main/java/com/in28minutes/microservices/currencyexchangeservice/resource/CurrencyExchangeController.java"
    click ExEntity "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/01-currency-exchange-microservice-basic/src/main/java/com/in28minutes/microservices/currencyexchangeservice/resource/ExchangeValue.java"
    click ExRepo "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/01-currency-exchange-microservice-basic/src/main/java/com/in28minutes/microservices/currencyexchangeservice/resource/ExchangeValueRepository.java"
    click ExInit "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/01-currency-exchange-microservice-basic/src/main/resources/data.sql"
    click ExSecurity "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/01-currency-exchange-microservice-basic/src/main/java/com/in28minutes/microservices/currencyexchangeservice/security/SecurityConfiguration.java"
    click CoDocker "https://github.com/in28minutes/docker-interview-guide/tree/main/microservices/02-currency-conversion-microservice-basic/Dockerfile"
    click CoEntry "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/02-currency-conversion-microservice-basic/src/main/java/com/in28minutes/microservices/currencyconversionservice/CurrencyConversionServiceApplication.java"
    click CoController "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/02-currency-conversion-microservice-basic/src/main/java/com/in28minutes/microservices/currencyconversionservice/resource/CurrencyConversionController.java"
    click CoBean "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/02-currency-conversion-microservice-basic/src/main/java/com/in28minutes/microservices/currencyconversionservice/resource/CurrencyConversionBean.java"
    click CoProxy "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/02-currency-conversion-microservice-basic/src/main/java/com/in28minutes/microservices/currencyconversionservice/resource/CurrencyExchangeServiceProxy.java"
    click CoSecurity "https://github.com/in28minutes/docker-interview-guide/blob/main/microservices/02-currency-conversion-microservice-basic/src/main/java/com/in28minutes/microservices/currencyconversionservice/security/SecurityConfiguration.java"

    %% Styles
    classDef build fill:#D6E9F8,stroke:#31708F,color:#31708F;
    classDef container fill:#DFF0D8,stroke:#3C763D,color:#3C763D;
    classDef client fill:#F5F5F5,stroke:#333333,color:#333333;
    classDef db fill:#E0E0E0,stroke:#666666,color:#666666;
```
