# poridhioss/e-commerce-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/poridhioss/e-commerce-microservices
- Repository: https://github.com/poridhioss/e-commerce-microservices

## Overview

##### Project Type and Purpose
- This is a full-blown microservices-based e-commerce backend. It consists of four loosely coupled Python FastAPI services—user, product, inventory, and order—plus an NGINX API gateway and per-service databases. Its goal is to enable user management, product CRUD with automatic inventory creation, and order processing (including inventory reservation).

##### File Structure Insights
- Top-level orchestrator: docker-compose.yml
- “nginx/”: API gateway configuration and Dockerfile
- Four service folders, each with its own Dockerfile, .env, docker-compose.yml, requirements.txt, and a FastAPI app under app/ with subfolders:
- api/routes (HTTP endpoints)
- core (config, logging, security)
- db (Postgres or MongoDB client wrappers)
- models and services (business logic)
- Each service persists to its own database (PostgreSQL for user & inventory, MongoDB for product & order).

##### Key Architecture Details from README
- All services are spun up via root docker-compose up.
- Client commands hit endpoints under /api/v1/**.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Top layer: External Client
    OC["External Client"]:::external

    %% API Gateway
    NGINX["NGINX API Gateway"]:::gateway

    %% Microservices layer
    US["User Service"]:::userService
    PS["Product Service"]:::productService
    ISV["Inventory Service"]:::inventoryService
    OSRV["Order Service"]:::orderService

    %% Databases layer
    UPG["User DB (PostgreSQL)"]:::database
    PSG["Product DB (MongoDB)"]:::database
    IVDB["Inventory DB (PostgreSQL)"]:::database
    ODB["Order DB (MongoDB)"]:::database

    %% Orchestrator
    ORCH["Docker Compose"]:::orchestrator

    %% Client to Gateway
    OC -->|"HTTP/REST"| NGINX

    %% Gateway to Services
    NGINX -->|"REST /auth,/users"| US
    NGINX -->|"REST /products"| PS
    NGINX -->|"REST /inventory"| ISV
    NGINX -->|"REST /orders"| OSRV

    %% Inter-service calls (dashed)
    PS -.->|"POST /inventory REST"| ISV
    OSRV -.->|"GET /users REST"| US
    OSRV -.->|"GET /products REST"| PS
    OSRV -.->|"POST /inventory/reserve REST"| ISV

    %% Services to their Databases
    US -->|"SQL"| UPG
    PS -->|"NoSQL"| PSG
    ISV -->|"SQL"| IVDB
    OSRV -->|"NoSQL"| ODB

    %% Orchestrator to containers
    ORCH -.-> NGINX
    ORCH -.-> US
    ORCH -.-> PS
    ORCH -.-> ISV
    ORCH -.-> OSRV

    %% Click Events
    click ORCH "https://github.com/poridhioss/e-commerce-microservices/blob/main/docker-compose.yml"
    click NGINX "https://github.com/poridhioss/e-commerce-microservices/tree/main/nginx/Dockerfile"
    click NGINX "https://github.com/poridhioss/e-commerce-microservices/blob/main/nginx/nginx.conf"
    click NGINX "https://github.com/poridhioss/e-commerce-microservices/blob/main/nginx/conf.d/default.conf"
    click US "https://github.com/poridhioss/e-commerce-microservices/tree/main/user-service/"
    click US "https://github.com/poridhioss/e-commerce-microservices/tree/main/user-service/Dockerfile"
    click US "https://github.com/poridhioss/e-commerce-microservices/blob/main/user-service/.env"
    click US "https://github.com/poridhioss/e-commerce-microservices/blob/main/user-service/app/api/routes/auth.py"
    click US "https://github.com/poridhioss/e-commerce-microservices/blob/main/user-service/app/api/routes/users.py"
    click US "https://github.com/poridhioss/e-commerce-microservices/blob/main/user-service/app/core/config.py"
    click US "https://github.com/poridhioss/e-commerce-microservices/blob/main/user-service/app/core/security.py"
    click US "https://github.com/poridhioss/e-commerce-microservices/blob/main/user-service/app/db/postgresql.py"
    click US "https://github.com/poridhioss/e-commerce-microservices/blob/main/user-service/app/main.py"
    click PS "https://github.com/poridhioss/e-commerce-microservices/tree/main/product-service/"
    click PS "https://github.com/poridhioss/e-commerce-microservices/tree/main/product-service/Dockerfile"
    click PS "https://github.com/poridhioss/e-commerce-microservices/blob/main/product-service/.env"
    click PS "https://github.com/poridhioss/e-commerce-microservices/blob/main/product-service/app/api/routes/products.py"
    click PS "https://github.com/poridhioss/e-commerce-microservices/blob/main/product-service/app/core/config.py"
    click PS "https://github.com/poridhioss/e-commerce-microservices/blob/main/product-service/app/db/mongodb.py"
    click PS "https://github.com/poridhioss/e-commerce-microservices/blob/main/product-service/app/main.py"
    click PS "https://github.com/poridhioss/e-commerce-microservices/blob/main/product-service/app/services/inventory_service.py"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/tree/main/inventory-service/"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/tree/main/inventory-service/Dockerfile"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/blob/main/inventory-service/.env"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/blob/main/inventory-service/app/api/routes/inventory.py"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/blob/main/inventory-service/app/core/config.py"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/blob/main/inventory-service/app/core/logging.py"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/blob/main/inventory-service/app/db/postgresql.py"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/blob/main/inventory-service/app/main.py"
    click ISV "https://github.com/poridhioss/e-commerce-microservices/blob/main/inventory-service/app/services/product.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/tree/main/order-service/"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/tree/main/order-service/Dockerfile"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/.env"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/api/routes/orders.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/core/config.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/core/logging.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/db/mongodb.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/main.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/services/user.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/services/product.py"
    click OSRV "https://github.com/poridhioss/e-commerce-microservices/blob/main/order-service/app/services/inventory.py"

    %% Styles
    classDef external fill:#E0F7FA,stroke:#006064,stroke-width:2px
    classDef gateway fill:#FFF3E0,stroke:#E65100,stroke-width:2px
    classDef userService fill:#E3F2FD,stroke:#1E88E5,stroke-width:2px
    classDef productService fill:#E8F5E9,stroke:#43A047,stroke-width:2px
    classDef inventoryService fill:#FFEBEE,stroke:#E53935,stroke-width:2px
    classDef orderService fill:#F3E5F5,stroke:#8E24AA,stroke-width:2px
    classDef database fill:#ECEFF1,stroke:#455A64,stroke-width:2px,shape:cylinder
    classDef orchestrator fill:#F5F5F5,stroke:#9E9E9E,stroke-dasharray:5 5
```
