package handler

// 质量状态口径（统一中文，客户口径；存值即界面值，禁用英文枚举）。
//
// 生命周期（与 inspection.go 一一对应）：
//
//	入库           → 未检（待检）
//	质量检验 合格   → 合格
//	质量检验 不合格 → 不合格（隔离）
//	不合格处置 退货 → 待退（隔离，等待退货运单）
//	不合格处置 报废 → 不合格 + 生命周期「报废」（退出可用）
//
// 客户诉求（问题记录 L135）：「不合格不入库、不上产线，仅合格品计入库存数量」——
// 故可用量/出库门禁统一只认「合格」。未检(待检)/不合格/待退 均不计入可用量、不可出库；
// 仅「退货/报废/退料」类处置出库豁免（本身即在处置不合格品，见 outboundBlocksUnqualified）。
const (
	QStatusPending = "未检" // 待检（入库初始状态，等待质量检验）
	QStatusPass    = "合格"
	QStatusFail    = "不合格"
	QStatusReturn  = "待退" // 待退货（隔离）
)

// qualityLabel 质量状态展示口径：空值按「未检(待检)」处理，避免列表出现空白。
func qualityLabel(q string) string {
	if q == "" {
		return QStatusPending
	}
	return q
}