# deepak-kumar-goyal/fcs-assignment architecture

> Architecture diagram of the GitHub repository deepak-kumar-goyal/fcs-assignment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deepak-kumar-goyal/fcs-assignment
- Repository: https://github.com/deepak-kumar-goyal/fcs-assignment

## Overview

This is a Quarkus service for managing stores, products, warehouses, and store-to-warehouse fulfilment assignments. Its main workflow accepts a fulfilment request through the REST resource, validates the store/product/warehouse combination and assignment limits, then persists the assignment. Warehouse management separately covers creation, archival, and replacement with location and capacity constraints. The graph includes these documented product areas; some unsampled resource and use-case internals are represented at their existing source directories. Connections are limited to relationships visible in excerpts, the source index, or README.

Main entry points: [`java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/database/FulfilmentAssignmentRepository.java`](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/database/FulfilmentAssignmentRepository.java) (Assignment Repository), [`java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/restapi/FulfilmentResource.java`](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/restapi/FulfilmentResource.java) (Fulfilment REST), [`java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/application/AssociateFulfilmentUseCase.java`](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/application/AssociateFulfilmentUseCase.java) (Association Use Case), [`java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/validator/FulfilmentValidator.java`](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/validator/FulfilmentValidator.java) (Assignment Rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fulfilment["Fulfilment"]
  node_fulfilment_api["Fulfilment REST"]
  node_associate["Association Use Case"]
  node_fulfilment_validation["Assignment Rules"]
  node_assignment_repo[("Assignment Repository")]
  node_assignment_model["Assignment Model"]
  node_fulfilment_error["Fulfilment Errors"]
end

subgraph group_warehouse["Warehouse Management"]
  node_warehouse_api["Warehouse REST"]
  node_warehouse_usecases["Warehouse Operations"]
  node_warehouse_rules["Warehouse Rules"]
  node_warehouse_repo[("Warehouse Repository")]
  node_warehouse_model["Warehouse Model<br/>[Warehouse.java]"]
  node_warehouse_ports["Warehouse Ports"]
  node_warehouse_error["Warehouse Errors"]
end

subgraph group_catalog["Stores and Products"]
  node_store_resource["Store API<br/>[StoreResource.java]"]
  node_store_model["Store Model<br/>[Store.java]"]
  node_product_resource["Product API"]
  node_product_repo[("Product Repository")]
  node_product_model["Product Model<br/>[Product.java]"]
end

subgraph group_location["Location Integration"]
  node_location_resolver["Location Resolver"]
  node_location_gateway["Location Gateway"]
  node_location_model["Location Model<br/>[Location.java]"]
end

node_user(("API Client"))

node_user -->|"requests fulfilment"| node_fulfilment_api
node_user -->|"manages warehouses"| node_warehouse_api
node_user -->|"manages stores"| node_store_resource
node_user -->|"manages products"| node_product_resource
node_fulfilment_api -->|"invokes"| node_associate
node_fulfilment_api -->|"accesses"| node_assignment_repo
node_associate -->|"validates"| node_fulfilment_validation
node_associate -->|"persists assignment"| node_assignment_repo
node_fulfilment_validation -->|"checks limits"| node_assignment_repo
node_fulfilment_validation -->|"looks up product"| node_product_repo
node_assignment_repo -->|"queries"| node_assignment_model
node_warehouse_api -->|"uses operations"| node_warehouse_ports
node_warehouse_repo -->|"implements store port"| node_warehouse_ports
node_warehouse_repo -->|"maps"| node_warehouse_model
node_warehouse_usecases -.->|"validates changes"| node_warehouse_rules
node_warehouse_rules -->|"resolves location"| node_location_resolver
node_location_gateway -->|"implements"| node_location_resolver
node_location_gateway -->|"returns location"| node_location_model

click node_fulfilment_api "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/restapi/FulfilmentResource.java"
click node_associate "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/application/AssociateFulfilmentUseCase.java"
click node_fulfilment_validation "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/validator/FulfilmentValidator.java"
click node_assignment_repo "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/database/FulfilmentAssignmentRepository.java"
click node_assignment_model "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/model/FulfilmentAssignment.java"
click node_fulfilment_error "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/FulfilmentBusinessException.java"
click node_warehouse_api "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/restapi/WarehouseResourceImpl.java"
click node_warehouse_usecases "https://github.com/deepak-kumar-goyal/fcs-assignment/tree/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/usecases"
click node_warehouse_rules "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/validators/WarehouseValidator.java"
click node_warehouse_repo "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/database/WarehouseRepository.java"
click node_warehouse_model "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/models/Warehouse.java"
click node_warehouse_ports "https://github.com/deepak-kumar-goyal/fcs-assignment/tree/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/ports"
click node_warehouse_error "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/WarehouseBusinessException.java"
click node_store_resource "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/stores/StoreResource.java"
click node_store_model "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/stores/Store.java"
click node_product_resource "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/products/ProductResource.java"
click node_product_repo "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/products/ProductRepository.java"
click node_product_model "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/products/Product.java"
click node_location_resolver "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/ports/LocationResolver.java"
click node_location_gateway "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/location/LocationGateway.java"
click node_location_model "https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/models/Location.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_fulfilment_api,node_associate,node_fulfilment_validation,node_assignment_repo,node_assignment_model,node_fulfilment_error,node_user toneBlue
class node_warehouse_api,node_warehouse_usecases,node_warehouse_rules,node_warehouse_repo,node_warehouse_model,node_warehouse_ports,node_warehouse_error toneAmber
class node_store_resource,node_store_model,node_product_resource,node_product_repo,node_product_model toneMint
class node_location_resolver,node_location_gateway,node_location_model toneRose
```

## Components

### Fulfilment

- [Fulfilment REST](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/restapi/FulfilmentResource.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/restapi/FulfilmentResource.java`
- [Association Use Case](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/application/AssociateFulfilmentUseCase.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/application/AssociateFulfilmentUseCase.java`
- [Assignment Rules](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/validator/FulfilmentValidator.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/validator/FulfilmentValidator.java`
- [Assignment Repository](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/database/FulfilmentAssignmentRepository.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/database/FulfilmentAssignmentRepository.java`
- [Assignment Model](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/model/FulfilmentAssignment.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/model/FulfilmentAssignment.java`
- [Fulfilment Errors](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/FulfilmentBusinessException.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/FulfilmentBusinessException.java`

### Warehouse Management

- [Warehouse REST](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/restapi/WarehouseResourceImpl.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/restapi/WarehouseResourceImpl.java`
- [Warehouse Operations](https://github.com/deepak-kumar-goyal/fcs-assignment/tree/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/usecases): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/usecases`
- [Warehouse Rules](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/validators/WarehouseValidator.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/validators/WarehouseValidator.java`
- [Warehouse Repository](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/database/WarehouseRepository.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/database/WarehouseRepository.java`
- [Warehouse Model](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/models/Warehouse.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/models/Warehouse.java`
- [Warehouse Ports](https://github.com/deepak-kumar-goyal/fcs-assignment/tree/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/ports): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/ports`
- [Warehouse Errors](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/WarehouseBusinessException.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/WarehouseBusinessException.java`

### Stores and Products

- [Store API](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/stores/StoreResource.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/stores/StoreResource.java`
- [Store Model](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/stores/Store.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/stores/Store.java`
- [Product API](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/products/ProductResource.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/products/ProductResource.java`
- [Product Repository](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/products/ProductRepository.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/products/ProductRepository.java`
- [Product Model](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/products/Product.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/products/Product.java`

### Location Integration

- [Location Resolver](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/ports/LocationResolver.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/ports/LocationResolver.java`
- [Location Gateway](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/location/LocationGateway.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/location/LocationGateway.java`
- [Location Model](https://github.com/deepak-kumar-goyal/fcs-assignment/blob/main/java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/models/Location.java): `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/models/Location.java`

### Other components

- **API Client**

## Connections

- API Client → Fulfilment REST: requests fulfilment (evidence: `README.md`)
- API Client → Warehouse REST: manages warehouses (evidence: `README.md`)
- API Client → Store API: manages stores (evidence: `README.md`)
- API Client → Product API: manages products (evidence: `README.md`)
- Fulfilment REST → Association Use Case: invokes (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/restapi/FulfilmentResource.java`)
- Fulfilment REST → Assignment Repository: accesses (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/restapi/FulfilmentResource.java`)
- Association Use Case → Assignment Rules: validates (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/application/AssociateFulfilmentUseCase.java`)
- Association Use Case → Assignment Repository: persists assignment (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/application/AssociateFulfilmentUseCase.java`)
- Assignment Rules → Assignment Repository: checks limits (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/validator/FulfilmentValidator.java`)
- Assignment Rules → Product Repository: looks up product (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/domain/validator/FulfilmentValidator.java`)
- Assignment Repository → Assignment Model: queries (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/fulfilment/adapters/database/FulfilmentAssignmentRepository.java`)
- Warehouse REST → Warehouse Ports: uses operations (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/restapi/WarehouseResourceImpl.java`)
- Warehouse Repository → Warehouse Ports: implements store port (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/database/WarehouseRepository.java`)
- Warehouse Repository → Warehouse Model: maps (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/adapters/database/WarehouseRepository.java`)
- Warehouse Operations → Warehouse Rules: validates changes (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/usecases/ReplaceWarehouseUseCase.java`)
- Warehouse Rules → Location Resolver: resolves location (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/warehouses/domain/validators/WarehouseValidator.java`)
- Location Gateway → Location Resolver: implements (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/location/LocationGateway.java`)
- Location Gateway → Location Model: returns location (evidence: `java-assignment/src/main/java/com/fulfilment/application/monolith/location/LocationGateway.java`)
