按「上游内核为基准」收敛: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 为部署依赖)
36 lines
1.5 KiB
Rust
36 lines
1.5 KiB
Rust
//! 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;
|