# alessandrocavaglia/taas-2021-backend architecture

> Architecture diagram of the GitHub repository alessandrocavaglia/taas-2021-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alessandrocavaglia/taas-2021-backend
- Repository: https://github.com/alessandrocavaglia/taas-2021-backend

## Overview

##### Project type and purpose
- This is a Java-based microservices backend for an online second-hand trading app (TAAS course).
- It consists of two domain services (User and Product), a service registry (Discovery/Eureka), an API gateway (Zuul), and a RabbitMQ broker.
- It’s deployable via Docker and Kubernetes.

##### File structure
- Top-level microservice folders:
– discovery-service: Eureka server to register and discover all services
– api-gateway: Netflix Zuul proxy routing client calls to microservices
– user-microservice: Spring Boot service managing users and Facebook integration
– product-microservice: Spring Boot service managing products, matches, tokens
- Messaging config: rabbitMQ.yaml at root for broker setup
- Deployment artifacts per service: Dockerfile, docker-compose.yml, deployment.yaml
- Parent pom.xml orchestrates multi-module build

##### README for additional insights
- Confirms use of Eureka for service discovery and Zuul for API gateway
- RabbitMQ as message broker between the two domain services
- Emphasis on containerization (Docker/ Kubernetes)

##### Detail
- Microservice’s registration with Eureka
- How API Gateway dynamically routes based on Eureka metadata
- Both synchronous HTTP calls and asynchronous message exchanges

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["External Client (Web/Mobile)"]:::client

    subgraph "Kubernetes Cluster / Docker Host"
        direction TB
        Eureka["Service Registry (Eureka)"]:::core
        Gateway["API Gateway (Zuul)"]:::gateway
        User["User Microservice"]:::core
        Product["Product Microservice"]:::core
        RabbitMQ["RabbitMQ Broker"]:::data
        UserDB["User Database"]:::db
        ProductDB["Product Database"]:::db
    end

    POM["Parent Multi-Module POM"]:::infra
    README["README.md"]:::infra
    DEMO["demo.adoc"]:::infra

    Client -->|"HTTP calls /api/**"| Gateway
    Gateway -->|"register & discover"| Eureka
    Gateway -->|"route to user-svc"| User
    Gateway -->|"route to product-svc"| Product

    User -->|"register"| Eureka
    Product -->|"register"| Eureka

    User -->|"publish/subscribe AMQP"| RabbitMQ
    Product -->|"publish/subscribe AMQP"| RabbitMQ

    User -->|"JDBC"| UserDB
    Product -->|"JDBC"| ProductDB

    click Gateway "https://github.com/alessandrocavaglia/taas-2021-backend/tree/master/api-gateway/"
    click Eureka "https://github.com/alessandrocavaglia/taas-2021-backend/tree/master/discovery-service/"
    click User "https://github.com/alessandrocavaglia/taas-2021-backend/tree/master/user-microservice/"
    click Product "https://github.com/alessandrocavaglia/taas-2021-backend/tree/master/product-microservice/"
    click RabbitMQ "https://github.com/alessandrocavaglia/taas-2021-backend/blob/master/rabbitMQ.yaml"
    click POM "https://github.com/alessandrocavaglia/taas-2021-backend/blob/master/pom.xml"
    click README "https://github.com/alessandrocavaglia/taas-2021-backend/blob/master/README.md"
    click DEMO "https://github.com/alessandrocavaglia/taas-2021-backend/blob/master/demo.adoc"

    classDef client fill:#D6EAF8,stroke:#21618C,color:#000
    classDef gateway fill:#D5F5E3,stroke:#196F3D,color:#000
    classDef core fill:#FDEBD0,stroke:#B9770E,color:#000
    classDef data fill:#E8DAEF,stroke:#6C3483,color:#000
    classDef db fill:#E8DAEF,stroke:#6C3483,color:#000
    classDef infra fill:#F2F3F4,stroke:#626567,color:#000
```
