15. Product-Service

client.product() dient als Zugriffspunkt. Der Dienst stellt CRUD-Operationen und die Zählfunktion für Produkte (Product) bereit.

15.1 Methodenübersicht

Methode	Rückgabetyp	HTTP	Endpunkt
create(ProductRequestV5)	ProductResponseV5 oder null	POST	/api/v5/product
update(product_id, ProductRequestV5)	ProductResponseV5 oder null	PUT	/api/v5/product/{id}
delete(product_id)	boolean	DELETE	/api/v5/product/{id}
get(product_id)	ProductResponseV5 oder null	GET	/api/v5/product/{id}
list()	List<ProductResponseV5>	GET	/api/v5/product
exists(product_id)	boolean	GET	/api/v5/product/{id}/exists
count()	long	GET	/api/v5/product/count

15.2 ProductRequestV5 / ProductResponseV5

Feld	Typ	Beschreibung
product_id	String	Produkt-ID (PK)
product_name	String	Produktname
site_id	String	Zugehöriger Standort
description	String	Beschreibung
external_product_id	String	Produkt-ID im Fremdsystem (ERP)
product_code	String	Produktcode (SKU)
category	String	Kategorie
unit_of_measure	String	Maßeinheit (EA, KG usw.)

15.3 Anwendungsbeispiele

Produkt anlegen

import plantpulse.api.v5.dto.request.ProductRequestV5;
import plantpulse.api.v5.dto.response.ProductResponseV5;

ProductRequestV5 req = new ProductRequestV5();
req.setProduct_id("PROD_A001");
req.setProduct_name("반도체 칩 A");
req.setSite_id("SITE_DJ");
req.setProduct_code("SKU-A001");
req.setCategory("반도체");
req.setUnit_of_measure("EA");
req.setExternal_product_id("ERP_P001");
req.setDescription("8nm 공정 반도체 칩");

ProductResponseV5 created = client.product().create(req);

Abfrage

ProductResponseV5 p = client.product().get("PROD_A001");
boolean exists      = client.product().exists("PROD_A001");
long total          = client.product().count();

Gruppierung nach Kategorie

import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;

Map<String, List<ProductResponseV5>> byCategory = client.product().list().stream()
        .collect(Collectors.groupingBy(ProductResponseV5::getCategory));

byCategory.forEach((cat, items) ->
    System.out.printf("%s: %d개%n", cat, items.size()));

Ändern / Löschen

ProductRequestV5 update = new ProductRequestV5();
update.setProduct_id("PROD_A001");
update.setProduct_name("반도체 칩 A (v2)");
update.setSite_id("SITE_DJ");
update.setProduct_code("SKU-A001");
update.setUnit_of_measure("EA");
client.product().update("PROD_A001", update);

client.product().delete("PROD_A001");

Nächste Schritte

• Order-Service — Produkte einem Arbeitsauftrag zuweisen