15. Product サービス

client.product() でアクセスします。製品(Product)のCRUDとカウントを提供します。

15.1 メソッド一覧

メソッド	戻り値の型	HTTP	エンドポイント
create(ProductRequestV5)	ProductResponseV5 または null	POST	/api/v5/product
update(product_id, ProductRequestV5)	ProductResponseV5 または null	PUT	/api/v5/product/{id}
delete(product_id)	boolean	DELETE	/api/v5/product/{id}
get(product_id)	ProductResponseV5 または 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

フィールド	型	説明
product_id	String	製品ID (PK)
product_name	String	製品名
site_id	String	所属サイト
description	String	説明
external_product_id	String	外部システム(ERP)製品ID
product_code	String	製品コード (SKU)
category	String	カテゴリ
unit_of_measure	String	測定単位 (EA、KGなど)

15.3 使用例

製品の作成

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);

照会

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

カテゴリ別グルーピング

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()));

更新 / 削除

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");

次のステップ

• Order サービス — 作業指示への製品割り当て