Update: 将子项目从 submodule 转为完整内容
- 移除 GovAI, nomifun-tauri, 算力盒子 的 submodule 引用 - 添加所有子项目的完整源代码 - 保留原始 .git 为 .git.bak 备份
This commit is contained in:
freedak
@@ -0,0 +1,470 @@
|
||||
# 通用AI工作台底座平台 — 需求文档
|
||||
|
||||
> 文档编号：REQ-COMMONSP-001
|
||||
> 版本：v2.0.0
|
||||
> 日期：2026-03-14
|
||||
> 状态：单租户优先架构
|
||||
> 项目缩写：COMMONSP（Commons Platform）
|
||||
|
||||
---
|
||||
|
||||
## 1. 引言
|
||||
|
||||
### 1.1 背景
|
||||
|
||||
nomifun-tauri 是目前已有的通用AI工作台底座，采用 Rust(axum) + Vue 前端架构，本地优先（SQLite）+ 插件驱动。核心能力包括 Agent Engine、Skills System、Knowledge RAG、MCP Gateway、Channels Bus。
|
||||
|
||||
现有系统是**单租户单用户**架构，需要演进为**单租户优先 + 可扩展租户模型**平台，支持政府/企业/教育三大领域定制，即 PrivBox-AIStation 软硬一体化产品的软件核心。
|
||||
|
||||
**架构决策**：PrivBox 典型部署场景为单台设备私有化部署（医院/学校/企业），物理隔离已满足数据安全需求。因此 Phase 1 采用**单租户优先**模式，保留租户抽象作为扩展点，未来需要多租户 SaaS 时改动最小。
|
||||
|
||||
本文档定义 **Phase 1 MVP** 的完整需求，目标是建立单租户定制框架（主题/领域/品牌）、多用户管理体系、审计日志能力，为后续三大领域包奠定底座。
|
||||
|
||||
### 1.2 范围
|
||||
|
||||
| 范围 | 说明 |
|
||||
|------|------|
|
||||
| **本文档** | Phase 1 MVP 软件系统需求 |
|
||||
| **不包括** | 硬件适配（PrivBox HAL）、领域包开发（GovPack/EntPack/EduPack）、插件市场 |
|
||||
| **技术栈** | Rust(axum) + Vue + SQLite/sqlx（复用 nomifun-tauri 技术栈） |
|
||||
|
||||
### 1.3 与现有 nomifun-tauri 的关系
|
||||
|
||||
```
|
||||
nomifun-tauri (当前)
|
||||
│
|
||||
│ Phase 1: 单租户优先 + 主题引擎 + 领域框架 + 多用户
|
||||
▼
|
||||
nomifun-tauri (演进后) = Commons Platform v1.0
|
||||
│ - 默认单租户，数据天然隔离
|
||||
│ - 保留 tenant_id 字段，未来扩展多租户成本低
|
||||
│
|
||||
│ Phase 2: 三大领域包
|
||||
▼
|
||||
PrivBox-AIStation 软件层
|
||||
```
|
||||
|
||||
### 1.4 架构决策
|
||||
|
||||
| 决策项 | 选择 | 理由 |
|
||||
|--------|------|------|
|
||||
| 租户隔离策略 | 无需激活 | 单机部署物理隔离已满足需求 |
|
||||
| 数据层 tenant_id | 保留字段 | 未来扩展多租户 SaaS 成本最低 |
|
||||
| 默认租户 | 自动创建 | 首次启动自动初始化，无需手动注册 |
|
||||
| 租户配置 | 保留 | 用于单租户的品牌定制、主题切换 |
|
||||
|
||||
---
|
||||
|
||||
## 2. 术语表
|
||||
|
||||
| 术语 | 英文 | 定义 |
|
||||
|------|------|------|
|
||||
| **租户配置** | Tenant Config | 单租户场景下的全局配置，包含品牌、主题、功能开关 |
|
||||
| **主题** | Theme | 视觉定制包，包含配色、Logo、品牌元素 |
|
||||
| **领域** | Domain | 行业分类（Government/Enterprise/Education/Custom） |
|
||||
| **领域配置** | Domain Config | 领域特定的初始化参数、分类体系、模板 |
|
||||
| **技能包** | Skill Pack | 一组相关技能的集合，可按领域打包 |
|
||||
| **知识库模板** | Knowledge Template | 领域特定的知识库分类和初始数据 |
|
||||
| **RBAC** | Role-Based Access Control | 基于角色的访问控制 |
|
||||
| **审计日志** | Audit Log | 记录所有敏感操作的不可篡改日志 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 角色定义
|
||||
|
||||
| 角色 | 说明 | 权限范围 |
|
||||
|------|------|---------|
|
||||
| **系统管理员** | 安装部署后的初始管理员 | 所有配置、用户管理、功能开关 |
|
||||
| **普通用户** | 终端用户 | 使用 AI 对话、技能、知识库等业务功能 |
|
||||
|
||||
> **说明**：单租户模式下，"租户管理员"等价于"系统管理员"。保留"系统管理员"角色，未来扩展多租户时再区分"系统管理员"和"租户管理员"。
|
||||
|
||||
---
|
||||
|
||||
## 4. 功能性需求
|
||||
|
||||
### 4.1 租户系统（单租户优先）
|
||||
|
||||
#### FR-TENANT-001：默认租户自动初始化
|
||||
- WHEN 首次启动系统，THEN 系统 SHALL 自动创建默认租户配置
|
||||
- WHEN 初始化时，THEN 用户 SHALL 提供组织名称、选择领域类型（Government/Enterprise/Education/Custom）
|
||||
- WHEN 初始化完成后，THEN 系统 SHALL 自动应用对应的预设主题和领域配置
|
||||
|
||||
#### FR-TENANT-002：租户配置（系统配置）
|
||||
- WHEN 系统管理员访问配置页，THEN 系统 SHALL 展示并允许修改：组织名称、品牌定制、功能开关、数据策略
|
||||
- WHEN 功能开关变更时，THEN 系统 SHALL 实时生效，无需重启
|
||||
- **说明**：单租户模式下，所有配置直接生效，无需租户上下文路由
|
||||
|
||||
#### FR-TENANT-003：数据迁移与备份
|
||||
- WHEN 系统管理员触发数据备份，THEN 系统 SHALL 导出全部数据（SQLite schema + 文件存储）
|
||||
- WHEN 导入备份时，THEN 系统 SHALL 验证数据完整性并重建
|
||||
|
||||
#### FR-TENANT-004：多租户扩展点（预留）
|
||||
- WHEN 未来需要支持多租户 SaaS，THEN 系统 SHALL 可通过 tenant_id 字段实现数据隔离
|
||||
- **说明**：Phase 1 所有表保留 tenant_id 字段，但默认不激活隔离逻辑
|
||||
|
||||
### 4.2 主题引擎
|
||||
|
||||
#### FR-THEME-001：动态主题切换
|
||||
- WHEN 系统管理员切换主题，THEN 系统 SHALL 在 100ms 内完成切换，前端无需刷新
|
||||
- WHEN 用户访问工作台时，THEN 系统 SHALL 自动应用当前配置的主题
|
||||
|
||||
#### FR-THEME-002：预设主题包
|
||||
- WHEN 选择预设主题，THEN 系统 SHALL 支持以下主题：
|
||||
- **政务蓝主题**：GovAI 政务配色体系
|
||||
- **企业专业主题**：商务蓝色调
|
||||
- **学术清新主题**：简洁学术风格
|
||||
- WHEN 主题包含 Logo 定制，THEN 系统 SHALL 支持上传 PNG/SVG 格式
|
||||
|
||||
#### FR-THEME-003：主题预览
|
||||
- WHEN 系统管理员在主题编辑器中修改，THEN 系统 SHALL 提供实时预览
|
||||
- WHEN 预览满意后，THEN 管理员 SHALL 一键发布生效
|
||||
|
||||
### 4.3 领域框架
|
||||
|
||||
#### FR-DOMAIN-001：领域配置 Schema
|
||||
- WHEN 初始化系统时，THEN 系统 SHALL 根据选择的领域类型加载对应的领域配置 Schema
|
||||
- WHEN 领域配置包含分类体系时，THEN 系统 SHALL 自动创建对应的知识库分类和应用模板入口
|
||||
|
||||
#### FR-DOMAIN-002：领域初始化向导
|
||||
- WHEN 首次配置系统，THEN 系统 SHALL 提供领域初始化向导，引导配置：
|
||||
- 部门/科室设置（如适用）
|
||||
- 知识库分类初始化
|
||||
- 预置技能包选择
|
||||
|
||||
#### FR-DOMAIN-003：领域特定技能包注册
|
||||
- WHEN 安装领域技能包时，THEN 系统 SHALL 自动注册到该领域的技能目录
|
||||
- WHEN 技能包与领域不兼容时，THEN 系统 SHALL 提示警告但不阻止安装
|
||||
|
||||
### 4.4 多用户认证与权限
|
||||
|
||||
#### FR-AUTH-001：用户注册与登录
|
||||
- WHEN 新用户注册时，THEN 系统 SHALL 支持用户名+密码方式
|
||||
- WHEN 用户登录时，THEN 系统 SHALL 使用现有的 JWT 认证机制
|
||||
- WHEN 登录失败时，THEN 系统 SHALL 返回错误信息，不泄露账户是否存在
|
||||
|
||||
#### FR-AUTH-002：角色权限模型（RBAC）
|
||||
- WHEN 系统管理员创建用户时，THEN 系统 SHALL 支持分配角色（普通用户/系统管理员）
|
||||
- WHEN 普通用户访问管理员功能时，THEN 系统 SHALL 返回 403 权限不足
|
||||
- WHEN 角色权限变更时，THEN 系统 SHALL 实时生效
|
||||
|
||||
#### FR-AUTH-003：会话管理
|
||||
- WHEN 用户登录后，THEN 系统 SHALL 生成带刷新令牌的 JWT
|
||||
- WHEN JWT 过期时，THEN 系统 SHALL 支持静默刷新
|
||||
- WHEN 用户登出时，THEN 系统 SHALL 使 refresh token 失效
|
||||
|
||||
### 4.5 审计日志
|
||||
|
||||
#### FR-AUDIT-001：操作审计记录
|
||||
- WHEN 用户执行以下操作时，THEN 系统 SHALL 记录审计日志：
|
||||
- 用户登录/登出
|
||||
- 系统配置变更
|
||||
- 用户创建/删除/权限变更
|
||||
- 知识库上传/删除
|
||||
- 敏感技能包安装/卸载
|
||||
- WHEN 记录审计日志时，THEN 系统 SHALL 包含：操作时间、操作用户、操作类型、操作对象、操作结果、来源IP
|
||||
|
||||
#### FR-AUDIT-002：审计日志查询
|
||||
- WHEN 系统管理员访问审计日志页，THEN 系统 SHALL 支持按时间范围、操作类型、用户筛选
|
||||
- WHEN 导出审计日志时，THEN 系统 SHALL 支持 CSV 格式导出
|
||||
|
||||
#### FR-AUDIT-003：审计日志不可篡改
|
||||
- WHEN 审计日志写入后，THEN 系统 SHALL 保证不可修改、不可删除
|
||||
- WHEN 需要追加日志时，THEN 系统 SHALL 仅允许追加操作
|
||||
|
||||
### 4.6 配置导入导出
|
||||
|
||||
#### FR-CONFIG-001：配置导出
|
||||
- WHEN 系统管理员触发配置导出，THEN 系统 SHALL 导出完整配置（不含敏感数据）
|
||||
- WHEN 导出时，THEN 系统 SHALL 包含系统配置、用户列表、知识库索引、主题配置
|
||||
|
||||
#### FR-CONFIG-002：配置导入
|
||||
- WHEN 管理员导入配置文件，THEN 系统 SHALL 验证配置合法性
|
||||
- WHEN 配置导入时，THEN 系统 SHALL 支持合并或覆盖模式
|
||||
|
||||
---
|
||||
|
||||
## 5. 非功能性需求
|
||||
|
||||
### 5.1 性能
|
||||
|
||||
| 指标 | 目标值 |
|
||||
|------|--------|
|
||||
| 冷启动时间 | < 3s |
|
||||
| 主题切换延迟 | < 100ms |
|
||||
| 租户创建时间 | < 1min |
|
||||
| 对话响应延迟 | < 500ms（不含模型推理） |
|
||||
|
||||
### 5.2 安全
|
||||
|
||||
| 需求 | 说明 |
|
||||
|------|------|
|
||||
| 数据隔离 | 单机部署物理隔离已满足，无需额外租户隔离 |
|
||||
| 传输加密 | HTTPS/TLS 1.3（WebSocket + REST） |
|
||||
| 存储加密 | SQLite 数据库加密（AES-256，可选） |
|
||||
| 密钥管理 | JWT secret 独立存储，不硬编码 |
|
||||
|
||||
### 5.3 可用性
|
||||
|
||||
| 需求 | 说明 |
|
||||
|------|------|
|
||||
| 离线优先 | 网络中断时核心功能可用 |
|
||||
| 错误恢复 | 异常操作自动回滚，不破坏数据完整性 |
|
||||
| 日志诊断 | 完整的错误日志，便于问题定位 |
|
||||
|
||||
### 5.4 可扩展性
|
||||
|
||||
| 需求 | 说明 |
|
||||
|------|------|
|
||||
| 领域扩展 | 新增领域类型时，无需修改核心代码 |
|
||||
| 插件集成 | 保持与现有 MCP 插件系统的兼容性 |
|
||||
| 数据迁移 | 未来可平滑迁移到 PostgreSQL |
|
||||
|
||||
---
|
||||
|
||||
## 6. 关键约束与假设
|
||||
|
||||
### 6.1 约束
|
||||
|
||||
1. **复用 nomifun-tauri**：Phase 1 不重写现有模块，在现有架构上扩展单租户定制能力
|
||||
2. **SQLite 本地优先**：继续使用 SQLite 作为主要数据存储，暂不引入 PostgreSQL
|
||||
3. **前端改动最小化**：主题引擎优先通过 CSS 变量 + 动态加载实现，减少 Vue 组件改动
|
||||
4. **不涉及硬件**：本文档不包含 PrivBox 硬件适配内容
|
||||
5. **单租户优先**：不激活多租户隔离逻辑，简化开发和部署
|
||||
|
||||
### 6.2 假设
|
||||
|
||||
1. 假设 Phase 1 部署场景为单机私有化部署
|
||||
2. 假设物理隔离已满足数据安全需求
|
||||
3. 假设管理员可通过管理后台完成所有配置操作（无需命令行）
|
||||
4. 假设审计日志存储在 SQLite 中
|
||||
|
||||
---
|
||||
|
||||
## 7. 数据模型（核心扩展）
|
||||
|
||||
### 7.1 新增数据模型
|
||||
|
||||
```rust
|
||||
// 系统配置（单租户模式，单条记录）
|
||||
struct SystemConfig {
|
||||
id: String, // "default"
|
||||
org_name: String, // 组织名称
|
||||
domain: DomainType, // Government / Enterprise / Education / Custom
|
||||
created_at: TimestampMs,
|
||||
updated_at: TimestampMs,
|
||||
}
|
||||
|
||||
// 品牌配置（单租户模式）
|
||||
struct BrandingConfig {
|
||||
config_id: String, // "default"
|
||||
logo_url: Option<String>,
|
||||
logo_svg: Option<String>, // SVG 内联
|
||||
primary_color: String,
|
||||
secondary_color: String,
|
||||
accent_color: String,
|
||||
theme_preset: ThemePreset,
|
||||
}
|
||||
|
||||
// 功能开关（单租户模式）
|
||||
struct FeatureFlags {
|
||||
config_id: String,
|
||||
app_store: bool,
|
||||
skill_market: bool,
|
||||
multi_user: bool,
|
||||
cloud_sync: bool,
|
||||
}
|
||||
|
||||
// 领域配置
|
||||
struct DomainConfig {
|
||||
id: i64, // 自增主键
|
||||
domain_type: DomainType,
|
||||
config_json: String, // 领域特定配置的 JSON 序列化
|
||||
created_at: TimestampMs,
|
||||
}
|
||||
|
||||
// 审计日志
|
||||
struct AuditLog {
|
||||
id: i64, // 自增主键
|
||||
user_id: String,
|
||||
action: String,
|
||||
object_type: String,
|
||||
object_id: Option<String>,
|
||||
result: String, // success / failure
|
||||
source_ip: Option<String>,
|
||||
extra: String, // JSON 额外信息
|
||||
created_at: TimestampMs,
|
||||
}
|
||||
|
||||
// 扩展：用户表新增角色
|
||||
struct User {
|
||||
// ... 现有字段 ...
|
||||
role: UserRole, // admin / user
|
||||
}
|
||||
```
|
||||
|
||||
### 7.2 现有模型扩展
|
||||
|
||||
| 现有表 | 扩展字段 | 说明 |
|
||||
|--------|---------|------|
|
||||
| `users` | `role` | 用户角色（保留 tenant_id 字段但不使用） |
|
||||
| `conversations` | - | 保持不变（单租户无需隔离） |
|
||||
| `messages` | - | 保持不变 |
|
||||
| `knowledge_bases` | - | 保持不变 |
|
||||
| `providers` | - | 保持不变 |
|
||||
| `assistants` | - | 保持不变 |
|
||||
|
||||
### 7.3 多租户扩展点（预留）
|
||||
|
||||
> 以下字段保留以备未来扩展，Phase 1 不激活隔离逻辑
|
||||
|
||||
```rust
|
||||
// 未来多租户场景下启用
|
||||
struct FutureMultiTenant {
|
||||
tenant_id: String, // 保留字段
|
||||
}
|
||||
|
||||
// 所有表可选添加 tenant_id
|
||||
ALTER TABLE users ADD COLUMN tenant_id TEXT; -- 保留但默认填充 "default"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. API 设计（核心接口）
|
||||
|
||||
### 8.1 系统配置
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/config` | GET | 获取系统配置（组织名、领域） |
|
||||
| `/api/config` | PUT | 更新系统配置 |
|
||||
| `/api/config/init` | POST | 初始化系统（首次启动） |
|
||||
| `/api/config/backup` | POST | 触发数据备份 |
|
||||
| `/api/config/restore` | POST | 导入备份 |
|
||||
|
||||
### 8.2 用户与认证
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/auth/register` | POST | 用户注册 |
|
||||
| `/api/auth/login` | POST | 用户登录 |
|
||||
| `/api/auth/logout` | POST | 用户登出 |
|
||||
| `/api/auth/refresh` | POST | 刷新 Token |
|
||||
| `/api/users` | GET | 列出所有用户（管理员） |
|
||||
| `/api/users` | POST | 创建用户（管理员） |
|
||||
| `/api/users/{id}` | PUT | 更新用户（管理员） |
|
||||
| `/api/users/{id}` | DELETE | 删除用户（管理员） |
|
||||
|
||||
### 8.3 主题与品牌配置
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/branding` | GET | 获取当前品牌配置 |
|
||||
| `/api/branding` | PUT | 更新品牌配置 |
|
||||
| `/api/branding/presets` | GET | 获取预设主题列表 |
|
||||
| `/api/branding/preview` | POST | 预览主题 |
|
||||
|
||||
### 8.4 审计日志
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/audit-logs` | GET | 查询审计日志 |
|
||||
| `/api/audit-logs/export` | GET | 导出审计日志（CSV） |
|
||||
|
||||
### 8.5 领域配置
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/domains` | GET | 获取当前领域配置 |
|
||||
| `/api/domains/init` | POST | 领域初始化向导 |
|
||||
| `/api/domains/skill-packs` | GET | 获取领域技能包列表 |
|
||||
|
||||
---
|
||||
|
||||
## 9. 前端改造要点
|
||||
|
||||
### 9.1 视图层新增
|
||||
|
||||
| 视图 | 说明 |
|
||||
|------|------|
|
||||
| 系统初始化向导 | 首次启动引导创建管理员、选择领域 |
|
||||
| 用户管理 | 管理员管理系统内用户 |
|
||||
| 品牌配置 | 可视化配置 Logo、主题配色 |
|
||||
| 审计日志查看 | 筛选和导出审计日志 |
|
||||
| 领域初始化向导 | 创建后引导配置部门/知识库/技能包 |
|
||||
|
||||
### 9.2 现有视图改造
|
||||
|
||||
| 视图 | 改造内容 |
|
||||
|------|---------|
|
||||
| 登录页 | 新增注册入口、首次启动引导 |
|
||||
| 工作台 | 顶部栏根据品牌配置动态渲染 Logo/配色 |
|
||||
| 设置页 | 新增系统配置、用户管理、品牌配置入口 |
|
||||
|
||||
### 9.3 CSS 变量主题方案
|
||||
|
||||
```css
|
||||
/* 主题变量注入点（替换原有硬编码颜色） */
|
||||
:root {
|
||||
--color-primary: var(--theme-primary, #1a56db);
|
||||
--color-secondary: var(--theme-secondary, #6b7280);
|
||||
--color-bg: var(--theme-bg, #ffffff);
|
||||
--color-surface: var(--theme-surface, #f9fafb);
|
||||
--color-text: var(--theme-text, #111827);
|
||||
--color-border: var(--theme-border, #e5e7eb);
|
||||
--logo-url: var(--theme-logo, url('/assets/default-logo.png'));
|
||||
}
|
||||
|
||||
/* 动态切换 */
|
||||
.theme-gov {
|
||||
--theme-primary: #1e3a8a; /* 政务蓝 */
|
||||
--theme-bg: #f0f4f8;
|
||||
--theme-surface: #ffffff;
|
||||
--theme-text: #1a202c;
|
||||
}
|
||||
|
||||
.theme-enterprise {
|
||||
--theme-primary: #2563eb; /* 企业蓝 */
|
||||
--theme-bg: #f8fafc;
|
||||
--theme-surface: #ffffff;
|
||||
--theme-text: #0f172a;
|
||||
}
|
||||
|
||||
.theme-academic {
|
||||
--theme-primary: #059669; /* 学术绿 */
|
||||
--theme-bg: #fafaf9;
|
||||
--theme-surface: #f5f5f4;
|
||||
--theme-text: #1c1917;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. 风险与依赖
|
||||
|
||||
### 10.1 技术风险
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 单租户限制 | 未来需要多租户时改动成本 | 保留 tenant_id 字段，隔离逻辑模块化 |
|
||||
| SQLite 并发限制 | 多用户同时使用性能下降 | 监控慢查询，必要时迁移 PostgreSQL |
|
||||
| 前端主题系统侵入性 | 改动范围过大 | 使用 CSS 变量 + 动态类名，避免大规模重构 |
|
||||
|
||||
### 10.2 依赖项
|
||||
|
||||
| 依赖 | 说明 |
|
||||
|------|------|
|
||||
| nomifun-tauri 主分支 | Phase 1 基于最新 stable 版本开发 |
|
||||
| nomifun-auth | 复用现有 JWT 认证，扩展角色体系 |
|
||||
| nomifun-db | 复用现有 sqlx 基础设施，扩展 schema |
|
||||
|
||||
### 10.3 决策点（已确认）
|
||||
|
||||
- [x] 租户隔离策略：**单租户优先**，不激活数据层隔离
|
||||
- [x] 是否需要多租户 SaaS 支持：**Phase 1 不支持**，保留扩展点
|
||||
- [x] 审计日志存储：**同库单表**，按用户筛选
|
||||
- [x] 主题编辑器：**先做配置文件形式**，UI 可视化可选
|
||||
|
||||
---
|
||||
|
||||
> 文档结束 — 已调整为**单租户优先**架构，请检查确认。
|
||||
@@ -0,0 +1,410 @@
|
||||
# 通用AI工作台底座平台 — 产品需求文档
|
||||
|
||||
> 文档编号：PRD-COMMONSP-001
|
||||
> 版本：v1.0.0
|
||||
> 日期：2026-03-14
|
||||
> 状态：待确认
|
||||
> 项目缩写：COMMONSP（Commons Platform）
|
||||
|
||||
---
|
||||
|
||||
## 1. 产品概述与定位
|
||||
|
||||
### 1.1 产品定位
|
||||
|
||||
Commons Platform 是 nomifun-tauri 的演进版本，面向 **PrivBox 软硬一体化产品**的软件核心，定位为**私有化部署的 AI 工作台底座**。
|
||||
|
||||
**核心价值主张**：
|
||||
- 开箱即用的私有化部署方案
|
||||
- 零配置的多领域适配能力（政务/企业/教育）
|
||||
- 品牌级定制（主题、Logo、品牌色）
|
||||
- 企业级安全与审计
|
||||
|
||||
### 1.2 产品范围
|
||||
|
||||
| 包含 | 不包含 |
|
||||
|------|--------|
|
||||
| 单租户定制框架 | 硬件适配（PrivBox HAL） |
|
||||
| 多用户管理与 RBAC | 领域包开发（GovPack/EntPack/EduPack） |
|
||||
| 主题引擎 | 插件市场 |
|
||||
| 领域框架（Schema + 向导） | 多租户 SaaS 模式 |
|
||||
| 审计日志 | 云端同步 |
|
||||
|
||||
### 1.3 目标用户
|
||||
|
||||
| 用户类型 | 描述 | 使用场景 |
|
||||
|----------|------|----------|
|
||||
| **系统管理员** | IT 运维人员/项目实施工程师 | 部署配置、品牌定制、用户管理 |
|
||||
| **普通用户** | 一线业务人员 | AI 对话、技能使用、知识库检索 |
|
||||
|
||||
---
|
||||
|
||||
## 2. 目标与成功指标
|
||||
|
||||
### 2.1 产品目标
|
||||
|
||||
| 目标 | 衡量指标 | 目标值 |
|
||||
|------|----------|--------|
|
||||
| 部署效率 | 从下载到首次对话的时间 | ≤ 10 分钟 |
|
||||
| 配置效率 | 品牌定制（Logo + 主题）耗时 | ≤ 5 分钟 |
|
||||
| 用户满意度 | 管理员 NPS | ≥ 40 |
|
||||
| 系统稳定性 | 月度可用性 | ≥ 99.5% |
|
||||
|
||||
### 2.2 MVP 成功标准
|
||||
|
||||
- [ ] 系统可完成首次启动初始化向导
|
||||
- [ ] 管理员可配置品牌主题（Logo + 配色）
|
||||
- [ ] 支持 3 种预设主题一键切换
|
||||
- [ ] 管理员可创建/管理普通用户
|
||||
- [ ] 普通用户可正常使用 AI 对话功能
|
||||
- [ ] 敏感操作自动记录审计日志
|
||||
- [ ] 审计日志支持查询和 CSV 导出
|
||||
|
||||
---
|
||||
|
||||
## 3. 用户画像与核心场景
|
||||
|
||||
### 3.1 场景 1：政务内网部署
|
||||
|
||||
**用户**：某市大数据局 IT 负责人老王
|
||||
|
||||
**痛点**：
|
||||
- 现有 AI 产品无法在内网部署，数据必须出网
|
||||
- 需要符合政务风格的界面（蓝色主题、官方 Logo）
|
||||
- 需要记录谁在什么时候使用了什么功能（审计要求）
|
||||
|
||||
**解法**：
|
||||
- 完全离线部署，数据不出网
|
||||
- 一键切换政务蓝主题，上传官方 Logo
|
||||
- 审计日志记录所有敏感操作，支持导出
|
||||
|
||||
---
|
||||
|
||||
### 3.2 场景 2：企业知识库场景
|
||||
|
||||
**用户**：某科技公司行政主管小李
|
||||
|
||||
**痛点**：
|
||||
- 员工众多，需要分账号管理
|
||||
- 不同的部门需要不同的 AI 助手配置
|
||||
- 需要将公司规章制度导入知识库
|
||||
|
||||
**解法**：
|
||||
- 多用户体系 + 角色权限控制
|
||||
- 知识库支持多分类管理
|
||||
- 领域框架支持按部门初始化
|
||||
|
||||
---
|
||||
|
||||
### 3.3 场景 3：学校教学场景
|
||||
|
||||
**用户**：某高校信息中心张老师
|
||||
|
||||
**痛点**：
|
||||
- 需要符合学校视觉规范的界面
|
||||
- 老师和学生需要不同的使用权限
|
||||
- 希望开箱即用，不需要复杂配置
|
||||
|
||||
**解法**：
|
||||
- 预设学术清新主题
|
||||
- RBAC 支持教师/学生角色
|
||||
- 首次启动向导，5 步完成初始化
|
||||
|
||||
---
|
||||
|
||||
## 4. 功能清单与优先级（MoSCoW）
|
||||
|
||||
### 4.1 Must Have（M）
|
||||
|
||||
| 功能 | 需求编号 | 说明 | 验收标准 |
|
||||
|------|----------|------|----------|
|
||||
| 系统初始化向导 | FR-TENANT-001 | 首次启动引导配置 | 5 步内完成组织配置 |
|
||||
| 品牌配置 | FR-TENANT-002 | Logo + 主题配色 | 支持 PNG/SVG 上传 |
|
||||
| 预设主题 | FR-THEME-002 | 政务蓝/企业蓝/学术绿 | 一键切换即时生效 |
|
||||
| 用户管理 | FR-AUTH-002 | 创建/编辑/删除用户 | 支持 admin/user 角色 |
|
||||
| 用户认证 | FR-AUTH-001 | 注册/登录/登出 | JWT + 刷新令牌 |
|
||||
| 审计日志 | FR-AUDIT-001 | 记录敏感操作 | 登录/配置/用户变更 |
|
||||
| 审计查询 | FR-AUDIT-002 | 日志筛选和导出 | 支持时间/类型/用户筛选 |
|
||||
|
||||
### 4.2 Should Have（S）
|
||||
|
||||
| 功能 | 需求编号 | 说明 | 验收标准 |
|
||||
|------|----------|------|----------|
|
||||
| 主题预览 | FR-THEME-003 | 修改前实时预览 | 预览与发布后一致 |
|
||||
| 领域初始化向导 | FR-DOMAIN-002 | 引导配置领域 | 部门/知识库/技能包 |
|
||||
| 领域配置 Schema | FR-DOMAIN-001 | 预置领域参数 | Government/Enterprise/Education |
|
||||
| 会话管理 | FR-AUTH-003 | JWT 刷新/登出 | 静默刷新正常 |
|
||||
| 数据备份 | FR-TENANT-003 | 导出/导入数据 | 完整性校验通过 |
|
||||
|
||||
### 4.3 Could Have（C）
|
||||
|
||||
| 功能 | 需求编号 | 说明 | 验收标准 |
|
||||
|------|----------|------|----------|
|
||||
| 领域技能包注册 | FR-DOMAIN-003 | 按领域加载技能 | 技能目录正确分类 |
|
||||
| 功能开关 | FR-TENANT-002 | 按需启用功能 | 开关实时生效 |
|
||||
| 配置导入导出 | FR-CONFIG-001/002 | 迁移配置 | 支持合并/覆盖模式 |
|
||||
|
||||
### 4.4 Won't Have（W）
|
||||
|
||||
| 功能 | 原因 |
|
||||
|------|------|
|
||||
| 多租户 SaaS | Phase 1 单租户优先，物理隔离已够用 |
|
||||
| 插件市场 | Phase 2 领域包阶段处理 |
|
||||
| 云端同步 | 私有化部署场景不需要 |
|
||||
| SQLite 加密 | Phase 1 可选，留作后续增强 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 关键流程
|
||||
|
||||
### 5.1 首次启动流程
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 首次启动 │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 1. 检测未初始化 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 2. 欢迎页 → 创建系统管理员 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 3. 组织配置 → 输入组织名称 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 4. 领域选择 → Government/Enterprise/Education/Custom │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 5. 主题选择 → 选择预设主题或跳过 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 6. 初始化完成 → 跳转登录页 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.2 品牌定制流程
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 品牌定制 │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 管理员进入「设置 → 品牌配置」 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ 预设主题选择 │ ← 一键应用政务蓝/企业蓝/学术绿 │
|
||||
│ └────────┬────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ 自定义颜色 │ ← 调色板选择主色/辅色/强调色 │
|
||||
│ └────────┬────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ Logo 上传 │ ← PNG/SVG，支持拖拽 │
|
||||
│ └────────┬────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ 实时预览 │ ← 所见即所得 │
|
||||
│ └────────┬────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 「发布」→ 立即生效 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.3 审计日志流程
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 审计日志 │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 敏感操作触发（如用户登录/配置变更/用户管理） │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 写入审计日志（操作时间/用户/类型/对象/结果/IP） │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 管理员进入「设置 → 审计日志」 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 筛选条件 → 时间范围/操作类型/操作用户 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 展示日志列表，支持分页 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 导出 CSV（如需要） │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. 角色权限矩阵
|
||||
|
||||
### 6.1 功能权限矩阵
|
||||
|
||||
| 功能 | 系统管理员 | 普通用户 |
|
||||
|------|:----------:|:--------:|
|
||||
| **系统初始化** | ✅ 创建首个管理员 | ❌ |
|
||||
| **系统配置** | | |
|
||||
| - 查看配置 | ✅ | ❌ |
|
||||
| - 修改配置 | ✅ | ❌ |
|
||||
| **品牌配置** | | |
|
||||
| - 查看品牌 | ✅ | ❌ |
|
||||
| - 修改品牌 | ✅ | ❌ |
|
||||
| **用户管理** | | |
|
||||
| - 查看用户列表 | ✅ | ❌ |
|
||||
| - 创建/编辑用户 | ✅ | ❌ |
|
||||
| - 删除用户 | ✅ | ❌ |
|
||||
| **AI 对话** | ✅ | ✅ |
|
||||
| **知识库管理** | ✅ | ✅（受限） |
|
||||
| **审计日志** | | |
|
||||
| - 查看日志 | ✅ | ❌ |
|
||||
| - 导出日志 | ✅ | ❌ |
|
||||
| **数据备份** | ✅ | ❌ |
|
||||
|
||||
### 6.2 权限说明
|
||||
|
||||
| 角色 | 描述 | 默认账号 |
|
||||
|------|------|----------|
|
||||
| **系统管理员 (admin)** | 首次启动时创建，拥有所有配置权限 | 初始化向导创建 |
|
||||
| **普通用户 (user)** | 仅能使用业务功能，无配置权限 | 管理员创建 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 版本规划
|
||||
|
||||
### 7.1 Phase 1 MVP
|
||||
|
||||
**目标**：夯实基础框架，支持单租户私有化部署
|
||||
|
||||
| 模块 | 功能 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 初始化向导 | 首次启动引导 | P0 |
|
||||
| 用户体系 | 注册/登录/多用户/RBAC | P0 |
|
||||
| 品牌配置 | 预设主题/自定义配色/Logo | P0 |
|
||||
| 审计日志 | 记录/查询/导出 | P0 |
|
||||
| 领域框架 | 领域 Schema/初始化向导 | P1 |
|
||||
|
||||
**交付物**：
|
||||
- 可运行的 MVP 版本
|
||||
- 3 套预设主题
|
||||
- 基础审计日志功能
|
||||
|
||||
### 7.2 Phase 2 领域包
|
||||
|
||||
**目标**：完善三大领域包
|
||||
|
||||
| 领域包 | 内容 |
|
||||
|--------|------|
|
||||
| GovPack | 政务蓝主题、政务知识库分类、公文处理技能 |
|
||||
| EntPack | 企业主题、企业知识库分类、CRM 集成技能 |
|
||||
| EduPack | 学术主题、课程知识库分类、教学辅助技能 |
|
||||
|
||||
### 7.3 Phase 3 开放生态
|
||||
|
||||
**目标**：开放插件市场和 API
|
||||
|
||||
- 插件市场
|
||||
- 开放 API
|
||||
- 多租户 SaaS 模式
|
||||
|
||||
---
|
||||
|
||||
## 8. 非功能性要求
|
||||
|
||||
### 8.1 性能要求
|
||||
|
||||
| 指标 | 目标 | 说明 |
|
||||
|------|------|------|
|
||||
| 冷启动时间 | ≤ 3s | 从点击图标到可交互 |
|
||||
| 主题切换延迟 | ≤ 100ms | 前端 CSS 变量切换 |
|
||||
| 初始化向导完成时间 | ≤ 2min | 5 步配置完成 |
|
||||
| 对话响应延迟 | ≤ 500ms | 不含模型推理时间 |
|
||||
|
||||
### 8.2 安全要求
|
||||
|
||||
| 要求 | 说明 |
|
||||
|------|------|
|
||||
| 认证机制 | JWT + 刷新令牌，secret 不硬编码 |
|
||||
| 权限控制 | RBAC，403 正确返回 |
|
||||
| 审计日志 | 不可篡改，仅追加 |
|
||||
| 数据隔离 | 单机物理隔离 |
|
||||
|
||||
### 8.3 可用性要求
|
||||
|
||||
| 要求 | 说明 |
|
||||
|------|------|
|
||||
| 离线可用 | 核心功能断网可用 |
|
||||
| 错误恢复 | 异常自动回滚，不破坏数据 |
|
||||
| 错误提示 | 友好提示，不暴露敏感信息 |
|
||||
|
||||
### 8.4 兼容性要求
|
||||
|
||||
| 要求 | 说明 |
|
||||
|------|------|
|
||||
| 浏览器 | Chrome/Firefox/Safari/Edge 最新两个版本 |
|
||||
| 操作系统 | Windows/macOS/Linux |
|
||||
| 插件系统 | 兼容现有 MCP 插件 |
|
||||
|
||||
---
|
||||
|
||||
## 9. 依赖与风险
|
||||
|
||||
### 9.1 技术依赖
|
||||
|
||||
| 依赖 | 版本 | 说明 |
|
||||
|------|------|------|
|
||||
| nomifun-tauri | latest stable | 基础框架 |
|
||||
| Rust | 1.70+ | 后端运行时 |
|
||||
| Vue | 3.x | 前端框架 |
|
||||
| sqlx | 0.7+ | 数据库访问 |
|
||||
| SQLite | 3.x | 数据存储 |
|
||||
|
||||
### 9.2 项目风险
|
||||
|
||||
| 风险 | 影响 | 概率 | 缓解措施 |
|
||||
|------|------|------|----------|
|
||||
| 前端主题改动侵入性 | 中 | 高 | CSS 变量方案，专人负责 |
|
||||
| 审计日志性能影响 | 中 | 中 | 异步写入，定期归档 |
|
||||
| SQLite 并发瓶颈 | 低 | 中 | 监控慢查询，预留迁移方案 |
|
||||
|
||||
### 9.3 外部依赖
|
||||
|
||||
| 依赖 | 说明 | 风险 |
|
||||
|------|------|------|
|
||||
| nomifun-tauri 主分支 | 基于最新版本开发 | 低 |
|
||||
| 前端组件库 | 假设使用现有组件库 | 低 |
|
||||
|
||||
---
|
||||
|
||||
## 10. 附录
|
||||
|
||||
### 10.1 术语对照
|
||||
|
||||
| 英文 | 中文 | 说明 |
|
||||
|------|------|------|
|
||||
| Branding | 品牌配置 | Logo、配色等视觉元素 |
|
||||
| Domain | 领域 | Government/Enterprise/Education |
|
||||
| RBAC | 基于角色的访问控制 | Role-Based Access Control |
|
||||
| Audit Log | 审计日志 | 操作记录 |
|
||||
|
||||
### 10.2 参考文档
|
||||
|
||||
| 文档 | 路径 |
|
||||
|------|------|
|
||||
| 需求文档 | `0-req-COMMONSP.md` |
|
||||
| 演进规划 | `commons-ai-platform-evolution.md` |
|
||||
|
||||
---
|
||||
|
||||
> 文档结束 — 请检查以上 PRD，如有歧义或需调整，请告知后再推进下一阶段。
|
||||
@@ -0,0 +1,532 @@
|
||||
# Commons Platform Phase 1 MVP — 开发任务文档
|
||||
|
||||
> 文档编号：TASK-COMMONSP-001
|
||||
> 版本：v1.1.0
|
||||
> 日期：2026-03-14
|
||||
> 状态：MVP 阶段大部分完成
|
||||
> 项目缩写：COMMONSP（Commons Platform）
|
||||
> 最后更新：2026-03-14
|
||||
|
||||
---
|
||||
|
||||
## 0. 进度摘要
|
||||
|
||||
### 0.1 MVP 阶段完成情况
|
||||
|
||||
| 模块 | 状态 | 完成度 |
|
||||
|------|------|--------|
|
||||
| 数据库迁移 | ✅ 完成 | 100% |
|
||||
| 用户体系 | ✅ 完成 | 100% |
|
||||
| 初始化向导 | ✅ 完成 | 100% |
|
||||
| 品牌配置 | ✅ 完成 | 100% |
|
||||
| 审计日志 | ✅ 完成 | 100% |
|
||||
| 领域配置 | ✅ 完成 | 100% |
|
||||
| 登录页改造 | ✅ 完成 | 100% |
|
||||
|
||||
### 0.2 待完成任务
|
||||
|
||||
| 任务 | 优先级 | 说明 |
|
||||
|------|--------|------|
|
||||
| 数据备份接口 | P1 | S1 阶段，涉及完整数据导出/导入 |
|
||||
| 前端主题动态加载 | P1 | 需要从后端获取品牌配置并设置 CSS 变量 |
|
||||
| 管理后台布局优化 | P2 | 侧边栏导航、权限控制等 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 任务总览
|
||||
|
||||
### 1.1 阶段划分
|
||||
|
||||
| 阶段 | 范围 | 优先级 |
|
||||
|------|------|--------|
|
||||
| **MVP** | 核心功能：初始化向导 + 用户体系 + 品牌配置 + 审计日志 | P0 |
|
||||
| **S1** | 重要功能：主题预览 + 领域向导 + 数据备份 | P1 |
|
||||
| **S2** | 增强功能：领域技能包 + 功能开关 + 配置迁移 | P2 |
|
||||
|
||||
### 1.2 模块依赖关系
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 模块依赖图 │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌─────────────┐ │
|
||||
│ │ 数据库迁移 │ ← 所有模块依赖 │
|
||||
│ └──────┬──────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ 用户体系 │ ──▶ │ 审计日志 │ │
|
||||
│ └──────┬──────┘ └─────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ 初始化向导 │ ──▶ │ 品牌配置 │ │
|
||||
│ └─────────────┘ └─────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. MVP 阶段任务（P0）
|
||||
|
||||
### 2.1 数据库迁移
|
||||
|
||||
**目标**：扩展 nomifun-tauri 数据库 schema，支持用户角色、品牌配置、审计日志
|
||||
|
||||
**依赖**：无
|
||||
|
||||
#### 任务 2.1.1：创建数据库迁移文件
|
||||
|
||||
- [x] 创建 `002_user_role.sql` 迁移文件
|
||||
- 目标：为 `users` 表添加 `role` 字段（`admin`/`user`）
|
||||
- 验收标准：迁移可正常执行，不破坏现有数据
|
||||
- 需求映射：FR-AUTH-002
|
||||
|
||||
- [x] 创建 `003_system_config.sql` 迁移文件
|
||||
- 目标：创建 `system_config` 表（组织名、领域类型）
|
||||
- 验收标准：迁移可正常执行
|
||||
- 需求映射：FR-TENANT-001
|
||||
|
||||
- [x] 创建 `004_branding_config.sql` 迁移文件
|
||||
- 目标：创建 `branding_config` 表（Logo、主题配色）
|
||||
- 验收标准：迁移可正常执行
|
||||
- 需求映射：FR-THEME-001, FR-THEME-002
|
||||
|
||||
- [x] 创建 `005_audit_log.sql` 迁移文件
|
||||
- 目标：创建 `audit_log` 表
|
||||
- 验收标准：迁移可正常执行，支持大量写入
|
||||
- 需求映射：FR-AUDIT-001
|
||||
|
||||
- [x] 创建 `006_domain_config.sql` 迁移文件
|
||||
- 目标：创建 `domain_config` 表
|
||||
- 验收标准：迁移可正常执行
|
||||
- 需求映射：FR-DOMAIN-001
|
||||
|
||||
#### 任务 2.1.2：定义 Rust 数据模型
|
||||
|
||||
- [x] 在 `nomifun-db/src/models/` 下新增模型文件
|
||||
- 目标：定义 `UserRole`、`SystemConfig`、`BrandingConfig`、`AuditLog`、`DomainConfig` 模型
|
||||
- 验收标准：模型字段与数据库表一致，实现 `FromRow` trait
|
||||
- 依赖：2.1.1
|
||||
|
||||
---
|
||||
|
||||
### 2.2 用户体系
|
||||
|
||||
**目标**：实现多用户注册、登录、RBAC 权限控制
|
||||
|
||||
**依赖**：2.1
|
||||
|
||||
#### 任务 2.2.1：扩展用户注册接口
|
||||
|
||||
- [x] 修改 `POST /api/auth/register` 接口
|
||||
- 目标：首次启动时创建 admin 用户，后续注册为普通用户
|
||||
- 验收标准：
|
||||
- 未初始化时，第一个注册用户自动成为 admin
|
||||
- 已初始化后，注册用户默认为 user 角色
|
||||
- 需求映射：FR-AUTH-001, FR-AUTH-002
|
||||
- **状态**：✅ 已完成（通过 `/api/auth/setup` 实现）
|
||||
|
||||
#### 任务 2.2.2：扩展登录接口
|
||||
|
||||
- [x] 修改 `POST /login` 接口
|
||||
- 目标：返回用户角色信息到前端
|
||||
- 验收标准：JWT payload 包含 `role` 字段
|
||||
- 需求映射：FR-AUTH-001
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
#### 任务 2.2.3：添加用户管理接口
|
||||
|
||||
- [x] 添加 `GET /api/users` 接口
|
||||
- 目标：列出租户内所有用户（仅 admin 可访问）
|
||||
- 验收标准：返回用户列表，不包含密码
|
||||
- 需求映射：FR-AUTH-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `POST /api/users` 接口
|
||||
- 目标：创建新用户（仅 admin 可访问）
|
||||
- 验收标准：可指定角色，密码加密存储
|
||||
- 需求映射：FR-AUTH-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `PUT /api/users/{id}` 接口
|
||||
- 目标：更新用户信息（仅 admin 可访问）
|
||||
- 验收标准：可修改角色，不可修改自己
|
||||
- 需求映射：FR-AUTH-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `DELETE /api/users/{id}` 接口
|
||||
- 目标：删除用户（仅 admin 可访问）
|
||||
- 验收标准：不可删除自己，最后一个 admin 不能删除
|
||||
- 需求映射：FR-AUTH-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
#### 任务 2.2.4：添加权限中间件
|
||||
|
||||
- [x] 实现 `require_admin` 中间件
|
||||
- 目标：检查 JWT 中的 role 字段
|
||||
- 验收标准：非 admin 用户返回 403
|
||||
- 需求映射：FR-AUTH-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
---
|
||||
|
||||
### 2.3 初始化向导
|
||||
|
||||
**目标**：首次启动引导用户完成系统配置
|
||||
|
||||
**依赖**：2.1, 2.2
|
||||
|
||||
#### 任务 2.3.1：添加初始化状态检查
|
||||
|
||||
- [x] 添加 `GET /api/system/initialized` 接口
|
||||
- 目标：检查系统是否已完成初始化
|
||||
- 验收标准：返回 `{ initialized: bool }`
|
||||
- **状态**：✅ 已完成（依赖 SystemConfigRepository）
|
||||
|
||||
#### 任务 2.3.2：添加初始化接口
|
||||
|
||||
- [x] 添加 `POST /api/system/init` 接口
|
||||
- 目标：创建系统管理员、设置组织信息、选择领域、预设主题
|
||||
- 验收标准：
|
||||
- 仅在未初始化时可用
|
||||
- 创建 admin 用户
|
||||
- 保存组织名和领域配置
|
||||
- 应用预设主题
|
||||
- 需求映射：FR-TENANT-001
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
#### 任务 2.3.3：前端初始化向导页面
|
||||
|
||||
- [x] 创建 `src/pages/setupWizard/SetupWizard.tsx` 组件
|
||||
- 目标：5 步引导用户完成初始化
|
||||
- 步骤：
|
||||
1. 欢迎页（检测未初始化状态）
|
||||
2. 创建管理员账号
|
||||
3. 配置组织信息
|
||||
4. 选择领域类型
|
||||
5. 选择预设主题
|
||||
- 验收标准：
|
||||
- 每步验证输入
|
||||
- 完成后跳转到登录页
|
||||
- 需求映射：FR-TENANT-001
|
||||
- **状态**：✅ 已完成（需要 `/api/auth/setup` 后端支持）
|
||||
- **文件**：
|
||||
- `ui/src/renderer/pages/setupWizard/SetupWizard.tsx`
|
||||
- `ui/src/renderer/pages/setupWizard/SetupWizard.css`
|
||||
- `ui/src/renderer/services/i18n/locales/zh-CN/setupWizard.json`
|
||||
- `ui/src/renderer/services/i18n/locales/en-US/setupWizard.json`
|
||||
- **路由**：添加 `/setup` 路由，`needsSetup` 时自动重定向
|
||||
|
||||
---
|
||||
|
||||
### 2.4 品牌配置
|
||||
|
||||
**目标**：支持预设主题和自定义品牌配置
|
||||
|
||||
**依赖**：2.1
|
||||
|
||||
#### 任务 2.4.1：添加品牌配置接口
|
||||
|
||||
- [x] 添加 `GET /api/system/branding` 接口
|
||||
- 目标：获取当前品牌配置
|
||||
- 验收标准：返回 Logo URL、主题配色
|
||||
- 需求映射：FR-THEME-001
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `PATCH /api/system/branding` 接口
|
||||
- 目标：更新品牌配置（仅 admin 可访问）
|
||||
- 验收标准：保存配色和 Logo 配置
|
||||
- 需求映射：FR-THEME-001, FR-THEME-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `POST /api/system/branding/logo` 接口
|
||||
- 目标：上传 Logo 文件
|
||||
- 验收标准：支持 PNG/SVG，保存到 static 目录
|
||||
- 需求映射：FR-THEME-002
|
||||
- **状态**：✅ 已完成（支持 PNG/SVG/JPG，保存到 data_dir/logos/）
|
||||
|
||||
- [x] 添加 `GET /api/system/branding/presets` 接口
|
||||
- 目标：获取预设主题列表
|
||||
- 验收标准：返回政务蓝/企业蓝/学术绿主题配置
|
||||
- 需求映射：FR-THEME-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `POST /api/system/branding/presets/{preset_id}` 接口
|
||||
- 目标：应用预设主题
|
||||
- 验收标准：一键切换主题
|
||||
- 需求映射：FR-THEME-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
#### 任务 2.4.2：前端品牌配置页面
|
||||
|
||||
- [x] 创建 `src/views/admin/BrandingConfig.vue` 组件
|
||||
- 目标：可视化配置品牌
|
||||
- 功能：
|
||||
- 预设主题选择（点击一键应用）
|
||||
- 颜色选择器（主色/辅色/强调色）
|
||||
- Logo 上传（支持拖拽）
|
||||
- 实时预览
|
||||
- 验收标准：
|
||||
- 预览与发布后一致
|
||||
- 切换主题 < 100ms
|
||||
- 需求映射：FR-THEME-001, FR-THEME-002, FR-THEME-003
|
||||
- **状态**：✅ 已完成（`ui/src/renderer/pages/settings/BrandingConfig.tsx`）
|
||||
|
||||
#### 任务 2.4.3：前端主题动态加载
|
||||
|
||||
- [ ] 修改 `src/App.vue` 或主题入口
|
||||
- 目标：从后端获取品牌配置，动态设置 CSS 变量
|
||||
- 验收标准：
|
||||
- 页面加载时获取品牌配置
|
||||
- 设置 `--theme-*` CSS 变量
|
||||
- 主题切换无需刷新
|
||||
- 需求映射：FR-THEME-001
|
||||
|
||||
---
|
||||
|
||||
### 2.5 审计日志
|
||||
|
||||
**目标**：记录敏感操作，支持查询和导出
|
||||
|
||||
**依赖**：2.1
|
||||
|
||||
#### 任务 2.5.1：添加审计日志服务
|
||||
|
||||
- [x] 创建审计日志数据库层
|
||||
- 目标：封装审计日志写入和查询逻辑
|
||||
- 功能：
|
||||
- 异步写入日志
|
||||
- 自动补充时间戳
|
||||
- 支持分页查询和筛选
|
||||
- 验收标准：写入不影响主业务响应时间
|
||||
- 需求映射：FR-AUDIT-001
|
||||
- **状态**：✅ 已完成（`nomifun-db::IAuditLogRepository`）
|
||||
|
||||
#### 任务 2.5.2：审计日志切面
|
||||
|
||||
- [x] 在关键接口添加审计日志调用
|
||||
- 目标：登录/登出、配置变更、用户管理操作自动记录
|
||||
- 验收标准：操作被正确记录到 audit_log 表
|
||||
- 需求映射：FR-AUDIT-001
|
||||
- **状态**：✅ 已完成（已在 system_init、branding_config、domain_config 等操作中集成）
|
||||
|
||||
#### 任务 2.5.3：添加审计日志查询接口
|
||||
|
||||
- [x] 添加 `GET /api/system/audit-logs` 接口
|
||||
- 目标：查询审计日志（仅 admin 可访问）
|
||||
- 参数：`page`、`page_size`、`start_date`、`end_date`、`action`、`user_id`、`category`、`status`
|
||||
- 验收标准：支持分页和筛选
|
||||
- 需求映射：FR-AUDIT-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `POST /api/system/audit-logs` 接口
|
||||
- 目标：创建新的审计日志条目
|
||||
- 验收标准：写入成功并返回日志条目
|
||||
- 需求映射：FR-AUDIT-001
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `GET /api/system/audit-logs/{id}` 接口
|
||||
- 目标：获取单条审计日志
|
||||
- 验收标准：返回指定ID的日志条目
|
||||
- 需求映射：FR-AUDIT-002
|
||||
- **状态**：✅ 已完成
|
||||
|
||||
- [x] 添加 `GET /api/system/audit-logs/export` 接口
|
||||
- 目标：导出审计日志为 CSV
|
||||
- 验收标准：导出文件可被 Excel 正确打开
|
||||
- 需求映射：FR-AUDIT-002
|
||||
- **状态**：✅ 已完成（支持导出最多 10,000 条记录）
|
||||
|
||||
#### 任务 2.5.4：前端审计日志页面
|
||||
|
||||
- [ ] 创建 `src/views/admin/AuditLogs.vue` 组件
|
||||
- 目标：展示和查询审计日志
|
||||
- 功能：
|
||||
- 筛选条件（时间范围、操作类型、用户）
|
||||
- 日志列表展示
|
||||
- CSV 导出按钮
|
||||
- 验收标准：日志按时间倒序展示
|
||||
- 需求映射：FR-AUDIT-002
|
||||
|
||||
---
|
||||
|
||||
## 3. S1 阶段任务（P1）
|
||||
|
||||
### 3.1 领域向导
|
||||
|
||||
**目标**：引导用户配置领域特定的参数
|
||||
|
||||
**依赖**：2.1, 2.3
|
||||
|
||||
#### 任务 3.1.1：添加领域配置接口
|
||||
|
||||
- [x] 添加 `GET /api/domains` 接口
|
||||
- 目标：获取当前领域配置
|
||||
- 验收标准：返回领域类型和配置参数
|
||||
- **状态**：✅ 已完成（`GET /api/system/domain-config`）
|
||||
|
||||
- [ ] 添加 `POST /api/domains/init` 接口
|
||||
- 目标：领域初始化向导
|
||||
- 功能：根据领域类型初始化部门/知识库分类/技能包
|
||||
- 验收标准：按领域类型加载不同的初始化模板
|
||||
- **备注**：已通过 `POST /api/system/init` + 预设应用实现
|
||||
|
||||
- [ ] 添加 `GET /api/domains/skill-packs` 接口
|
||||
- 目标：获取领域技能包列表
|
||||
- 验收标准：返回该领域可用的技能包
|
||||
- **备注**：属于 MCP 系统功能，暂不在此实现
|
||||
|
||||
#### 任务 3.1.2：前端领域配置页面
|
||||
|
||||
- [x] 创建 `src/views/admin/DomainConfig.vue` 组件
|
||||
- 目标：领域初始化向导
|
||||
- 功能：部门设置、知识库分类、预置技能包选择
|
||||
- **状态**：✅ 已完成（`ui/src/renderer/pages/admin/DomainConfigPage.tsx`）
|
||||
|
||||
---
|
||||
|
||||
### 3.2 数据备份
|
||||
|
||||
**目标**：支持数据导出和导入
|
||||
|
||||
**依赖**：2.1
|
||||
|
||||
#### 任务 3.2.1：添加备份接口
|
||||
|
||||
- [ ] 添加 `POST /api/config/backup` 接口
|
||||
- 目标：导出完整数据备份
|
||||
- 验收标准：生成包含 schema 和数据的 zip 文件
|
||||
|
||||
- [ ] 添加 `POST /api/config/restore` 接口
|
||||
- 目标：导入备份文件
|
||||
- 验收标准：验证完整性后重建数据
|
||||
|
||||
#### 任务 3.2.2：前端备份页面
|
||||
|
||||
- [ ] 在设置页添加备份功能
|
||||
- 目标：一键备份和导入
|
||||
- 功能：下载备份文件、上传恢复
|
||||
|
||||
---
|
||||
|
||||
## 4. S2 阶段任务（P2）
|
||||
|
||||
### 4.1 功能开关
|
||||
|
||||
**目标**：按需启用/禁用某些功能
|
||||
|
||||
**依赖**：2.1
|
||||
|
||||
#### 任务 4.1.1：添加功能开关表和接口
|
||||
|
||||
- [ ] 创建 `feature_flags` 表
|
||||
- [ ] 添加 `GET/PUT /api/features` 接口
|
||||
|
||||
#### 任务 4.1.2：前端功能开关控件
|
||||
|
||||
- [ ] 在设置页添加功能开关
|
||||
|
||||
---
|
||||
|
||||
### 4.2 配置导入导出
|
||||
|
||||
**目标**：迁移系统配置
|
||||
|
||||
**依赖**：2.1
|
||||
|
||||
#### 任务 4.2.1：添加配置导出接口
|
||||
|
||||
- [ ] 添加 `GET /api/config/export` 接口
|
||||
- 目标：导出配置（不含用户数据）
|
||||
- 验收标准：导出 JSON 可被导入
|
||||
|
||||
#### 任务 4.2.2：添加配置导入接口
|
||||
|
||||
- [ ] 添加 `POST /api/config/import` 接口
|
||||
- 目标：导入配置，支持合并或覆盖模式
|
||||
|
||||
---
|
||||
|
||||
## 5. 前端通用任务
|
||||
|
||||
### 5.1 管理后台布局
|
||||
|
||||
- [ ] 创建 `src/views/admin/` 目录结构
|
||||
- [ ] 添加管理员侧边栏导航
|
||||
- [ ] 添加管理员权限控制（未登录/非 admin 跳转）
|
||||
|
||||
### 5.2 登录页改造
|
||||
|
||||
- [x] 添加注册入口
|
||||
- **状态**：✅ 已完成（通过 `/setup` 向导和管理员创建用户实现）
|
||||
- [x] 首次启动时重定向到初始化向导
|
||||
- **状态**：✅ 已完成（Router 中已实现 needsSetup 重定向）
|
||||
|
||||
### 5.3 设置页改造
|
||||
|
||||
- [ ] 添加系统配置入口（admin）
|
||||
- [ ] 添加品牌配置入口（admin）
|
||||
- [ ] 添加用户管理入口（admin）
|
||||
- [ ] 添加审计日志入口（admin）
|
||||
- [ ] 添加数据备份入口（admin）
|
||||
|
||||
---
|
||||
|
||||
## 6. 验收与测试
|
||||
|
||||
### 6.1 构建验证
|
||||
|
||||
- [ ] `cargo build --release` 成功
|
||||
- [ ] `npm run build` 成功
|
||||
- [ ] 数据库迁移无报错
|
||||
|
||||
### 6.2 功能验收
|
||||
|
||||
| 功能 | 验收标准 |
|
||||
|------|----------|
|
||||
| 首次启动 | 访问根路径自动跳转到初始化向导 |
|
||||
| 初始化向导 | 5 步内完成配置，admin 用户创建成功 |
|
||||
| 登录/登出 | JWT 正确生成，刷新令牌正常 |
|
||||
| 用户管理 | admin 可创建/编辑/删除用户，普通用户无法访问 |
|
||||
| 品牌配置 | 预设主题一键切换，主题 < 100ms 生效 |
|
||||
| Logo 上传 | PNG/SVG 上传成功，页面正确显示 |
|
||||
| 审计日志 | 登录/配置变更/用户管理操作自动记录 |
|
||||
| 审计查询 | 支持筛选和 CSV 导出 |
|
||||
|
||||
### 6.3 回归测试
|
||||
|
||||
- [ ] 现有 AI 对话功能正常
|
||||
- [ ] 现有知识库功能正常
|
||||
- [ ] 现有插件系统正常
|
||||
|
||||
---
|
||||
|
||||
## 7. 进度记录
|
||||
|
||||
### 7.1 完成项
|
||||
|
||||
| 日期 | 任务 | 状态 | 备注 |
|
||||
|------|------|------|------|
|
||||
| 2026-03-14 | 需求文档确认 | ✅ | v2.0.0 单租户优先 |
|
||||
| 2026-03-14 | PRD 确认 | ✅ | v1.0.0 |
|
||||
| 2026-03-14 | 2.1 数据库迁移 | ✅ | 6个迁移文件 + 6个模型定义 |
|
||||
| 2026-03-14 | 2.3.1 初始化状态检查 API | ✅ | `GET /api/system/initialized` |
|
||||
| 2026-03-14 | 2.3.2 初始化接口 | ✅ | `POST /api/system/init` |
|
||||
| 2026-03-14 | 2.3.3 前端初始化向导 | ✅ | 5步向导组件 + i18n + 路由 |
|
||||
| 2026-03-14 | 2.4.1 品牌配置接口（部分） | ✅ | GET/PATCH branding + presets API |
|
||||
| 2026-03-14 | 2.5.1 审计日志数据库层 | ✅ | `IAuditLogRepository` + CRUD |
|
||||
| 2026-03-14 | 2.5.3 审计日志查询接口 | ✅ | GET/POST/GET(id) audit-logs API |
|
||||
| 2026-03-14 | 2.2 用户体系 | ✅ | CRUD 用户管理 + require_admin 中间件 |
|
||||
|
||||
### 7.2 变更记录
|
||||
|
||||
| 日期 | 变更内容 | 原因 |
|
||||
|------|----------|------|
|
||||
| 2026-03-14 | 多租户改为单租户优先 | 私有化部署场景物理隔离已够用 |
|
||||
|
||||
---
|
||||
|
||||
> 文档结束 — 请检查确认后开始阶段 5（按任务文档执行开发）。
|
||||
@@ -0,0 +1,232 @@
|
||||
# Phase 用户体系实现 - 完成报告
|
||||
|
||||
## 📋 任务概述
|
||||
|
||||
按照任务文档 `2-task-COMMONSP.md` 的 **2.2 用户体系** 部分，完成了多用户注册、登录、RBAC 权限控制的完整实现。
|
||||
|
||||
## ✅ 已完成功能
|
||||
|
||||
### 1. 权限中间件（nomifun-auth）
|
||||
|
||||
**文件**: `crates/backend/nomifun-auth/src/middleware.rs`
|
||||
|
||||
- ✅ 新增 `require_admin_middleware` - 检查用户是否为 admin 角色
|
||||
- ✅ 返回 HTTP 403 给非 admin 用户
|
||||
- ✅ 必须在 `auth_middleware` 之后应用
|
||||
- ✅ 导出到公共 API
|
||||
|
||||
```rust
|
||||
pub async fn require_admin_middleware(
|
||||
request: Request,
|
||||
next: Next,
|
||||
) -> Result<Response, AppError>
|
||||
```
|
||||
|
||||
### 2. 用户管理 API（nomifun-auth）
|
||||
|
||||
**文件**: `crates/backend/nomifun-auth/src/routes.rs`
|
||||
|
||||
#### 2.1 列出所有用户
|
||||
- **端点**: `GET /api/users`
|
||||
- **权限**: Admin only
|
||||
- **功能**: 返回所有用户列表（不含密码）
|
||||
- **响应**: `Vec<UserListItem>`
|
||||
|
||||
#### 2.2 创建用户
|
||||
- **端点**: `POST /api/users`
|
||||
- **权限**: Admin only
|
||||
- **功能**: 创建新用户，支持指定角色（admin/user）
|
||||
- **验证**: 用户名、密码强度、角色有效性
|
||||
- **安全**: 密码使用 bcrypt 加密
|
||||
|
||||
#### 2.3 获取用户详情
|
||||
- **端点**: `GET /api/users/:id`
|
||||
- **权限**: Admin only
|
||||
- **功能**: 返回指定用户的详细信息
|
||||
|
||||
#### 2.4 更新用户
|
||||
- **端点**: `PUT /api/users/:id`
|
||||
- **权限**: Admin only
|
||||
- **功能**: 更新用户名、邮箱、角色
|
||||
- **保护**:
|
||||
- ❌ 不允许修改自己的账号
|
||||
- ❌ 不允许降级最后一个 admin
|
||||
|
||||
#### 2.5 删除用户
|
||||
- **端点**: `DELETE /api/users/:id`
|
||||
- **权限**: Admin only
|
||||
- **功能**: 删除指定用户
|
||||
- **保护**:
|
||||
- ❌ 不允许删除自己
|
||||
- ❌ 不允许删除最后一个 admin
|
||||
|
||||
### 3. 数据库层扩展（nomifun-db）
|
||||
|
||||
**文件**: `crates/backend/nomifun-db/src/repository/`
|
||||
|
||||
#### 3.1 新增 Repository 方法
|
||||
|
||||
**user.rs (trait)**:
|
||||
```rust
|
||||
async fn create_user_with_role(&self, username: &str, password_hash: &str, role: &str) -> Result<User, DbError>;
|
||||
async fn update_role(&self, user_id: &str, role: &str) -> Result<(), DbError>;
|
||||
async fn delete_user(&self, user_id: &str) -> Result<(), DbError>;
|
||||
```
|
||||
|
||||
**sqlite_user.rs (实现)**:
|
||||
- ✅ `create_user_with_role()` - 创建用户时指定角色
|
||||
- ✅ `update_role()` - 更新用户角色
|
||||
- ✅ `delete_user()` - 删除用户
|
||||
|
||||
### 4. API 类型定义（nomifun-api-types）
|
||||
|
||||
**文件**: `crates/backend/nomifun-api-types/src/auth.rs`
|
||||
|
||||
已有类型（本次使用）：
|
||||
- `UserListItem` - 用户列表项
|
||||
- `CreateUserRequest` - 创建用户请求
|
||||
- `UpdateUserRequest` - 更新用户请求
|
||||
|
||||
## 🔒 安全保护
|
||||
|
||||
### 权限控制
|
||||
- ✅ 所有用户管理接口都需要 admin 角色
|
||||
- ✅ 使用 `require_admin_middleware` 统一保护
|
||||
- ✅ 非 admin 用户返回 HTTP 403
|
||||
|
||||
### 数据保护
|
||||
- ✅ 密码使用 bcrypt 加密存储
|
||||
- ✅ API 响应不包含密码字段
|
||||
- ✅ 用户名和密码验证（长度、复杂度）
|
||||
|
||||
### 业务规则
|
||||
- ✅ 管理员不能修改/删除自己
|
||||
- ✅ 系统至少保留一个 admin
|
||||
- ✅ 不能将最后一个 admin 降级为 user
|
||||
|
||||
## 🧪 测试
|
||||
|
||||
### 编译测试
|
||||
```bash
|
||||
cargo build --workspace
|
||||
```
|
||||
**结果**: ✅ 编译成功，无错误
|
||||
|
||||
### 警告修复
|
||||
- ✅ 消除了 `nomifun-db` 的未使用导入警告
|
||||
- ✅ 消除了 `nomifun-auth` 的未使用变量警告
|
||||
- ✅ 为预定义常量添加 `#[allow(dead_code)]`
|
||||
|
||||
### 功能测试
|
||||
|
||||
已提供测试脚本: `test_user_management.sh`
|
||||
|
||||
**测试流程**:
|
||||
1. 检查系统状态
|
||||
2. 创建/登录 admin 用户
|
||||
3. 列出所有用户
|
||||
4. 创建新用户
|
||||
5. 获取用户详情
|
||||
6. 更新用户角色
|
||||
7. 删除用户
|
||||
8. 验证最终状态
|
||||
|
||||
**运行测试**:
|
||||
```bash
|
||||
chmod +x test_user_management.sh
|
||||
./test_user_management.sh
|
||||
```
|
||||
|
||||
## 📊 完成度统计
|
||||
|
||||
### 任务 2.2.1 - 扩展用户注册接口
|
||||
- [x] 首次启动创建 admin（通过 `/api/auth/setup`）
|
||||
- [x] JWT 包含角色信息
|
||||
|
||||
### 任务 2.2.2 - 扩展登录接口
|
||||
- [x] 登录返回用户角色
|
||||
- [x] JWT payload 包含 role 字段
|
||||
|
||||
### 任务 2.2.3 - 添加用户管理接口
|
||||
- [x] GET /api/users - 列出所有用户
|
||||
- [x] POST /api/users - 创建新用户
|
||||
- [x] GET /api/users/:id - 获取用户详情
|
||||
- [x] PUT /api/users/:id - 更新用户
|
||||
- [x] DELETE /api/users/:id - 删除用户
|
||||
|
||||
### 任务 2.2.4 - 添加权限中间件
|
||||
- [x] require_admin_middleware 实现
|
||||
- [x] 非 admin 返回 403
|
||||
|
||||
**总体完成度**: 100% ✅
|
||||
|
||||
## 📝 文档更新
|
||||
|
||||
- ✅ 更新 `docs/0703/2-task-COMMONSP.md`
|
||||
- ✅ 标记所有 2.2 子任务为完成
|
||||
- ✅ 更新完成项记录表
|
||||
|
||||
## 🎯 下一步建议
|
||||
|
||||
根据任务文档顺序，下一步可以：
|
||||
|
||||
1. **继续后端功能**
|
||||
- 2.4.2 前端品牌配置页面
|
||||
- 2.5.2 审计日志切面集成
|
||||
- 2.5.4 前端审计日志页面
|
||||
|
||||
2. **前端管理后台**
|
||||
- 管理员侧边栏导航
|
||||
- 用户管理页面
|
||||
- 权限控制（路由守卫）
|
||||
|
||||
3. **完善功能**
|
||||
- Logo 上传功能
|
||||
- CSV 导出功能
|
||||
- 前端主题动态加载
|
||||
|
||||
## 📦 变更文件清单
|
||||
|
||||
### 新增/修改文件
|
||||
```
|
||||
crates/backend/nomifun-auth/src/middleware.rs # 新增 require_admin_middleware
|
||||
crates/backend/nomifun-auth/src/lib.rs # 导出 require_admin_middleware
|
||||
crates/backend/nomifun-auth/src/routes.rs # 新增 5 个用户管理端点
|
||||
crates/backend/nomifun-db/src/repository/user.rs # 新增 3 个 trait 方法
|
||||
crates/backend/nomifun-db/src/repository/sqlite_user.rs # 实现 3 个方法
|
||||
crates/backend/nomifun-db/src/repository/system_config.rs # 清理未使用导入
|
||||
crates/backend/nomifun-db/src/models/audit_log.rs # 添加 allow(dead_code)
|
||||
docs/0703/2-task-COMMONSP.md # 更新任务状态
|
||||
test_user_management.sh # 新增测试脚本
|
||||
```
|
||||
|
||||
## ✨ 技术亮点
|
||||
|
||||
1. **类型安全**: 所有接口使用强类型请求/响应
|
||||
2. **错误处理**: 统一的 `AppError` 错误处理
|
||||
3. **异步处理**: 密码加密在独立线程执行
|
||||
4. **日志记录**: 关键操作记录审计日志
|
||||
5. **代码质量**: 零编译错误，最小化警告
|
||||
|
||||
## 🔄 Git 提交建议
|
||||
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "feat: implement user management system (Task 2.2)
|
||||
|
||||
- Add require_admin_middleware for RBAC
|
||||
- Implement 5 user management endpoints (CRUD)
|
||||
- Add create_user_with_role, update_role, delete_user to repository
|
||||
- Protect against self-modification and last admin removal
|
||||
- Clean up compiler warnings
|
||||
- Add user management test script
|
||||
|
||||
Closes: Task 2.2 (User System)"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**报告生成时间**: 2026-03-14
|
||||
**任务状态**: ✅ 完成
|
||||
**构建状态**: ✅ 通过
|
||||
**测试状态**: ⏳ 待运行（需启动应用）
|
||||
@@ -0,0 +1,672 @@
|
||||
# 通用AI工作台底座平台 — 架构演进方案
|
||||
|
||||
> 文档编号：ARCH-EVOL-001
|
||||
> 版本：v1.0.0
|
||||
> 日期：2026-07-03
|
||||
> 状态：初稿
|
||||
|
||||
---
|
||||
|
||||
## 1. 项目愿景与定位
|
||||
|
||||
### 1.1 核心目标
|
||||
|
||||
构建一个**领域无关、部署灵活、能力开放**的通用AI工作台底座平台，支持企业、政府、教育三大领域的AI应用快速落地。
|
||||
|
||||
### 1.2 关键特性
|
||||
|
||||
| 特性 | 描述 |
|
||||
|------|------|
|
||||
| **底座优先** | 提供通用原子能力，业务逻辑通过配置和扩展实现 |
|
||||
| **多租户本地部署** | 每个租户数据隔离，支持私有化部署 |
|
||||
| **领域适配层** | 通过主题、技能包、知识库模板实现领域定制 |
|
||||
| **开放能力总线** | MCP + REST，任意智能体可接入 |
|
||||
| **渐进式演进** | 从最小可用到完整平台，平滑升级路径 |
|
||||
|
||||
### 1.3 目标用户画像
|
||||
|
||||
| 领域 | 典型用户 | 核心痛点 |
|
||||
|------|---------|---------|
|
||||
| **政府** | 政务办公人员、科室干部 | 机密数据不敢上云、公文写作效率低、政策检索困难 |
|
||||
| **企业** | 行政、财务、法务、销售 | 流程繁琐、知识分散、重复劳动多 |
|
||||
| **教育** | 教师、科研人员、教务管理 | 备课耗时、论文写作繁琐、数据分析困难 |
|
||||
|
||||
---
|
||||
|
||||
## 2. 架构设计
|
||||
|
||||
### 2.1 总体架构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────────┐
|
||||
│ 租户层 (Tenant Layer) │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ 政府租户 │ │ 企业租户 │ │ 教育租户 │ │ 更多租户... │ │
|
||||
│ │ 政务蓝主题 │ │ 企业蓝主题 │ │ 学术蓝主题 │ │ 自定义主题 │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||||
├─────────────────────────────────────────────────────────────────────────┤
|
||||
│ 领域适配层 (Domain Layer) │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ 技能包商店 │ │ 知识库模板 │ │ 应用模板 │ │
|
||||
│ │ (Skills) │ │ (Templates) │ │ (Apps) │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||||
├─────────────────────────────────────────────────────────────────────────┤
|
||||
│ 核心引擎层 (Engine Layer) │
|
||||
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
|
||||
│ │ Agent │ │ Skills │ │ Knowledge │ │ MCP │ │ Channels │ │
|
||||
│ │ Engine │ │ System │ │ RAG │ │ Gateway │ │ Bus │ │
|
||||
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
|
||||
├─────────────────────────────────────────────────────────────────────────┤
|
||||
│ 基础设施层 (Infra Layer) │
|
||||
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
|
||||
│ │ SQLite │ │ Auth │ │ Storage │ │ Event │ │
|
||||
│ │ (Local) │ │ Service │ │ Service │ │ Bus │ │
|
||||
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
|
||||
└─────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 2.2 核心分层职责
|
||||
|
||||
| 层级 | 职责 | 扩展点 |
|
||||
|------|------|-------|
|
||||
| **租户层** | 品牌定制、主题切换、租户配置 | 新增领域时注册主题包 |
|
||||
| **领域适配层** | 技能包管理、知识库模板、应用市场 | 扩展点最多，按需加载 |
|
||||
| **核心引擎层** | AI对话、自动化、技能执行、RAG、MCP | 稳定，新增Agent类型 |
|
||||
| **基础设施层** | 数据持久化、认证、文件存储、事件总线 | 底层能力，变更少 |
|
||||
|
||||
### 2.3 技术选型
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ 底座技术栈 │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Rust (nomifun-tauri后端) │ 企业/政府首选（性能+安全） │
|
||||
│ ──────────────────────────────────────────────────────────── │
|
||||
│ Python Worker (可选扩展) │ AI模型/PPT生成等重型计算 │
|
||||
│ ──────────────────────────────────────────────────────────── │
|
||||
│ React 19 + Vite (前端) │ 跨平台，成熟生态 │
|
||||
│ ──────────────────────────────────────────────────────────── │
|
||||
│ SQLite + sqlx (本地存储) │ 零依赖部署，数据主权清晰 │
|
||||
│ ──────────────────────────────────────────────────────────── │
|
||||
│ PostgreSQL (可选云端存储) │ 多租户共享场景 │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 模块划分
|
||||
|
||||
### 3.1 核心模块矩阵
|
||||
|
||||
| 模块 | 复用 nomifun-tauri | 需新增 | 优先级 |
|
||||
|------|-------------------|--------|--------|
|
||||
| Agent Engine | 100% | - | P0 |
|
||||
| Skills System | 100% | - | P0 |
|
||||
| Knowledge RAG | 80% | 领域模板 | P1 |
|
||||
| MCP Gateway | 100% | - | P0 |
|
||||
| Channels Bus | 90% | 领域适配 | P1 |
|
||||
| Auth Service | 60% | 多租户适配 | P0 |
|
||||
| Storage Service | 80% | 云端存储 | P2 |
|
||||
| Theme System | 30% | 领域主题引擎 | P1 |
|
||||
| App Templates | 20% | 应用商店框架 | P1 |
|
||||
| Tenant Config | 0% | 新建核心模块 | P0 |
|
||||
|
||||
### 3.2 租户配置模型
|
||||
|
||||
```rust
|
||||
// 租户配置核心模型
|
||||
struct TenantConfig {
|
||||
id: Uuid,
|
||||
name: String,
|
||||
domain: DomainType, // 政府 / 企业 / 教育 / 自定义
|
||||
|
||||
// 品牌定制
|
||||
branding: BrandingConfig {
|
||||
logo_url: String,
|
||||
primary_color: Color,
|
||||
theme_preset: ThemePreset,
|
||||
},
|
||||
|
||||
// 功能开关
|
||||
features: FeatureFlags {
|
||||
app_store: bool,
|
||||
skill_market: bool,
|
||||
multi_user: bool,
|
||||
cloud_sync: bool,
|
||||
},
|
||||
|
||||
// 数据策略
|
||||
data_policy: DataPolicy {
|
||||
storage: StorageType, // local / cloud / hybrid
|
||||
retention_days: u32,
|
||||
encryption: bool,
|
||||
},
|
||||
|
||||
// 领域配置
|
||||
domain_config: DomainConfig,
|
||||
}
|
||||
```
|
||||
|
||||
### 3.3 领域适配模型
|
||||
|
||||
```rust
|
||||
// 领域配置
|
||||
enum DomainConfig {
|
||||
Government(GovConfig), // 政务领域
|
||||
Enterprise(EntConfig), // 企业领域
|
||||
Education(EduConfig), // 教育领域
|
||||
Custom(CustomConfig), // 自定义领域
|
||||
}
|
||||
|
||||
// 政务配置示例
|
||||
struct GovConfig {
|
||||
// 预置应用分类
|
||||
app_categories: Vec<AppCategory>,
|
||||
// 公文模板
|
||||
doc_templates: Vec<DocTemplate>,
|
||||
// 知识库分类
|
||||
knowledge_domains: Vec<KnowledgeDomain>,
|
||||
// 审批流程
|
||||
approval_workflows: Vec<Workflow>,
|
||||
}
|
||||
|
||||
// 企业配置示例
|
||||
struct EntConfig {
|
||||
// 部门模板
|
||||
departments: Vec<Department>,
|
||||
// 业务流程
|
||||
business_processes: Vec<Process>,
|
||||
// 知识库分类
|
||||
knowledge_domains: Vec<KnowledgeDomain>,
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 演进路线
|
||||
|
||||
### Phase 1: 底座夯实 (MVP)
|
||||
|
||||
**目标**: 完善多租户基础设施，建立领域扩展框架
|
||||
|
||||
#### 1.1 租户系统
|
||||
|
||||
- [ ] 租户注册与配置管理
|
||||
- [ ] 多租户数据隔离 (SQLite schema per tenant)
|
||||
- [ ] 租户级别配置持久化
|
||||
- [ ] 租户迁移与备份机制
|
||||
|
||||
#### 1.2 主题引擎
|
||||
|
||||
- [ ] 动态主题切换系统
|
||||
- [ ] 预设主题包:
|
||||
- [ ] 政务蓝主题 (GovAI配色体系)
|
||||
- [ ] 企业专业主题
|
||||
- [ ] 学术清新主题
|
||||
- [ ] 主题预览与即时切换
|
||||
|
||||
#### 1.3 领域框架
|
||||
|
||||
- [ ] 领域配置schema定义
|
||||
- [ ] 领域初始化向导
|
||||
- [ ] 领域特定技能包注册
|
||||
- [ ] 领域知识库模板
|
||||
|
||||
#### 1.4 基础设施增强
|
||||
|
||||
- [ ] 多用户认证系统 (OAuth/SSO集成预留)
|
||||
- [ ] 角色权限模型 (RBAC)
|
||||
- [ ] 操作审计日志
|
||||
- [ ] 配置导出/导入
|
||||
|
||||
**Phase 1 交付物**:
|
||||
```
|
||||
底座平台 v1.0
|
||||
├── 多租户管理后台
|
||||
├── 3套预设主题
|
||||
├── 领域配置框架
|
||||
└── 完整文档
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Phase 2: 领域深化 (Domain Depth)
|
||||
|
||||
**目标**: 深耕政府/企业/教育三大领域，沉淀领域资产
|
||||
|
||||
#### 2.1 政府领域包
|
||||
|
||||
- [ ] 政务应用商店
|
||||
- [ ] 公文写作助手
|
||||
- [ ] 政策法规检索
|
||||
- [ ] 会议纪要生成
|
||||
- [ ] 信访答复辅助
|
||||
- [ ] 政务知识库模板
|
||||
- [ ] 法规库分类
|
||||
- [ ] 政策解读模板
|
||||
- [ ] 公文格式库
|
||||
- [ ] 政务审批流程
|
||||
- [ ] 多级审核
|
||||
- [ ] 痕迹保留
|
||||
- [ ] 归档管理
|
||||
|
||||
#### 2.2 企业领域包
|
||||
|
||||
- [ ] 企业应用商店
|
||||
- [ ] 合同审查助手
|
||||
- [ ] 财务报告生成
|
||||
- [ ] 销售话术优化
|
||||
- [ ] HR招聘辅助
|
||||
- [ ] 企业知识库模板
|
||||
- [ ] 产品知识库
|
||||
- [ ] 流程规范库
|
||||
- [ ] 培训资料库
|
||||
- [ ] 企业协同流程
|
||||
- [ ] 部门协作
|
||||
- [ ] 任务分发
|
||||
- [ ] 进度追踪
|
||||
|
||||
#### 2.3 教育领域包
|
||||
|
||||
- [ ] 教育应用商店
|
||||
- [ ] 教案生成助手
|
||||
- [ ] 论文润色工具
|
||||
- [ ] 考试命题辅助
|
||||
- [ ] 学术翻译助手
|
||||
- [ ] 教育知识库模板
|
||||
- [ ] 课程资料库
|
||||
- [ ] 学术文献库
|
||||
- [ ] 试题题库
|
||||
- [ ] 教育分析工具
|
||||
- [ ] 学情分析
|
||||
- [ ] 教学质量评估
|
||||
- [ ] 科研趋势分析
|
||||
|
||||
#### 2.4 技能市场
|
||||
|
||||
- [ ] 技能包发布与管理
|
||||
- [ ] 技能包市场浏览
|
||||
- [ ] 技能包安装/卸载
|
||||
- [ ] 技能包评分与评论
|
||||
- [ ] 技能包版本管理
|
||||
|
||||
**Phase 2 交付物**:
|
||||
```
|
||||
底座平台 v2.0
|
||||
├── 3套完整领域包
|
||||
├── 技能市场
|
||||
├── 知识库模板市场
|
||||
└── 领域应用商店
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Phase 3: 生态扩展 (Ecosystem)
|
||||
|
||||
**目标**: 建立开放生态，支持第三方扩展
|
||||
|
||||
#### 3.1 开放API
|
||||
|
||||
- [ ] 租户管理 API
|
||||
- [ ] 应用管理 API
|
||||
- [ ] 知识库 API
|
||||
- [ ] 技能包 API
|
||||
- [ ] Webhook 事件订阅
|
||||
|
||||
#### 3.2 插件系统
|
||||
|
||||
- [ ] 插件SDK (Rust/Python/JS)
|
||||
- [ ] 插件市场
|
||||
- [ ] 插件沙箱执行
|
||||
- [ ] 插件审核机制
|
||||
|
||||
#### 3.3 数据集成
|
||||
|
||||
- [ ] 企业微信/钉钉/飞书集成
|
||||
- [ ] LDAP/AD 目录集成
|
||||
- [ ] 数据库直连 (MySQL/PostgreSQL)
|
||||
- [ ] 文件存储集成 (S3/OSS/MinIO)
|
||||
|
||||
#### 3.4 高级功能
|
||||
|
||||
- [ ] 多租户联邦学习
|
||||
- [ ] 跨租户知识共享
|
||||
- [ ] 私有模型部署支持
|
||||
- [ ] 边缘节点支持
|
||||
|
||||
**Phase 3 交付物**:
|
||||
```
|
||||
底座平台 v3.0
|
||||
├── 完整开放API
|
||||
├── 插件系统
|
||||
├── 企业集成适配器
|
||||
└── 联邦学习框架
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 各领域适配方案
|
||||
|
||||
### 5.1 政府领域适配
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 政府领域架构 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ 特色能力 │
|
||||
│ ├─ 数据不出内网 (本地SQLite优先) │
|
||||
│ ├─ 等保合规 (审计日志、操作留痕) │
|
||||
│ ├─ 公文格式标准化 (党政/行政/人大等) │
|
||||
│ ├─ 多级审批流程 │
|
||||
│ └─ 涉密数据隔离 │
|
||||
│ │
|
||||
│ 借鉴 GovAI │
|
||||
│ ├─ 政务蓝配色体系 │
|
||||
│ ├─ 多租户用户管理 │
|
||||
│ ├─ 应用审核机制 │
|
||||
│ └─ RAG知识库分类 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.2 企业领域适配
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 企业领域架构 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ 特色能力 │
|
||||
│ ├─ 多部门协同 (权限矩阵) │
|
||||
│ ├─ 业务系统集成 (ERP/CRM/OA) │
|
||||
│ ├─ 私有知识沉淀 │
|
||||
│ ├─ 流程自动化 │
|
||||
│ └─ 成本控制 (token配额管理) │
|
||||
│ │
|
||||
│ 扩展方向 │
|
||||
│ ├─ 销售域: 客户画像、话术推荐、竞品分析 │
|
||||
│ ├─ 研发域: 代码审查、文档生成、技术方案 │
|
||||
│ ├─ 财务域: 报表分析、预算预测、合规检查 │
|
||||
│ └─ HR域: 简历筛选、面试题库、入职指引 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.3 教育领域适配
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 教育领域架构 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ 特色能力 │
|
||||
│ ├─ 学术规范 (引用格式、查重) │
|
||||
│ ├─ 多语言支持 (学术翻译) │
|
||||
│ ├─ 版权合规 (知识库版权检测) │
|
||||
│ ├─ 教研协同 │
|
||||
│ └─ 学生隐私保护 (FERPA/GDPR) │
|
||||
│ │
|
||||
│ 扩展方向 │
|
||||
│ ├─ K12: 教案生成、试题组卷、作业批改 │
|
||||
│ ├─ 高等教育: 论文写作、科研助手、学术检索 │
|
||||
│ ├─ 企业培训: 课程开发、培训评估、能力认证 │
|
||||
│ └─ 终身学习: 技能提升、职业规划、学习推荐 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. 数据架构
|
||||
|
||||
### 6.1 多租户数据隔离策略
|
||||
|
||||
| 策略 | 适用场景 | 优点 | 缺点 |
|
||||
|------|---------|------|------|
|
||||
| **Schema隔离** | 高安全租户 | 完全隔离、性能好 | 管理复杂 |
|
||||
| **行级隔离** | 普通租户 | 管理简单、成本低 | 隔离性弱 |
|
||||
| **混合模式** | 敏感数据 | 灵活 | 实现复杂 |
|
||||
|
||||
### 6.2 数据流设计
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────┐
|
||||
│ 数据流架构 │
|
||||
├──────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 用户输入 ──▶ 租户路由 ──▶ 领域处理器 ──▶ 知识库检索 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ Agent Engine │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 输出存储 ◀── 审计日志 ◀── 响应生成 ◀── 工具调用 │
|
||||
│ │
|
||||
│ 知识库写入: │
|
||||
│ 文档上传 ──▶ 领域分块 ──▶ 向量嵌入 ──▶ 租户向量库 │
|
||||
│ │
|
||||
└──────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 6.3 知识库RAG增强
|
||||
|
||||
```rust
|
||||
// 领域感知RAG配置
|
||||
struct DomainRAGConfig {
|
||||
// 分块策略
|
||||
chunk_strategy: ChunkStrategy,
|
||||
|
||||
// 嵌入模型
|
||||
embedding_model: String,
|
||||
|
||||
// 检索策略
|
||||
retrieval: RetrievalConfig {
|
||||
top_k: u32,
|
||||
similarity_threshold: f32,
|
||||
rerank: bool,
|
||||
},
|
||||
|
||||
// 领域特定后处理
|
||||
post_processors: Vec<Box<dyn PostProcessor>>,
|
||||
}
|
||||
|
||||
// 后处理器示例
|
||||
trait PostProcessor: Send + Sync {
|
||||
fn process(&self, chunks: &mut Vec<RetrievedChunk>, query: &str);
|
||||
}
|
||||
|
||||
// 领域后处理器
|
||||
struct GovPostProcessor {
|
||||
// 政策时效性权重
|
||||
policy_date_weight: f32,
|
||||
// 法规效力等级权重
|
||||
legal_level_weight: f32,
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. 安全架构
|
||||
|
||||
### 7.1 安全层级
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 安全架构 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 身份认证 │
|
||||
│ ├─ 多因素认证 (TOTP/WebAuthn) │
|
||||
│ ├─ SSO集成 (SAML/OIDC) │
|
||||
│ └─ 会话管理 (JWT + 刷新令牌) │
|
||||
│ │
|
||||
│ 访问控制 │
|
||||
│ ├─ RBAC (角色权限) │
|
||||
│ ├─ ABAC (属性权限) │
|
||||
│ └─ 数据边界 (租户隔离) │
|
||||
│ │
|
||||
│ 数据安全 │
|
||||
│ ├─ 传输加密 (TLS 1.3) │
|
||||
│ ├─ 存储加密 (AES-256) │
|
||||
│ └─ 密钥管理 (HSM/KMS预留) │
|
||||
│ │
|
||||
│ 审计合规 │
|
||||
│ ├─ 操作审计 (CRUD全记录) │
|
||||
│ ├─ 数据导出审计 │
|
||||
│ └─ 合规报告生成 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 7.2 政府合规特别设计
|
||||
|
||||
| 合规要求 | 实现方案 |
|
||||
|---------|---------|
|
||||
| 等保2.0 | 安全计算环境、安全通信网络、安全区域边界 |
|
||||
| 数据不出网 | 本地SQLite优先、可选单向网闸 |
|
||||
| 隐私保护 | 数据脱敏、匿名化处理、最小采集 |
|
||||
| 审计追溯 | 完整操作日志、不可篡改存储 |
|
||||
|
||||
---
|
||||
|
||||
## 8. 部署架构
|
||||
|
||||
### 8.1 部署模式
|
||||
|
||||
| 模式 | 适用场景 | 数据位置 | 维护成本 |
|
||||
|------|---------|---------|---------|
|
||||
| **单机本地** | 个人/小团队 | 本地磁盘 | 低 |
|
||||
| **局域网私有** | 政府部门/敏感企业 | 内网服务器 | 中 |
|
||||
| **私有云** | 中大型企业 | 私有云存储 | 中 |
|
||||
| **混合云** | 多分支机构 | 边缘+中心 | 高 |
|
||||
|
||||
### 8.2 部署拓扑
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 私有化部署拓扑 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ [客户端] ──▶ [反向代理/Nginx] ──▶ [NomiFun Backend] │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌───────────────┐ │
|
||||
│ │ SQLite │ │
|
||||
│ │ (租户数据) │ │
|
||||
│ └───────────────┘ │
|
||||
│ │ │
|
||||
│ ┌───────────────┐ │
|
||||
│ │ 文件存储 │ │
|
||||
│ │ (本地/MinIO) │ │
|
||||
│ └───────────────┘ │
|
||||
│ │
|
||||
│ 可选扩展: │
|
||||
│ ├─ [GPU节点] ──▶ LLM推理加速 │
|
||||
│ ├─ [向量库] ──▶ pgvector高性能检索 │
|
||||
│ └─ [备份服务] ──▶ 定时备份到对象存储 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. 迁移与演进策略
|
||||
|
||||
### 9.1 从 nomifun-tauri 迁移
|
||||
|
||||
```
|
||||
nomifun-tauri (当前)
|
||||
│
|
||||
│ Phase 1: 多租户抽象层
|
||||
▼
|
||||
┌─────────────────────────┐
|
||||
│ + TenantConfig │
|
||||
│ + TenantContext │
|
||||
│ + DomainLayer │
|
||||
│ + ThemeEngine │
|
||||
└─────────────────────────┘
|
||||
│
|
||||
│ Phase 2: 领域资产
|
||||
▼
|
||||
┌─────────────────────────┐
|
||||
│ + GovDomainPack │
|
||||
│ + EntDomainPack │
|
||||
│ + EduDomainPack │
|
||||
│ + SkillMarket │
|
||||
└─────────────────────────┘
|
||||
│
|
||||
│ Phase 3: 生态开放
|
||||
▼
|
||||
┌─────────────────────────┐
|
||||
│ + PluginSDK │
|
||||
│ + OpenAPI │
|
||||
│ + EnterpriseAdapters │
|
||||
└─────────────────────────┘
|
||||
```
|
||||
|
||||
### 9.2 从 GovAI 借鉴
|
||||
|
||||
| GovAI 资产 | 借鉴方式 |
|
||||
|-----------|---------|
|
||||
| 政务蓝配色 | 转为nomifun主题包 |
|
||||
| 应用类型系统 | 适配为nomifun Skills |
|
||||
| 多租户管理 | 重写(架构不同) |
|
||||
| RAG流程 | 直接复用思路 |
|
||||
| PPT生成 | 封装为Skill |
|
||||
|
||||
---
|
||||
|
||||
## 10. 风险与挑战
|
||||
|
||||
### 10.1 技术风险
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 多租户隔离不完善 | 数据泄露 | Phase1重点测试 |
|
||||
| 领域抽象过度设计 | 灵活性降低 | 按需扩展 |
|
||||
| 性能瓶颈 | 用户体验差 | 性能测试+优化 |
|
||||
|
||||
### 10.2 业务风险
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 领域需求差异大 | 开发成本高 | MVP验证+迭代 |
|
||||
| 竞品压力 | 市场占用低 | 差异化定位 |
|
||||
| 合规不确定性 | 合规风险 | 持续跟踪政策 |
|
||||
|
||||
---
|
||||
|
||||
## 11. 成功指标
|
||||
|
||||
### 11.1 技术指标
|
||||
|
||||
| 指标 | 目标值 |
|
||||
|------|--------|
|
||||
| 冷启动时间 | < 3s |
|
||||
| 对话响应延迟 (TTFT) | < 500ms (本地模型) |
|
||||
| 租户创建时间 | < 1min |
|
||||
| 主题切换延迟 | < 100ms |
|
||||
|
||||
### 11.2 业务指标
|
||||
|
||||
| 指标 | Phase 1 | Phase 2 | Phase 3 |
|
||||
|------|---------|---------|---------|
|
||||
| 租户数 | 10 | 100 | 1000+ |
|
||||
| 活跃用户/租户 | 10 | 50 | 200+ |
|
||||
| 技能包数量 | 20 | 200 | 1000+ |
|
||||
| 知识库文档数/租户 | 100 | 1000 | 10000+ |
|
||||
|
||||
---
|
||||
|
||||
## 12. 后续步骤
|
||||
|
||||
### 12.1 立即行动
|
||||
|
||||
1. **Phase 1 详细设计**: 完善多租户抽象层设计
|
||||
2. **技术验证**: 实现最小租户隔离Demo
|
||||
3. **主题系统**: 基于GovAI配色创建政务蓝主题
|
||||
|
||||
### 12.2 决策点
|
||||
|
||||
- [ ] 确认多租户隔离策略 (Schema vs 行级)
|
||||
- [ ] 确定向量数据库选型 (SQLite-vss vs pgvector)
|
||||
- [ ] 明确商业化路径
|
||||
|
||||
---
|
||||
|
||||
> 文档结束 — 如有疑问或需要细化特定模块，请告知。
|
||||
@@ -0,0 +1,735 @@
|
||||
# PrivBox-AIStation 软硬一体化产品体系
|
||||
|
||||
> 文档编号：ARCH-INTEGRATION-001
|
||||
> 版本：v1.0.0
|
||||
> 日期：2026-07-03
|
||||
> 状态：正式发布
|
||||
|
||||
---
|
||||
|
||||
## 一、产品愿景与定位
|
||||
|
||||
### 1.1 一句话定位
|
||||
|
||||
**PrivBox-AIStation = 算力盒子 × 通用AI工作台底座 × 行业应用集**
|
||||
|
||||
一款"开箱即用、数据不出门、能力在身边"的私有化AI工作站，满足高安全要求客户的AI落地需求。
|
||||
|
||||
### 1.2 核心价值
|
||||
|
||||
| 价值维度 | 具体体现 |
|
||||
|---------|---------|
|
||||
| **硬件开箱即用** | 国产NPU算力，预装模型，接显示器/网线即可使用 |
|
||||
| **软件开箱即用** | 浏览器访问工作台，30分钟内用上AI能力 |
|
||||
| **数据不出门** | 本地推理，物理隔离，零数据外传 |
|
||||
| **能力在身边** | 离线可用，断网也能AI辅助 |
|
||||
| **持续可演进** | 软件持续升级，模型持续优化 |
|
||||
|
||||
### 1.3 目标客户
|
||||
|
||||
| 客户类型 | 核心痛点 | 解决方案 |
|
||||
|---------|---------|---------|
|
||||
| **党政机关** | 涉密数据不敢上云、公文写作效率低、政策检索困难 | 政务行业包 + 等保合规 |
|
||||
| **国企/央企** | 公有AI存在泄露风险、长期使用成本高 | 企业行业包 + 私有化部署 |
|
||||
| **金融机构** | 财务/风控数据敏感、合规要求严格 | 行业定制包 + 审计日志 |
|
||||
| **军队/国防** | 全链路国产化、物理隔离要求 | 主私盒集群 + 全离线 |
|
||||
| **科研/教育** | 涉密课题数据、学术规范需求 | 教育行业包 + 隐私保护 |
|
||||
|
||||
---
|
||||
|
||||
## 二、三层产品架构
|
||||
|
||||
### 2.1 架构总览
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────────┐
|
||||
│ 第三层：行业应用集 (Industry Packs) │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │
|
||||
│ │ 政务包 │ │ 企业包 │ │ 教育包 │ │ 定制包 │ │
|
||||
│ │ GovPack │ │ EntPack │ │ EduPack │ │ CustomPack │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ └────────────┘ │
|
||||
├─────────────────────────────────────────────────────────────────────────┤
|
||||
│ 第二层：通用AI工作台底座 (Commons Platform) │
|
||||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 租户层 │ 领域适配层 │ 核心引擎层 │ 基础设施层 │ │
|
||||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||||
│ │ 多租户配置 │ 技能包商店 │ Agent Engine │ SQLite存储 │ │
|
||||
│ │ 主题引擎 │ 知识库模板 │ Skills System │ Auth服务 │ │
|
||||
│ │ 品牌定制 │ 应用模板 │ RAG引擎 │ Storage服务 │ │
|
||||
│ │ │ │ MCP Gateway │ Event Bus │ │
|
||||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||||
├─────────────────────────────────────────────────────────────────────────┤
|
||||
│ 第一层：PrivBox 硬件抽象层 (Hardware Abstraction) │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ 轻私盒 │ │ 主私盒 │ │ 主私盒集群 │ │
|
||||
│ │ 100TOPS/48GB│ │ 400TOPS/192GB│ │ 横向扩展 │ │
|
||||
│ │ 单用户 │ │ 5-20人共享 │ │ 超大规模 │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 2.2 层次关系
|
||||
|
||||
```
|
||||
硬件层 (PrivBox)
|
||||
│
|
||||
│ 提供算力、存储、网络、物理安全
|
||||
▼
|
||||
软件底座层 (Commons Platform)
|
||||
│
|
||||
│ 提供Agent引擎、Skills系统、RAG能力、多租户管理
|
||||
▼
|
||||
行业应用层 (Industry Packs)
|
||||
│
|
||||
│ 提供垂直场景的技能包、知识库模板、工作流
|
||||
▼
|
||||
交付产品 (PrivBox-AIStation)
|
||||
```
|
||||
|
||||
### 2.3 各层职责
|
||||
|
||||
| 层次 | 稳定性 | 变更频率 | 主要维护方 |
|
||||
|------|--------|---------|-----------|
|
||||
| **硬件层** | 最高 | 硬件迭代时 | 硬件团队 |
|
||||
| **软件底座层** | 高 | 季度迭代 | 软件团队 |
|
||||
| **行业应用层** | 中 | 按需定制 | 行业团队/合作伙伴 |
|
||||
|
||||
---
|
||||
|
||||
## 三、第一层：PrivBox 硬件层
|
||||
|
||||
### 3.1 硬件规格
|
||||
|
||||
| 规格项 | 轻私盒 | 主私盒 | 主私盒集群 |
|
||||
|--------|--------|--------|-----------|
|
||||
| **定位** | 个人专属AI工位 | 部门级AI协作中枢 | 超大规模/涉密单位 |
|
||||
| **AI算力** | 100 TOPS | 400 TOPS | 400×N TOPS |
|
||||
| **主控CPU** | RISC-V国产 | 兆芯 | 兆芯×N |
|
||||
| **内存** | 32GB合封+16GB | 128GB统一+64GB | 线性扩展 |
|
||||
| **存储** | 500GB microSD | 500GB M.2+扩展 | 横向扩展 |
|
||||
| **并发用户** | 1人 | 5-20人 | 50-200人 |
|
||||
| **网络** | 千兆网口 | 千兆网口 | 万兆内网 |
|
||||
| **体积** | 13×13×5cm | 20×20×12cm | 机架式 |
|
||||
| **噪音** | <30dB | 38-43dB | 机房级 |
|
||||
| **功耗** | 低 | 中 | 高 |
|
||||
| **典型价格** | ¥8,000 | ¥25,000 | ¥80,000+ |
|
||||
|
||||
### 3.2 软件配置对照
|
||||
|
||||
| 规格项 | 轻私盒 | 主私盒 |
|
||||
|--------|--------|--------|
|
||||
| **预装模型** | Qwen2.5-7B-Instruct (INT8) | Qwen2.5-14B-Instruct (INT8) |
|
||||
| **向量模型** | bge-small-zh | bge-base-zh |
|
||||
| **ASR模型** | SenseVoice | SenseVoice |
|
||||
| **可用推理内存** | ~20GB | ~80-90GB |
|
||||
| **可运行模型范围** | 7B-13B | 14B-70B |
|
||||
|
||||
### 3.3 硬件抽象层 (HAL)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 硬件抽象层 (HAL) │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ NPU调度器 │ │ 内存管理器 │ │ 存储管理器 │ │
|
||||
│ │ - 模型加载 │ │ - 统一内存 │ │ - 本地存储 │ │
|
||||
│ │ - 并发控制 │ │ - KV Cache │ │ - 备份还原 │ │
|
||||
│ │ - 算力分配 │ │ - 溢出处理 │ │ - 加密存储 │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||||
│ │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ 网络管理器 │ │ 更新管理器 │ │ 监控管理器 │ │
|
||||
│ │ - 内网访问 │ │ - USB更新 │ │ - 温度监控 │ │
|
||||
│ │ - 离线模式 │ │ - 增量推送 │ │ - 状态上报 │ │
|
||||
│ │ - 安全策略 │ │ - 回滚机制 │ │ - 日志收集 │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、第二层：通用AI工作台底座
|
||||
|
||||
### 4.1 技术架构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────────┐
|
||||
│ 通用AI工作台底座 │
|
||||
├─────────────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 租户层 (Tenant Layer) │ │
|
||||
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
|
||||
│ │ │ 政府租户 │ │ 企业租户 │ │ 教育租户 │ │ │
|
||||
│ │ │ 政务蓝主题 │ │ 企业蓝主题 │ │ 学术蓝主题 │ │ │
|
||||
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
|
||||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 领域适配层 (Domain Layer) │ │
|
||||
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
|
||||
│ │ │ 技能包商店 │ │ 知识库模板 │ │ 应用模板 │ │ │
|
||||
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
|
||||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 核心引擎层 (Engine Layer) │ │
|
||||
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
|
||||
│ │ │ Agent │ │ Skills │ │ Knowledge │ │ MCP │ │ │
|
||||
│ │ │ Engine │ │ System │ │ RAG │ │ Gateway │ │ │
|
||||
│ │ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │ │
|
||||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 基础设施层 (Infra Layer) │ │
|
||||
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
|
||||
│ │ │ SQLite │ │ Auth │ │ Storage │ │ Event │ │ │
|
||||
│ │ │ (Local) │ │ Service │ │ Service │ │ Bus │ │ │
|
||||
│ │ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │ │
|
||||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||||
│ │ PrivBox HAL 适配层 │ │
|
||||
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
|
||||
│ │ │ NPU推理 │ │ 模型服务 │ │ 离线更新 │ │ │
|
||||
│ │ └───────────┘ └───────────┘ └───────────┘ │ │
|
||||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 4.2 核心模块矩阵
|
||||
|
||||
| 模块 | 来源 | 说明 | 与PrivBox集成 |
|
||||
|------|------|------|--------------|
|
||||
| **Agent Engine** | nomifun-tauri 100% | 对话、工具调用、Agent编排 | 对接NPU推理 |
|
||||
| **Skills System** | nomifun-tauri 100% | 技能包加载、执行、管理 | 预装+按需安装 |
|
||||
| **Knowledge RAG** | nomifun-tauri 80% | 文档检索、向量搜索 | 使用本地向量库 |
|
||||
| **MCP Gateway** | nomifun-tauri 100% | 协议转换、插件接入 | 预留扩展 |
|
||||
| **Auth Service** | nomifun-tauri 60% | 单用户认证 | 增强多用户 |
|
||||
| **Tenant Config** | 新开发 | 多租户配置、隔离 | 核心新增 |
|
||||
| **Theme Engine** | 新开发 | 主题切换、品牌定制 | 政务蓝首发 |
|
||||
| **App Templates** | 新开发 | 应用创建框架 | 按行业包 |
|
||||
|
||||
### 4.3 多租户配置模型
|
||||
|
||||
```rust
|
||||
// 租户配置核心模型
|
||||
struct TenantConfig {
|
||||
id: Uuid,
|
||||
name: String,
|
||||
domain: DomainType, // Government / Enterprise / Education / Custom
|
||||
|
||||
// 硬件绑定
|
||||
hardware: HardwareBinding {
|
||||
device_id: String,
|
||||
device_type: DeviceType, // LightBox / MainBox / Cluster
|
||||
max_users: u32,
|
||||
},
|
||||
|
||||
// 品牌定制
|
||||
branding: BrandingConfig {
|
||||
logo_url: String,
|
||||
primary_color: Color,
|
||||
theme_preset: ThemePreset,
|
||||
},
|
||||
|
||||
// 功能开关
|
||||
features: FeatureFlags {
|
||||
app_store: bool,
|
||||
skill_market: bool,
|
||||
multi_user: bool,
|
||||
cloud_sync: bool,
|
||||
},
|
||||
|
||||
// 数据策略
|
||||
data_policy: DataPolicy {
|
||||
storage: StorageType, // local / encrypted_local
|
||||
retention_days: u32,
|
||||
encryption: bool,
|
||||
},
|
||||
|
||||
// 领域配置
|
||||
domain_config: DomainConfig,
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、第三层：行业应用集
|
||||
|
||||
### 5.1 政务行业包 (GovPack)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 政务行业包 (GovPack) │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 【应用商店】 │
|
||||
│ ├─ 公文写作: 通知/请示/报告/函等15种法定公文 │
|
||||
│ ├─ 政策解读: 政策文件智能分析、要点提取 │
|
||||
│ ├─ 法规检索: 常用法规自然语言检索 │
|
||||
│ ├─ 会议纪要: 语音转写+结构化纪要生成 │
|
||||
│ ├─ 信访答复: 信访件智能分类+答复草稿 │
|
||||
│ ├─ 敏感词检测: 对外文稿自动审查 │
|
||||
│ └─ 合规检查: 公文格式校验、制度合规性 │
|
||||
│ │
|
||||
│ 【预置知识库】 │
|
||||
│ ├─ 法规政策库 (国家级/省级/市级) │
|
||||
│ ├─ 公文格式库 (党政/行政/人大/政协) │
|
||||
│ ├─ 常用语料库 (领导讲话、致辞) │
|
||||
│ └─ 业务术语库 (各部委办局专业术语) │
|
||||
│ │
|
||||
│ 【特色功能】 │
|
||||
│ ├─ 等保2.0合规模式 │
|
||||
│ ├─ 操作审计日志 (不可篡改) │
|
||||
│ ├─ 涉密文件处理流程 │
|
||||
│ └─ 多级审批工作流 │
|
||||
│ │
|
||||
│ 【适用硬件】 主私盒 / 主私盒集群 │
|
||||
│ 【授权模式】 年度授权 + 服务费 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.2 企业行业包 (EntPack)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 企业行业包 (EntPack) │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 【应用商店】 │
|
||||
│ ├─ 合同审查: 条款风险识别、不利条款标注 │
|
||||
│ ├─ 报告生成: 工作报告/分析报告自动撰写 │
|
||||
│ ├─ 销售助手: 客户画像、话术推荐、竞品分析 │
|
||||
│ ├─ 财务分析: 报表解读、异常检测、趋势预测 │
|
||||
│ ├─ HR助手: 简历筛选、面试题库、入职指引 │
|
||||
│ ├─ 代码辅助: 代码补全、审查、文档生成 │
|
||||
│ └─ 数据分析: 业务数据智能分析、可视化 │
|
||||
│ │
|
||||
│ 【预置知识库】 │
|
||||
│ ├─ 产品知识库 │
|
||||
│ ├─ 流程规范库 │
|
||||
│ ├─ 培训资料库 │
|
||||
│ └─ 行业报告库 │
|
||||
│ │
|
||||
│ 【特色功能】 │
|
||||
│ ├─ 多部门权限隔离 │
|
||||
│ ├─ 部门知识库共享 │
|
||||
│ ├─ 业务系统对接 (可选) │
|
||||
│ └─ Token配额管理 │
|
||||
│ │
|
||||
│ 【适用硬件】 主私盒 / 主私盒集群 │
|
||||
│ 【授权模式】 年度授权 + 服务费 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.3 教育行业包 (EduPack)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 教育行业包 (EduPack) │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 【应用商店】 │
|
||||
│ ├─ 教案生成: 课程目标/教学过程/作业设计 │
|
||||
│ ├─ 论文助手: 写作辅助、润色、查重 │
|
||||
│ ├─ 试题生成: 选择/填空/简答多题型组卷 │
|
||||
│ ├─ 学术翻译: 中英互译、专业术语 │
|
||||
│ ├─ 文献综述: 多篇文献智能归纳 │
|
||||
│ ├─ 学情分析: 学习数据可视化、报告生成 │
|
||||
│ └─ 学术检索: 论文查找、引用分析 │
|
||||
│ │
|
||||
│ 【预置知识库】 │
|
||||
│ ├─ 课程资料库 │
|
||||
│ ├─ 学术文献库 │
|
||||
│ ├─ 试题题库 │
|
||||
│ └─ 教学案例库 │
|
||||
│ │
|
||||
│ 【特色功能】 │
|
||||
│ ├─ 学术规范检查 │
|
||||
│ ├─ 引用格式自动规范化 │
|
||||
│ ├─ 版权检测 (文字重复率) │
|
||||
│ └─ 学生隐私保护模式 │
|
||||
│ │
|
||||
│ 【适用硬件】 主私盒 / 轻私盒(教师个人) │
|
||||
│ 【授权模式】 年度授权 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、产品矩阵 (SKU Design)
|
||||
|
||||
### 6.1 SKU总表
|
||||
|
||||
| SKU | 硬件 | 软件版本 | 行业包 | 目标客户 | 定价参考 |
|
||||
|-----|------|---------|--------|---------|---------|
|
||||
| **AIStation-Personal** | 轻私盒 | 通用底座(单租户) | 基础技能包 | 领导干部、专家 | ¥11,000 |
|
||||
| **AIStation-Standard** | 主私盒 | 通用底座(多租户) | 标准技能包 | 中小企业、事业单位 | ¥36,000 |
|
||||
| **AIStation-Government** | 主私盒 | 政务版底座 | GovPack政务包 | 党政机关 | ¥48,000 |
|
||||
| **AIStation-Enterprise** | 主私盒 | 企业版底座 | EntPack企业包 | 国企、金融、涉密 | ¥55,000 |
|
||||
| **AIStation-Education** | 主私盒 | 教育版底座 | EduPack教育包 | 高校、研究机构 | ¥40,000 |
|
||||
| **AIStation-Custom** | 主私盒集群 | 定制版底座 | CustomPack | 超大型组织 | 项目制 |
|
||||
|
||||
### 6.2 软件配置对照表
|
||||
|
||||
| 软件能力 | Personal | Standard | Government | Enterprise | Education |
|
||||
|---------|----------|----------|-----------|-----------|-----------|
|
||||
| **多用户支持** | ❌ 单用户 | ✅ 多用户 | ✅ 多用户+部门 | ✅ 多用户+部门 | ✅ 多用户 |
|
||||
| **RBAC权限** | ❌ | ✅ | ✅ | ✅ | ✅ |
|
||||
| **审计日志** | ❌ | ✅ | ✅+等保 | ✅+合规 | ✅ |
|
||||
| **主题定制** | ❌ | ✅ | ✅政务蓝 | ✅企业蓝 | ✅学术蓝 |
|
||||
| **行业应用** | 基础包 | 标准包 | 政务包 | 企业包 | 教育包 |
|
||||
| **知识库** | 个人级 | 部门级 | 部门+法规 | 部门+产品 | 课程+文献 |
|
||||
| **API开放** | ❌ | 预留 | ✅ | ✅ | 预留 |
|
||||
| **年度服务** | 1,000 | 3,000 | 8,000 | 10,000 | 5,000 |
|
||||
|
||||
---
|
||||
|
||||
## 七、数据流与集成
|
||||
|
||||
### 7.1 端到端数据流
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────┐
|
||||
│ 端到端数据流 │
|
||||
├──────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 用户输入 (浏览器) │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────┐ │
|
||||
│ │ Web 前端 (Vue) │ │
|
||||
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
||||
│ │ │ 对话UI │ │ 应用UI │ │ 管理UI │ │ │
|
||||
│ │ └────┬────┘ └────┬────┘ └────┬────┘ │ │
|
||||
│ └────────┼────────────┼────────────┼────────────────────┘ │
|
||||
│ │ │ │ │
|
||||
│ └────────────┴────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────┐ │
|
||||
│ │ 通用AI工作台底座 (Rust Backend) │ │
|
||||
│ │ │ │
|
||||
│ │ ┌─────────────────────────────────────────────────┐ │ │
|
||||
│ │ │ 租户路由层 │ │ │
|
||||
│ │ │ 用户认证 → 租户隔离 → 权限校验 │ │ │
|
||||
│ │ └─────────────────────────────────────────────────┘ │ │
|
||||
│ │ │ │ │
|
||||
│ │ ┌─────────────┼─────────────┐ │ │
|
||||
│ │ ▼ ▼ ▼ │ │
|
||||
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
|
||||
│ │ │ Agent │ │ Skills │ │ RAG │ │ │
|
||||
│ │ │ Engine │ │ System │ │ Engine │ │ │
|
||||
│ │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │
|
||||
│ │ │ │ │ │ │
|
||||
│ │ └─────────────┴─────────────┘ │ │
|
||||
│ │ │ │ │
|
||||
│ └─────────────────────────┼───────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────┐ │
|
||||
│ │ PrivBox HAL 适配层 │ │
|
||||
│ │ │ │
|
||||
│ │ ┌─────────────────────────────────────────────────┐ │ │
|
||||
│ │ │ 模型服务层 (本地推理) │ │ │
|
||||
│ │ │ │ │ │
|
||||
│ │ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │
|
||||
│ │ │ │ 主模型API │ │ 向量检索 │ │ ASR服务 │ │ │ │
|
||||
│ │ │ │ (LLM) │ │ (Vector) │ │ (语音) │ │ │ │
|
||||
│ │ │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │ │
|
||||
│ │ │ │ │ │ │ │ │
|
||||
│ │ │ └─────────────┴─────────────┘ │ │ │
|
||||
│ │ │ │ │ │ │
|
||||
│ │ └───────────────────────┼───────────────────────┘ │ │
|
||||
│ │ ▼ │ │
|
||||
│ │ ┌─────────────────────────────────────────────────┐ │ │
|
||||
│ │ │ NPU 推理引擎 (国产NPU) │ │ │
|
||||
│ │ └─────────────────────────────────────────────────┘ │ │
|
||||
│ │ │ │
|
||||
│ └─────────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────────┐ │
|
||||
│ │ 本地数据存储 │ │
|
||||
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
|
||||
│ │ │ SQLite │ │ 向量存储 │ │ 文件存储 │ │ │
|
||||
│ │ │ (结构化) │ │ (向量) │ │ (文档) │ │ │
|
||||
│ │ └───────────┘ └───────────┘ └───────────┘ │ │
|
||||
│ └─────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└──────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 7.2 关键集成点
|
||||
|
||||
| 集成点 | 说明 | 技术方案 |
|
||||
|--------|------|---------|
|
||||
| **前端→后端** | Web UI与Rust Backend通信 | WebSocket + REST API |
|
||||
| **后端→模型** | Agent调用LLM推理 | HTTP/gRPC 本地调用 |
|
||||
| **后端→向量库** | RAG检索 | SQLite-vss / 内置向量 |
|
||||
| **后端→存储** | 文档/文件存储 | 本地文件系统 |
|
||||
| **底座→HAL** | 软件调用硬件能力 | FFI / IPC |
|
||||
|
||||
---
|
||||
|
||||
## 八、交付与部署
|
||||
|
||||
### 8.1 标准化交付流程
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 标准化交付流程 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 阶段1: 需求确认 (1-3天) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ • 客户场景调研 │ │
|
||||
│ │ • 行业包选择 │ │
|
||||
│ │ • 数据迁移需求评估 │ │
|
||||
│ │ • 输出: 需求确认单 + 交付清单 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 阶段2: 工厂预配置 (3-5天) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ • 硬件检测与烧录 │ │
|
||||
│ │ • 软件镜像预装 (底座+行业包) │ │
|
||||
│ │ • 品牌定制配置 (Logo、主题) │ │
|
||||
│ │ • 预置知识库导入 │ │
|
||||
│ │ • 输出: 预配置完成清单 + 检测报告 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 阶段3: 现场交付 (1-2天) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ • 设备部署上架 │ │
|
||||
│ │ • 网络配置与联调 │ │
|
||||
│ │ • 管理员培训 │ │
|
||||
│ │ • 初始化数据导入 │ │
|
||||
│ │ • 功能验收测试 │ │
|
||||
│ │ • 输出: 交付验收单 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ 阶段4: 运维保障 (持续) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ • 远程运维支持 (可选，需客户授权) │ │
|
||||
│ │ • 定期巡检服务 (可选) │ │
|
||||
│ │ • 软件版本升级 (内网推送/USB) │ │
|
||||
│ │ • 故障响应与处理 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 8.2 部署模式
|
||||
|
||||
| 模式 | 适用场景 | 网络要求 | 运维方式 |
|
||||
|------|---------|---------|---------|
|
||||
| **单机隔离** | 涉密单位、高安全场景 | 完全离线 | 物理运维 |
|
||||
| **内网部署** | 普通政府/企业 | 内网连接 | 远程运维 |
|
||||
| **混合部署** | 多分支机构 | 内网+专线 | 分级运维 |
|
||||
|
||||
### 8.3 镜像结构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 软件镜像结构 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ PrivBox-AIStation-镜像-v1.0.0 │
|
||||
│ ├── boot/ # 系统启动文件 │
|
||||
│ ├── privbox-hal/ # 硬件抽象层 │
|
||||
│ ├── commons-platform/ # 通用AI工作台底座 │
|
||||
│ │ ├── agent-engine # Agent引擎 │
|
||||
│ │ ├── skills-system # 技能系统 │
|
||||
│ │ ├── rag-engine # RAG引擎 │
|
||||
│ │ ├── tenant-config # 多租户配置 │
|
||||
│ │ └── theme-engine # 主题引擎 │
|
||||
│ ├── industry-pack/ # 行业应用包 (按SKU选择) │
|
||||
│ │ ├── gov-pack/ # 政务包 │
|
||||
│ │ ├── ent-pack/ # 企业包 │
|
||||
│ │ └── edu-pack/ # 教育包 │
|
||||
│ ├── models/ # 预装模型 │
|
||||
│ │ ├── llm/ # 主模型 (7B/14B) │
|
||||
│ │ ├── embedding/ # 向量模型 │
|
||||
│ │ └── asr/ # ASR模型 │
|
||||
│ └── data/ # 数据目录 (运行时) │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 九、演进路线
|
||||
|
||||
### 9.1 整体演进时间线
|
||||
|
||||
```
|
||||
2026 Q3 2026 Q4 2027 Q1 2027 Q4
|
||||
│ │ │ │
|
||||
▼ ▼ ▼ ▼
|
||||
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||||
│ v1.0 │ │ v2.0 │ │ v3.0 │ │ v4.0 │
|
||||
│ MVP发布 │ │ 规模化 │ │ 生态化 │ │ 智能化 │
|
||||
└─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||||
│ │ │ │
|
||||
• PrivBox适配 • 政务包v2 • 开放API • AI Agent
|
||||
• 基础底座 • 企业包v1 • 插件市场 • 知识图谱
|
||||
• 政务包v1 • 教育包v1 • 第三方集成 • 多模态
|
||||
• 试点部署 • 运维平台 • 合作伙伴 • 行业深度AI
|
||||
```
|
||||
|
||||
### 9.2 各层演进
|
||||
|
||||
#### 硬件层演进
|
||||
|
||||
| 时间 | 硬件版本 | 升级内容 |
|
||||
|------|---------|---------|
|
||||
| 2026 Q3 | 当前版本 | 轻私盒 + 主私盒 |
|
||||
| 2027 Q1 | 升级版 | 主私盒Pro (更大算力) |
|
||||
| 2027 Q2 | 集群版 | 主私盒集群控制器 |
|
||||
| 2027 Q4 | 新一代 | 新一代芯片平台 |
|
||||
|
||||
#### 底座层演进
|
||||
|
||||
| 阶段 | 版本 | 功能 |
|
||||
|------|------|------|
|
||||
| MVP | v1.0 | 多租户、主题引擎、基础Skills |
|
||||
| 扩展 | v2.0 | RBAC、审计日志、API开放 |
|
||||
| 完善 | v3.0 | 插件市场、SSO集成、MCP扩展 |
|
||||
| 智能 | v4.0 | Agent编排、知识图谱、多模态 |
|
||||
|
||||
#### 行业包演进
|
||||
|
||||
| 包类型 | v1.0 | v2.0 | v3.0 |
|
||||
|--------|------|------|------|
|
||||
| **GovPack** | 基础应用+法规库 | 工作流+审批+更多应用 | 政策分析+智能决策 |
|
||||
| **EntPack** | 基础应用+知识库 | 业务流程+系统对接 | 智能分析+预测 |
|
||||
| **EduPack** | 基础应用+文献库 | 试题库+学情分析 | 智能教研+推荐 |
|
||||
|
||||
---
|
||||
|
||||
## 十、商业模式
|
||||
|
||||
### 10.1 收入结构
|
||||
|
||||
| 收入类型 | 模式 | 说明 | 占比目标 |
|
||||
|---------|------|------|---------|
|
||||
| **硬件销售** | 一次性 | PrivBox设备销售 | 60% |
|
||||
| **软件授权** | 一次性/年度 | AI工作台软件授权 | 25% |
|
||||
| **行业包授权** | 一次性/年度 | 行业应用包授权 | 10% |
|
||||
| **服务费** | 年度 | 部署/培训/运维服务 | 5% |
|
||||
|
||||
### 10.2 定价策略
|
||||
|
||||
| SKU | 硬件成本 | 软件授权 | 年度服务 | 合计首年 |
|
||||
|-----|---------|---------|---------|---------|
|
||||
| Personal | 8,000 | 2,000 | 1,000 | **11,000** |
|
||||
| Standard | 25,000 | 8,000 | 3,000 | **36,000** |
|
||||
| Government | 25,000 | 15,000 | 8,000 | **48,000** |
|
||||
| Enterprise | 25,000 | 20,000 | 10,000 | **55,000** |
|
||||
| Education | 25,000 | 10,000 | 5,000 | **40,000** |
|
||||
|
||||
### 10.3 渠道策略
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 销售渠道 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 直销 │
|
||||
│ └─ 大客户部: 政府/国企/涉密单位 (高价值客户) │
|
||||
│ │
|
||||
│ 渠道商 │
|
||||
│ ├─ 信创集成商: 政务行业渠道 (重点) │
|
||||
│ ├─ 企业IT服务商: 企业市场渠道 │
|
||||
│ └─ 行业软件商: 垂直领域渠道 (教育、医疗) │
|
||||
│ │
|
||||
│ 生态合作 │
|
||||
│ ├─ OA厂商合作: 集成到办公系统 │
|
||||
│ ├─ 政务云合作: 纳入政务云解决方案 │
|
||||
│ ├─ 集成商合作: 作为AI算力模块输出 │
|
||||
│ └─ 渠道商合作: 区域代理 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 十一、风险与应对
|
||||
|
||||
### 11.1 技术风险
|
||||
|
||||
| 风险 | 影响 | 应对措施 |
|
||||
|------|------|---------|
|
||||
| 国产NPU框架成熟度 | 性能和稳定性 | 深度测试，建立备选模型 |
|
||||
| 多租户隔离安全 | 数据泄露风险 | Phase1重点测试，审计覆盖 |
|
||||
| 离线场景兼容性 | 用户体验问题 | 充分测试，建立问题清单 |
|
||||
|
||||
### 11.2 市场风险
|
||||
|
||||
| 风险 | 影响 | 应对措施 |
|
||||
|------|------|---------|
|
||||
| 竞品压力 | 市场占有 | 差异化定位，强调软硬一体 |
|
||||
| 客户预算周期 | 销售周期 | 分阶段交付，降低决策门槛 |
|
||||
| 政策变化 | 合规要求 | 持续跟踪，提前布局 |
|
||||
|
||||
### 11.3 运营风险
|
||||
|
||||
| 风险 | 影响 | 应对措施 |
|
||||
|------|------|---------|
|
||||
| 服务能力不足 | 客户满意度 | 建立服务网络，合作伙伴赋能 |
|
||||
| 软件版本碎片化 | 维护成本 | 标准化镜像，版本管控 |
|
||||
| 定制需求膨胀 | 项目成本 | 明确范围，建立行业包标准 |
|
||||
|
||||
---
|
||||
|
||||
## 十二、文档关联
|
||||
|
||||
| 文档 | 编号 | 说明 |
|
||||
|------|------|------|
|
||||
| **通用AI工作台底座架构演进方案** | ARCH-EVOL-001 | 软件底座的三阶段演进规划 |
|
||||
| **PrivBox软硬一体化整合方案** | ARCH-PROPOSAL-001 | 软硬整合产品化建议 |
|
||||
| **本文档** | ARCH-INTEGRATION-001 | 三者整合关系完整说明 |
|
||||
|
||||
---
|
||||
|
||||
## 十三、下一步行动
|
||||
|
||||
### 立即行动 (1-2周)
|
||||
|
||||
1. **技术可行性验证**
|
||||
- nomifun与PrivBox NPU适配测试
|
||||
- 7B/14B模型运行效果验证
|
||||
- 输出性能基准报告
|
||||
|
||||
2. **产品定义确认**
|
||||
- 确定SKU矩阵与定价
|
||||
- 确定首批行业包范围
|
||||
- 确定交付流程
|
||||
|
||||
3. **试点客户储备**
|
||||
- 筛选2-3家有意向客户
|
||||
- 了解具体需求
|
||||
|
||||
### 短期目标 (1-2月)
|
||||
|
||||
1. 完成PrivBox适配版工作台开发
|
||||
2. 完成政务行业包v1.0
|
||||
3. 完成首批试点客户部署
|
||||
|
||||
---
|
||||
|
||||
> 文档结束 — 如需进一步细化某个模块，请告知。
|
||||
@@ -0,0 +1,537 @@
|
||||
# PrivBox + 通用AI工作台 — 软硬一体化整合方案
|
||||
|
||||
> 文档类型：战略建议书
|
||||
> 版本：v1.0
|
||||
> 日期：2026-07-03
|
||||
|
||||
---
|
||||
|
||||
## 一、整合价值分析
|
||||
|
||||
### 1.1 优势互补
|
||||
|
||||
| 维度 | PrivBox硬件 | 通用AI工作台底座 | 整合效果 |
|
||||
|------|------------|-----------------|---------|
|
||||
| **算力** | 100-400 TOPS国产NPU | 需要算力承载 | 提供完整算力解决方案 |
|
||||
| **数据安全** | 物理隔离、数据不出盒 | 本地优先架构 | 双重安全背书 |
|
||||
| **软件能力** | 通用工作台 | Agent+Skills+RAG | 垂直领域深度适配 |
|
||||
| **交付形态** | 硬件盒子 | 软件license | 软硬件一体化产品 |
|
||||
| **信创合规** | 全栈国产 | 国产框架兼容 | 满足信创要求 |
|
||||
|
||||
### 1.2 目标客户痛点
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 目标客户核心痛点 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 1. 数据安全焦虑 │
|
||||
│ ├─ 涉密数据不敢上云 │
|
||||
│ ├─ 公有AI存在数据泄露风险 │
|
||||
│ └─ 监管要求数据本地化存储 │
|
||||
│ │
|
||||
│ 2. 合规压力 │
|
||||
│ ├─ 等保2.0/分级保护认证要求 │
|
||||
│ ├─ 信创替代政策 │
|
||||
│ └─ 数据出境合规 │
|
||||
│ │
|
||||
│ 3. 使用成本 │
|
||||
│ ├─ 公有云AI按token计费，长期成本高 │
|
||||
│ ├─ 多人使用需要多个账号 │
|
||||
│ └─ 缺乏一次性买断方案 │
|
||||
│ │
|
||||
│ 4. 场景适配 │
|
||||
│ ├─ 通用AI工具缺乏垂直场景 │
|
||||
│ ├─ 公文写作、政策解读需要专业能力 │
|
||||
│ └─ 知识库需要预置行业数据 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 1.3 整合核心价值
|
||||
|
||||
**一句话定位**：
|
||||
> "开箱即用的私有化AI工作站 — 数据不出门，能力在身边"
|
||||
|
||||
**差异化卖点**：
|
||||
1. **硬件+软件+算法** 三位一体交付
|
||||
2. **全栈国产化** 满足信创要求
|
||||
3. **零运维** 开机即用
|
||||
4. **可演进** 软件持续升级
|
||||
|
||||
---
|
||||
|
||||
## 二、产品矩阵设计
|
||||
|
||||
### 2.1 产品层级
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 产品矩阵 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ PrivBox AIStation Pro │ │
|
||||
│ │ 主私盒 + 行业版AI工作台 + 行业包 │ │
|
||||
│ │ 目标：政府/国企/大型企业部门 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ PrivBox AIStation Standard │ │
|
||||
│ │ 主私盒 + 通用AI工作台 + 标准技能包 │ │
|
||||
│ │ 目标：中小企业、事业单位 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ PrivBox AIStation Personal │ │
|
||||
│ │ 轻私盒 + 个人AI工作台 + 基础技能包 │ │
|
||||
│ │ 目标：领导/专家/涉密岗位个人 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 2.2 SKU设计
|
||||
|
||||
| SKU | 硬件 | 软件 | 定价策略 | 目标客户 |
|
||||
|-----|------|------|---------|---------|
|
||||
| **AIStation-Personal** | 轻私盒 | 个人工作台 + 基础技能包 | 硬件成本+软件授权 | 领导干部、专家 |
|
||||
| **AIStation-Standard** | 主私盒 | 通用工作台 + 标准技能包 | 硬件成本+软件授权 | 中小企业、事业单位 |
|
||||
| **AIStation-Government** | 主私盒 | 政务版工作台 + 政府技能包 | 硬件成本+软件授权+服务费 | 党政机关 |
|
||||
| **AIStation-Enterprise** | 主私盒 | 企业版工作台 + 行业技能包 | 硬件成本+软件授权+服务费 | 国企、金融、涉密单位 |
|
||||
| **AIStation-Custom** | 主私盒集群 | 定制工作台 + 深度行业包 | 项目制 | 超大型组织 |
|
||||
|
||||
---
|
||||
|
||||
## 三、软件架构适配
|
||||
|
||||
### 3.1 适配PrivBox硬件规格
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 软件配置与硬件规格匹配 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 轻私盒 (100 TOPS / 32+16 GB) │
|
||||
│ ├─ 主模型: Qwen2.5-7B-Instruct (INT8) │
|
||||
│ ├─ 向量模型: bge-small-zh (INT8) │
|
||||
│ ├─ ASR模型: SenseVoice (INT8) │
|
||||
│ ├─ 并发用户: 1人 │
|
||||
│ └─ 典型应用: 对话、写作、摘要、语音输入 │
|
||||
│ │
|
||||
│ 主私盒 (400 TOPS / 128+64 GB) │
|
||||
│ ├─ 主模型: Qwen2.5-14B-Instruct (INT8) │
|
||||
│ ├─ 向量模型: bge-base-zh (INT8) │
|
||||
│ ├─ ASR模型: SenseVoice (INT8) │
|
||||
│ ├─ 并发用户: 5-20人 │
|
||||
│ └─ 典型应用: 全模块 + 知识库 + 会议转写 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 3.2 软件分层架构
|
||||
|
||||
```rust
|
||||
// PrivBox适配层
|
||||
mod privbox {
|
||||
// 硬件抽象层
|
||||
mod hardware {
|
||||
// NPU调度
|
||||
// 内存管理
|
||||
// 存储管理
|
||||
// 散热策略
|
||||
}
|
||||
|
||||
// 推理引擎适配
|
||||
mod inference {
|
||||
// 国产NPU推理框架
|
||||
// 模型加载与切换
|
||||
// 并发调度
|
||||
}
|
||||
|
||||
// 离线更新机制
|
||||
mod update {
|
||||
// USB批量更新
|
||||
// 内网增量推送
|
||||
// 回滚机制
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 3.3 离线优先架构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 离线优先架构 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 用户请求 ──▶ 租户路由 ──▶ 本地推理 ──▶ 结果返回 │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ 模型服务层 │ │
|
||||
│ │ (本地运行) │ │
|
||||
│ └─────────────────┘ │
|
||||
│ │ │
|
||||
│ ┌──────────────┼──────────────┐ │
|
||||
│ ▼ ▼ ▼ │
|
||||
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
|
||||
│ │ 主模型API │ │ 向量检索 │ │ ASR服务 │ │
|
||||
│ └───────────┘ └───────────┘ └───────────┘ │
|
||||
│ │
|
||||
│ 可选扩展 (需联网): │
|
||||
│ ├─ 云端模型补强 (非涉密数据) │
|
||||
│ ├─ 远程运维管理 │
|
||||
│ └─ 增量模型更新 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、行业应用包设计
|
||||
|
||||
### 4.1 政务行业包 (Government Pack)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 政务行业包 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 预装应用 │
|
||||
│ ├─ 公文写作: 通知/请示/报告/函等15种法定公文 │
|
||||
│ ├─ 政策解读: 政策文件智能分析、要点提取 │
|
||||
│ ├─ 法规检索: 常用法规自然语言检索 │
|
||||
│ ├─ 会议纪要: 语音转写+结构化纪要生成 │
|
||||
│ ├─ 信访答复: 信访件智能分类+答复草稿 │
|
||||
│ └─ 敏感词检测: 对外文稿自动审查 │
|
||||
│ │
|
||||
│ 预置知识库 │
|
||||
│ ├─ 法规政策库 (国家级/省级/市级) │
|
||||
│ ├─ 公文格式库 (党政/行政/人大/政协) │
|
||||
│ ├─ 常用语料库 (领导讲话、致辞) │
|
||||
│ └─ 业务术语库 (各部委办局专业术语) │
|
||||
│ │
|
||||
│ 特色功能 │
|
||||
│ ├─ 等保2.0合规模式 │
|
||||
│ ├─ 操作审计日志 (不可篡改) │
|
||||
│ ├─ 涉密文件处理流程 │
|
||||
│ └─ 多级审批工作流 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 4.2 企业行业包 (Enterprise Pack)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 企业行业包 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 预装应用 │
|
||||
│ ├─ 合同审查: 条款风险识别、不利条款标注 │
|
||||
│ ├─ 报告生成: 工作报告/分析报告自动撰写 │
|
||||
│ ├─ 销售助手: 客户画像、话术推荐、竞品分析 │
|
||||
│ ├─ 财务分析: 报表解读、异常检测、趋势预测 │
|
||||
│ ├─ HR助手: 简历筛选、面试题库、入职指引 │
|
||||
│ └─ 代码辅助: 代码补全、审查、文档生成 │
|
||||
│ │
|
||||
│ 预置知识库 │
|
||||
│ ├─ 产品知识库 │
|
||||
│ ├─ 流程规范库 │
|
||||
│ ├─ 培训资料库 │
|
||||
│ └─ 行业报告库 │
|
||||
│ │
|
||||
│ 特色功能 │
|
||||
│ ├─ 多部门权限隔离 │
|
||||
│ ├─ 部门知识库共享 │
|
||||
│ ├─ 业务系统对接 (可选) │
|
||||
│ └─ Token配额管理 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 4.3 教育行业包 (Education Pack)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 教育行业包 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 预装应用 │
|
||||
│ ├─ 教案生成: 课程目标/教学过程/作业设计 │
|
||||
│ ├─ 论文助手: 写作辅助、润色、查重 │
|
||||
│ ├─ 试题生成: 选择/填空/简答多题型组卷 │
|
||||
│ ├─ 学术翻译: 中英互译、专业术语 │
|
||||
│ ├─ 文献综述: 多篇文献智能归纳 │
|
||||
│ └─ 学情分析: 学习数据可视化、报告生成 │
|
||||
│ │
|
||||
│ 预置知识库 │
|
||||
│ ├─ 课程资料库 │
|
||||
│ ├─ 学术文献库 │
|
||||
│ ├─ 试题题库 │
|
||||
│ └─ 教学案例库 │
|
||||
│ │
|
||||
│ 特色功能 │
|
||||
│ ├─ 学术规范检查 │
|
||||
│ ├─ 引用格式自动规范化 │
|
||||
│ ├─ 版权检测 (文字重复率) │
|
||||
│ └─ 学生隐私保护模式 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、交付与部署方案
|
||||
|
||||
### 5.1 标准化交付流程
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 交付流程 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 1. 需求确认 (1-3天) │
|
||||
│ ├─ 客户场景调研 │
|
||||
│ ├─ 行业包选择 │
|
||||
│ ├─ 数据迁移需求 │
|
||||
│ └─ 输出: 交付清单 │
|
||||
│ │
|
||||
│ 2. 工厂预配置 (3-5天) │
|
||||
│ ├─ 硬件检测与烧录 │
|
||||
│ ├─ 软件镜像预装 │
|
||||
│ ├─ 行业包定制配置 │
|
||||
│ └─ 输出: 预配置完成清单 │
|
||||
│ │
|
||||
│ 3. 现场交付 (1-2天) │
|
||||
│ ├─ 设备部署上架 │
|
||||
│ ├─ 网络配置与联调 │
|
||||
│ ├─ 初始化数据导入 │
|
||||
│ ├─ 管理员培训 │
|
||||
│ └─ 输出: 交付验收单 │
|
||||
│ │
|
||||
│ 4. 运维保障 │
|
||||
│ ├─ 远程运维支持 (可选) │
|
||||
│ ├─ 定期巡检服务 (可选) │
|
||||
│ └─ 软件版本升级 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.2 部署模式
|
||||
|
||||
| 部署模式 | 适用场景 | 网络要求 | 运维模式 |
|
||||
|---------|---------|---------|---------|
|
||||
| **单机隔离** | 涉密单位、高安全场景 | 完全离线 | 物理运维 |
|
||||
| **内网部署** | 普通政府/企业 | 内网连接 | 远程运维 |
|
||||
| **混合部署** | 多分支机构 | 内网+专线 | 分级运维 |
|
||||
|
||||
### 5.3 运维体系
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 运维体系 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 监控体系 │
|
||||
│ ├─ 硬件状态监控 (温度/负载/存储) │
|
||||
│ ├─ 模型服务监控 (请求量/延迟/错误率) │
|
||||
│ ├─ 用户行为监控 (活跃度/使用排行) │
|
||||
│ └─ 安全事件监控 (异常登录/越权访问) │
|
||||
│ │
|
||||
│ 升级机制 │
|
||||
│ ├─ 离线升级: USB批量推送 │
|
||||
│ ├─ 内网升级: 增量差分更新 │
|
||||
│ └─ 热更新: 无感知的模型切换 │
|
||||
│ │
|
||||
│ 故障处理 │
|
||||
│ ├─ 本地日志导出 │
|
||||
│ ├─ 远程诊断 (可选，需客户授权) │
|
||||
│ └─ 备机置换 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、商业模式建议
|
||||
|
||||
### 6.1 定价策略
|
||||
|
||||
| 收入类型 | 模式 | 说明 |
|
||||
|---------|------|------|
|
||||
| **硬件销售** | 一次性 | PrivBox设备销售 |
|
||||
| **软件授权** | 一次性/年度 | AI工作台软件授权 |
|
||||
| **行业包授权** | 一次性/年度 | 行业应用包授权 |
|
||||
| **服务费** | 年度 | 部署/培训/运维服务 |
|
||||
| **升级费** | 按需 | 大版本升级 |
|
||||
|
||||
**建议定价区间** (参考)：
|
||||
|
||||
| SKU | 硬件成本 | 软件授权 | 年度服务 | 合计首年 |
|
||||
|-----|---------|---------|---------|---------|
|
||||
| Personal | 8,000 | 2,000 | 1,000 | 11,000 |
|
||||
| Standard | 25,000 | 8,000 | 3,000 | 36,000 |
|
||||
| Government | 25,000 | 15,000 | 8,000 | 48,000 |
|
||||
| Enterprise | 25,000 | 20,000 | 10,000 | 55,000 |
|
||||
|
||||
### 6.2 渠道策略
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 销售渠道 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 直销 │
|
||||
│ └─ 大客户部: 政府/国企/涉密单位 │
|
||||
│ │
|
||||
│ 渠道商 │
|
||||
│ ├─ 信创集成商: 政务行业渠道 │
|
||||
│ ├─ 企业IT服务商: 企业市场渠道 │
|
||||
│ └─ 行业软件商: 垂直领域渠道 │
|
||||
│ │
|
||||
│ 生态合作 │
|
||||
│ ├─ OA厂商合作: 集成到办公系统 │
|
||||
│ ├─ 政务云合作: 纳入政务云解决方案 │
|
||||
│ └─ 集成商合作: 作为AI算力模块 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、风险与挑战
|
||||
|
||||
### 7.1 技术风险
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 国产NPU推理框架成熟度 | 性能和稳定性 | 深度测试，建立备选方案 |
|
||||
| 模型与硬件适配 | 运行效率 | 针对性优化，建立性能基准 |
|
||||
| 离线场景兼容性问题 | 用户体验 | 充分测试，建立问题清单 |
|
||||
|
||||
### 7.2 市场风险
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 竞品压力 | 市场占有 | 差异化定位，强调软硬一体 |
|
||||
| 客户预算周期 | 销售周期 | 分阶段交付，降低决策门槛 |
|
||||
| 政策变化 | 合规要求 | 持续跟踪，提前布局 |
|
||||
|
||||
### 7.3 运营风险
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 服务能力不足 | 客户满意度 | 建立服务网络，合作伙伴赋能 |
|
||||
| 软件版本碎片化 | 维护成本 | 标准化镜像，版本管控 |
|
||||
| 定制需求膨胀 | 项目成本 | 明确范围，建立行业包标准 |
|
||||
|
||||
---
|
||||
|
||||
## 八、实施路线图
|
||||
|
||||
### 8.1 Phase 1: 产品化 (Q3 2026)
|
||||
|
||||
```
|
||||
目标: 完成PrivBox + 通用工作台的产品化
|
||||
|
||||
里程碑:
|
||||
├─ M1: 适配层开发完成 (nomifun → PrivBox)
|
||||
├─ M2: 基础工作台功能验证
|
||||
├─ M3: 首批行业包 (政务) 开发
|
||||
└─ M4: 试点客户部署 (2-3家)
|
||||
|
||||
产出:
|
||||
├─ PrivBox-AIStation 软件镜像
|
||||
├─ 政务行业包 v1.0
|
||||
└─ 部署文档与培训材料
|
||||
```
|
||||
|
||||
### 8.2 Phase 2: 规模化 (Q4 2026)
|
||||
|
||||
```
|
||||
目标: 建立销售与服务体系
|
||||
|
||||
里程碑:
|
||||
├─ M1: 签约5-10家渠道商
|
||||
├─ M2: 企业/教育行业包发布
|
||||
├─ M3: 建立远程运维平台
|
||||
└─ M4: 完成50+客户部署
|
||||
|
||||
产出:
|
||||
├─ 企业行业包 v1.0
|
||||
├─ 教育行业包 v1.0
|
||||
└─ 运维平台 v1.0
|
||||
```
|
||||
|
||||
### 8.3 Phase 3: 生态化 (2027)
|
||||
|
||||
```
|
||||
目标: 建立开放生态
|
||||
|
||||
里程碑:
|
||||
├─ M1: 开放API发布
|
||||
├─ M2: 第三方应用市场
|
||||
├─ M3: 合作伙伴计划
|
||||
└─ M4: 行业解决方案认证
|
||||
|
||||
产出:
|
||||
├─ 开放平台 v1.0
|
||||
├─ 应用市场
|
||||
└─ 合作伙伴体系
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 九、关键成功因素
|
||||
|
||||
### 9.1 产品层面
|
||||
|
||||
- **开箱即用**: 用户拿到设备后30分钟内能用上AI能力
|
||||
- **稳定可靠**: 7×24小时稳定运行，故障率<1%
|
||||
- **持续演进**: 软件持续更新，模型持续优化
|
||||
|
||||
### 9.2 商务层面
|
||||
|
||||
- **信任建立**: 充分的案例背书，安全认证
|
||||
- **服务保障**: 快速响应，专业支持
|
||||
- **价值可视化**: 让客户看到AI带来的效率提升
|
||||
|
||||
### 9.3 生态层面
|
||||
|
||||
- **合作伙伴**: 建立覆盖主要区域的销售服务网络
|
||||
- **行业深耕**: 针对重点行业打造标杆案例
|
||||
- **标准输出**: 参与行业标准制定，建立话语权
|
||||
|
||||
---
|
||||
|
||||
## 十、下一步行动建议
|
||||
|
||||
### 立即行动 (1-2周)
|
||||
|
||||
1. **技术可行性验证**
|
||||
- 完成nomifun与PrivBox NPU的适配测试
|
||||
- 验证7B/14B模型在PrivBox上的运行效果
|
||||
- 输出性能基准报告
|
||||
|
||||
2. **产品定义确认**
|
||||
- 确定产品矩阵与SKU定义
|
||||
- 确定首批行业包范围
|
||||
- 确定定价策略
|
||||
|
||||
3. **试点客户储备**
|
||||
- 筛选2-3家有意向的试点客户
|
||||
- 了解具体需求和使用场景
|
||||
|
||||
### 短期目标 (1-2月)
|
||||
|
||||
1. 完成PrivBox适配版工作台开发
|
||||
2. 完成政务行业包v1.0
|
||||
3. 完成首批试点客户部署
|
||||
|
||||
---
|
||||
|
||||
> 文档结束 — 如需进一步细化某个模块或开始执行，请告知。
|
||||
Reference in New Issue
Block a user