From 4158773849e3e2ae9aa8fae4f37bb2a5fe8c33c5 Mon Sep 17 00:00:00 2001 From: wizardchen Date: Fri, 30 Jan 2026 16:28:01 +0800 Subject: [PATCH] feat: add organization management features - Introduced a new API for organization management, including creation, updating, and deletion of organizations. - Implemented organization sharing functionality for knowledge bases, allowing users to share knowledge bases with specific organizations and set permissions. - Added UI components for organization selection and sharing dialogs. - Enhanced existing components to support organization-related features, including shared knowledge base handling and organization role management. This update enhances collaboration capabilities within the application by allowing users to manage and share knowledge bases across different organizations. --- docs/工作空间说明.md | 241 ++ frontend/src/api/knowledge-base/index.ts | 6 +- frontend/src/api/organization/index.ts | 491 ++++ .../src/assets/img/organization-green.svg | 3 + frontend/src/assets/img/organization.svg | 3 + frontend/src/components/AgentSelector.vue | 97 +- frontend/src/components/Input-field.vue | 148 +- frontend/src/components/MentionSelector.vue | 34 +- .../components/ShareKnowledgeBaseDialog.vue | 394 +++ frontend/src/components/SpaceAvatar.vue | 136 + frontend/src/components/menu.vue | 919 +------ frontend/src/i18n/locales/en-US.ts | 305 ++- frontend/src/i18n/locales/zh-CN.ts | 296 +++ frontend/src/router/index.ts | 19 + frontend/src/stores/menu.ts | 9 +- frontend/src/stores/organization.ts | 435 ++++ frontend/src/views/agent/AgentList.vue | 89 + frontend/src/views/chat/index.vue | 19 +- .../src/views/knowledge/KnowledgeBase.vue | 318 ++- .../knowledge/KnowledgeBaseEditorModal.vue | 10 + .../src/views/knowledge/KnowledgeBaseList.vue | 1124 ++++++++- .../knowledge/components/FAQEntryManager.vue | 445 +++- .../knowledge/settings/KBShareSettings.vue | 550 ++++ .../views/organization/JoinOrganization.vue | 118 + .../organization/OrganizationEditorModal.vue | 900 +++++++ .../views/organization/OrganizationList.vue | 1709 +++++++++++++ .../OrganizationSettingsModal.vue | 2204 +++++++++++++++++ internal/agent/tools/data_analysis.go | 3 +- internal/agent/tools/data_schema.go | 4 +- internal/agent/tools/get_document_info.go | 26 +- internal/agent/tools/grep_chunks.go | 94 +- internal/agent/tools/knowledge_search.go | 38 +- internal/agent/tools/list_knowledge_chunks.go | 33 +- internal/application/repository/chunk.go | 24 + internal/application/repository/kbshare.go | 187 ++ internal/application/repository/knowledge.go | 117 + .../application/repository/organization.go | 285 +++ internal/application/repository/user.go | 22 + internal/application/service/agent_service.go | 8 +- internal/application/service/chunk.go | 13 + internal/application/service/kbshare.go | 379 +++ internal/application/service/knowledge.go | 133 +- internal/application/service/knowledgebase.go | 188 +- internal/application/service/model.go | 56 + internal/application/service/organization.go | 587 +++++ internal/application/service/session.go | 101 +- internal/application/service/tag.go | 30 +- internal/application/service/user.go | 8 + internal/common/tools.go | 3 + internal/container/container.go | 5 + internal/handler/chunk.go | 158 +- internal/handler/knowledge.go | 354 ++- internal/handler/knowledgebase.go | 106 +- internal/handler/organization.go | 1196 +++++++++ internal/handler/session/qa.go | 46 +- internal/handler/tag.go | 109 +- internal/logger/logger.go | 2 + internal/middleware/auth.go | 10 +- internal/router/router.go | 64 + internal/types/const.go | 2 + internal/types/interfaces/chunk.go | 8 +- internal/types/interfaces/knowledge.go | 10 +- internal/types/interfaces/knowledgebase.go | 10 + internal/types/interfaces/model.go | 2 + internal/types/interfaces/organization.go | 125 + internal/types/interfaces/user.go | 4 + internal/types/knowledge.go | 6 + internal/types/knowledgebase.go | 2 + internal/types/organization.go | 373 +++ internal/types/search.go | 35 + .../versioned/000011_organizations.down.sql | 9 + .../versioned/000011_organizations.up.sql | 107 + 72 files changed, 14685 insertions(+), 1419 deletions(-) create mode 100644 docs/工作空间说明.md create mode 100644 frontend/src/api/organization/index.ts create mode 100644 frontend/src/assets/img/organization-green.svg create mode 100644 frontend/src/assets/img/organization.svg create mode 100644 frontend/src/components/ShareKnowledgeBaseDialog.vue create mode 100644 frontend/src/components/SpaceAvatar.vue create mode 100644 frontend/src/stores/organization.ts create mode 100644 frontend/src/views/knowledge/settings/KBShareSettings.vue create mode 100644 frontend/src/views/organization/JoinOrganization.vue create mode 100644 frontend/src/views/organization/OrganizationEditorModal.vue create mode 100644 frontend/src/views/organization/OrganizationList.vue create mode 100644 frontend/src/views/organization/OrganizationSettingsModal.vue create mode 100644 internal/application/repository/kbshare.go create mode 100644 internal/application/repository/organization.go create mode 100644 internal/application/service/kbshare.go create mode 100644 internal/application/service/organization.go create mode 100644 internal/handler/organization.go create mode 100644 internal/types/interfaces/organization.go create mode 100644 internal/types/organization.go create mode 100644 migrations/versioned/000011_organizations.down.sql create mode 100644 migrations/versioned/000011_organizations.up.sql diff --git a/docs/工作空间说明.md b/docs/工作空间说明.md new file mode 100644 index 00000000..6677de59 --- /dev/null +++ b/docs/工作空间说明.md @@ -0,0 +1,241 @@ +# 工作空间(共享空间)说明文档 + +本文档说明 WeKnora 中的**工作空间**(产品中又称「共享空间」)功能,包括空间创建与加入、成员角色与权限、知识库共享规则,以及用户对知识库的最终访问权限计算方式。 + +--- + +## 一、工作空间概述 + +### 1.1 什么是工作空间 + +工作空间(Organization)是跨租户协作的载体。用户可以在同一系统内属于不同租户(账户),通过**加入同一工作空间**,实现: + +- 共享知识库:将本租户的知识库共享到空间,供空间内其他成员使用; +- 访问他人共享的知识库:在「知识库列表」中看到并打开通过空间共享给自己的知识库; +- 在对话、智能体等场景中选择并使用这些共享知识库。 + +数据与权限关系简要如下: + +- **租户**:知识库的归属单位,每个知识库属于一个租户; +- **工作空间**:不拥有知识库,只记录「某知识库被共享到某空间」以及「共享时的权限」; +- **成员**:用户通过邀请码或管理员邀请加入空间,在空间内拥有一个角色(管理员 / 编辑者 / 只读)。 + +### 1.2 核心概念对照 + +| 概念 | 说明 | +|------|------| +| 工作空间 / 共享空间 | 同一产品中的「组织」(Organization),用于跨租户共享知识库 | +| 空间创建者 | 创建该空间的用户,自动成为该空间的管理员,且不可被移除或降级 | +| 空间成员 | 通过邀请码加入或由管理员邀请加入的用户,拥有管理员、编辑者或只读之一角色 | +| 知识库归属 | 知识库始终属于一个租户;共享到空间不改变归属,只建立「空间 ↔ 知识库」的共享关系 | +| 共享关系 | 一条记录表示:某知识库以某种权限(只读/可写)被共享到某工作空间 | + +--- + +## 二、工作空间的创建、加入与离开 + +### 2.1 创建空间 + +- 任意已登录用户均可创建空间。 +- 创建时需填写空间名称;描述、头像、邀请码有效期等为可选项。 +- 创建者自动成为该空间的**管理员**,且: + - 不能将自己移出空间; + - 不能将自己的角色改为编辑者或只读。 + +### 2.2 加入空间 + +加入方式有两种: + +1. **邀请码直接加入** + - 若空间未开启「加入需审批」,用户输入有效邀请码即可加入。 + - 加入后默认角色为**只读**。 +2. **提交加入申请(需审批)** + - 若空间开启了「加入需审批」,用户输入邀请码后提交加入申请。 + - 空间管理员审批通过时可指定角色(管理员/编辑者/只读);若不指定,则使用申请时填写的角色或默认只读。 + - 审批拒绝后,用户不是成员,无法访问该空间及其共享知识库。 + +### 2.3 邀请码 + +- 仅空间**管理员**可生成或刷新邀请码。 +- 邀请码可设置有效期(例如 1 天、7 天、30 天或永不过期);过期后需重新生成才能使用。 +- 同一时间一个空间仅有一个有效邀请码;重新生成会使旧邀请码失效。 + +### 2.4 离开空间 + +- 成员可主动退出空间(无需管理员同意)。 +- 管理员可移除其他成员(不能移除空间创建者)。 +- 退出或移除后,该用户不再拥有该空间内的任何角色,也无法再通过该空间访问其共享的知识库。 + +### 2.5 删除空间 + +- 仅空间**创建者**可删除空间。 +- 删除空间时会解除该空间下所有知识库的共享关系,成员将无法再通过该空间访问这些知识库。 + +--- + +## 三、空间内角色与权限 + +工作空间内共有三种角色,权限从高到低为:**管理员 > 编辑者 > 只读**。 + +### 3.1 角色定义 + +| 角色 | 英文标识 | 说明 | +|------|----------|------| +| 管理员 | admin | 空间设置、成员、邀请码及知识库共享的全面管理 | +| 编辑者 | editor | 可编辑空间内共享的知识库内容,可将自己的知识库共享到空间;不可管理空间设置与成员 | +| 只读 | viewer | 仅可查看与检索空间内共享的知识库;不可共享知识库到空间,不可管理空间 | + +### 3.2 权限矩阵(空间内能力) + +| 能力 | 管理员 | 编辑者 | 只读 | +|------|--------|--------|------| +| 查看、检索空间内共享的知识库 | ✓ | ✓ | ✓ | +| 编辑空间内共享的知识库内容 | ✓ | ✓ | ✗ | +| **将知识库共享到本空间** | ✓ | ✓ | ✗ | +| 管理空间内知识库共享(取消共享、修改共享权限等) | ✓(见下) | 仅限自己发起的共享 | ✗ | +| 管理空间设置(名称、描述、头像、邀请码有效期、是否需审批等) | ✓ | ✗ | ✗ | +| 管理成员(邀请、移除、修改角色) | ✓ | ✗ | ✗ | +| 生成/刷新邀请码 | ✓ | ✗ | ✗ | +| 审批加入申请、权限升级申请 | ✓ | ✗ | ✗ | +| 提交权限升级申请 | — | ✓ | ✓ | +| 退出空间 | ✓ | ✓ | ✓ | + +说明: + +- **「将知识库共享到本空间」**:仅**管理员**和**编辑者**可以执行;只读成员不能把自己的知识库共享到该空间。 +- **管理空间内知识库共享**: + - 共享的发起人可取消自己发起的共享、修改该条共享的权限; + - 空间**管理员**可取消任意一条指向本空间的共享(例如内容治理、发起人已离开等)。 + +--- + +## 四、知识库共享规则 + +### 4.1 谁可以发起共享 + +- 只有**知识库所属租户下的用户**(即「拥有」该知识库的账户下的用户)才能将该知识库共享到某个工作空间。 +- 同时,该用户必须是目标工作空间的**成员**,且角色为**管理员**或**编辑者**。 + 即:**只读成员不能把任何知识库(包括自己的)共享到该空间。** + +### 4.2 共享时的权限设置 + +将知识库共享到空间时,需为「该空间」指定一个**共享权限**: + +- **只读(viewer)**:空间成员在该知识库上最多只读(实际权限还会受成员在空间内的角色限制,见下)。 +- **可写(editor)**:空间成员在该知识库上可被赋予编辑能力(同样受成员角色限制)。 + +同一知识库可以共享到多个工作空间,且每个空间可以设置不同的共享权限(例如空间 A 只读、空间 B 可写)。 + +### 4.3 更新与取消共享 + +- **修改某条共享的权限**:仅**发起该次共享的用户**可以修改(只读 ↔ 可写)。 +- **取消某条共享**: + - **发起该次共享的用户**可随时取消; + - 目标空间的**管理员**也可取消该空间下的任意共享(包括他人发起的)。 + +### 4.4 同一知识库共享到多个空间 + +- 允许将同一知识库共享到多个工作空间。 +- 每个空间一条共享记录,各自独立配置权限(只读/可写)。 +- 例如:知识库 K 共享到空间 A(只读)、空间 B(可写),互不影响。 + +--- + +## 五、用户对知识库的最终访问权限 + +用户对某个知识库的访问可能来自两种途径,最终权限取「最宽」的一种。 + +### 5.1 两种访问来源 + +1. **本租户拥有** + 知识库属于用户当前所在租户 → 用户对该知识库拥有**完整权限**(创建者/管理端意义上的「所有者」权限:可编辑、管理设置、删除知识库等),无需也不依赖工作空间。 +2. **通过工作空间共享获得** + 知识库不属于当前租户,但被共享到了用户所在的至少一个工作空间 → 用户通过「成员身份 + 共享设置」得到**受限权限**(见下)。 + +若同时满足 1 和 2(例如先通过空间访问,后来切换到知识库所属租户),系统按「本租户拥有」处理,即完整权限。 + +### 5.2 单条共享下的「有效权限」 + +对**某一条**「知识库 ↔ 空间」的共享而言,用户在该空间内对这份知识库的权限为: + +- **有效权限 = min( 该条共享的权限, 用户在该空间内的角色 )** + +即:取「共享给空间的权限」与「用户在空间内的角色」中**更严格**的一档。 + +- 共享权限与角色均按:**只读(viewer) < 编辑(editor) < 管理员(admin)** 比较。 +- 例如: + - 共享为「可写」,用户在空间内是「只读」→ 有效权限为**只读**; + - 共享为「只读」,用户在空间内是「编辑者」→ 有效权限为**只读**; + - 共享为「可写」,用户在空间内是「编辑者」→ 有效权限为**可写**。 + +### 5.3 同一用户通过多个空间访问同一知识库(取高) + +若用户加入了多个工作空间,且同一知识库被共享到了其中多个空间(可能权限不同),则: + +- 先按 5.2 对每个空间分别算出一条「有效权限」; +- 用户对该知识库的**最终权限** = 这些有效权限中的**最高**一档(不取低、不取交集)。 + +示例: + +- 知识库 K 共享到空间 A(只读)、空间 B(可写); +- 用户同时是 A、B 的成员,在 A、B 内都是编辑者; +- 通过 A 的有效权限 = 只读,通过 B 的有效权限 = 可写; +- 最终用户对 K 的权限 = **可写**。 + +这样设计可以避免:用户因同时在一个「只读共享」的空间里而被整体降级为只读。 + +### 5.4 权限层级与可执行操作 + +| 最终权限 | 可执行操作 | +|----------|------------| +| 本租户拥有 | 完整管理:编辑内容、修改知识库设置、删除知识库、管理共享到哪些空间等 | +| 通过共享获得 · 管理员/编辑 | 在共享范围内:编辑知识库内容(文档/FAQ 等)、检索与问答 | +| 通过共享获得 · 只读 | 仅查看与检索、在对话/智能体中使用该知识库进行问答,不可修改内容 | + +(具体接口层是否区分「编辑」与「只读」以该最终权限为准。) + +--- + +## 六、典型场景小结 + +| 场景 | 结果 | +|------|------| +| 用户是空间内只读成员 | 不能把任何知识库共享到该空间;只能查看/检索该空间内已共享的知识库,且每条共享的有效权限不会超过「只读」 | +| 用户是空间内编辑者 | 可把自己的知识库共享到该空间(可设只读或可写);可编辑空间内已共享的知识库内容(在共享权限允许的前提下);不可管理空间设置与成员 | +| 用户是空间内管理员 | 除编辑者能力外,还可管理空间设置、成员、邀请码、审批加入/升级,以及取消空间内任意知识库共享 | +| 同一知识库共享到多空间且权限不同,用户同属多空间 | 用户对该知识库的最终权限 = 各空间有效权限中的**最高**一档 | +| 用户退出或被移出空间 | 立即失去通过该空间访问任何共享知识库的权限 | + +--- + +## 七、与产品术语的对应 + +- 产品中的「共享空间」= 本文的「工作空间」= 系统中的 Organization。 +- 产品中的「创建者」= 空间创建者 = 自动拥有管理员角色且不可被降级或移出的成员。 +- 知识库「共享到空间」= 建立一条 KnowledgeBaseShare 记录,并指定该空间下的共享权限(只读/可写)。 +- 成员在空间内的「权限说明」中「共享知识库到空间」一项:仅管理员和编辑者具备,只读不具备;与本文第四节、第五节规则一致。 + +--- + +## 八、附录:权限判定流程(实现参考) + +以下为后端逻辑的简要归纳,便于与实现对照: + +1. **判断是否本租户知识库** + 若 `knowledge_base.tenant_id == current_user.tenant_id` → 直接视为完整权限,不再查共享。 + +2. **收集所有「该知识库 → 某空间」的共享** + 查出所有 `kb_id = 该知识库` 的共享记录。 + +3. **对每条共享** + - 若用户不是该空间的成员 → 跳过; + - 否则:`effective = min(share.permission, user_role_in_org)`(按 admin > editor > viewer 比较取低)。 + +4. **合并多条有效权限** + 最终权限 = 所有 `effective` 中的最大值(即取高)。 + +5. **共享到空间的操作权限** + - 发起共享:用户须为空间成员且角色为 admin 或 editor; + - 取消/修改共享:发起人可操作自己的共享;空间管理员可取消任意指向本空间的共享。 + +以上规则与 `internal/application/service/kbshare.go` 及 `organization.go` 中的实现一致。产品界面(如成员列表中的「权限说明」、共享知识库时的空间筛选)已按相同规则做了展示与限制。 diff --git a/frontend/src/api/knowledge-base/index.ts b/frontend/src/api/knowledge-base/index.ts index 614c9631..4b6ba6d4 100644 --- a/frontend/src/api/knowledge-base/index.ts +++ b/frontend/src/api/knowledge-base/index.ts @@ -97,8 +97,10 @@ export function downKnowledgeDetails(id: string) { return getDown(`/api/v1/knowledge/${id}/download`); } -export function batchQueryKnowledge(idsQueryString: string) { - return get(`/api/v1/knowledge/batch?${idsQueryString}`); +/** @param idsQueryString - query string with ids (e.g. ids=xxx&ids=yyy) */ +export function batchQueryKnowledge(idsQueryString: string, kbId?: string) { + const qs = kbId ? `${idsQueryString}&kb_id=${encodeURIComponent(kbId)}` : idsQueryString; + return get(`/api/v1/knowledge/batch?${qs}`); } export function getKnowledgeDetailsCon(id: string, page: number) { diff --git a/frontend/src/api/organization/index.ts b/frontend/src/api/organization/index.ts new file mode 100644 index 00000000..19c16b7a --- /dev/null +++ b/frontend/src/api/organization/index.ts @@ -0,0 +1,491 @@ +import { get, post, put, del } from '@/utils/request' + +// Organization types +export interface Organization { + id: string + name: string + description: string + avatar?: string + owner_id: string + invite_code?: string + invite_code_expires_at?: string | null + invite_code_validity_days?: number + require_approval?: boolean + member_count?: number + share_count?: number + pending_join_request_count?: number + is_owner?: boolean + my_role?: string + has_pending_upgrade?: boolean + created_at: string + updated_at: string +} + +export interface OrganizationMember { + id: string + user_id: string + username: string + email: string + avatar?: string + role: 'admin' | 'editor' | 'viewer' + tenant_id: number + joined_at: string +} + +export interface KnowledgeBaseShare { + id: string + knowledge_base_id: string + knowledge_base_name?: string + knowledge_base_type?: string + knowledge_count?: number + chunk_count?: number + organization_id: string + organization_name?: string + shared_by_user_id: string + shared_by_username?: string + source_tenant_id: number + /** Share permission: what the space was granted (viewer/editor) */ + permission: 'admin' | 'editor' | 'viewer' + /** Current user's role in this organization (admin/editor/viewer) */ + my_role_in_org?: 'admin' | 'editor' | 'viewer' + /** Effective permission for current user = min(permission, my_role_in_org) */ + my_permission?: 'admin' | 'editor' | 'viewer' + created_at: string +} + +export interface SharedKnowledgeBase { + knowledge_base: { + id: string + name: string + description: string + type: string + knowledge_count?: number + chunk_count?: number + } + share_id: string + organization_id: string + org_name: string + permission: 'admin' | 'editor' | 'viewer' + source_tenant_id: number + shared_at: string +} + +export interface OrganizationPreview { + id: string + name: string + description: string + avatar?: string + member_count: number + share_count: number + is_already_member: boolean + require_approval: boolean + created_at: string +} + +// Request types +export interface CreateOrganizationRequest { + name: string + description?: string + avatar?: string + invite_code_validity_days?: number // 0=never, 1, 7, 30; default 7 +} + +export interface UpdateOrganizationRequest { + name?: string + description?: string + avatar?: string + require_approval?: boolean + invite_code_validity_days?: number // 0=never, 1, 7, 30 +} + +export interface UpdateMemberRoleRequest { + role: 'admin' | 'editor' | 'viewer' +} + +export interface JoinOrganizationRequest { + invite_code: string +} + +export interface ShareKnowledgeBaseRequest { + organization_id: string + permission: 'admin' | 'editor' | 'viewer' +} + +export interface UpdateSharePermissionRequest { + permission: 'admin' | 'editor' | 'viewer' +} + +// Response types +export interface ApiResponse { + success: boolean + data?: T + message?: string +} + +export interface ListOrganizationsResponse { + organizations: Organization[] + total: number +} + +export interface ListMembersResponse { + members: OrganizationMember[] + total: number +} + +export interface JoinRequestResponse { + id: string + user_id: string + username: string + email: string + message: string + request_type: 'join' | 'upgrade' // 'join' for new member, 'upgrade' for role upgrade + prev_role?: string // Previous role (only for upgrade requests) + requested_role: string // Role applicant requested: admin, editor, viewer + status: string + created_at: string + reviewed_at?: string +} + +export interface ListJoinRequestsResponse { + requests: JoinRequestResponse[] + total: number +} + +export interface SubmitJoinRequestRequest { + invite_code: string + message?: string + role?: 'admin' | 'editor' | 'viewer' // Optional: role applicant requests; default viewer +} + +export interface ReviewJoinRequestRequest { + approved: boolean + message?: string + role?: 'admin' | 'editor' | 'viewer' // Optional: role to assign when approving; overrides applicant's requested role +} + +export interface RequestRoleUpgradeRequest { + requested_role: 'admin' | 'editor' | 'viewer' // The role user wants to upgrade to + message?: string // Optional message explaining the reason +} + +export interface InviteMemberRequest { + user_id: string // User ID to invite + role: 'admin' | 'editor' | 'viewer' // Role to assign +} + +export interface UserSearchResult { + id: string + username: string + email: string + avatar?: string +} + +export interface ListSharesResponse { + shares: KnowledgeBaseShare[] + total: number +} + +// Organization API functions + +/** + * Create a new organization + */ +export async function createOrganization(req: CreateOrganizationRequest): Promise> { + try { + const response = await post('/api/v1/organizations', req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to create organization' } + } +} + +/** + * Get organization by ID + */ +export async function getOrganization(id: string): Promise> { + try { + const response = await get(`/api/v1/organizations/${id}`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to get organization' } + } +} + +/** + * List my organizations + */ +export async function listMyOrganizations(): Promise> { + try { + const response = await get('/api/v1/organizations') + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to list organizations' } + } +} + +/** + * Update organization + */ +export async function updateOrganization(id: string, req: UpdateOrganizationRequest): Promise> { + try { + const response = await put(`/api/v1/organizations/${id}`, req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to update organization' } + } +} + +/** + * Delete organization + */ +export async function deleteOrganization(id: string): Promise> { + try { + const response = await del(`/api/v1/organizations/${id}`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to delete organization' } + } +} + +/** + * Join organization by invite code + */ +export async function joinOrganization(req: JoinOrganizationRequest): Promise> { + try { + const response = await post('/api/v1/organizations/join', req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to join organization' } + } +} + +/** + * Submit a join request (for organizations that require approval). + * Optional role: applicant's requested role (admin/editor/viewer); default viewer. + */ +export async function submitJoinRequest(req: SubmitJoinRequestRequest): Promise> { + try { + const response = await post('/api/v1/organizations/join-request', req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to submit join request' } + } +} + +/** + * Preview organization by invite code (without joining) + */ +export async function previewOrganization(inviteCode: string): Promise> { + try { + const response = await get(`/api/v1/organizations/preview/${inviteCode}`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to preview organization' } + } +} + +/** + * Leave organization + */ +export async function leaveOrganization(id: string): Promise> { + try { + const response = await post(`/api/v1/organizations/${id}/leave`, {}) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to leave organization' } + } +} + +/** + * Request role upgrade in an organization + */ +export async function requestRoleUpgrade( + orgId: string, + request: RequestRoleUpgradeRequest +): Promise> { + try { + const response = await post(`/api/v1/organizations/${orgId}/request-upgrade`, request) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to submit upgrade request' } + } +} + +/** + * Generate new invite code + */ +export async function generateInviteCode(id: string): Promise> { + try { + const response = await post(`/api/v1/organizations/${id}/invite-code`, {}) + return response as unknown as ApiResponse<{ invite_code: string }> + } catch (error: any) { + return { success: false, message: error.message || 'Failed to generate invite code' } + } +} + +// Member management + +/** + * List organization members + */ +export async function listMembers(orgId: string): Promise> { + try { + const response = await get(`/api/v1/organizations/${orgId}/members`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to list members' } + } +} + +/** + * Update member role + */ +export async function updateMemberRole(orgId: string, userId: string, req: UpdateMemberRoleRequest): Promise> { + try { + const response = await put(`/api/v1/organizations/${orgId}/members/${userId}`, req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to update member role' } + } +} + +/** + * Remove member + */ +export async function removeMember(orgId: string, userId: string): Promise> { + try { + const response = await del(`/api/v1/organizations/${orgId}/members/${userId}`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to remove member' } + } +} + +/** + * List join requests (pending) for an organization (admin only) + */ +export async function listJoinRequests(orgId: string): Promise> { + try { + const response = await get(`/api/v1/organizations/${orgId}/join-requests`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to list join requests' } + } +} + +/** + * Review join request (approve or reject) - admin only + */ +export async function reviewJoinRequest(orgId: string, requestId: string, req: ReviewJoinRequestRequest): Promise> { + try { + const response = await put(`/api/v1/organizations/${orgId}/join-requests/${requestId}/review`, req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to review join request' } + } +} + +// Knowledge base sharing + +/** + * Share knowledge base to organization + */ +export async function shareKnowledgeBase(kbId: string, req: ShareKnowledgeBaseRequest): Promise> { + try { + const response = await post(`/api/v1/knowledge-bases/${kbId}/shares`, req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to share knowledge base' } + } +} + +/** + * List shares for a knowledge base + */ +export async function listKBShares(kbId: string): Promise> { + try { + const response = await get(`/api/v1/knowledge-bases/${kbId}/shares`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to list shares' } + } +} + +/** + * Update share permission + */ +export async function updateSharePermission(kbId: string, shareId: string, req: UpdateSharePermissionRequest): Promise> { + try { + const response = await put(`/api/v1/knowledge-bases/${kbId}/shares/${shareId}`, req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to update share permission' } + } +} + +/** + * Remove share + */ +export async function removeShare(kbId: string, shareId: string): Promise> { + try { + const response = await del(`/api/v1/knowledge-bases/${kbId}/shares/${shareId}`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to remove share' } + } +} + +/** + * List shared knowledge bases (shared to me through organizations) + */ +export async function listSharedKnowledgeBases(): Promise> { + try { + const response = await get('/api/v1/shared-knowledge-bases') + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to list shared knowledge bases' } + } +} + +/** + * List knowledge bases shared to a specific organization + */ +export async function listOrgShares(orgId: string): Promise> { + try { + const response = await get(`/api/v1/organizations/${orgId}/shares`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to list organization shares' } + } +} + +/** + * Search users for inviting to organization (excludes existing members) + */ +export async function searchUsersForInvite( + orgId: string, + query: string, + limit: number = 10 +): Promise> { + try { + const response = await get(`/api/v1/organizations/${orgId}/search-users?q=${encodeURIComponent(query)}&limit=${limit}`) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to search users' } + } +} + +/** + * Invite a user to organization directly (admin only) + */ +export async function inviteMember( + orgId: string, + req: InviteMemberRequest +): Promise> { + try { + const response = await post(`/api/v1/organizations/${orgId}/invite`, req) + return response as unknown as ApiResponse + } catch (error: any) { + return { success: false, message: error.message || 'Failed to invite member' } + } +} diff --git a/frontend/src/assets/img/organization-green.svg b/frontend/src/assets/img/organization-green.svg new file mode 100644 index 00000000..33dd02f2 --- /dev/null +++ b/frontend/src/assets/img/organization-green.svg @@ -0,0 +1,3 @@ + + + diff --git a/frontend/src/assets/img/organization.svg b/frontend/src/assets/img/organization.svg new file mode 100644 index 00000000..83495f56 --- /dev/null +++ b/frontend/src/assets/img/organization.svg @@ -0,0 +1,3 @@ + + + diff --git a/frontend/src/components/AgentSelector.vue b/frontend/src/components/AgentSelector.vue index 9945dabe..74ec72c0 100644 --- a/frontend/src/components/AgentSelector.vue +++ b/frontend/src/components/AgentSelector.vue @@ -44,16 +44,23 @@ {{ agent.name }} - - - +
+ +
+ +
+
+ + + +