# 项目组件

## 1. 什么是“组件“？

ONES Project 通过“项目“来管理团队各项事务，**“组件“是项目内具有独立工作逻辑的功能模块，**可以有效拓宽“项目-任务类型“结构的单一场景，为管理各类事务提供更灵活的支撑，匹配更丰富的业务场景，满足不同规模团队的协作和管理需求。

此外，组件能力也使得 ONES Project **更高效的与其它子产品联动，**实现研发管理全流程与全场景的打通。

## 2. 组件类型

系统内有三种组件类型：通用组件、系统组件、自定义工作项类型组件；组件数量众多，功能丰富，配置灵活，各功能特性将在后续章节中展开详细介绍。

### 2.1 通用组件

* **一级导航**：是一个空文件夹，支持添加二级导航组件
* **自定义链接**：可以通过配置URL，跳转对应网页

### 2.2 系统组件

系统组件大致可分为 3 类：

#### 2.2.1 预置的工作项类型组件

**“工作项“**是 ONES 系统定义各类项目事务的基本工作单位，是对于具备相同数据结构（常见的如状态、属性、工作流）的业务类型的抽象定义，有着相似的业务场景，都是围绕“完成这件事情“来流转。

**“工作项类型组件“**基于这类事务的处理逻辑，做了一些产品能力的封装，增强可复用性的同时，也支持基于不同工作项类型的个性化的配置。

典型的工作项类型组件包括：

* **用户故事**：详细的用户故事列表，可以对用户故事进行排序、筛选、规划
* **需求**：详细的需求列表，包含需求规划、拆分、关联工作项等针对性功能
* **缺陷**：详细的缺陷列表，包含关联需求、关联测试计划等针对性功能
* **任务**：详细的任务列表，包含关联工作项等针对性功能

另外，还有一类特殊的工作项类型组件，针对其业务特性，在组件能力上做了特殊处理：

* **工单**：详细的工单列表，包含工单收集，指派工单处理人，自定义工单状态流转
* **发布：**包含发布列表，可以进行发布的计划与管理

#### 2.2.2 敏捷研发核心组件

* **迭代**：包含迭代列表、迭代周期、迭代燃尽图、相关工作项列表等内容
* **迭代计划**：通过列表、详情视图展示多个迭代所处阶段与基本信息

#### 2.2.3 瀑布项目规划核心组件

* **项目计划**：传统项目规划和进度管理甘特，同时支持与关联迭代、混合使用
* **里程碑**：包含里程碑列表，支持增删改查里程碑、对比里程碑计划的历史版本
* **交付物**：包含项目交付物列表及来源
* **执行**：包含从项目计划拆解得到的所有计划
* **时间视图**：工作项甘特视图；展示工作项执行顺序、持续时间及进度情况

#### 2.3.4 其它基础功能组件

* **项目概览**：自定义卡片，展示当前项目的基本信息以及迭代和工作项的完成情况
* **筛选器**：根据项目所需汇总工作项信息，提供公共视图、私人视图的能力
* **成员**：展示当前项目中的所有成员及其角色构成，可进行项目成员管理
* **报表**：提供了当前项目的多维度数据统计能力以及可视化展现
* **文档**：通过关联 Wiki 页面组的方式，实时同步页面信息
* **文件**：汇总展示项目下所有工作项包含的文件
* **流水线**：展示当前项目关联的流水线信息

### 2.3 自定义工作项类型组件

用户创建了一个新的工作项类型时，系统会自动生成自定义工作项类型组件。自定义工作项类型的组件能力与系统预置的工作项类型组件，如需求、缺陷、任务等一致。

## 3. 组件添加和移除

![](/files/-MWrjVkcw20h-I_SyN4u)

在项目内顶部导航入口选择**`项目设置>项目组件`**，即可为一个项目搭配所需的组件，目标是将自定义导航中的组件调整至团队所需。

你可以通过拖放的方式添加和移除组件。将左侧组件库中的组件拖至自定义导航下，完成添加；从自定义导航拖至组件库，即完成移除。此外：

* 一个项目内，可重复添加多个相同组件
* 组件显示名称支持自定义修改

每个组件基于业务类型和功能设计上的差异，有相应的个性化配置，具体的操作在各组件功能特性中详细有详细说明。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides-ones.gitbook.io/guides/usage-guide/ones-project/pei-zhi-xiang-mu-zu-jian.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.