How devsam1966/e-commerce works
This is a Java/Spring hexagonal e-commerce backend. Its main workflow exposes category, product, user, and order operations through REST controllers, application services, domain ports, and persistence adapters; product images also use file storage. Orders are assembled from REST requests and support PayPal payment integration. The README describes PostgreSQL and JWT, but the available source excerpts do not establish their runtime wiring, so those links are not asserted. Edges reflect shown calls or documented capabilities; unsampled implementation details are omitted.
Main entry points: CategoryCrudRepositoryImpl.java Category adapter · ProductCrudRepositoryImpl.java Product adapter · UserCrudRepositoryImpl.java User adapter · OrderCrudRepositoryImpl.java Order adapter
Components 31
REST API
- Category API
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java - Product API
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java - User API
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java - Order API
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java - PayPal API
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java
Application
- Category service
src/main/java/com/devsam/backend/ecommerce/application/CategoryService.java - Product service
src/main/java/com/devsam/backend/ecommerce/application/ProductService.java - User service
src/main/java/com/devsam/backend/ecommerce/application/UserService.java - Order service
src/main/java/com/devsam/backend/ecommerce/application/OrderService.java - Order assembler
src/main/java/com/devsam/backend/ecommerce/application/assembler/OrderAssembler.java - Image file storage
src/main/java/com/devsam/backend/ecommerce/application/UploadFile.java
Domain
- Category model
src/main/java/com/devsam/backend/ecommerce/domain/model/Category.java - Product model
src/main/java/com/devsam/backend/ecommerce/domain/model/Product.java - User model
src/main/java/com/devsam/backend/ecommerce/domain/model/User.java - Order models
src/main/java/com/devsam/backend/ecommerce/domain/model/Order.java - Category port
src/main/java/com/devsam/backend/ecommerce/domain/port/ICategoryRepository.java - Product port
src/main/java/com/devsam/backend/ecommerce/domain/port/IProductRepository.java - User port
src/main/java/com/devsam/backend/ecommerce/domain/port/IUserRepository.java - Order port
src/main/java/com/devsam/backend/ecommerce/domain/port/IOrderRepository.java
Persistence and integrations
- Category adapter
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java - Product adapter
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java - User adapter
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java - Order adapter
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java - Category mapper
src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/CategoryMapper.java - Product mapper
src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/ProductMapper.java - User mapper
src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/UserMapper.java - Order mapper
src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/IOrderMapper.java - PayPal service
src/main/java/com/devsam/backend/ecommerce/infrastructure/service/PaypalService.java
Other components
- API client
- PostgreSQL
- PayPal
Connections 30
- API client → Category API: calls
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java - API client → Product API: calls
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java - API client → User API: calls
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java - API client → Order API: calls
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java - API client → PayPal API: calls
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java - Category API → Category service: delegates to
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java - Product API → Product service: delegates to
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java - User API → User service: delegates to
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java - Order API → Order assembler: assembles with
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java - Order API → Order service: delegates to
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java - PayPal API → PayPal service: delegates to
src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java - Category service → Category port: uses
src/main/java/com/devsam/backend/ecommerce/application/CategoryService.java - Product service → Product port: uses
src/main/java/com/devsam/backend/ecommerce/application/ProductService.java - Product service → Image file storage: uploads and deletes
src/main/java/com/devsam/backend/ecommerce/application/ProductService.java - User service → User port: uses
src/main/java/com/devsam/backend/ecommerce/application/UserService.java - Order service → Order port: uses
src/main/java/com/devsam/backend/ecommerce/application/OrderService.java - Order assembler → Order models: creates
src/main/java/com/devsam/backend/ecommerce/application/assembler/OrderAssembler.java - Category adapter → Category port: implements
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java - Product adapter → Product port: implements
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java - User adapter → User port: implements
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java - Order adapter → Order port: implements
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java - Category adapter → Category mapper: maps through
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java - Product adapter → Product mapper: maps through
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java - User adapter → User mapper: maps through
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java - Order adapter → Order mapper: maps through
src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java - PayPal service → PayPal: creates and executes payments
src/main/java/com/devsam/backend/ecommerce/infrastructure/service/PaypalService.java - Category adapter → PostgreSQL: persists via Spring Data
- Product adapter → PostgreSQL: persists via Spring Data
- User adapter → PostgreSQL: persists via Spring Data
- Order adapter → PostgreSQL: persists via Spring Data