billing-behaviors

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Billing Behavior Rules

计费行为规则

This skill contains the detailed business behavior rules for Commet. Load the specific files you need based on the task.

本技能包含Commet的详细业务行为规则，你可以根据任务需要加载对应的具体文件。

Core Principle

核心原则

Commet does what's fair by default:

Change Type	When Applied
Benefits customer	Immediately
Hurts customer	At renewal

Benefits customer: More limits (API calls, storage), adding features, more included seats. Hurts customer: Price increase, reduced limits, removing features, fewer included seats.

Commet默认执行公平原则：

变更类型	生效时间
对客户有利	立即生效
对客户不利	续费时生效

对客户有利的变更： 更高额度（API调用、存储）、新增功能、更多包含席位。 对客户不利的变更： 价格上涨、额度下调、功能移除、包含席位减少。

Actors

参与角色

Actor	Where They Act	Examples
Founder	Dashboard	Change prices, edit features, deprecate plans
Customer	Customer Portal	Upgrade, downgrade, change billing interval
System	Automatic	Trial end, payment failure, billing

角色	操作场景	示例
创始人	管理后台（Dashboard）	调整价格、编辑功能、弃用套餐
客户	客户门户（Customer Portal）	升级、降级、变更计费周期
系统	自动执行	试用结束、支付失败、计费

Decision Tree

决策树

Who makes the change?
│
├─ FOUNDER (Dashboard)
│   ├─ Benefits customer? → IMMEDIATE
│   └─ Hurts customer? → AT RENEWAL
│   └─ Delete plan/customer? → See references/plan-management.md
│
└─ CUSTOMER (Portal)
    ├─ Upgrade (more expensive)? → IMMEDIATE + proration
    └─ Downgrade (cheaper)? → AT RENEWAL

Who makes the change?
│
├─ FOUNDER (Dashboard)
│   ├─ Benefits customer? → IMMEDIATE
│   └─ Hurts customer? → AT RENEWAL
│   └─ Delete plan/customer? → See references/plan-management.md
│
└─ CUSTOMER (Portal)
    ├─ Upgrade (more expensive)? → IMMEDIATE + proration
    └─ Downgrade (cheaper)? → AT RENEWAL

Detailed Rules

详细规则

Each file covers a specific aspect of billing behavior:

references/subscription-changes.md - Upgrades, downgrades, interval changes, proration by consumption model
references/pricing-changes.md - Base price, overage, and seat price changes
references/feature-changes.md - Limit increases/decreases, boolean features, included seats
references/plan-management.md - Deprecating and deleting plans, deleting customers
references/intro-offer.md - Introductory offer eligibility, components, plan change behavior
references/consumption-models.md - Credits and balance proration, plan changes, cancellation, purchases
references/edge-cases.md - Trial pricing, reactivations, payment failures, exhaustion, currency at checkout

每个文件覆盖计费行为的一个特定方面：

references/subscription-changes.md - 升级、降级、周期变更、按消费模式计算proration
references/pricing-changes.md - 基准价格、超额费用、席位价格变更
references/feature-changes.md - 额度上调/下调、布尔型功能、包含席位
references/plan-management.md - 弃用和删除套餐、删除客户
references/intro-offer.md - 新用户优惠资格、构成、套餐变更规则
references/consumption-models.md - Credits与余额proration、套餐变更、取消、购买
references/edge-cases.md - 试用定价、重新激活、支付失败、额度耗尽、结算币种

Domain Reference

领域参考

Module-specific knowledge for understanding the codebase:

references/domain-billing-engine.md - Billing engine orchestration, calculator resolution, processing flow, invoice line types, monthly resets
references/domain-subscriptions.md - Subscription states, creation flow, billing period, currency, trials, pause, cancellation
references/domain-plans.md - Plan structure, free vs paid, PlanPrice, PlanFeature, introductory offers, regional pricing
references/domain-features.md - Feature types (boolean, metered, seats), feature codes as SDK identifiers
references/domain-usage.md - Consumption models (metered, credits, balance), usage events, AI token tracking, subscription balance
references/domain-seats.md - Seat billing (advance + true-up), proration, seat types, SDK integration
references/domain-customers.md - Customer fields, external ID, address, customer credits, business flow
references/domain-plan-groups.md - Plan grouping for upgrades/downgrades, business rules
references/domain-addons.md - Addon system, activation/deactivation, billing, consumption model compatibility
references/domain-ai-costs.md - AI model catalog, token cost tracking, margin pricing, balance deductions
references/domain-promo-codes.md - Promo code system, validation rules, checkout flow, mutual exclusivity with intro offers

用于理解代码库的模块专属知识：

references/domain-billing-engine.md - 计费引擎编排、计算器解析、处理流程、发票行类型、月度重置
references/domain-subscriptions.md - 订阅状态、创建流程、计费周期、币种、试用、暂停、取消
references/domain-plans.md - 套餐结构、免费vs付费、PlanPrice、PlanFeature、新用户优惠、区域定价
references/domain-features.md - 功能类型（布尔型、计量型、席位）、作为SDK标识符的功能代码
references/domain-usage.md - 消费模式（计量型、credits、余额）、使用事件、AI token追踪、订阅余额
references/domain-seats.md - 席位计费（预付+清算）、proration、席位类型、SDK集成
references/domain-customers.md - 客户字段、外部ID、地址、客户credits、业务流程
references/domain-plan-groups.md - 用于升级/降级的套餐分组、业务规则
references/domain-addons.md - 附加组件系统、激活/停用、计费、消费模式兼容性
references/domain-ai-costs.md - AI模型目录、token成本追踪、利润率定价、余额扣除
references/domain-promo-codes.md - 优惠码系统、校验规则、结算流程、与新用户优惠互斥