# vsuraj25/microservices-demo-app architecture

> Architecture diagram of the GitHub repository vsuraj25/microservices-demo-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vsuraj25/microservices-demo-app
- Repository: https://github.com/vsuraj25/microservices-demo-app

## Overview

##### Project type and purpose
- This is a full-stack microservices demo application. It comprises three primary services (React frontend, Django admin, Flask API) that communicate via RabbitMQ and share a MySQL database. Docker Compose is used to spin up containers for each component.

##### File structure
- Top-level directories:
- admin/   – Django admin service
- main/   – Flask API service (contains main.py, producer.py, consumer.py, migrations/, requirements.txt, Dockerfile, docker-compose.yml, and a MySQL data volume under .dbdata/)
- react-app/ – React frontend (likely in react-crud subfolder)
- Under main/:
- migrations/ – Alembic migration scripts for schema versioning
- .dbdata/   – MySQL data directory (volume)
- producer.py, consumer.py, manager.py – RabbitMQ producers/consumers for async events
- Dockerfile & docker-compose.yml – service container definitions and orchestration

##### README for additional insights
- Architectural call-out: React UI, Django Admin (port 8000), Flask API (port 8001), RabbitMQ, MySQL, Docker.
- Features: CRUD on products, REST endpoints, event-driven via RabbitMQ.
- Technologies: React/TypeScript, Django, Flask, Python, RabbitMQ, MySQL, Docker.

a. Main components
- Browser/React App (port 3000)
- Django Admin Service (container, port 8000)
- Flask API Service (container, port 8001)
- RabbitMQ Broker (container, ports 5672 & 15672)
- MySQL Database (container, data volume at main/.dbdata)
- Worker(s) – the consumer.py process that subscribes to product events
b. Relationships & data flows
- React → HTTP → Flask API (CRUD REST calls)
- React → HTTP → Django Admin (admin API calls)
- Flask API → MySQL (sync DB reads/writes)
- Django Admin → MySQL (sync DB reads/writes)
- Flask API (producer.py) → AMQP → RabbitMQ
- Worker (consumer.py) ← AMQP ← RabbitMQ
c. Architectural patterns & design principles
- Microservices: each service in its own container
- Layered: UI layer (React), API layer (Flask & Django), persistence (MySQL), messaging layer (RabbitMQ)
- Event-driven: product create/update/delete events go through a message broker
- Infrastructure as code: Dockerfiles + docker-compose.yml define the entire environment
d. Key technologies/frameworks
- Frontend: React, TypeScript
- Admin backend: Django
- Main API: Flask, Python, Alembic for migrations
- Messaging: RabbitMQ
- Database: MySQL (persistent volume under main/.dbdata)
- Orchestration: Docker Compose

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Docker Compose"
        subgraph "React Frontend (port 3000)"
            React["React UI"]:::frontend
        end
        subgraph "Django Admin (port 8000)"
            Django["Django Admin"]:::backend
        end
        subgraph "Flask API Service"
            APIHTTP["HTTP Server\n(main.py)"]:::backend
            APIProd["Producer\n(producer.py)"]:::backend
            APIManager["Manager\n(manager.py)"]:::backend
            APIMig["Migrations\n(migrations/)"]:::backend
            APIReq["requirements.txt"]:::backend
            APIDocker["Dockerfile"]:::backend
        end
        Worker["Worker\n(consumer.py)"]:::backend
        Rabbit["RabbitMQ Broker\n5672/15672"]:::broker
        MySQL["MySQL Database\n3306\nVolume"]:::database
    end

    React -->|"HTTP"| APIHTTP
    React -->|"HTTP"| Django
    Django -->|"SQL"| MySQL
    APIHTTP -->|"SQL"| MySQL
    APIProd -.->|"AMQP"| Rabbit
    Rabbit -.->|"AMQP"| Worker
    Worker -->|"SQL"| MySQL

    click React "https://github.com/vsuraj25/microservices-demo-app/tree/master/react-app/react-crud"
    click Django "https://github.com/vsuraj25/microservices-demo-app/tree/master/admin/"
    click APIHTTP "https://github.com/vsuraj25/microservices-demo-app/blob/master/main/main.py"
    click APIProd "https://github.com/vsuraj25/microservices-demo-app/blob/master/main/producer.py"
    click Worker "https://github.com/vsuraj25/microservices-demo-app/blob/master/main/consumer.py"
    click APIManager "https://github.com/vsuraj25/microservices-demo-app/blob/master/main/manager.py"
    click APIReq "https://github.com/vsuraj25/microservices-demo-app/blob/master/main/requirements.txt"
    click APIDocker "https://github.com/vsuraj25/microservices-demo-app/tree/master/main/Dockerfile"
    click APIMig "https://github.com/vsuraj25/microservices-demo-app/tree/master/main/migrations/"
    click Rabbit "https://github.com/vsuraj25/microservices-demo-app/blob/master/main/docker-compose.yml"
    click MySQL "https://github.com/vsuraj25/microservices-demo-app/tree/master/main/.dbdata/"

    classDef frontend fill:#ddeeff,stroke:#000,stroke-width:1px
    classDef backend fill:#ddffdd,stroke:#000,stroke-width:1px
    classDef broker fill:#ffdead,stroke:#000,stroke-width:1px
    classDef database fill:#e0c0ff,stroke:#000,stroke-width:1px
```
