升鲜宝 SaaS 自动计费引擎核心接口清单 

目标：

🔥 分层清晰
🔥 支持订阅 + 用量 + 升级补差 + 自动续费
🔥 可重算 + 幂等 + 可审计
🔥 可插拔价格策略

结构风格：
遵循你升鲜宝 Spring Boot 单体 + 分域包结构

一、整体分层结构

二、1️⃣ BillingFacade（对外统一入口）

计费引擎总门面

三、2️⃣ PricingService（价格计算核心）

负责组件级金额计算

PricingResult

四、3️⃣ UsageService（用量读取层）

所有用量来源统一入口

五、4️⃣ InvoiceService（账单持久层）

负责落库 + 幂等 + 状态机

六、5️⃣ PaymentService（支付域）

七、6️⃣ SubscriptionService

八、7️⃣ EntitlementService（授权快照）

九、8️⃣ PricingStrategy（策略模式）

FixedPricingStrategy

PerUnitPricingStrategy

TieredPricingStrategy

十、核心流程调用关系图

十一、账单构建标准流程（最终生产流程）

十二、幂等保障点

十三、金额统一规范（升鲜宝标准）

• 金额 DECIMAL(18,2)

• 单价 DECIMAL(18,6)

• 统一 HALF_UP

• 所有中间运算 BigDecimal

十四、你现在已经具备

✅ 商业级计费核心结构
✅ 可插拔价格策略
✅ 可扩展用量模型
✅ 可重算架构
✅ 可冻结可解冻授权