docs(wiki): 系统性更新 — L0速览+L1模块标准化+L2功能链路映射(33条)

三层架构增强:
- L0 index.md: 用户功能清单+跨模块数据流全景图+导航树增强 (92→143行)
- L1 8个模块页标准化: 功能清单/API接口/测试链路/已知问题
  routing(252→326) chat(101→157) saas(153→230) memory(182→333)
  butler(137→179) middleware(121→159) hands-skills(218→257) pipeline(111→156)
- L1 新增2页: security.md(157行) data-model.md(180行)
- L2 feature-map.md: 33条端到端功能链路映射(408行)

维护机制: CLAUDE.md §8.3 wiki触发规则 5→9条
设计文档: docs/superpowers/specs/2026-04-21-wiki-systematic-overhaul-design.md

wiki/saas.md

@@ -1,6 +1,6 @@
 ---
 title: SaaS 平台
-updated: 2026-04-19
+updated: 2026-04-21
 status: active
 tags: [module, saas, auth, billing]
 ---
@@ -19,6 +19,28 @@ tags: [module, saas, auth, billing]
 3. **计费闭环** — 配额实时递增 → 聚合器调度 → mock 支付路由
 4. **Admin V2** — 17 页管理后台，管理模型/用户/计费/知识库
 
+## 功能清单
+
+| 功能 | 描述 | 入口文件 | 状态 |
+|------|------|----------|------|
+| 用户认证 | 注册/登录/JWT刷新/登出 | auth/handlers.rs | ✅ |
+| TOTP 2FA | 设置/验证/禁用 | auth/handlers.rs | ✅ |
+| Token Pool | RPM/TPM 轮换 Key 分配 | relay/handlers.rs | ✅ |
+| 聊天中转 | OpenAI 兼容 relay | relay/handlers.rs | ✅ |
+| 计费系统 | 配额递增/订阅/支付回调 | billing/ | ✅ |
+| 用户管理 | CRUD/状态/设备/token | account/ | ✅ |
+| 模型管理 | Provider/模型/Key CRUD | model_config/ | ✅ |
+| Agent 模板 | 模板 CRUD + 自动分配 | agent_template/ | ✅ |
+| 知识库 | 分类/条目/搜索/pgvector | knowledge/ | ✅ |
+| Prompt 管理 | 版本控制/回滚 | prompt/ | ✅ |
+| 角色权限 | RBAC + 权限模板 | role/ | ✅ |
+| 行业配置 | 行业 CRUD + 账户分配 | industry/ | ✅ |
+| 定时任务 | 任务调度 CRUD | scheduled_task/ | ✅ |
+| 用量统计 | Telemetry 上报/查询 | telemetry/ | ✅ |
+| 配置同步 | 项 CRUD/分析/seed/sync/diff | migration/ | ✅ |
+| Admin Dashboard | 系统概览 + 运营指标 | account/admin_routes | ✅ |
+| Mock 支付 | 开发环境模拟支付 | billing/mock_routes | ✅ |
+
 ## 代码逻辑
 
 ### 认证流
@@ -123,6 +145,52 @@ relay/  role/  scheduled_task/  tasks/  telemetry/  workers/
 | aggregate_usage | workers/ | 用量聚合 |
 | generate_embedding | workers/ | 内容分块 (embedding deferred) |
 
