用途：为 SaaS 应用添加订阅计费，支持分级订阅、按用量定价、客户自助门户与安全的支付 Webhook 处理。
主要能力：创建 Stripe 客户与 Checkout 会话；处理 checkout.session.completed、customer.subscription.updated/deleted、invoice.payment_failed 等事件；生成客户门户会话；同步订阅层级、状态与周期结束时间到数据库。
使用方式：配置环境变量 STRIPE_SECRET_KEY、STRIPE_PUBLISHABLE_KEY、STRIPE_WEBHOOK_SECRET 及各价格 ID；后端初始化 Stripe 客户端并映射价格到层级；前端按钮请求 /api/create-checkout 后跳转；Webhook 端点校验签名并分发事件；数据库为 users 表增加 stripe_customer_id、stripe_subscription_id、subscription_tier、subscription_status、current_period_end、cancel_at_period_end 字段。本地测试可用 stripe listen --forward-to localhost:3000/api/webhooks/stripe 与 stripe trigger 命令。
适用场景：SaaS 订阅计费、用量计费、自助管理订阅。
限制与注意：必须验证 Webhook 签名、保证幂等、服务端校验层级、仅用 HTTPS、区分测试与正式模式；资料未提供具体价格、收费与效果数据。