1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! Credit 计量模块(`credit-metering` feature):`CreditMeter` 为计量引擎(按 tenant 维度,
//! tenant_id 来源为 `context::tenant`),`CreditCycle` 决定配额周期,`CreditSchedule`
//! 提供资源权重,`ActivityWriteThrottle` 默认启用做活跃度写路径节流,
//! `CreditMeteringListener` 为可选事件监听器(Login 自动扣减,CreditConsumed /
//! CreditAlert 事件可被 `listener::audit` 审计)。
//!
//! 消费语义与已知限制:`consume_credit` 的 credits = cost × weight 经 `checked_mul`
//! 计算,溢出返回错误(不静默回绕),被拒绝的请求不消耗配额(并发交错超限时回滚
//! 本次扣减);`CreditMeterStorage::incr_consumed` 在 `GarrisonDao` 无 `INCRBY`
//! 语义下按 credits 循环单步 incr,整体非原子且为 N 次串行 DAO 往返(详见
//! `credit::storage`);persist_history 默认经 `ActivityWriteThrottle` 节流聚合
//! (同 key 窗口内仅首次快照落库、进程退出不持久化),逐笔对账用
//! `CreditMeter::without_activity_throttle` 关闭(详见 `credit::throttle`)。
/// Credit 配额周期模型。
/// Credit 消费权重表。
/// Credit 计量配置。
/// Credit 计量错误类型与结果类型。
/// Credit KV 热数据存储层。
/// 高频活跃度写路径节流聚合器。
/// Credit 计量引擎。
/// Credit 计量 Prometheus 指标。
/// Credit 计量监听器(可选自动扣减)。
// Re-export 核心类型
pub use ;
pub use CreditCycle;
pub use ;
pub use CreditMeter;
pub use CreditMetrics;
pub use CreditSchedule;
pub use CreditMeterStorage;
pub use ActivityWriteThrottle;
pub use CreditMeteringListener;