# heddge/flowin.wms architecture

> Architecture diagram of the GitHub repository heddge/flowin.wms, 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/heddge/flowin.wms
- Repository: https://github.com/heddge/flowin.wms

## Overview

Flowin.WMS is a warehouse-management system. The sampled implementation exposes catalogue SKU, SKU-category, and work-area operations; requests pass through controllers to services, which use repositories and mappers to access domain data and form responses. The README also describes receiving, storage, inventory, reservation, picking, packing, movement, and stocktaking, but the sampled source does not establish their runtime implementation or connections. Those capabilities are shown as documented, unverified areas rather than as an inferred execution pipeline.

Main entry points: [`Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java`](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java) (SKU operations), [`Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java`](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java) (Category operations), [`Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java`](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java) (Work-area operations), [`Flowin.WMS.server/src/main/java/com/flowin/wms/controller/CatalogueSkuController.java`](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/CatalogueSkuController.java) (SKU endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_sku_api["SKU endpoints"]
  node_category_api["Category endpoints"]
  node_area_api["Work-area endpoints"]
  node_health["Health endpoint"]
  node_security["Security configuration"]
end

subgraph group_catalogue["SKU catalogue"]
  node_sku_service["SKU operations"]
  node_category_service["Category operations"]
  node_sku_mapper["SKU mapping"]
  node_category_mapper["Category mapping"]
  node_sku_dto["SKU request/response"]
  node_category_dto["Category request/response"]
  node_sku_entity["Catalogue SKU<br/>[CatalogueSku.java]"]
  node_category_entity["SKU category<br/>[SkuCategory.java]"]
  node_sku_repo["SKU repository"]
  node_category_repo["Category repository"]
end

subgraph group_areas["Work areas"]
  node_area_service["Work-area operations"]
  node_area_mapper["Work-area mapping"]
  node_area_dto["Work-area request/response<br/>[WorkAreaDto.java]"]
  node_area_entity["Work area<br/>[WorkArea.java]"]
  node_area_repo["Work-area repository"]
end

subgraph group_platform["Persistence and errors"]
  node_error_handler["Exception responses"]
  node_error_dto["Error response DTOs"]
  node_database[("Relational database")]
  node_warehouse_capabilities["Broader warehouse workflows<br/>[wms]"]
end

node_user(("Warehouse client"))

node_user -.->|"sends requests"| node_sku_api
node_user -.->|"sends requests"| node_category_api
node_user -.->|"sends requests"| node_area_api
node_sku_api -->|"delegates to"| node_sku_service
node_category_api -->|"delegates to"| node_category_service
node_area_api -->|"delegates to"| node_area_service
node_sku_service -->|"reads/writes"| node_sku_repo
node_sku_service -->|"maps data"| node_sku_mapper
node_sku_service -->|"looks up category"| node_category_service
node_category_service -->|"reads/writes"| node_category_repo
node_category_service -->|"maps data"| node_category_mapper
node_area_service -->|"reads data"| node_area_repo
node_area_service -->|"maps data"| node_area_mapper
node_sku_service -->|"uses contracts"| node_sku_dto
node_category_service -->|"uses contracts"| node_category_dto
node_area_service -->|"uses contracts"| node_area_dto
node_sku_repo -->|"persists entities"| node_database
node_category_repo -->|"persists entities"| node_database
node_area_repo -->|"persists entities"| node_database
node_sku_entity -->|"references category"| node_category_entity
node_sku_api -->|"accepts/returns"| node_sku_dto
node_category_api -->|"accepts/returns"| node_category_dto
node_area_api -->|"accepts/returns"| node_area_dto
node_error_handler -->|"forms responses"| node_error_dto
node_warehouse_capabilities -.->|"includes catalogue"| node_sku_service
node_warehouse_capabilities -.->|"includes storage areas"| node_area_service

click node_sku_api "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/CatalogueSkuController.java"
click node_category_api "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/SkuCategoryController.java"
click node_area_api "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/WorkAreaController.java"
click node_health "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/HealthController.java"
click node_security "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/config/SecurityConfig.java"
click node_sku_service "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java"
click node_category_service "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java"
click node_sku_mapper "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/CatalogueSkuMapper.java"
click node_category_mapper "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/SkuCategoryMapper.java"
click node_sku_dto "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/CatalogueSkuDto.java"
click node_category_dto "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/SkuCategoryDto.java"
click node_sku_entity "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/entity/CatalogueSku.java"
click node_category_entity "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/entity/SkuCategory.java"
click node_sku_repo "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/repository/CatalogueSkuRepository.java"
click node_category_repo "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/repository/SkuCategoryRepository.java"
click node_area_service "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java"
click node_area_mapper "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/WorkAreaMapper.java"
click node_area_dto "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/WorkAreaDto.java"
click node_area_entity "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/entity/WorkArea.java"
click node_area_repo "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/repository/WorkAreaRepository.java"
click node_error_handler "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/GlobalExceptionController.java"
click node_error_dto "https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/ExceptionResponses.java"
click node_warehouse_capabilities "https://github.com/heddge/flowin.wms/tree/main/Flowin.WMS.server/src/main/java/com/flowin/wms"

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_sku_api,node_category_api,node_area_api,node_health,node_security,node_user toneBlue
class node_sku_service,node_category_service,node_sku_mapper,node_category_mapper,node_sku_dto,node_category_dto,node_sku_entity,node_category_entity,node_sku_repo,node_category_repo toneAmber
class node_area_service,node_area_mapper,node_area_dto,node_area_entity,node_area_repo toneMint
class node_error_handler,node_error_dto,node_database,node_warehouse_capabilities toneRose
```

## Components

### API and access

- [SKU endpoints](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/CatalogueSkuController.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/CatalogueSkuController.java`
- [Category endpoints](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/SkuCategoryController.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/SkuCategoryController.java`
- [Work-area endpoints](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/WorkAreaController.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/WorkAreaController.java`
- [Health endpoint](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/HealthController.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/HealthController.java`
- [Security configuration](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/config/SecurityConfig.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/config/SecurityConfig.java`

### SKU catalogue

- [SKU operations](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java`
- [Category operations](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java`
- [SKU mapping](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/CatalogueSkuMapper.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/CatalogueSkuMapper.java`
- [Category mapping](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/SkuCategoryMapper.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/SkuCategoryMapper.java`
- [SKU request/response](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/CatalogueSkuDto.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/dto/CatalogueSkuDto.java`
- [Category request/response](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/SkuCategoryDto.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/dto/SkuCategoryDto.java`
- [Catalogue SKU](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/entity/CatalogueSku.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/entity/CatalogueSku.java`
- [SKU category](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/entity/SkuCategory.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/entity/SkuCategory.java`
- [SKU repository](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/repository/CatalogueSkuRepository.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/repository/CatalogueSkuRepository.java`
- [Category repository](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/repository/SkuCategoryRepository.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/repository/SkuCategoryRepository.java`

### Work areas

- [Work-area operations](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java`
- [Work-area mapping](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/WorkAreaMapper.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/mapper/WorkAreaMapper.java`
- [Work-area request/response](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/WorkAreaDto.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/dto/WorkAreaDto.java`
- [Work area](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/entity/WorkArea.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/entity/WorkArea.java`
- [Work-area repository](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/repository/WorkAreaRepository.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/repository/WorkAreaRepository.java`

### Persistence and errors

- [Exception responses](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/controller/GlobalExceptionController.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/GlobalExceptionController.java`
- [Error response DTOs](https://github.com/heddge/flowin.wms/blob/main/Flowin.WMS.server/src/main/java/com/flowin/wms/dto/ExceptionResponses.java): `Flowin.WMS.server/src/main/java/com/flowin/wms/dto/ExceptionResponses.java`
- **Relational database**
- [Broader warehouse workflows](https://github.com/heddge/flowin.wms/tree/main/Flowin.WMS.server/src/main/java/com/flowin/wms): `Flowin.WMS.server/src/main/java/com/flowin/wms`

### Other components

- **Warehouse client**

## Connections

- Warehouse client → SKU endpoints: sends requests
- Warehouse client → Category endpoints: sends requests
- Warehouse client → Work-area endpoints: sends requests
- SKU endpoints → SKU operations: delegates to (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/CatalogueSkuController.java`)
- Category endpoints → Category operations: delegates to (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/SkuCategoryController.java`)
- Work-area endpoints → Work-area operations: delegates to (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/WorkAreaController.java`)
- SKU operations → SKU repository: reads/writes (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java`)
- SKU operations → SKU mapping: maps data (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java`)
- SKU operations → Category operations: looks up category (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java`)
- Category operations → Category repository: reads/writes (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java`)
- Category operations → Category mapping: maps data (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java`)
- Work-area operations → Work-area repository: reads data (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java`)
- Work-area operations → Work-area mapping: maps data (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java`)
- SKU operations → SKU request/response: uses contracts (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/CatalogueSkuService.java`)
- Category operations → Category request/response: uses contracts (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/SkuCategoryService.java`)
- Work-area operations → Work-area request/response: uses contracts (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/service/WorkAreaService.java`)
- SKU repository → Relational database: persists entities (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/repository/CatalogueSkuRepository.java`)
- Category repository → Relational database: persists entities (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/repository/SkuCategoryRepository.java`)
- Work-area repository → Relational database: persists entities (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/repository/WorkAreaRepository.java`)
- Catalogue SKU → SKU category: references category (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/entity/CatalogueSku.java`)
- SKU endpoints → SKU request/response: accepts/returns (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/CatalogueSkuController.java`)
- Category endpoints → Category request/response: accepts/returns (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/SkuCategoryController.java`)
- Work-area endpoints → Work-area request/response: accepts/returns (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/WorkAreaController.java`)
- Exception responses → Error response DTOs: forms responses (evidence: `Flowin.WMS.server/src/main/java/com/flowin/wms/controller/GlobalExceptionController.java`)
- Broader warehouse workflows → SKU operations: includes catalogue (evidence: `README.md`)
- Broader warehouse workflows → Work-area operations: includes storage areas (evidence: `README.md`)
