How jsuarez65/orderflow-backend-masters works
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: ProductService.py Product service · CustomerRepository.py Customer repository · CustomerMapper.py Customer mapper · ProductMapper.py Product mapper
Components 27
Master API
- Customer endpoints
OrderFlow/masters/controllers/CustomerController.py - Product endpoints
OrderFlow/masters/controllers/ProductController.py - Provider endpoints
OrderFlow/masters/controllers/ProviderController.py - Flask app
OrderFlow/masters/master_app.py
Domain Services
- Customer service
OrderFlow/masters/services/CustomerService.py - Product service
OrderFlow/masters/services/ProductService.py - Provider service
OrderFlow/masters/services/ProviderService.py - Customer mapper
OrderFlow/masters/mappers/CustomerMapper.py - Product mapper
OrderFlow/masters/mappers/ProductMapper.py - Customer DTO
OrderFlow/masters/model/dtos/CustomerDTO.py - Product DTO
OrderFlow/masters/model/dtos/ProductDTO.py - Customer entity
OrderFlow/masters/model/entities/CustomerEntity.py - Product entity
OrderFlow/masters/model/entities/ProductEntity.py
Persistence
- Customer repository
OrderFlow/masters/repositories/CustomerRepository.py - Product repository
OrderFlow/masters/repositories/ProductRepository.py - Provider repository
OrderFlow/masters/repositories/ProviderRepository.py - Database sessions
OrderFlow/masters/configuration/DatabaseConfiguration.py
Other Capabilities
- Customer/address API
master_clientes.py - Delivery addresses
master_clientes.py - Customer endpoints
endpoints_clientes.py - Backend service
master_backend_service.py - City master
master_cities.py - User role permissions
M_ABM_usu_rol_per.py - Product browser UI
OrderFlow/Front-End/masters/js/masterProduct.js - Provider browser UI
OrderFlow/Front-End/provider_Front/js/masterProvider.js
Other components
- API client
- PostgreSQL
Connections 23
- Customer endpoints → Customer service: calls
OrderFlow/masters/controllers/CustomerController.py - Product endpoints → Product service: calls
OrderFlow/masters/controllers/ProductController.py - Provider endpoints → Provider service: calls
OrderFlow/masters/controllers/ProviderController.py - Customer service → Customer repository: delegates to
OrderFlow/masters/services/CustomerService.py - Product service → Product repository: delegates to
OrderFlow/masters/services/ProductService.py - Product service → Product mapper: maps with
OrderFlow/masters/services/ProductService.py - Provider service → Provider repository: delegates to
OrderFlow/masters/services/ProviderService.py - Customer repository → Customer mapper: maps with
OrderFlow/masters/repositories/CustomerRepository.py - Customer mapper → Customer entity: converts to
OrderFlow/masters/mappers/CustomerMapper.py - Customer mapper → Customer DTO: converts to
OrderFlow/masters/mappers/CustomerMapper.py - Product mapper → Product entity: converts to
OrderFlow/masters/mappers/ProductMapper.py - Product mapper → Product DTO: converts to
OrderFlow/masters/mappers/ProductMapper.py - Product repository → Product entity: queries
OrderFlow/masters/repositories/ProductRepository.py - Product service → Product DTO: accepts
OrderFlow/masters/services/ProductService.py - Product endpoints → Product DTO: parses
OrderFlow/masters/controllers/ProductController.py - Customer endpoints → Customer DTO: parses
OrderFlow/masters/controllers/CustomerController.py - Provider repository → Database sessions: connects through
OrderFlow/masters/repositories/ProviderRepository.py - Database sessions → PostgreSQL: opens sessions
OrderFlow/masters/configuration/DatabaseConfiguration.py - Customer repository → Database sessions: opens sessions
OrderFlow/masters/repositories/CustomerRepository.py - Customer repository → Customer entity: queries
OrderFlow/masters/repositories/CustomerRepository.py - Flask app → Customer endpoints: registers
OrderFlow/masters/master_app.py - Customer/address API → PostgreSQL: queries
master_clientes.py - Customer/address API → Delivery addresses: serves routes for
master_clientes.py