Skip to content

枚举冻结(全局唯一值域)

枚举冻结(全局唯一值域)

用于统一系统内关键字段的枚举定义,确保全局值域唯一、稳定,避免语义漂移与重复扩展。

订单相关

orderStatus

订单履约主状态。

  • pending_payment
  • pending_writeoff
  • pending_delivery
  • shipped
  • completed
  • cancelled

说明:退款过程不通过扩展 orderStatus 表达,退款状态请参考 refundStatus

refundStatus

退款过程状态,独立于 orderStatus

  • none
  • processing
  • succeeded
  • rejected

payType

支付类型。

  • wechat:纯现金
  • points:纯积分
  • mix:积分 + 现金

deliveryMode

履约/交付方式。

  • pickup:自提 / 核销
  • shipping:邮寄

商品相关

goods.channel

商品渠道。

  • points:积分商品
  • merch:周边商品

goods.goodsType

商品类型。

  • service
  • rights
  • physical

goods.status

商品状态。

  • draft
  • onsale
  • offsale
  • soldout

业务状态相关

checkinStatus

签到状态。

  • uncheckin
  • checking
  • success
  • failed

badgeStatus

徽章状态。

  • locked
  • unlockable
  • unlocked

消息相关

message.type

消息类型。

  • official
  • system

积分相关

points.ledgerType

积分账务类型,建议以此字段为权威定义

  • increase
  • decrease
  • freeze
  • unfreeze
  • refund

规范要求

  • 上述枚举为冻结值域,应在全局范围内保持唯一且稳定。
  • 新增或调整枚举值时,应避免与既有业务语义冲突。
  • 涉及状态拆分时,优先采用独立字段表达,不通过复用或污染主状态字段实现。

谷子科技知识库平台 - 多格式摄入、受控编译、岗位隔离问答