# Epic OP-1943 - API for SCM repositories

Project: OpenProject
Status: closed
URL: https://community.openproject.org/work_packages/OP-1943

## Detailed specification

### Motivation and background information

### Acceptance criteria

### Out of scope

| Attribute | Value |
| --- | --- |
| Mockups |  |

## Planning

| Attribute | Value |
| --- | --- |
| Roadmap |  |
| Date | 2015-06-17 – 2015-08-14 |
| Votes |  |
| List |  |
| Target versions | 5.0.0 |
| Sprint | 5.0.0 |
| Backlog bucket |  |
| Relevance |  |

## Subitems

| ID | Type | Subject | Status | Assignee | Target versions | Project | Priority | Spent time |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| OP-1799 | Feature | [repo] Show used storage total and per project | closed |  | 5.0.0 | OpenProject | Medium |  |
| OP-1825 | Feature | Restyle and restructure projects table in admin overview | closed |  | 5.0.0 | OpenProject | Medium |  |
| OP-1973 | Feature | [repo] Repository Interface | closed |  | 5.0.0 | OpenProject | Medium |  |
| OP-1974 | Feature | [repo] Explicit Creation of Repositories | closed |  | 5.0.0 | OpenProject | Medium |  |
| OP-2082 | Feature | Remove filesystem repository | closed |  | 5.0.0 | OpenProject | Medium |  |
| OP-2103 | Feature | Deprecate reposman due to integrated managed repositories. | closed |  | 5.0.0 | OpenProject | High |  |
| OP-2105 | Feature | [repo] Make checkout plugin compatible | closed |  | 5.0.0 | OpenProject | Medium |  |
| OP-2108 | Feature | [repo] Allow users to configure available SCM vendor types | closed |  | 5.0.0 | OpenProject | Medium |  |
| OP-2137 | Feature | [repo] Integrate checkout plugin functionality | closed |  | 5.0.0 | OpenProject | High |  |
| OP-2161 | Feature | Allow managed repository to be created upon project creation | closed |  | 5.0.0 | OpenProject | High |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Module |
| --- | --- | --- | --- | --- | --- | --- |
| OP-2231 | Task | Repositories: Consolidate and improve documentation and migration paths to 5.0 | closed |  | 5.0.0 |  |
| OP-2135 | Task | Refactor managed repository storage | closed |  | 5.0.0 |  |
| OP-2074 | Bug | [repo] Git can't annotate files with UTF-8 encoded authors. | closed |  | 5.0.0 |  |
| OP-1987 | Bug | Remote subversion repository does not print error for invalid credentials | closed |  | 5.0.0 |  |

## Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Enterprise plan |  |
| Labels |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable | Oliver Günther |
| Product manager |  |
| Feature Lead |  |
| Designer |  |
| Developers |  |
| Requested by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work |  |

## Description

**As** an OpenProject user  
**I want** to have SCM repositories tied to projects, managed by OpenProject  
**so that** I do not need to control SCM availability and authorization myself.

**Acceptance Criteria**:

  - A new, managed repository functionality is introduced: Managed repositories are owned by OpenProject and created and deleted immediately when requested.
  - Managed repositories can be created for Subversion and Git, but the interface itself is open to be integrated by third-party SCM vendor plugins.
  - Managed repositories are tracked by OpenProject. When their associated project is removed or renamed, the appropriate action is taken on disk automatically.
  - Authentication using the OpenProjectAuthentication Apache perl module is extended for Git (Smart HTTP).
  - The availability of managed and existing repositories can be configured globally per OpenProject instance.
  - The user experience of creating managed and existing repositories manually is improved.
  - Life time
      - Managed repositories may be automatically created when a project is created respectively removed. This automatic creation can be configured in the system settings.
  - Browsing Repositories in OpenProject
      - The visual style of the repository module is updated and modernized.
      - The state of the repository is communicated more clearly to the user. An error/warning is displayed when the repository is unavailable respectively empty.
  - Checkout Instructions
      - Checkout instructions can be enabled on all repository-related pages (Previously provided by the OpenProject-Checkout plugin).
      - Checkout instructions contain the checkout URL as well as the permissions the user has for the repository.
  - Packager
      - Extend packager configuration to allow enabling Git repository integration besides the existing Subversion.
  - Quota / Storage: 
      - The disk space required to store the repository is determined asynchronously in configurable intervals when visiting the repository pages.
      - An updated computation of the required disk space can be requested through the SYS API endpoint
      - The required disk space for a repository is displayed to project administrators in OpenProject in the project itself and the project overview.
      - Administrators can sort the project overview by required disk space.
  - Deprecations
      - The asynchronous repository management script (*reposman.rb*) is removed.
      - The OpenProject-Checkout Plugin is removed.
      - The Filesystem SCM type is removed.