+## API 接口
+
+~118 个唯一路由，分布在 13 个模块中（详见上方「SaaS API 分布」和各模块 `mod.rs`）。
+
+| 模块 | 路由数 | 核心端点 |
+|------|--------|---------|
+| auth | 9 | POST /auth/{register,login,refresh,logout} + TOTP + password |
+| relay | 5 | POST /relay/chat/completions + GET /relay/models |
+| billing | 12 | 订阅/用量/支付/mock/回调/invoice |
+| knowledge | 24 | 分类/条目/搜索/上传/版本/分析/结构化 |
+| model_config | 19 | Provider/模型/Key/模型组/用量 |
+| account | 12 | CRUD/状态/token/设备/操作日志/dashboard |
+| agent_template | 11 | 模板 CRUD + 创建 Agent + 分配 |
+| industry | 8 | 行业 CRUD + 账户分配 |
+| prompt | 6 | Prompt CRUD + 版本/回滚 |
+| role | 6 | 角色/权限模板 CRUD |
+| telemetry | 4 | 上报/统计/日报/审计 |
+| scheduled_task | 2 | 定时任务 CRUD |
+| migration | 8 | 配置项 CRUD + 分析/seed/sync/diff |
+
+## 测试链路
+
+| 功能 | 测试文件 | 说明 |
+|------|---------|------|
+| 认证 | `crates/zclaw-saas/tests/auth_test.rs` | 注册/登录/刷新/登出 |
+| 认证安全 | `crates/zclaw-saas/tests/auth_security_test.rs` | 安全边界场景 |
+| 账户 | `crates/zclaw-saas/tests/account_test.rs` | CRUD/token/设备 |
+| 账户安全 | `crates/zclaw-saas/tests/account_security_test.rs` | 安全边界 |
+| Agent 模板 | `crates/zclaw-saas/tests/agent_template_test.rs` | 模板 CRUD |
+| 计费 | `crates/zclaw-saas/tests/billing_test.rs` | 计划/订阅/支付 |
+| 知识库 | `crates/zclaw-saas/tests/knowledge_test.rs` | CRUD/搜索 |
+| 模型配置 | `crates/zclaw-saas/tests/model_config_test.rs` | Provider/模型/Key |
+| 模型配置扩展 | `crates/zclaw-saas/tests/model_config_extended_test.rs` | 扩展覆盖 |
+| Prompt | `crates/zclaw-saas/tests/prompt_test.rs` | 版本管理 |
+| 权限矩阵 | `crates/zclaw-saas/tests/permission_matrix_test.rs` | 角色/权限 |
+| Relay | `crates/zclaw-saas/tests/relay_test.rs` | 聊天中转 |
+| Relay 验证 | `crates/zclaw-saas/tests/relay_validation_test.rs` | 请求验证 |
+| 角色 | `crates/zclaw-saas/tests/role_test.rs` | 角色 CRUD |
+| 定时任务 | `crates/zclaw-saas/tests/scheduled_task_test.rs` | 任务 CRUD |
+| Telemetry | `crates/zclaw-saas/tests/telemetry_test.rs` | 上报/查询 |
+| 配置同步 | `crates/zclaw-saas/tests/migration_test.rs` | sync/diff/seed |
+| Admin 启动 | `crates/zclaw-saas/tests/smoke_saas.rs` | 启动冒烟 |
+| Admin V2 UI | `admin-v2/tests/pages/*.test.tsx` (17文件) | 每页独立测试 |
+| 桌面端 SaaS | `tests/desktop/connectionStore.adminRouting.test.ts` | Admin 路由 |
+| 桌面端集成 | `tests/desktop/integration/zclaw-api.test.ts` | API 集成 |
+
 ## 关联模块
 
 - [[routing]] — SaaS Relay 是 Tauri 的主路径
@@ -151,3 +219,12 @@ relay/  role/  scheduled_task/  tasks/  telemetry/  workers/
 - Cookie Secure (dev=false, prod=true)
 - JWT 签名密钥 >= 32 字符 (release fallback 拒绝启动)
 - 独立 TOTP 加密密钥
+
+## 已知问题
+
+- ⚠️ **Admin 用量统计显示 0/0** — P2 Open。Dashboard 显示 17 requests / 6304 tokens，但 Usage 页显示 0/0，数据源不一致
+- ⚠️ **SaaS Embedding 生成未实现** — Open。pgvector 索引就绪，`generate_embedding.rs` Worker 存在但生成逻辑未实现
+- ⚠️ **AuthGuard 竞态条件** — P1-04 Deferred。并发请求时可能绕过认证
+- ✅ **Dashboard 404** — BUG-H1 已修复。`/api/v1/admin/dashboard` 路由注册遗漏
+- ✅ **invoice_id 未暴露** — BUG-M1 已修复
+- ✅ **非 Admin 返回 404 而非 403** — BUG-M4 已修复 (admin_guard_middleware)