新增字典和常量

适用场景

• 需要为字段增加枚举 / 字典值。
• 需要补充业务常量。

AI 决策提示

• 数据库字段枚举优先定义在 ORM 的 dicts 中。
• 业务常量放在手写常量类或接口中。
• 不要在 Entity 里手写数据库字典常量。

最小闭环

1. 在 ORM 中定义 dict

<dicts>
    <dict name="order/status" valueType="int">
        <option code="PENDING" value="101"/>
        <option code="CANCELLED" value="102"/>
        <option code="PAID" value="201"/>
    </dict>
</dicts>

2. 在字段上挂字典

<column name="orderStatus" ext:dict="order/status"/>

3. 重新生成并使用生成常量

if (order.getOrderStatus() == ORDER_STATUS_PAID) {
    // ...
}

4. 业务常量单独定义

public interface OrderConstants {
    BigDecimal FREE_SHIPPING_THRESHOLD = new BigDecimal("88");
}

常见坑

1. 在 Entity 中硬写数据库枚举常量。
2. 把业务常量和字段枚举混在一起。
3. 修改 ORM 后不重新生成。

相关文档

• ./change-model-and-regenerate.md
• ../02-core-guides/model-first-development.md
• ../01-repo-map/domain-module-pattern.md