docs: wiki 全量更新 — 2026-04-14 代码验证驱动
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 77K行(274 .rs)、Tauri 189命令、SaaS 137 routes
- Admin V2 17页、SaaS 16模块(含industry)、@reserved 22
- SQL 20迁移/42表、TODO/FIXME 4个、dead_code 16

内容更新:
- known-issues: V13-GAP 全部标记已修复 + 三端联调测试结果
- middleware: 14层 runtime + 10层 SaaS HTTP 完整清单
- saas: industry模块、路由模块13个、数据表42个
- routing: Store含industryStore、21个Store文件
- butler: 行业配置接入ButlerPanel、4内置行业
- log: 三端联调+V13修复记录追加
This commit is contained in:
iven
2026-04-14 22:15:53 +08:00
parent d0aabf5f2e
commit 27b98cae6f
12 changed files with 137 additions and 69 deletions

View File

@@ -1,6 +1,6 @@
---
title: SaaS 平台
updated: 2026-04-11
updated: 2026-04-14
status: active
tags: [module, saas, auth, billing]
---
@@ -77,17 +77,17 @@ POST /api/v1/auth/refresh
### SaaS 模块结构(代码验证)
15 个模块目录 (`crates/zclaw-saas/src/`):
16 个模块目录 (`crates/zclaw-saas/src/`):
```
account/ agent_template/ auth/ billing/ knowledge/
migration/ model_config/ models/ prompt/ relay/
role/ scheduled_task/ tasks/ telemetry/ workers/
account/ agent_template/ auth/ billing/ industry/
knowledge/ migration/ model_config/ models/ prompt/
relay/ role/ scheduled_task/ tasks/ telemetry/ workers/
```
### SaaS API 分布
121`.route()` 调用12 个路由模块 (main.rs `.merge()` 注册):
137`.route()` 调用13 个路由模块 (main.rs `.merge()` 注册):
| 模块 | 路由注册 | 说明 |
|------|----------|------|
@@ -102,13 +102,14 @@ role/ scheduled_task/ tasks/ telemetry/ workers/
| telemetry | telemetry/ | 用量统计 |
| prompt | prompt/ | Prompt 模板 |
| scheduled_task | scheduled_task/ | 定时任务 CRUD |
| industry | industry/ | 行业配置管理 (V13 新增) |
| migration | migration/ | Schema 迁移 |
### 数据表 (38 CREATE TABLE)
### 数据表 (42 CREATE TABLE)
32 个 SQL 迁移文件,38`CREATE TABLE` 语句。
20 个 SQL 迁移文件,42`CREATE TABLE` 语句。
核心表: users, agents, conversations, messages, billing_*, knowledge_*, model_configs, roles, permissions, scheduled_tasks, telemetry, agent_templates, saas_schema_version, user_profiles, trajectory_records
核心表: users, agents, conversations, messages, billing_*, knowledge_*, model_configs, roles, permissions, scheduled_tasks, telemetry, agent_templates, saas_schema_version, user_profiles, trajectory_records, industries, account_industries
### Workers (7 个)
@@ -132,14 +133,14 @@ role/ scheduled_task/ tasks/ telemetry/ workers/
| 文件 | 职责 |
|------|------|
| `crates/zclaw-saas/src/main.rs` | 路由注册入口 (12个 .merge()) |
| `crates/zclaw-saas/src/main.rs` | 路由注册入口 (13个 .merge()) |
| `crates/zclaw-saas/src/auth/handlers.rs` | 认证端点 |
| `crates/zclaw-saas/src/relay/` | 聊天中转 |
| `crates/zclaw-saas/src/billing/` | 计费 |
| `crates/zclaw-saas/src/knowledge/` | 知识库 |
| `crates/zclaw-saas/src/workers/` | 7 个后台 Worker |
| `crates/zclaw-saas/migrations/` | SQL 迁移 (32 文件) |
| `admin-v2/src/pages/` | 15 页管理后台 |
| `crates/zclaw-saas/migrations/` | SQL 迁移 (20 文件) |
| `admin-v2/src/pages/` | 17 页管理后台 |
| `desktop/src/lib/saas-client.ts` | 前端 SaaS API 客户端 |
| `desktop/src/store/saasStore.ts` | SaaS 认证状态 |