iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

chore: 提交所有工作进度 — SaaS 后端增强、Admin UI、桌面端集成

Browse Source 
包含大量 SaaS 平台改进、Admin 管理后台更新、桌面端集成完善、
文档同步、测试文件重构等内容。为 QA 测试准备干净工作树。
This commit is contained in:
iven
2026-03-29 10:46:26 +08:00
parent 9a5fad2b59
commit 5fdf96c3f5
268 changed files with 22011 additions and 3886 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
docs/superpowers/specs/2026-03-27-saas-backend-design.md
View File

@@ -391,8 +391,8 @@ pub mod permissions {
pub const ACCOUNT_READ: &str = "account:read";
pub const ACCOUNT_WRITE: &str = "account:write";
pub const ACCOUNT_ADMIN: &str = "account:admin";
pub const MODEL_READ: &str = "model:read";
pub const MODEL_WRITE: &str = "model:write";
pub const PROVIDER_MANAGE: &str = "provider:manage";
pub const MODEL_MANAGE: &str = "model:manage";
pub const RELAY_USE: &str = "relay:use";
pub const RELAY_ADMIN: &str = "relay:admin";
pub const CONFIG_READ: &str = "config:read";
@@ -404,8 +404,8 @@ pub mod permissions {
| 角色 | 权限 |
|------|------|
| `super_admin` | `admin:full` (授权检查时直接放行) |
| `admin` | account:read/write, model:read/write, relay:use/admin, config:read/write |
| `user` | model:read, relay:use, config:read |
| `admin` | account:read/write/admin, provider:manage, model:manage, relay:use/admin, config:read/write |
| `user` | relay:use, config:read |
### 4.4 API 端点
@@ -418,8 +418,8 @@ pub mod permissions {
| POST | `/api/v1/auth/totp/verify` | JWT | 验证并启用 TOTP |
| POST | `/api/v1/auth/totp/disable` | JWT | 禁用 TOTP |
| GET | `/api/v1/accounts` | account:read | 账号列表 |
| GET | `/api/v1/accounts/:id` | account:read | 账号详情 |
| PUT | `/api/v1/accounts/:id` | account:write | 更新账号 |
| GET | `/api/v1/accounts/:id` | 本人/account:read | 账号详情 |
| PATCH | `/api/v1/accounts/:id` | 本人/account:write | 更新账号 |
| PATCH | `/api/v1/accounts/:id/status` | account:admin | 启用/禁用 |
| GET | `/api/v1/tokens` | - (本人) | 列出 API 令牌 |
| POST | `/api/v1/tokens` | - (本人) | 创建令牌 |
@@ -481,25 +481,22 @@ pub enum AccountStatus { Active, Disabled, Suspended }
| 方法 | 路径 | 权限 | 说明 |
|------|------|------|------|
| GET | `/api/v1/providers` | model:read | 提供商列表 |
| POST | `/api/v1/providers` | model:write | 创建提供商 |
| GET | `/api/v1/providers/:id` | model:read | 提供商详情 |
| PUT | `/api/v1/providers/:id` | model:write | 更新提供商 |
| PATCH | `/api/v1/providers/:id/status` | model:write | 启用/禁用 |
| GET | `/api/v1/providers/:id/models` | model:read | 模型列表 |
| POST | `/api/v1/providers/:id/models` | model:write | 添加模型 |
| PUT | `/api/v1/models/:id` | model:write | 更新模型 |
| PATCH | `/api/v1/models/:id/status` | model:write | 启用/禁用模型 |
| GET | `/api/v1/account/api-keys` | - (本人) | 密钥列表 |
| POST | `/api/v1/account/api-keys` | - (本人) | 创建密钥 |
| PUT | `/api/v1/account/api-keys/:id` | - (本人) | 更新权限/标签 |
| POST | `/api/v1/account/api-keys/:id/rotate` | - (本人) | 轮换密钥 |
| PATCH | `/api/v1/account/api-keys/:id/status` | - (本人) | 启用/禁用 |
| DELETE | `/api/v1/account/api-keys/:id` | - (本人) | 撤销密钥 |
| GET | `/api/v1/usage/stats` | relay:admin | 总体统计 |
| GET | `/api/v1/usage/daily` | - (本人) | 每日统计 |
| GET | `/api/v1/usage/account/:id` | relay:admin | 账号统计 |
| GET | `/api/v1/catalog/models` | model:read | 公开模型目录 |
| GET | `/api/v1/providers` | 认证用户 | 提供商列表 |
| POST | `/api/v1/providers` | provider:manage | 创建提供商 |
| GET | `/api/v1/providers/:id` | 认证用户 | 提供商详情 |
| PATCH | `/api/v1/providers/:id` | provider:manage | 更新提供商 |
| DELETE | `/api/v1/providers/:id` | provider:manage | 删除提供商 |
| GET | `/api/v1/providers/:id/models` | 认证用户 | 模型列表 |
| GET | `/api/v1/models` | 认证用户 | 模型列表 |
| POST | `/api/v1/models` | model:manage | 创建模型 |
| GET | `/api/v1/models/:id` | 认证用户 | 模型详情 |
| PATCH | `/api/v1/models/:id` | model:manage | 更新模型 |
| DELETE | `/api/v1/models/:id` | model:manage | 删除模型 |
| GET | `/api/v1/keys` | - (本人) | API Key 列表 |
| POST | `/api/v1/keys` | - (本人) | 创建 API Key |
| DELETE | `/api/v1/keys/:id` | - (本人) | 撤销 API Key |
| POST | `/api/v1/keys/:id/rotate` | - (本人) | 轮换 API Key |
| GET | `/api/v1/usage` | - (本人) | 使用量统计 |
### 5.5 初始种子数据