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
60
61
62
63
64
65
66
67
68
69
70
71
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! SMS 验证码渐进式限速模块。
//!
//! 三层抽象:`SmsSender` trait(业务方实现短信发送)+ `SmsRateLimiter`(双窗口限速)+ `SmsVerificationService`(发送/验证/异常检测)。
//!
//! # Key 空间设计
//!
//! | key | TTL | 用途 |
//! |-----|-----|------|
//! | `quota:hour:sms:{phone}` | 3600s | 小时限速账本(limiteron QuotaStorage) |
//! | `quota:day:sms:{phone}` | 86400s | 天限速账本(limiteron QuotaStorage) |
//! | `sms:code:{phone}` | 300s | 验证码 |
//! | `sms:attempts:{phone}` | 300s | 验证尝试次数 |
//! | `sms:unverified:{phone}` | 86400s | 连续未验证计数器 |
//! | `sms:recycled:{phone}` | 86400s | 通道回收标记 |
//!
//! # 安全约束
//!
//! phone 不含 ':'(防 key 注入);验证码用 `rand::rng()`(ThreadRng,ChaCha12 CSPRNG);限速账本与
//! 未验证计数器均经 `GarrisonDao::incr`/`decr` 原子增减(QuotaStorage 适配器)。
use crateGarrisonDao;
use crateGarrisonResult;
use crateGarrisonDaoQuotaStorage;
use crateDualWindowQuota;
use async_trait;
use Arc;
/// 短信发送 trait(业务方实现)。
/// NoopSmsSender:仅日志不实际发送(用于测试)。
;
/// SMS 限速器(双窗口:小时 + 天)。
///
/// 窗口判定与补偿委托泛型内核 `DualWindowQuota`(limiteron `QuotaStorage` 账本,经 `GarrisonDaoQuotaStorage` 落 DAO);
/// 本类型只保留 SMS 特有面:normalize/validate、`sms:` 命名空间与 `SmsRateLimitExceeded` 错误变体。
/// SMS 验证码服务。
///
/// # DAO 注入约束(重要)
///
/// 本服务与内嵌 [`SmsRateLimiter`] 各持有一个 [`GarrisonDao`](分别用于 code/attempts/unverified/recycled key 与限速计数),
/// **两者必须指向同一实例/后端**(构造时传同一个 `Arc`);框架不强制该约束,若注入不同实例,限速递增与读码落在不同后端,
/// 导致限速失效或验证码状态错乱。