docs(wiki): 全量代码验证驱动更新 — 10页基于实际扫描非文档推测
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
关键数字修正: - Rust 74.5K行(原66K), Tauri命令 183(原182), SaaS路由 121 - 前端组件 104, lib/ 85文件, Store 17+4子store - TODO/FIXME 仅 8 个(前端4+Rust4) 内容增强: - 中间件完整14层注册清单含注册条件和优先级分类 - Store完整目录结构, Pipeline完整目录树 - Hands测试分布, Memory 16个Tauri命令列表 - 管家模式: 关键词路由→语义路由(TF-IDF)修正 - 代码健康度指标新增
This commit is contained in:
73
wiki/saas.md
73
wiki/saas.md
@@ -25,7 +25,7 @@ tags: [module, saas, auth, billing]
|
||||
|
||||
```
|
||||
用户登录 (POST /api/v1/auth/login)
|
||||
→ Argon2id + OsRng 盐验证密码
|
||||
→ Argon2id + OsRg 盐验证密码
|
||||
→ 签发 JWT (Claims: user_id, role, pwv)
|
||||
→ set_auth_cookies():
|
||||
zclaw_access_token (path:/api, 2h TTL, HttpOnly)
|
||||
@@ -62,7 +62,7 @@ JWT password_version (pwv):
|
||||
→ 每次验证 JWT 时比对 Claims.pwv vs DB.pwv
|
||||
→ 修改密码 → DB.pwv 递增 → 所有旧 JWT 自动失效
|
||||
|
||||
密码存储: Argon2id + OsRng 随机盐
|
||||
密码存储: Argon2id + OsRg 随机盐
|
||||
TOTP 加密: AES-256-GCM + 随机 Nonce
|
||||
```
|
||||
|
||||
@@ -75,40 +75,52 @@ POST /api/v1/auth/refresh
|
||||
→ 签发新 access + refresh token
|
||||
```
|
||||
|
||||
### SaaS 模块结构(代码验证)
|
||||
|
||||
15 个模块目录 (`crates/zclaw-saas/src/`):
|
||||
|
||||
```
|
||||
account/ agent_template/ auth/ billing/ knowledge/
|
||||
migration/ model_config/ models/ prompt/ relay/
|
||||
role/ scheduled_task/ tasks/ telemetry/ workers/
|
||||
```
|
||||
|
||||
### SaaS API 分布
|
||||
|
||||
12 个路由模块,140 端点:
|
||||
121 个 `.route()` 调用,12 个路由模块 (main.rs `.merge()` 注册):
|
||||
|
||||
| 模块 | 端点数 | 说明 |
|
||||
|------|--------|------|
|
||||
| auth | ~10 | 登录/注册/刷新/2FA |
|
||||
| relay | ~5 | 聊天中转/模型列表/任务 |
|
||||
| billing | 10 | 配额/订阅/支付 |
|
||||
| knowledge | 23 | 知识库 CRUD + pgvector |
|
||||
| model_config | ~8 | Provider + 模型管理 |
|
||||
| account | ~8 | 用户管理 |
|
||||
| agent_template | ~8 | Agent 模板 |
|
||||
| role | 11 | 角色 + 权限 |
|
||||
| telemetry | ~5 | 用量统计 |
|
||||
| prompt | ~5 | Prompt 模板 |
|
||||
| scheduled_task | 5 | 定时任务 CRUD |
|
||||
| migration | ~2 | Schema 迁移 |
|
||||
| 模块 | 路由注册 | 说明 |
|
||||
|------|----------|------|
|
||||
| auth | handlers.rs | 登录/注册/刷新/2FA |
|
||||
| relay | relay/ | 聊天中转/模型列表/任务 |
|
||||
| billing | billing/ + callback_routes | 配额/订阅/支付 |
|
||||
| knowledge | knowledge/ | 知识库 CRUD + pgvector (最大模块) |
|
||||
| model_config | model_config/ | Provider + 模型管理 |
|
||||
| account | account/ | 用户管理 |
|
||||
| agent_template | agent_template/ | Agent 模板 |
|
||||
| role | role/ | 角色 + 权限 |
|
||||
| telemetry | telemetry/ | 用量统计 |
|
||||
| prompt | prompt/ | Prompt 模板 |
|
||||
| scheduled_task | scheduled_task/ | 定时任务 CRUD |
|
||||
| migration | migration/ | Schema 迁移 |
|
||||
|
||||
### 数据表 (34 个)
|
||||
### 数据表 (38 CREATE TABLE)
|
||||
|
||||
核心: users, agents, conversations, messages, billing_*, knowledge_*, model_configs, roles, permissions, scheduled_tasks, telemetry, agent_templates, saas_schema_version
|
||||
32 个 SQL 迁移文件,38 个 `CREATE TABLE` 语句。
|
||||
|
||||
核心表: users, agents, conversations, messages, billing_*, knowledge_*, model_configs, roles, permissions, scheduled_tasks, telemetry, agent_templates, saas_schema_version, user_profiles, trajectory_records
|
||||
|
||||
### Workers (7 个)
|
||||
|
||||
| Worker | 职责 |
|
||||
|--------|------|
|
||||
| log_operation | 操作日志 |
|
||||
| cleanup_rate_limit | 限流记录清理 |
|
||||
| cleanup_refresh_tokens | 刷新 token 清理 |
|
||||
| record_usage | 用量记录 |
|
||||
| update_last_used | 模型最后使用更新 |
|
||||
| aggregate_usage | 用量聚合 |
|
||||
| generate_embedding | 内容分块 (Phase 2 embedding deferred) |
|
||||
| Worker | 文件 | 职责 |
|
||||
|--------|------|------|
|
||||
| log_operation | workers/ | 操作日志 |
|
||||
| cleanup_rate_limit | workers/ | 限流记录清理 |
|
||||
| cleanup_refresh_tokens | workers/ | 刷新 token 清理 |
|
||||
| record_usage | workers/ | 用量记录 |
|
||||
| update_last_used | workers/ | 模型最后使用更新 |
|
||||
| aggregate_usage | workers/ | 用量聚合 |
|
||||
| generate_embedding | workers/ | 内容分块 (embedding deferred) |
|
||||
|
||||
## 关联模块
|
||||
|
||||
@@ -120,12 +132,13 @@ POST /api/v1/auth/refresh
|
||||
|
||||
| 文件 | 职责 |
|
||||
|------|------|
|
||||
| `crates/zclaw-saas/src/main.rs` | 路由注册入口 (12个 .merge()) |
|
||||
| `crates/zclaw-saas/src/auth/handlers.rs` | 认证端点 |
|
||||
| `crates/zclaw-saas/src/relay/` | 聊天中转 |
|
||||
| `crates/zclaw-saas/src/billing/` | 计费 |
|
||||
| `crates/zclaw-saas/src/knowledge/` | 知识库 (23 API) |
|
||||
| `crates/zclaw-saas/src/knowledge/` | 知识库 |
|
||||
| `crates/zclaw-saas/src/workers/` | 7 个后台 Worker |
|
||||
| `crates/zclaw-saas/migrations/` | SQL 迁移 (34 表) |
|
||||
| `crates/zclaw-saas/migrations/` | SQL 迁移 (32 文件) |
|
||||
| `admin-v2/src/pages/` | 15 页管理后台 |
|
||||
| `desktop/src/lib/saas-client.ts` | 前端 SaaS API 客户端 |
|
||||
| `desktop/src/store/saasStore.ts` | SaaS 认证状态 |
|
||||
|
||||
Reference in New Issue
Block a user