# 项目管理

项目功能使企业内的多个组织或部门能够独立使用和管理各自的 MQTT 集群。通过为不同角色分配权限，可以实现对平台能力的更细化管理。基于项目的结构，每个组织或部门都可以独立管理其所属的 MQTT 集群，并实现资源与账单的隔离。在多项目机制下，所有部署必须创建在某个项目下，且每个部署只能属于一个项目。

## 查看项目

您可以通过控制台的多个入口查看和管理项目：

- 在控制台首页的**项目管理**区块中，点击**查看所有项目**。
- 或者，在左侧导航栏点击**项目管理**。

进入**项目管理**页面，您将看到所有已创建的项目。每个项目卡片展示以下信息：

- 项目名称与描述
- EMQX Broker 概览，包括：
  - Broker 总数
  - 运行中的 Broker 数量
  - 已停止的 Broker 数量

::: tip

如果您是项目管理员、项目使用者，或项目查看者角色，只能访问您被授权使用或查看的项目。有关各角色对应的项目管理权限，请参见[角色与权限](./user.md#角色与权限)。

:::

![default_project](./_assets/default_project.png)

点击项目卡片可进入**项目概览**页面，在该页面中可以创建和管理该项目下的部署。

## 创建项目

您可以在**项目管理**页面或控制台**概览**页面中点击 **+ 新建项目**来创建新项目。

1. 进入**项目管理**或控制台**首页**。
2. 点击 **+ 新建项目**。
3. 在弹出的**新建项目**对话框中，填写项目名称和备注（备注为必填项）。
4. 点击**确认**创建项目。

::: tip 注意

EMQX Cloud 控制台最多支持创建 20 个项目。

:::

![create_project](./_assets/create_project.png)

## 在项目下创建部署

要创建部署，您需要先进入目标项目：

1. 点击项目卡片进入**项目概览**页面。
2. 在项目概览页面中，有以下两种方式可创建部署：
   - 直接点击页面中的 **+ 新建部署**。
   - 或点击左侧菜单中的 **EMQX Broker**，在该页面中点击 **+ 新建部署**。

有关部署的详细创建步骤，请参见：[创建部署](../create/overview.md)章节。

为提升多部署场景下的管理效率，项目页面顶部的面包屑导航支持下拉切换项目与部署，实现快速跳转与自动刷新页面数据。

<img src="./_assets/breadcrumb-switching.png" alt="breadcrumb-switching" style="zoom:67%;" />

## 移动部署至其他项目

1. 点击部署卡片右上角的菜单按钮，选择**移动到**。

   <img src="./_assets/move_project_menu.png" alt="move_project_menu" style="zoom:67%;" />

2. 在弹出的下拉菜单中选择目标项目。

3. 点击**确认**后，部署将被移动到所选项目中。

## 编辑项目名称与备注

::: tip

仅**主账号用户（管理员账户）** 可以编辑项目名称和备注。详见：[管理子账号](./user.md#角色权限)。

:::

1. 点击目标项目卡片进入项目。
2. 在左侧菜单中点击**项目设置**。
3. 在**基础设置**区块中修改项目名称与备注。
4. 点击**保存**。

<img src="./_assets/update_project_menu.png" alt="update_project_menu" style="zoom:67%;" />

## 删除项目

::: tip

仅**主账号用户（管理员账户）** 可以删除项目。详见：[管理子账号](./user.md#角色权限)。

:::

::: tip 注意

删除项目前，请确保该项目下没有任何部署。

:::

1. 点击目标项目卡片进入项目。
2. 在左侧菜单中点击**项目设置**。
3. 滚动至页面底部，点击**删除项目**按钮。
4. 确认提示后点击**确认**执行删除操作。

## 添加项目成员

如果您是管理员角色，可以将团队成员分配至项目中，包括创建新成员账户或添加已有成员账户，以实现更灵活的协作和权限控制。

1. 点击目标项目卡片进入项目。
2. 在左侧菜单中点击**项目设置**。
3. 在**项目成员**区块中点击 **+ 添加**。在弹出的**添加项目成员**对话框中：

   - 可选择添加**新建用户**或**已有用户**。

   - 若为**新建用户**：
     - 输入有效的成员**账号**（邮箱地址）
     - 设置登录**密码**
     - 可填写**备注**（可选）
     - 选择**角色**：
       - 项目查看者
       - 项目使用者
       - 项目管理员
4. 点击**确认**即可添加成员至项目。您可以重复此操作添加更多成员。

![add_project_member](./_assets/add_project_member.png)

