# jsuarez65/orderflow-backend-masters architecture

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

- Interactive diagram: https://gitdiagram.com/jsuarez65/orderflow-backend-masters
- Repository: https://github.com/jsuarez65/orderflow-backend-masters

## Overview

OrderFlow is a Python/Flask application for maintaining customer, product, and provider master data, with browser interfaces for products and providers. Its principal workflow is a request to a master-data endpoint, conversion and validation through service/mapper layers, and persistence to PostgreSQL. The repository also contains a separate customer-and-delivery-address API, city and user/role/permission modules. Those additional capabilities are included, but their wiring to the main application is not established by the available excerpts.

Main entry points: [`OrderFlow/masters/services/ProductService.py`](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/services/ProductService.py) (Product service), [`OrderFlow/masters/repositories/CustomerRepository.py`](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/repositories/CustomerRepository.py) (Customer repository), [`OrderFlow/masters/mappers/CustomerMapper.py`](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/mappers/CustomerMapper.py) (Customer mapper), [`OrderFlow/masters/mappers/ProductMapper.py`](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/mappers/ProductMapper.py) (Product mapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Master API"]
  node_customer_controller["Customer endpoints"]
  node_product_controller["Product endpoints"]
  node_provider_controller["Provider endpoints"]
  node_master_app["Flask app<br/>[master_app.py]"]
end

subgraph group_domain["Domain Services"]
  node_customer_service["Customer service<br/>[CustomerService.py]"]
  node_product_service["Product service<br/>[ProductService.py]"]
  node_provider_service["Provider service<br/>[ProviderService.py]"]
  node_customer_mapper["Customer mapper<br/>[CustomerMapper.py]"]
  node_product_mapper["Product mapper<br/>[ProductMapper.py]"]
  node_customer_dto["Customer DTO<br/>[CustomerDTO.py]"]
  node_product_dto["Product DTO<br/>[ProductDTO.py]"]
  node_customer_entity["Customer entity<br/>[CustomerEntity.py]"]
  node_product_entity["Product entity<br/>[ProductEntity.py]"]
end

subgraph group_persistence["Persistence"]
  node_customer_repo["Customer repository"]
  node_product_repo["Product repository"]
  node_provider_repo["Provider repository"]
  node_db_config["Database sessions"]
end

subgraph group_other["Other Capabilities"]
  node_customer_ui["Customer/address API<br/>[master_clientes.py]"]
  node_addresses["Delivery addresses<br/>[master_clientes.py]"]
  node_legacy_clients["Customer endpoints"]
  node_backend_service["Backend service"]
  node_cities["City master<br/>[master_cities.py]"]
  node_user_roles["User role permissions"]
  node_product_ui["Product browser UI<br/>[masterProduct.js]"]
  node_provider_ui["Provider browser UI<br/>[masterProvider.js]"]
end

node_user(("API client"))
node_postgres[("PostgreSQL")]

node_customer_controller -->|"calls"| node_customer_service
node_product_controller -->|"calls"| node_product_service
node_provider_controller -->|"calls"| node_provider_service
node_customer_service -->|"delegates to"| node_customer_repo
node_product_service -->|"delegates to"| node_product_repo
node_product_service -->|"maps with"| node_product_mapper
node_provider_service -->|"delegates to"| node_provider_repo
node_customer_repo -->|"maps with"| node_customer_mapper
node_customer_mapper -->|"converts to"| node_customer_entity
node_customer_mapper -->|"converts to"| node_customer_dto
node_product_mapper -->|"converts to"| node_product_entity
node_product_mapper -->|"converts to"| node_product_dto
node_product_repo -->|"queries"| node_product_entity
node_product_service -->|"accepts"| node_product_dto
node_product_controller -->|"parses"| node_product_dto
node_customer_controller -->|"parses"| node_customer_dto
node_provider_repo -->|"connects through"| node_db_config
node_db_config -->|"opens sessions"| node_postgres
node_customer_repo -->|"opens sessions"| node_db_config
node_customer_repo -->|"queries"| node_customer_entity
node_master_app -->|"registers"| node_customer_controller
node_customer_ui -->|"queries"| node_postgres
node_customer_ui -->|"serves routes for"| node_addresses

click node_customer_controller "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/controllers/CustomerController.py"
click node_product_controller "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/controllers/ProductController.py"
click node_provider_controller "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/controllers/ProviderController.py"
click node_customer_service "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/services/CustomerService.py"
click node_product_service "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/services/ProductService.py"
click node_provider_service "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/services/ProviderService.py"
click node_customer_mapper "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/mappers/CustomerMapper.py"
click node_product_mapper "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/mappers/ProductMapper.py"
click node_customer_dto "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/dtos/CustomerDTO.py"
click node_product_dto "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/dtos/ProductDTO.py"
click node_customer_entity "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/entities/CustomerEntity.py"
click node_product_entity "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/entities/ProductEntity.py"
click node_customer_repo "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/repositories/CustomerRepository.py"
click node_product_repo "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/repositories/ProductRepository.py"
click node_provider_repo "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/repositories/ProviderRepository.py"
click node_db_config "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/configuration/DatabaseConfiguration.py"
click node_master_app "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/master_app.py"
click node_customer_ui "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_clientes.py"
click node_addresses "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_clientes.py"
click node_legacy_clients "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/endpoints_clientes.py"
click node_backend_service "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_backend_service.py"
click node_cities "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_cities.py"
click node_user_roles "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/M_ABM_usu_rol_per.py"
click node_product_ui "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/Front-End/masters/js/masterProduct.js"
click node_provider_ui "https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/Front-End/provider_Front/js/masterProvider.js"

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_customer_controller,node_product_controller,node_provider_controller,node_master_app,node_user toneBlue
class node_customer_service,node_product_service,node_provider_service,node_customer_mapper,node_product_mapper,node_customer_dto,node_product_dto,node_customer_entity,node_product_entity,node_postgres toneAmber
class node_customer_repo,node_product_repo,node_provider_repo,node_db_config toneMint
class node_customer_ui,node_addresses,node_legacy_clients,node_backend_service,node_cities,node_user_roles,node_product_ui,node_provider_ui toneRose
```

## Components

### Master API

- [Customer endpoints](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/controllers/CustomerController.py): `OrderFlow/masters/controllers/CustomerController.py`
- [Product endpoints](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/controllers/ProductController.py): `OrderFlow/masters/controllers/ProductController.py`
- [Provider endpoints](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/controllers/ProviderController.py): `OrderFlow/masters/controllers/ProviderController.py`
- [Flask app](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/master_app.py): `OrderFlow/masters/master_app.py`

### Domain Services

- [Customer service](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/services/CustomerService.py): `OrderFlow/masters/services/CustomerService.py`
- [Product service](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/services/ProductService.py): `OrderFlow/masters/services/ProductService.py`
- [Provider service](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/services/ProviderService.py): `OrderFlow/masters/services/ProviderService.py`
- [Customer mapper](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/mappers/CustomerMapper.py): `OrderFlow/masters/mappers/CustomerMapper.py`
- [Product mapper](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/mappers/ProductMapper.py): `OrderFlow/masters/mappers/ProductMapper.py`
- [Customer DTO](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/dtos/CustomerDTO.py): `OrderFlow/masters/model/dtos/CustomerDTO.py`
- [Product DTO](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/dtos/ProductDTO.py): `OrderFlow/masters/model/dtos/ProductDTO.py`
- [Customer entity](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/entities/CustomerEntity.py): `OrderFlow/masters/model/entities/CustomerEntity.py`
- [Product entity](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/model/entities/ProductEntity.py): `OrderFlow/masters/model/entities/ProductEntity.py`

### Persistence

- [Customer repository](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/repositories/CustomerRepository.py): `OrderFlow/masters/repositories/CustomerRepository.py`
- [Product repository](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/repositories/ProductRepository.py): `OrderFlow/masters/repositories/ProductRepository.py`
- [Provider repository](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/repositories/ProviderRepository.py): `OrderFlow/masters/repositories/ProviderRepository.py`
- [Database sessions](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/masters/configuration/DatabaseConfiguration.py): `OrderFlow/masters/configuration/DatabaseConfiguration.py`

### Other Capabilities

- [Customer/address API](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_clientes.py): `master_clientes.py`
- [Delivery addresses](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_clientes.py): `master_clientes.py`
- [Customer endpoints](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/endpoints_clientes.py): `endpoints_clientes.py`
- [Backend service](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_backend_service.py): `master_backend_service.py`
- [City master](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/master_cities.py): `master_cities.py`
- [User role permissions](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/M_ABM_usu_rol_per.py): `M_ABM_usu_rol_per.py`
- [Product browser UI](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/Front-End/masters/js/masterProduct.js): `OrderFlow/Front-End/masters/js/masterProduct.js`
- [Provider browser UI](https://github.com/jsuarez65/orderflow-backend-masters/blob/main/OrderFlow/Front-End/provider_Front/js/masterProvider.js): `OrderFlow/Front-End/provider_Front/js/masterProvider.js`

### Other components

- **API client**
- **PostgreSQL**

## Connections

- Customer endpoints → Customer service: calls (evidence: `OrderFlow/masters/controllers/CustomerController.py`)
- Product endpoints → Product service: calls (evidence: `OrderFlow/masters/controllers/ProductController.py`)
- Provider endpoints → Provider service: calls (evidence: `OrderFlow/masters/controllers/ProviderController.py`)
- Customer service → Customer repository: delegates to (evidence: `OrderFlow/masters/services/CustomerService.py`)
- Product service → Product repository: delegates to (evidence: `OrderFlow/masters/services/ProductService.py`)
- Product service → Product mapper: maps with (evidence: `OrderFlow/masters/services/ProductService.py`)
- Provider service → Provider repository: delegates to (evidence: `OrderFlow/masters/services/ProviderService.py`)
- Customer repository → Customer mapper: maps with (evidence: `OrderFlow/masters/repositories/CustomerRepository.py`)
- Customer mapper → Customer entity: converts to (evidence: `OrderFlow/masters/mappers/CustomerMapper.py`)
- Customer mapper → Customer DTO: converts to (evidence: `OrderFlow/masters/mappers/CustomerMapper.py`)
- Product mapper → Product entity: converts to (evidence: `OrderFlow/masters/mappers/ProductMapper.py`)
- Product mapper → Product DTO: converts to (evidence: `OrderFlow/masters/mappers/ProductMapper.py`)
- Product repository → Product entity: queries (evidence: `OrderFlow/masters/repositories/ProductRepository.py`)
- Product service → Product DTO: accepts (evidence: `OrderFlow/masters/services/ProductService.py`)
- Product endpoints → Product DTO: parses (evidence: `OrderFlow/masters/controllers/ProductController.py`)
- Customer endpoints → Customer DTO: parses (evidence: `OrderFlow/masters/controllers/CustomerController.py`)
- Provider repository → Database sessions: connects through (evidence: `OrderFlow/masters/repositories/ProviderRepository.py`)
- Database sessions → PostgreSQL: opens sessions (evidence: `OrderFlow/masters/configuration/DatabaseConfiguration.py`)
- Customer repository → Database sessions: opens sessions (evidence: `OrderFlow/masters/repositories/CustomerRepository.py`)
- Customer repository → Customer entity: queries (evidence: `OrderFlow/masters/repositories/CustomerRepository.py`)
- Flask app → Customer endpoints: registers (evidence: `OrderFlow/masters/master_app.py`)
- Customer/address API → PostgreSQL: queries (evidence: `master_clientes.py`)
- Customer/address API → Delivery addresses: serves routes for (evidence: `master_clientes.py`)
