# kellyrestrepo65/nexusmarket architecture

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

- Interactive diagram: https://gitdiagram.com/kellyrestrepo65/nexusmarket
- Repository: https://github.com/kellyrestrepo65/nexusmarket

## Overview

NexusMarket is a multi-role marketplace with REST and Thymeleaf entry points, shared domain use cases, and MySQL/MongoDB persistence. Its principal buyer workflow spans catalog browsing, cart management, checkout, payment, fulfillment, and returns; seller, inventory, administration, reporting, and user-management capabilities are also represented. The README documents the hexagonal boundaries; sampled source confirms selected domain dependencies. Some unsampled subsystems are therefore shown at directory level, without inferred internal call chains.

Main entry points: [`src/main/java/com/nexusmarket/application/adapters/in/web/controllers`](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/in/web/controllers) (Thymeleaf web), [`src/main/java/com/nexusmarket/application/adapters/in/rest/controllers`](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/in/rest/controllers) (REST API), [`src/main/java/com/nexusmarket/domain/services/order`](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/order) (Order services), [`src/main/java/com/nexusmarket/application/adapters/out/persistence/mysql/adapters`](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/out/persistence/mysql/adapters) (MySQL adapters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry adapters"]
  node_web["Thymeleaf web"]
  node_rest["REST API"]
end

subgraph group_commerce["Commerce domain"]
  node_cart["Cart services"]
  node_catalog["Catalog services"]
  node_checkout["Order services"]
  node_product_model["Product model<br/>[Product.java]"]
  node_order_model["Order model<br/>[Order.java]"]
  node_order_status["Order status<br/>[OrderStatus.java]"]
end

subgraph group_operations["Operations domain"]
  node_inventory_services["Inventory services"]
  node_inventory_model["Inventory model<br/>[Inventory.java]"]
  node_returns["Returns services"]
  node_logistics["Logistics services"]
  node_reports["Reporting services"]
  node_users["User services"]
  node_authorization["Authorization"]
  node_order_loader["Order loader<br/>[OrderLoader.java]"]
end

subgraph group_storage["Persistence adapters"]
  node_mysql_adapters["MySQL adapters"]
  node_mongo_adapter["Product Mongo adapter"]
end

node_browser(("Browser"))
node_rest_client(("REST client"))
node_mysql[("MySQL")]
node_mongodb[("MongoDB")]

node_browser -->|"uses"| node_web
node_rest_client -->|"calls"| node_rest
node_web -->|"invokes use cases"| node_cart
node_web -->|"invokes use cases"| node_catalog
node_web -->|"invokes use cases"| node_checkout
node_web -->|"invokes use cases"| node_inventory_services
node_web -->|"invokes use cases"| node_returns
node_web -->|"invokes use cases"| node_reports
node_web -->|"invokes use cases"| node_users
node_rest -->|"invokes use cases"| node_cart
node_rest -->|"invokes use cases"| node_catalog
node_rest -->|"invokes use cases"| node_checkout
node_rest -->|"invokes use cases"| node_inventory_services
node_rest -->|"invokes use cases"| node_returns
node_rest -->|"invokes use cases"| node_reports
node_rest -->|"invokes use cases"| node_users
node_checkout -->|"creates and advances"| node_order_model
node_order_model -->|"checks transitions"| node_order_status
node_checkout -->|"uses inventory"| node_inventory_model
node_catalog -->|"reads catalog"| node_product_model
node_authorization -->|"loads active user"| node_users
node_order_loader -->|"loads orders and products"| node_checkout
node_checkout -.->|"uses repository ports"| node_mysql_adapters
node_inventory_services -.->|"uses repository ports"| node_mysql_adapters
node_returns -.->|"uses repository ports"| node_mysql_adapters
node_users -.->|"uses repository ports"| node_mysql_adapters
node_catalog -.->|"uses product port"| node_mongo_adapter
node_mysql_adapters -->|"persists data"| node_mysql
node_mongo_adapter -->|"persists products"| node_mongodb

click node_web "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/in/web/controllers"
click node_rest "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/in/rest/controllers"
click node_cart "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/cart"
click node_catalog "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/catalog"
click node_checkout "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/order"
click node_product_model "https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/models/catalog/Product.java"
click node_order_model "https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/models/order/Order.java"
click node_order_status "https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/enums/OrderStatus.java"
click node_inventory_services "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/inventory"
click node_inventory_model "https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/models/inventory/Inventory.java"
click node_returns "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/returns"
click node_logistics "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/logistics"
click node_reports "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/report"
click node_users "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/user"
click node_authorization "https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/services/security/AuthorizationService.java"
click node_order_loader "https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/services/order/OrderLoader.java"
click node_mysql_adapters "https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/out/persistence/mysql/adapters"
click node_mongo_adapter "https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/application/adapters/out/persistence/mongodb/adapters/ProductMongoAdapter.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_rest,node_browser,node_rest_client toneBlue
class node_cart,node_catalog,node_checkout,node_product_model,node_order_model,node_order_status,node_mysql,node_mongodb toneAmber
class node_inventory_services,node_inventory_model,node_returns,node_logistics,node_reports,node_users,node_authorization,node_order_loader toneMint
class node_mysql_adapters,node_mongo_adapter toneRose
```

## Components

### Entry adapters

- [Thymeleaf web](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/in/web/controllers): `src/main/java/com/nexusmarket/application/adapters/in/web/controllers`
- [REST API](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/in/rest/controllers): `src/main/java/com/nexusmarket/application/adapters/in/rest/controllers`

### Commerce domain

- [Cart services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/cart): `src/main/java/com/nexusmarket/domain/services/cart`
- [Catalog services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/catalog): `src/main/java/com/nexusmarket/domain/services/catalog`
- [Order services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/order): `src/main/java/com/nexusmarket/domain/services/order`
- [Product model](https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/models/catalog/Product.java): `src/main/java/com/nexusmarket/domain/models/catalog/Product.java`
- [Order model](https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/models/order/Order.java): `src/main/java/com/nexusmarket/domain/models/order/Order.java`
- [Order status](https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/enums/OrderStatus.java): `src/main/java/com/nexusmarket/domain/enums/OrderStatus.java`

### Operations domain

- [Inventory services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/inventory): `src/main/java/com/nexusmarket/domain/services/inventory`
- [Inventory model](https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/models/inventory/Inventory.java): `src/main/java/com/nexusmarket/domain/models/inventory/Inventory.java`
- [Returns services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/returns): `src/main/java/com/nexusmarket/domain/services/returns`
- [Logistics services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/logistics): `src/main/java/com/nexusmarket/domain/services/logistics`
- [Reporting services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/report): `src/main/java/com/nexusmarket/domain/services/report`
- [User services](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/domain/services/user): `src/main/java/com/nexusmarket/domain/services/user`
- [Authorization](https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/services/security/AuthorizationService.java): `src/main/java/com/nexusmarket/domain/services/security/AuthorizationService.java`
- [Order loader](https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/domain/services/order/OrderLoader.java): `src/main/java/com/nexusmarket/domain/services/order/OrderLoader.java`

### Persistence adapters

- [MySQL adapters](https://github.com/kellyrestrepo65/nexusmarket/tree/main/src/main/java/com/nexusmarket/application/adapters/out/persistence/mysql/adapters): `src/main/java/com/nexusmarket/application/adapters/out/persistence/mysql/adapters`
- [Product Mongo adapter](https://github.com/kellyrestrepo65/nexusmarket/blob/main/src/main/java/com/nexusmarket/application/adapters/out/persistence/mongodb/adapters/ProductMongoAdapter.java): `src/main/java/com/nexusmarket/application/adapters/out/persistence/mongodb/adapters/ProductMongoAdapter.java`

### Other components

- **Browser**
- **REST client**
- **MySQL**
- **MongoDB**

## Connections

- Browser → Thymeleaf web: uses
- REST client → REST API: calls
- Thymeleaf web → Cart services: invokes use cases
- Thymeleaf web → Catalog services: invokes use cases
- Thymeleaf web → Order services: invokes use cases
- Thymeleaf web → Inventory services: invokes use cases
- Thymeleaf web → Returns services: invokes use cases
- Thymeleaf web → Reporting services: invokes use cases
- Thymeleaf web → User services: invokes use cases
- REST API → Cart services: invokes use cases
- REST API → Catalog services: invokes use cases
- REST API → Order services: invokes use cases
- REST API → Inventory services: invokes use cases
- REST API → Returns services: invokes use cases
- REST API → Reporting services: invokes use cases
- REST API → User services: invokes use cases
- Order services → Order model: creates and advances (evidence: `src/main/java/com/nexusmarket/domain/services/order/CheckoutService.java`)
- Order model → Order status: checks transitions (evidence: `src/main/java/com/nexusmarket/domain/models/order/Order.java`)
- Order services → Inventory model: uses inventory (evidence: `src/main/java/com/nexusmarket/domain/services/order/CheckoutService.java`)
- Catalog services → Product model: reads catalog (evidence: `src/main/java/com/nexusmarket/domain/services/catalog/ConsultCatalogService.java`)
- Authorization → User services: loads active user (evidence: `src/main/java/com/nexusmarket/domain/services/security/AuthorizationService.java`)
- Order loader → Order services: loads orders and products (evidence: `src/main/java/com/nexusmarket/domain/services/order/OrderLoader.java`)
- Order services → MySQL adapters: uses repository ports
- Inventory services → MySQL adapters: uses repository ports
- Returns services → MySQL adapters: uses repository ports
- User services → MySQL adapters: uses repository ports
- Catalog services → Product Mongo adapter: uses product port
- MySQL adapters → MySQL: persists data
- Product Mongo adapter → MongoDB: persists products
