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 服务 — 为工单分配产品