# zogurf/herramientas-backend architecture

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

- Interactive diagram: https://gitdiagram.com/zogurf/herramientas-backend
- Repository: https://github.com/zogurf/herramientas-backend

## Overview

NEXORA is a Spring REST backend for store catalog and logistics features. The main user workflow is to authenticate, browse products and categories, and consult an order’s tracking history; administrators additionally manage catalog and inventory, including filtered statistics and Excel/PDF exports. Authentication also supports profile/avatar updates and password recovery. The graph separates HTTP entry points, domain services, persistence, and integrations. Relationships are limited to calls shown in excerpts, repository references in the source index, or README-documented capabilities; unsampled package and order behavior is not expanded beyond documented features.

Main entry points: [`src/main/java/com/logistics/proyect/group5/service/CategoryService.java`](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/CategoryService.java) (Category Management), [`src/main/java/com/logistics/proyect/group5/service/ProductService.java`](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/ProductService.java) (Product & Inventory), [`src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java`](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java) (Admin Inventory API), [`src/main/java/com/logistics/proyect/group5/service/AuthService.java`](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/AuthService.java) (Authentication & Profile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_auth_api["Authentication API"]
  node_catalog_api["Public Catalog API"]
  node_category_api["Category API"]
  node_admin_products["Admin Inventory API"]
  node_admin_categories["Admin Categories API"]
  node_tracking_api["Order Tracking API"]
end

subgraph group_domain["Domain Services"]
  node_auth_service["Authentication &amp; Profile<br/>[AuthService.java]"]
  node_product_service["Product &amp; Inventory"]
  node_category_service["Category Management"]
  node_tracking_service["Tracking Events"]
  node_export_service["Inventory Exports"]
  node_image_service["Image Handling"]
  node_email_service["Recovery Email<br/>[EmailService.java]"]
end

subgraph group_persistence["Persistence"]
  node_product_repo["Product Repository"]
  node_category_repo["Category Repository"]
  node_user_repo["User Repository"]
  node_tracking_repo["Tracking Repository"]
  node_order_repo["Order Repository"]
end

subgraph group_integrations["External Integrations"]
  node_postgres[("PostgreSQL")]
  node_cloudinary["Cloudinary"]
  node_smtp["SMTP Mail"]
end

node_shopper(("Shopper / Admin"))

node_shopper -->|"authenticates"| node_auth_api
node_shopper -->|"browses"| node_catalog_api
node_shopper -->|"browses"| node_category_api
node_shopper -->|"checks history"| node_tracking_api
node_auth_api -->|"delegates to"| node_auth_service
node_catalog_api -->|"delegates to"| node_product_service
node_category_api -->|"delegates to"| node_category_service
node_admin_products -->|"delegates to"| node_product_service
node_admin_products -->|"uses categories"| node_category_service
node_admin_products -->|"exports inventory"| node_export_service
node_admin_products -->|"uploads / deletes"| node_image_service
node_admin_categories -->|"delegates to"| node_category_service
node_tracking_api -->|"delegates to"| node_tracking_service
node_auth_service -->|"reads / writes users"| node_user_repo
node_auth_service -->|"uploads avatar"| node_image_service
node_auth_service -->|"sends recovery mail"| node_email_service
node_product_service -->|"queries / saves"| node_product_repo
node_product_service -->|"resolves categories"| node_category_service
node_category_service -->|"queries / saves"| node_category_repo
node_category_service -->|"checks product use"| node_product_repo
node_tracking_service -->|"checks order"| node_order_repo
node_tracking_service -->|"saves / lists events"| node_tracking_repo
node_export_service -->|"reads products"| node_product_service
node_product_repo -.->|"persists catalog"| node_postgres
node_category_repo -.->|"persists categories"| node_postgres
node_user_repo -.->|"persists accounts"| node_postgres
node_tracking_repo -.->|"persists events"| node_postgres
node_order_repo -.->|"reads orders"| node_postgres
node_image_service -->|"uploads / deletes"| node_cloudinary
node_email_service -.->|"sends email"| node_smtp

click node_auth_api "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/AuthController.java"
click node_catalog_api "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/ProductController.java"
click node_category_api "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/CategoryController.java"
click node_admin_products "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java"
click node_admin_categories "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/AdminCategoryController.java"
click node_tracking_api "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/TrackingController.java"
click node_auth_service "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/AuthService.java"
click node_product_service "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/ProductService.java"
click node_category_service "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/CategoryService.java"
click node_tracking_service "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/TrackingService.java"
click node_export_service "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/InventoryExportService.java"
click node_image_service "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/CloudinaryService.java"
click node_email_service "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/EmailService.java"
click node_product_repo "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/ProductRepository.java"
click node_category_repo "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/CategoryRepository.java"
click node_user_repo "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/UserRepository.java"
click node_tracking_repo "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/TrackingEventRepository.java"
click node_order_repo "https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/OrderRepository.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_auth_api,node_catalog_api,node_category_api,node_admin_products,node_admin_categories,node_tracking_api toneBlue
class node_auth_service,node_product_service,node_category_service,node_tracking_service,node_export_service,node_image_service,node_email_service toneAmber
class node_product_repo,node_category_repo,node_user_repo,node_tracking_repo,node_order_repo toneMint
class node_postgres,node_cloudinary,node_smtp toneRose
class node_shopper toneIndigo
```

## Components

### HTTP API

- [Authentication API](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/AuthController.java): `src/main/java/com/logistics/proyect/group5/controller/AuthController.java`
- [Public Catalog API](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/ProductController.java): `src/main/java/com/logistics/proyect/group5/controller/ProductController.java`
- [Category API](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/CategoryController.java): `src/main/java/com/logistics/proyect/group5/controller/CategoryController.java`
- [Admin Inventory API](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java): `src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java`
- [Admin Categories API](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/AdminCategoryController.java): `src/main/java/com/logistics/proyect/group5/controller/AdminCategoryController.java`
- [Order Tracking API](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/controller/TrackingController.java): `src/main/java/com/logistics/proyect/group5/controller/TrackingController.java`

### Domain Services

- [Authentication & Profile](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/AuthService.java): `src/main/java/com/logistics/proyect/group5/service/AuthService.java`
- [Product & Inventory](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/ProductService.java): `src/main/java/com/logistics/proyect/group5/service/ProductService.java`
- [Category Management](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/CategoryService.java): `src/main/java/com/logistics/proyect/group5/service/CategoryService.java`
- [Tracking Events](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/TrackingService.java): `src/main/java/com/logistics/proyect/group5/service/TrackingService.java`
- [Inventory Exports](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/InventoryExportService.java): `src/main/java/com/logistics/proyect/group5/service/InventoryExportService.java`
- [Image Handling](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/CloudinaryService.java): `src/main/java/com/logistics/proyect/group5/service/CloudinaryService.java`
- [Recovery Email](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/service/EmailService.java): `src/main/java/com/logistics/proyect/group5/service/EmailService.java`

### Persistence

- [Product Repository](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/ProductRepository.java): `src/main/java/com/logistics/proyect/group5/repository/ProductRepository.java`
- [Category Repository](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/CategoryRepository.java): `src/main/java/com/logistics/proyect/group5/repository/CategoryRepository.java`
- [User Repository](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/UserRepository.java): `src/main/java/com/logistics/proyect/group5/repository/UserRepository.java`
- [Tracking Repository](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/TrackingEventRepository.java): `src/main/java/com/logistics/proyect/group5/repository/TrackingEventRepository.java`
- [Order Repository](https://github.com/zogurf/herramientas-backend/blob/main/src/main/java/com/logistics/proyect/group5/repository/OrderRepository.java): `src/main/java/com/logistics/proyect/group5/repository/OrderRepository.java`

### External Integrations

- **PostgreSQL**
- **Cloudinary**
- **SMTP Mail**

### Other components

- **Shopper / Admin**

## Connections

- Shopper / Admin → Authentication API: authenticates (evidence: `README.md`)
- Shopper / Admin → Public Catalog API: browses (evidence: `README.md`)
- Shopper / Admin → Category API: browses (evidence: `README.md`)
- Shopper / Admin → Order Tracking API: checks history (evidence: `README.md`)
- Authentication API → Authentication & Profile: delegates to (evidence: `src/main/java/com/logistics/proyect/group5/controller/AuthController.java`)
- Public Catalog API → Product & Inventory: delegates to (evidence: `src/main/java/com/logistics/proyect/group5/controller/ProductController.java`)
- Category API → Category Management: delegates to (evidence: `src/main/java/com/logistics/proyect/group5/controller/CategoryController.java`)
- Admin Inventory API → Product & Inventory: delegates to (evidence: `src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java`)
- Admin Inventory API → Category Management: uses categories (evidence: `src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java`)
- Admin Inventory API → Inventory Exports: exports inventory (evidence: `src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java`)
- Admin Inventory API → Image Handling: uploads / deletes (evidence: `src/main/java/com/logistics/proyect/group5/controller/AdminProductController.java`)
- Admin Categories API → Category Management: delegates to (evidence: `src/main/java/com/logistics/proyect/group5/controller/AdminCategoryController.java`)
- Order Tracking API → Tracking Events: delegates to (evidence: `src/main/java/com/logistics/proyect/group5/controller/TrackingController.java`)
- Authentication & Profile → User Repository: reads / writes users (evidence: `src/main/java/com/logistics/proyect/group5/service/AuthService.java`)
- Authentication & Profile → Image Handling: uploads avatar (evidence: `src/main/java/com/logistics/proyect/group5/service/AuthService.java`)
- Authentication & Profile → Recovery Email: sends recovery mail (evidence: `src/main/java/com/logistics/proyect/group5/service/AuthService.java`)
- Product & Inventory → Product Repository: queries / saves (evidence: `src/main/java/com/logistics/proyect/group5/service/ProductService.java`)
- Product & Inventory → Category Management: resolves categories (evidence: `src/main/java/com/logistics/proyect/group5/service/ProductService.java`)
- Category Management → Category Repository: queries / saves (evidence: `src/main/java/com/logistics/proyect/group5/service/CategoryService.java`)
- Category Management → Product Repository: checks product use (evidence: `src/main/java/com/logistics/proyect/group5/service/CategoryService.java`)
- Tracking Events → Order Repository: checks order (evidence: `src/main/java/com/logistics/proyect/group5/service/TrackingService.java`)
- Tracking Events → Tracking Repository: saves / lists events (evidence: `src/main/java/com/logistics/proyect/group5/service/TrackingService.java`)
- Inventory Exports → Product & Inventory: reads products (evidence: `src/main/java/com/logistics/proyect/group5/service/InventoryExportService.java`)
- Product Repository → PostgreSQL: persists catalog
- Category Repository → PostgreSQL: persists categories
- User Repository → PostgreSQL: persists accounts
- Tracking Repository → PostgreSQL: persists events
- Order Repository → PostgreSQL: reads orders
- Image Handling → Cloudinary: uploads / deletes (evidence: `src/main/java/com/logistics/proyect/group5/service/CloudinaryService.java`)
- Recovery Email → SMTP Mail: sends email
