# 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**](https://docs.xygeni.io/xygeni-administration/platform-administration/policies) 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](https://docs.xygeni.io/introduction-to-xygeni/xygeni-web-ui-overview#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&#x20;

<figure><img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FUpV7uz49KwSi684PmThY%2Fimage.png?alt=media&#x26;token=4494d359-5172-4893-9992-e2778ceb2656" alt=""><figcaption></figcaption></figure>

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

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).&#x20;

Clicking on the <img src="https://4096647782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTz59rJLkJBjiRWAMknU%2Fuploads%2FHw3oLT3nBIMvoJaTsJ8J%2Fimage.png?alt=media&#x26;token=6fcaedec-2a07-45a1-9780-600f9eb9f2cb" 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](https://docs.xygeni.io/xygeni-administration/platform-administration/projects-management/properties-project-management)
* [Configuration](https://docs.xygeni.io/xygeni-administration/platform-administration/projects-management/configuration-project-management)
* [Auto-fix](https://docs.xygeni.io/xygeni-administration/platform-administration/projects-management/auto-fix) (tbd)