//! 持久化数据模型。 //! //! 字段名与旧版 `data/users.json` / `data/domains.json` **逐字对应**, //! 以便新版直接接管旧数据文件、且管理台前端无需改动。 use serde::{Deserialize, Serialize}; use serde_json::Value; use std::collections::BTreeMap; /// 账号表(`users.json`):以账号名为 key 的对象。 pub type UserTable = BTreeMap; /// 单个账号。 /// /// `temp_grant_until` 是「临时授权权限」的到期时间戳;> now 表示当前拥有 /// 该权限,申请临时域名时可跳过审核直接放行。 #[derive(Debug, Clone, Serialize, Deserialize)] pub struct User { pub username: String, /// 中文姓名等展示名。**只用于展示**,不参与鉴权、不参与热路径查询。 /// /// `username` 规则是 ASCII(`valid_username`),中文名塞不进账号名, /// 所以「吴桂荣」这类实名单独放这里;留空时前端回落到 `username`。 #[serde(default)] pub display_name: String, /// `admin` | `user` pub role: String, pub salt: String, /// 迭代加盐 SHA-256 pub pwd_hash: String, /// `sk_<48 位 hex>`。 /// /// LLM 代理与域名接口**共用这一把 Key**——这正是「用同一套 Key 验证」 /// 的落点,所以重置 Key 会同时影响两个入口。 pub api_key: String, /// LLM 代理可用的上游 slot 白名单。空 = 不限。 /// /// 老数据没有该字段,`serde(default)` 反序列化得空表,语义正好是「不限」。 #[serde(default)] pub allowed_models: Vec, /// LLM 每分钟请求上限。老数据缺省 → 全局默认(`LLM_RPM_DEFAULT`);0 = 不限 #[serde(default = "default_llm_rpm")] pub llm_rpm: i64, /// LLM 每日请求上限。老数据缺省 → 全局默认(`LLM_DAILY_DEFAULT`);0 = 不限 #[serde(default = "default_llm_daily")] pub llm_daily: i64, #[serde(default)] pub temp_grant_until: i64, #[serde(default)] pub created_at: i64, /// 插件字段透传:内核持有、**不解释**。 /// /// 反序列化时,文件中**未被上面字段认领的 key 自动进 `extra`**;序列化时 /// 展开回顶层(`#[serde(flatten)]`)。`serde` 优先匹配已认领字段,所以 /// 存量 `users.json`(含任何插件写入的字段)可原样接管,**不会因内核不 /// 认识而丢数据**——这是 iPass 向上游 sso 合流的扩展点(A1)。 /// /// 未来插件要存 TOTP 密钥、邮箱、用户组、锁定状态……都直接往 `extra` /// 写,不再走内核加字段。修改走 [`crate::users::update_extra`] 的 /// 「读-改-写」原语。 #[serde(default, flatten)] pub extra: BTreeMap, } impl User { /// 是否拥有「临时授权权限」 pub fn has_temp_permission(&self, now: i64) -> bool { self.temp_grant_until > now } pub fn is_admin(&self) -> bool { self.role == "admin" } } fn default_llm_rpm() -> i64 { crate::config::LLM_RPM_DEFAULT } fn default_llm_daily() -> i64 { crate::config::LLM_DAILY_DEFAULT }