cosms-core/docs/requirements.md

# Requirements

## Introduction

This document contains the user stories and requirements for the cosms (c open source media station) project. The whole application is based around the requirements set in this document. If at any point in the futhere there are any new requirements they should be documented here before the feature is implemented.

## How to document

When documenting the user stories and requirements there are a few rules that have to be followed to make sure that they are consistent and do not miss any important information.

### User stories

For the user stories the following format will be used:

```
Code: US-[user story number]
Description: As [type of user], I want [an action] so that [the benefits/value]
```

Using this structure helps identify who wants what and why. This method of documenting user stories focuses more on the value than the technical details making sure the needs of the user are met. To validate if the user story was implemented right accaptance criteria will also be setup along side the user stories. These accaptance criteria tell us when the user story can be seen as complete/accaptable. For documenting the accaptance criteria the following format will be used:

```
Accaptance:
    * Given [how things begin] when [action taken] then [outcome of taking action].
```

These accaptance criteria will be placed in a list underneath the user story it is a part of as this will make it easier to find.

### Requirements

The requirements come forth from the user stories and define the functional and non-functional requirements the application must meet. When setting up the requirements the following format will be used:

```
Code: RQ-[requirement number]
User story: [the code of the user story this requirements comes from]
User: [the user this requirements comes from]
Requirement: [the requirement itself]
Type: [is it a functional or non-functional requirement]
Quality attribute: [ISO-25010 standard quality attribute (only for non-functionals)]
Priority: [how important is the requirement (low, medium, high, highest)]
```

By using this format the requirement will be easly retracable to the user story and user where it originated from. It also tells the type and importance of the requirements allowing us to more easly decide which requirement will be implemented first.

## User stories and requirements

### User stories

**Code**: US-01 \
**Description**: As an user, I want to watch/listen to my media on any device so that I can watch content anywhere.

**Accaptance**

* Given the user is connected to the internet when the user opens cosms then the user should beable to watch/listen to any available media.
* Given that cosms is running when the user select a supported media file to play then playback should start within 5 seconds.

--------------------------------

**Code**: US-02 \
**Description**: As an user, I want to search for content quickly so I can easly find something I want to watch.

**Accaptance**

* Given the user has media on cosms when the user enters a search term then the user should automatically see relevant media based on the metadata.
* Given the user has no media on cosms when the user enters a search term then the user should get a message "No media found".

--------------------------------

**Code**: US-03 \
**Description**: As an user, I want to continue where I left of so I can easly resume playback.

**Accaptance**

* Given the user has watched/listened to part of a media file when the user stops playback and closes the app then the media should continue where the user left it the next time the user starts playing it.
  
--------------------------------

**Code**: US-04 \
**Description**: As an user, I want subtitles to display so I can enjoy foreign language content.

**Accaptance**

* Given the user has media files that have subtitles when the user starts playback then the user should be able to select subtitles track.
* Given a subtitle track is selected when the user starts playback then the subtitles should appear in sync with the dialogue.
* Given a language is selected and automatic subtitles is on when the user starts playback with audio in a different language then subtitles should automatically appear.

--------------------------------

**Code**: US-05 \
**Description**: As an administrator, I want to upload and organize media so I can add new content for users to watch.

**Accaptance**

* Given the administrator logged in as administrator when the administrator uploads a media file then the system should automatically add it to the media list and categirize it.
* Given new media has been added when the administrator or user views the library then the media should appear.

-------------------------------

**Code**: US-06 \
**Description**: As an administrator, I want to manage user accounts so I can control who has access to the media station.

**Accaptance**

* Given the administrator is logged in as administrator when the administrator creates a new user then the new user should appear in the list and beable to login.
* Given the administrator is logged in as administrator when the administrator disables or deletes an user then the user should not beable to login anymore.
* Given the administrator is logged in as administrator when the administrator sets the access rights of an user then they should only beable to see media they are allowed to see.
* Given the administrator is logged in as administrator when the administrator sets the access rights of an user then they should only beable to make changes to media they are allowed to.

------------------------------

**Code**: US-07 \
**Description**: As an administrator, I want automatic library scanning so I do not have to manually add new content.

**Accaptance**

* Given scanning is enabled when new media is added to the watched folder then the new media should be visible in cosms.
* Given manual scanning is triggered when the scan is complete then the new media should be visible in cosms.

------------------------------

**Code**: US-08 \
**Description**: As an user, I want to download media localy so I can watch it anywhere even without internet.

**Accaptance**

* Given the user is connected to the internet when the user downloads the media then it should be stored localy on there device.
* Given the user has media downloaded when the user has not internet then the user should be able to watch the downloaded media.
* Given the user has media downloaded when the user deletes the download files then the files should not be stored anymore on there device.

### Requirements