跳到主要内容

项目空间

项目是平台的业务隔离边界。接口、数据源、环境、分组、治理规则、订阅与会话都归属于某个项目；切换项目后，所有列表与配置都会随之切换。

进入项目​

登录成功后，页面会弹出项目选择面板，包含两类操作：

  • 进入已有项目：点击项目卡片或在下拉面板中切换项目。
  • 新建项目：填写项目名称、接口前缀与描述后创建。

项目顶部切换器会显示当前项目（如「默认」），点击后可切换项目或管理项目。

创建项目​

字段必填规则
项目名称是用于项目卡片与切换器展示
接口前缀是全平台唯一，比较时忽略大小写与首尾斜杠
项目描述否项目用途说明

创建完成后平台自动完成：

  1. 初始化 dev 开发环境与生产环境。
  2. 绑定默认执行服务。
  3. 初始化项目成员关系，创建者成为项目管理员。
接口前缀

接口前缀会参与开放接口地址拼接。修改项目名称不会改变已发布接口的路径；接口前缀需要全平台唯一，避免不同项目路由冲突。

成员与协作​

项目管理员可以邀请其他用户加入项目，成员至少输入两个字符才会触发检索。

项目角色能力
管理员邀请/移除成员、维护项目信息、管理项目内资源
成员在项目内开发接口、配置数据源与规则；数据范围仍受个人权限约束

在项目下拉面板中可以：

  • 切换当前项目。
  • 查看项目成员。
  • 管理员移除成员或删除项目。
  • 打开项目管理面板，编辑项目信息、添加成员。
删除项目

删除项目会影响项目内的接口、配置与成员关系，属于不可逆操作。删除前请确认没有其他项目正在引用本项目的数据源或接口。

项目隔离范围​

资源隔离方式
接口与分组仅当前项目可见；跨项目需通过分组授权或迁移
数据源默认项目内可见；可通过数据源授权给其他项目使用
环境与发布按项目维护，项目创建时自动初始化
流控、缓存、IP、告警规则按项目 + 环境隔离
调用凭证归当前用户所有，但作用域基于接口授权
订阅与审批按项目与接口隔离
AI 会话与日志按用户 + 项目隔离

数据源跨项目授权​

数据源支持授权给其他项目访问：

  1. 在数据源列表点击【授权】。
  2. 选择目标项目并确认。
  3. 被授权项目可以在接口中选择该数据源。
  4. 被授权项目 不能 查看或修改数据源的连接信息与账号密码。

当数据源已被其他项目的接口引用时，不允许取消授权或删除。

请求上下文​

前端会在除登录相关接口外的所有管理端请求中自动携带：

X-Project-Id: 1

后端 ProjectContextInterceptor 据此加载项目上下文。缺少项目上下文或项目无权限时，业务接口会拒绝访问。

权限与可见性​

  • 普通用户只能看到自己创建的数据，以及被授权的分组与数据源。
  • 项目成员关系决定「能否进入项目」，菜单权限决定「进入项目后能看哪些页面」。
  • 超级管理员可以跨项目执行管理操作，但接口列表仍默认按当前项目过滤。

相关阅读：权限模型、数据源授权。