Files
sso/source/rust/crates/ipass-core/src/lib.rs
T
ssw 74e5678188 refactor(core): 内核原样同步上游 ipass-core ee05b27 (1.0.13)
按「上游内核为基准」收敛:ipass-core 14 文件与 refs/ipass 逐字节一致。
- 上游采纳我方建议已实现:User.extra flatten (A1) + users::update_extra、
  split_value rposition (A2)、iter_prefix_ex (A3)
- 新增内核身份端点 api.rs/auth.rs (CorePlugin) + usage.rs
- audit.rs 迁出内核(仅 sso 使用 → plugin-sso 本地模块)
- Cargo.toml 元数据保留我方 crate 名(产物 libsso_gateway.dylib 为部署依赖)
2026-09-13 18:52:26 +08:00

36 lines
1.5 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.
//! ipass-core —— iPass 内核。
//!
//! 承担「去掉任何插件,网关还能跑」的部分:
//!
//! * `state` —— 唯一共享内存 zone(`RwLock<RbTreeMap>`)+ 文件写锁
//! * `store` —— JSON 原子写 + 跨 worker 互斥(状态就是几个 JSON 文件,无数据库)
//! * `users` —— 账号唯一写入口(`ukey:` Key 索引、播种管理员、删除钩子)
//! * `session` —— 管理会话
//! * `auth`(P3 起)—— 下行 `sk_` 鉴权 + `rl:` 配额(LLM 与 API 代理两条链路共用)
//! * `config` / `models` / `util` / `http` —— 常量、账号模型与通用原语
//!
//! 插件(plugin-domain / plugin-llm / plugin-apix)只允许**单向依赖**本 crate;
//! 内核不认识任何插件。插件通过 `Plugin` trait(P1 引入)与 gateway 装配。
//!
//! ## 关键实现约束(均为实测/查证确认,详见 CLAUDE.md)
//!
//! * 共享内存只有 `RwLock<RbTreeMap<_, _, SlabPool>, _>` 一种安全形态;
//! `SlabPool` 只能在 zone 初始化回调里取出,锁本身也必须用
//! `ngx::allocator::allocate` 放进共享内存,否则各 worker 拿到的是各自的副本。
//! * 热路径**永不回源**:每请求决策只读共享内存;任何写操作必须
//! 先落文件、再写穿 shm,写 shm 失败必须 `log_err`。
pub mod api;
pub mod auth;
pub mod config;
pub mod http;
pub mod loc;
pub mod models;
pub mod plugin;
pub mod session;
pub mod state;
pub mod store;
pub mod usage;
pub mod users;
pub mod util;