# Runtime View

## Table of Contents

- [Runtime View](#runtime-view)
  - [Table of Contents](#table-of-contents)
  - [Login Process](#login-process)
  - [Project Creation](#project-creation)
    - [Mining Method Selection](#mining-method-selection)
  - [Scenario Creation](#scenario-creation)
    - [Default Business Scenario](#default-business-scenario)
  - [Parameter Configuration](#parameter-configuration)
  - [Basic Accounting Setup](#basic-accounting-setup)
  - [Currency Setup](#currency-setup)
  - [Report Generation](#report-generation)
  - [User Management](#user-management)

<!--
The runtime view describes concrete behavior and interactions of the system's building blocks in form of scenarios from the following areas:

- important use cases or features: how do building blocks execute them?
- interactions at critical external interfaces: how do building blocks cooperate with users and neighboring systems?
- operation and administration: launch, start-up, stop
- error and exception scenarios

Remark: The main criterion for the choice of possible scenarios (sequences, workflows) is their _architectural relevance_. It is _not_ important to describe a large number of scenarios. You should rather document a representative selection.

_Motivation:_ You should understand how (instances of) building blocks of your system perform their job and communicate at runtime. You will mainly capture scenarios in your documentation to communicate your architecture to stakeholders that are less willing or able to read and understand the static models (building block view, deployment view).

_Form:_ There are many notations for describing scenarios, e.g. numbered list of steps (in natural language), activity diagrams or flow charts, sequence diagrams, BPMN or EPCs (event process chains), state machines, ...

## Runtime Scenario 1

- _<insert runtime diagram or textual description of the scenario>_
- _<insert description of the notable aspects of the interactions between the building block instances depicted in this diagram.>_

-->

## Login Process

1. The user navigates to the login page.
2. The user enters their credentials (username and password).
3. The API Layer receives the login request and forwards it to the Authentication Service in the Service Layer.
4. The Authentication Service validates the credentials against the user data stored in the Database System via the Data Access Layer.
5. If the credentials are valid, the Authentication Service generates a session token and sends it back to the API Layer.
6. The API Layer returns the session token to the user, granting access to the system.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant AS as Authentication Service
    participant DB as Database System

    U->>API: Submit login credentials
    API->>AS: Forward credentials
    AS->>DB: Validate credentials
    DB-->>AS: Return validation result
    alt Valid Credentials
        AS->>API: Generate session token
        API->>U: Return session token
    else Invalid Credentials
        AS->>API: Return error message
        API->>U: Return error message
    end
```

## Project Creation

### Mining Method Selection

1. The user selects the option to create a new project.
2. The API Layer presents the user with a list of available mining methods.
3. The user selects a mining method from the list.
4. The API Layer forwards the selection to the Service Layer.
5. The Service Layer retrieves the details of the selected mining method from the Data Access Layer.
6. The Data Access Layer queries the Database System for the mining method information.
7. The Database System returns the mining method details to the Data Access Layer.
8. The Data Access Layer sends the mining method details back to the Service Layer.
9. The Service Layer returns the mining method details to the API Layer.
10. The API Layer displays the mining method details to the user for confirmation.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant S as Service Layer
    participant D as Data Access Layer

    U->>API: Select mining method
    API->>S: Forward selection
    S->>D: Retrieve available methods
    D-->>S: Return methods
    S-->>API: Return methods
    API->>U: Display methods
    U->>API: Confirm selection
    API->>S: Forward confirmation
    S->>D: Store selected method
    D-->>S: Acknowledge storage
```

## Scenario Creation

### Default Business Scenario

1. The user selects the option to create a default business scenario.
2. The API Layer receives the request and forwards it to the Service Layer.
3. The Service Layer initiates the creation of a default scenario in the Data Access Layer.
4. The Data Access Layer creates the default scenario in the Database System.
5. The Database System acknowledges the creation of the scenario to the Data Access Layer.
6. The Data Access Layer confirms the scenario creation to the Service Layer.
7. The Service Layer notifies the API Layer of the successful scenario creation.
8. The API Layer informs the user that the default business scenario has been successfully created.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant S as Service Layer
    participant D as Data Access Layer

    U->>API: Request default scenario creation
    API->>S: Forward request
    S->>D: Create default scenario
    D-->>S: Acknowledge creation
    S-->>API: Confirm scenario creation
    API->>U: Notify user of successful creation
```

## Parameter Configuration

1. The user navigates to the parameter configuration section.
2. The API Layer retrieves the current configuration parameters from the Service Layer.
3. The Service Layer requests the parameters from the Data Access Layer.
4. The Data Access Layer queries the Database System for the configuration parameters.
5. The Database System returns the configuration parameters to the Data Access Layer.
6. The Data Access Layer sends the parameters back to the Service Layer.
7. The Service Layer forwards the parameters to the API Layer.
8. The API Layer displays the current configuration parameters to the user.
9. The user modifies the desired parameters and submits the changes.
10. The API Layer forwards the updated parameters to the Service Layer.
11. The Service Layer updates the parameters in the Data Access Layer.
12. The Data Access Layer saves the updated parameters in the Database System.
13. The Database System acknowledges the update to the Data Access Layer.
14. The Data Access Layer confirms the update to the Service Layer.
15. The Service Layer notifies the API Layer of the successful parameter update.
16. The API Layer informs the user that the parameters have been successfully updated.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant S as Service Layer
    participant D as Data Access Layer
    participant DB as Database System

    U->>API: Request current parameters
    API->>S: Forward request
    S->>D: Retrieve parameters
    D->>DB: Query parameters
    DB-->>D: Return parameters
    D-->>S: Send parameters
    S-->>API: Forward parameters
    API->>U: Display parameters
    U->>API: Submit updated parameters
    API->>S: Forward updates
    S->>D: Update parameters
    D->>DB: Save updated parameters
    DB-->>D: Acknowledge update
    D-->>S: Confirm update
    S-->>API: Notify successful update
    API->>U: Inform user of success
```

## Basic Accounting Setup

1. The user accesses the basic accounting setup section.
2. The API Layer retrieves the current accounting settings from the Service Layer.
3. The Service Layer requests the settings from the Data Access Layer.
4. The Data Access Layer queries the Database System for the accounting settings.
5. The Database System returns the accounting settings to the Data Access Layer.
6. The Data Access Layer sends the settings back to the Service Layer.
7. The Service Layer forwards the settings to the API Layer.
8. The API Layer displays the current accounting settings to the user.
9. The user modifies the accounting settings and submits the changes.
10. The API Layer forwards the updated settings to the Service Layer.
11. The Service Layer updates the settings in the Data Access Layer.
12. The Data Access Layer saves the updated settings in the Database System.
13. The Database System acknowledges the update to the Data Access Layer.
14. The Data Access Layer confirms the update to the Service Layer.
15. The Service Layer notifies the API Layer of the successful accounting settings update.
16. The API Layer informs the user that the accounting settings have been successfully updated.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant S as Service Layer
    participant D as Data Access Layer
    participant DB as Database System

    U->>API: Request current accounting settings
    API->>S: Forward request
    S->>D: Retrieve settings
    D->>DB: Query settings
    DB-->>D: Return settings
    D-->>S: Send settings
    S-->>API: Forward settings
    API->>U: Display settings
    U->>API: Submit updated settings
    API->>S: Forward updates
    S->>D: Update settings
    D->>DB: Save updated settings
    DB-->>D: Acknowledge update
    D-->>S: Confirm update
    S-->>API: Notify successful update
    API->>U: Inform user of success
```

## Currency Setup

1. The user navigates to the currency setup section.
2. The API Layer retrieves the current currency settings from the Service Layer.
3. The Service Layer requests the settings from the Data Access Layer.
4. The Data Access Layer queries the Database System for the currency settings.
5. The Database System returns the currency settings to the Data Access Layer.
6. The Data Access Layer sends the settings back to the Service Layer.
7. The Service Layer forwards the settings to the API Layer.
8. The API Layer displays the current currency settings to the user.
9. The user modifies the currency settings and submits the changes.
10. The API Layer forwards the updated settings to the Service Layer.
11. The Service Layer updates the settings in the Data Access Layer.
12. The Data Access Layer saves the updated settings in the Database System.
13. The Database System acknowledges the update to the Data Access Layer.
14. The Data Access Layer confirms the update to the Service Layer.
15. The Service Layer notifies the API Layer of the successful currency settings update.
16. The API Layer informs the user that the currency settings have been successfully updated.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant S as Service Layer
    participant D as Data Access Layer
    participant DB as Database System

    U->>API: Request current currency settings
    API->>S: Forward request
    S->>D: Retrieve settings
    D->>DB: Query settings
    DB-->>D: Return settings
    D-->>S: Send settings
    S-->>API: Forward settings
    API->>U: Display settings
    U->>API: Submit updated settings
    API->>S: Forward updates
    S->>D: Update settings
    D->>DB: Save updated settings
    DB-->>D: Acknowledge update
    D-->>S: Confirm update
    S-->>API: Notify successful update
    API->>U: Inform user of success
```

## Report Generation

1. The user selects the option to generate a report.
2. The API Layer receives the report generation request and forwards it to the Reporting Module in the Service Layer.
3. The Reporting Module retrieves the necessary data from the Data Access Layer.
4. The Data Access Layer queries the Database System for the required data.
5. The Database System returns the data to the Data Access Layer.
6. The Data Access Layer sends the data back to the Reporting Module.
7. The Reporting Module processes the data and generates the report.
8. The Reporting Module returns the generated report to the API Layer.
9. The API Layer delivers the report to the user for download or viewing.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant S as Service Layer
    participant D as Data Access Layer
    participant DB as Database System

    U->>API: Request report generation
    API->>S: Forward request
    S->>D: Retrieve data for report
    D->>DB: Query data
    DB-->>D: Return data
    D-->>S: Send data
    S-->>API: Forward data
    API->>U: Display report
```

## User Management

1. The user navigates to the user management section.
2. The API Layer retrieves the list of users from the Service Layer.
3. The Service Layer requests the user list from the Data Access Layer.
4. The Data Access Layer queries the Database System for the user information.
5. The Database System returns the user information to the Data Access Layer.
6. The Data Access Layer sends the user information back to the Service Layer.
7. The Service Layer forwards the user information to the API Layer.
8. The API Layer displays the list of users to the administrator.
9. The administrator can add, modify, or delete users as needed.
10. The API Layer forwards any user management actions to the Service Layer.
11. The Service Layer processes the actions in the Data Access Layer.
12. The Data Access Layer updates the user information in the Database System.
13. The Database System acknowledges the updates to the Data Access Layer.
14. The Data Access Layer confirms the updates to the Service Layer.
15. The Service Layer notifies the API Layer of the successful user management actions.
16. The API Layer informs the administrator of the successful user management operations.

```mermaid
sequenceDiagram
    autonumber
    participant U as User
    participant API as API Layer
    participant S as Service Layer
    participant D as Data Access Layer
    participant DB as Database System

    U->>API: Request user information
    API->>S: Forward request
    S->>D: Retrieve user data
    D->>DB: Query user data
    DB-->>D: Return user data
    D-->>S: Send user data
    S-->>API: Forward user data
    API->>U: Display user information
    U->>API: Submit user management actions
    API->>S: Forward actions
    S->>D: Process user management actions
    D->>DB: Update user information
    DB-->>D: Acknowledge updates
    D-->>S: Confirm updates
    S-->>API: Notify successful actions
    API->>U: Inform user of success
```