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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! 用户级双态账号锁定子模块(吸收 keycloak UserLockoutStrategy)。
//! 提供用户级 temporary + permanent 双态锁定,与 BruteForceStrategy(IP 级)组合使用。
//! 详见 spec `user-lockout`。
//!
//! # 核心类型(T011)
//!
//! - [`WaitStrategy`](crate::account::lockout::WaitStrategy):等待策略 enum(Multiple 倍数 / Linear 线性)
//! - [`UserLockoutConfig`](crate::account::lockout::UserLockoutConfig):用户级锁定配置(5 字段)
//! - [`LockoutState`](crate::account::lockout::LockoutState):锁定状态(4 字段,DAO 持久化)
//!
//! # 策略实现(T012)
//!
//! T012 的 `UserLockoutStrategy` + `GarrisonFirewallStrategy` trait 实现位于 `strategy` 子模块。
use crateGarrisonDao;
use ;
use Arc;
/// 锁定状态存储抽象子模块。
///
/// v0.6.0 的 `UserLockoutStrategy` 直接通过 `GarrisonDao` 持久化 `LockoutState`,
/// 本子模块预留给未来版本的专用存储后端实现(Redis TTL / SQL 持久化 / 分布式锁定)。
/// 策略实现子模块(impl 块、辅助函数、inventory 注册)。
/// 等待策略,计算临时锁定时长。
///
/// - `Multiple`:倍数等待,第 N 次锁定时长 = `base_seconds × multiplier^(N-1)`
/// - `Linear`:线性等待,第 N 次锁定时长 = `base_seconds × N`
/// 用户级锁定配置。
///
/// 含 5 个公开字段,控制锁定行为阈值与策略。
/// 锁定状态,在 DAO 中以 `lockout:{user_id}` 为 key 持久化。
// ============================================================================
// UserLockoutStrategy:用户级双态锁定策略(T012)
// ============================================================================
/// 用户级双态锁定策略。
///
/// 实现 [`GarrisonFirewallStrategy`](crate::strategy::firewall::GarrisonFirewallStrategy) trait,
/// 与 `BruteForceStrategy`(IP 级)组合使用。
/// 通过 `lockout:{user_id}` key 在 DAO 中持久化 [`LockoutState`]。
///
/// impl 块与 trait 实现位于 [`strategy`] 子模块。
///
/// # 构造
///
/// ```ignore
/// use std::sync::Arc;
/// use garrison::account::lockout::{UserLockoutConfig, UserLockoutStrategy};
/// use garrison::dao::GarrisonDao;
///
/// let dao: Arc<dyn GarrisonDao> = /* oxcache 实现 */;
/// let strategy = UserLockoutStrategy::new(UserLockoutConfig::default(), dao);
/// ```