用途：用于搭建自动化计费系统，处理周期性付款、发票生成、订阅生命周期与催收管理，适合实现 SaaS 订阅计费、发票自动化、失败付款恢复、套餐变更按比例计费、销售税/VAT/GST 处理、按用量计费和账单周期续订等场景。
主要能力：订阅状态管理（trial→active→past_due→canceled，含 paused/resumed）；计费周期处理（检查到期、生成发票、扣款、成功则推进周期并发送发票，失败则标记逾期并启动催收）；催收管理（重试计划、客户通知、宽限期、账号限制）；按比例计费（套餐升降级、增减席位、变更计费周期）；税费计算（按地区税率，如 US_CA、GB、DE、FR、AU，支持 VAT 号校验）；发票生成（行项目、小计、税、总额，可输出 PDF 或 HTML）；按用量计费（记录用量、按分层或按单位计价）。
使用方式：资料给出 Python 示例，需引入计费模块并初始化引擎，例如 from billing import BillingEngine, Subscription；随后可 create_subscription(customer_id="cus_123", plan_id="plan_pro_monthly", billing_cycle_anchor=datetime.now(), trial_days=14) 创建订阅，再用 process_billing_cycle(subscription.id) 处理周期。示例中扣款使用 stripe.Charge.create，金额需转换为分（amount * 100）。
限制：示例代码依赖 generate_id、generate_invoice_number、UsageRecord、send_email、render_template、stripe 等未在资料中定义的模块或外部服务，需自行补充；税率数据仅为示例，未说明完整税务规则与合规要求；催收重试计划为示例配置。具体安装步骤、运行环境、版本要求及收费情况暂未提供。