Files
ipass__ipass/rust/crates/ipass-core/src/models.rs
T
admin ee05b27a36 refactor(core): 采纳 sso 上游化 4 条 —— A1/A2/A3 + A1 配套
按 sso/docs/upstream-core-changes.md 评估后的采纳清单:

A1(强采纳):User 增加 `extra` flatten 透传通道,让插件字段不再污染内核模型
A1 配套:新增 `users::update_extra<T,F>`,与 set_allowed_models 同源
A2(修真 bug):state::split_value `position` → `rposition`(payload 含 0x1f
     时被 position 截断;sso 已踩、rposition 取最后一个边界)
A3:state::iter_prefix_ex 返回 (key, payload, exp);iter_prefix 保留兼容包装

不采纳:A4(iPass 已具备大部分,plugin-sso 自实现)、A5(选选项 2 零代码)、
       A6-1(破坏测试边界用例,iPass 内核最小约束,由插件加策略)、
       A6-2(admin login 端点直接用 COOKIE_NAME)

262 项回归全绿(gateway 102 + llm 160)。

详见 docs/plugin/SSO_UPSTREAM_DECISIONS.md。
2026-09-13 17:43:13 +08:00

85 lines
3.1 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 持久化数据模型。
//!
//! 字段名与旧版 `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<String, User>;
/// 单个账号。
///
/// `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<String>,
/// 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<String, Value>,
}
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
}