# Projects Management

## Introduction <a href="#introduction" id="introduction"></a>

A **project** is the target for the scans. It can be any *unit of software* that can be analyzed independently, with any granularity. It could correspond with an application, module, service, microservice, container image, library, component…​

A project typically is under version control, and it physically has a set of source files, often grouped as a *repository* in a Source Code Management (SCM) System.

So, in short, a **project** is the analysis unit in Xygeni, can match any software item that is analyzed independently (library, application etc.) and often is a repository under version control.

Projects have the following properties:

* **Business Value**, one of CRITICAL, HIGH, MEDIUM, LOW or INFO.
* **Business Area**, organization-specific.
* **Architecture**, organization-specific.
* **Tags**, arbitrary labels that could be added to a project for grouping and classification purposes.

Other common properties are **Provider**, which could be used to track your software suppliers' risk, and **Product Unit**, which help organizing scanned modules into aggregated software products.

{% hint style="info" %}
You can also create your own Custom Properties. See [Custom Properties](#choosing_project_or_group_in_dashboard-2) for further details.
{% endhint %}

A [**Policy**](/xygeni-administration/platform-administration/policies.md) could be assigned to a project. If no explicit policy is set for the project, the default policy will be used.

### Choosing project or group in Dashboard <a href="#choosing_project_or_group_in_dashboard" id="choosing_project_or_group_in_dashboard"></a>

In the top bar of the Dashboard there is a `project selector` for choosing an individual project or a group of projects

The **Projects Selector** is a UI feature that allows to select a project subset among the available ones in the Xygeni organization. Almost every UI page’s data is related to the selected Project(s).

The subset of projects can vary from a unique project to All projects, passing for any defined subset.

{% hint style="info" %}
See [Projects Selector](/introduction-to-xygeni/xygeni-web-ui-overview.md#projects-selector) for further details
{% endhint %}

Projects can be aggregated into **groups** defined dynamically via their properties. Projects can be tagged with *labels* that allow to group them in arbitrary collections.

Projects are scanned for analyzing Software Supply Chain Security issues; the scan findings are uploaded to the Xygeni service. The Dashboard shows such findings for an individual project or aggregated at any group.

{% hint style="info" %}
There is a special group including the full software assets in the organization, the default **All** group.
{% endhint %}

### Projects Management <a href="#choosing_project_or_group_in_dashboard" id="choosing_project_or_group_in_dashboard"></a>

Project Management page can be found at Settings >> Project Management

<figure><img src="/files/mGRjSkbmdvIpX6ZZSfs1" alt=""><figcaption></figcaption></figure>

In order to browse through the existing projects, you can use the **Filter fields**.

Clicking on **New Project** button allows you to create a project. When creating a new project, you will see that some properties are **General** (i.e. out-of-the-box properties, those marked with a (\*) are mandatory ) and others are **Custom** (i.e. defined by the Xygeni administrator).

Clicking on the <img src="/files/ozc5kSgwKShG7KaagPZ8" alt="" data-size="line"> icons will allow you to edit and delete the selected project.

When editing a particular project, the project management slide opens and is organized into the following tabs:

* [Properties](/xygeni-administration/platform-administration/projects-management/properties-project-management.md)
* [Configuration](/xygeni-administration/platform-administration/projects-management/configuration-project-management.md)
* [Auto-fix](/xygeni-administration/platform-administration/projects-management/auto-fix.md) (tbd)


---

# 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://docs.xygeni.io/xygeni-administration/platform-administration/projects-management.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.