Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release/v0.4.6: Documentation links fixed #10

Merged
merged 6 commits into from
Mar 1, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,13 @@ The changelog format is based on [Keep a Changelog](https://keepachangelog.com/e

## [released]

## [0.4.6] - 2023-03-01

## Updated
- Updated documentation, corrected links.

## [released]

## [0.4.5] - 2023-02-28

# Security Issues
Expand Down
2 changes: 1 addition & 1 deletion DEPENDENCIES_BACKEND
Original file line number Diff line number Diff line change
Expand Up @@ -128,4 +128,4 @@ maven/mavencentral/org.springframework/spring-webflux/6.0.4, Apache-2.0, approve
maven/mavencentral/org.springframework/spring-webmvc/6.0.4, Apache-2.0, approved, #5944
maven/mavencentral/org.webjars/swagger-ui/4.15.5, Apache-2.0 AND MIT, approved, #5921
maven/mavencentral/org.webjars/webjars-locator-core/0.52, MIT, approved, clearlydefined
maven/mavencentral/org.yaml/snakeyaml/2.0, , restricted, clearlydefined
maven/mavencentral/org.yaml/snakeyaml/2.0, Apache-2.0 AND (Apache-2.0 AND BSD-3-Clause AND EPL-1.0 AND GPL-2.0-or-later AND LGPL-2.1-or-later), restricted, #7275
Copy link
Contributor Author

@matbmoser matbmoser Mar 1, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added the ticket with the new library version IP revision

34 changes: 16 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,20 +29,20 @@ To get Started you can have a look into our documentation:

| Name | Description |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Arc42](\docs\arc42\Arc42.md) | Arc42 of Digital Product Pass |
| [Administration Guide](\docs\admin%20guide\Admin_Guide.md) | Backend documentation Product Passport App |
| [Backend Documentation](\consumer-backend\productpass\readme.md) | Backend documentation Product Passport App |
| [Deployment in Hotel Budapest](\deployment\README.md) | Technical Guide - Deployment in ArgoCD Hotel Budapest (integration environment) |
| [Docker Overview](\docker\README.md) | Overview on general docker commands |
| [Keycloak Overview](\docker\local\Keycloak\README.md) | This guide describes how to setup a keycloak instance in local docker container and import existing realm.json file. |
| [Short Introduction into the project](\docs\GETTING-STARTED.md) | Battery Pass Allpication infrastructure, installation guide, technical usage guide |
| [Code Scaning with Kics and Trivy](\docs\IaC.md) | Infrastructure As Code (IaC) with KICS intends to find security vulnerabilities by scanning the code and upload results to the security dashboard in github |
| [Release Guideance](\docs\RELEASE.md) | Product Battery Pass Consumer App Release Guide |
| [Secret Management](\docs\SECRETS-MANAGEMENT.md) | Secrets management with CX HashiCorp Vault and ArgoCD Vault Plugin (AVP) - client credentials, database passwords, access tokens |
| [Cypress Overview](\docs\cypress\CYPRESS.md) | Documentation for Battery Passport App E2E Cypress test |
| [End User Manual](\User%20Manual%20Product%20Viewer%20App.md) | Enduser Manual Product Viewer App |
| [Postman Overview](\postman\README.md) | Technical guide depicts the battery pass end-to-end API calls through the postman REST client |
| [Changelog](\CHANGELOG.md) | Changelog |
| [Arc42](./docs/arc42/Arc42.md) | Arc42 of Digital Product Pass |
| [Administration Guide](./docs/admin%20guide/Admin_Guide.md) | Backend documentation Product Passport App |
| [Backend Documentation](./consumer-backend/productpass/readme.md) | Backend documentation Product Passport App |
| [Deployment in Hotel Budapest](./deployment/README.md) | Technical Guide - Deployment in ArgoCD Hotel Budapest (integration environment) |
| [Docker Overview](./docker/README.md) | Overview on general docker commands |
| [Keycloak Overview](./docker/local/Keycloak/README.md) | This guide describes how to setup a keycloak instance in local docker container and import existing realm.json file. |
| [Short Introduction into the project](./docs/GETTING-STARTED.md) | Battery Pass Allpication infrastructure, installation guide, technical usage guide |
| [Code Scaning with Kics and Trivy](./docs/IaC.md) | Infrastructure As Code (IaC) with KICS intends to find security vulnerabilities by scanning the code and upload results to the security dashboard in github |
| [Release Guideance](./docs/RELEASE.md) | Product Battery Pass Consumer App Release Guide |
| [Secret Management](./docs/SECRETS-MANAGEMENT.md) | Secrets management with CX HashiCorp Vault and ArgoCD Vault Plugin (AVP) - client credentials, database passwords, access tokens |
| [Cypress Overview](./docs/cypress/CYPRESS.md) | Documentation for Battery Passport App E2E Cypress test |
| [End User Manual](./docs/user%20manual/User%20Manual%20Product%20Viewer%20App.md) | End User Manual Product Viewer App |
| [Postman Overview](./postman/README.md) | Technical guide depicts the battery pass end-to-end API calls through the postman REST client |
| [Changelog](./CHANGELOG.md) | Changelog |

### Prerequisites:

Expand All @@ -63,7 +63,7 @@ git clone https://github.com/eclipse-tractusx/digital-product-pass.git
### Install dependencies

```bash
cd product-battery-passport-consumer-app/
cd digital-product-pass/
npm install --legacy-peer-deps
```

Expand Down Expand Up @@ -101,8 +101,6 @@ docker stop consumer-ui; docker rm consumer-ui;
```
You can run the application in docker container with existing image from GitHub packages.

See consumer frontend docker image in registry: [consumer-ui](https://github.com/eclipse-tractusx/digital-product-pass/pkgs/container/product-battery-passport-consumer-app%2Fconsumer-ui)

```bash
# pull the image
# Replace placeholder <LATEST_TAG> with the most recent tag in registry
Expand All @@ -118,7 +116,7 @@ The consumer frontend is available in browser at [http://localhost:8080](http://

### How to set up a code editor

See [VSCode configuration](https://confluence.catena-x.net/pages/viewpage.action?pageId=55009683).
See [VSCode configuration](https://code.visualstudio.com/docs/getstarted/settings).

## License

Expand Down
4 changes: 2 additions & 2 deletions charts/consumer-backend/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,10 @@ type: application
# This is the chart version. This version number should be incremented each time you make changes
# to the chart and its templates, including the app version.
# Versions are expected to follow Semantic Versioning (https://semver.org/)
version: 0.2.4
version: 0.2.5

# This is the version number of the application being deployed. This version number should be
# incremented each time you make changes to the application. Versions are not expected to
# follow Semantic Versioning. They should reflect the version the application is using.
# It is recommended to use it with quotes.
appVersion: "0.4.5"
appVersion: "0.4.6"
4 changes: 2 additions & 2 deletions charts/consumer-ui/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,10 @@ type: application
# This is the chart version. This version number should be incremented each time you make changes
# to the chart and its templates, including the app version.
# Versions are expected to follow Semantic Versioning (https://semver.org/)
version: 0.2.4
version: 0.2.5

# This is the version number of the application being deployed. This version number should be
# incremented each time you make changes to the application. Versions are not expected to
# follow Semantic Versioning. They should reflect the version the application is using.
# It is recommended to use it with quotes.
appVersion: "0.4.5"
appVersion: "0.4.6"
37 changes: 22 additions & 15 deletions deployment/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
## Technical Guide - Deployment in ArgoCD Hotel Budapest


> [Getting Started Documentation](getting-started.md)
> [Getting Started Documentation](../docs/GETTING-STARTED.md)

This document describes the battery pass application deployment steps in hotel budapest using helm charts. In order to deploy the app components, the following artifacts are required.

Expand All @@ -27,8 +27,9 @@ This document describes the battery pass application deployment steps in hotel b

- [edc-provider](./helm/edc-provider)

- [consumer-ui](./helm/consumer-ui)
- [consumer-ui](../charts/consumer-ui)

- [consumer-backend](../charts/consumer-backend)

#### Sign in via the GitHub account

Expand All @@ -40,30 +41,34 @@ Create new app from the top-left corner button.
Fill out the following required fields.
- **Application Name:** <APP_NAME> (e.g., materialpass-edc)
- **Project:** project-material-pass
- **Source:** Git repository where the application artifacts are stored (https://github.com/catenax-ng/product-battery-passport-consumer-app)
- **Source:** Git repository where the application artifacts are stored (https://github.com/eclipse-tractusx/digital-product-pass)
- **Revision:** select branch or a tag
- **Path:** The path to the deployment (possible values: deployment/helm/edc-consumer, deployment/helm/edc-provider, deployment/helm/consumer-ui)
- **Path:** The path to the deployment (possible values: deployment/helm/edc-consumer, deployment/helm/edc-provider, charts/consumer-ui, charts/consumer-backend)
- **Cluster URL:** https://kubernetes.default.svc
- **Namespace:** product-material-pass
- **Plugin:** argocd-vault-plugin-helm-args
- set ENV as ***helm_args : --set image.tag='$ARGOCD_APP_REVISION'***
- Set following helm args with the corresponding application:
- consumer-ui: set ENV as ***helm_args = --set productpass.backend=true -f values.yaml -f values-int.yaml'***
- consumer-backend: set ENV as ***helm_args = -f values.yaml -f values-int.yaml'***
- edc-consumer: set ENV as ***helm_args = -f values-int.yaml'***
- edc-consumer: set ENV as ***helm_args = -f values-int.yaml'***

Click on 'Create' button

![Create New App](./images/create_application_with_vault_plugin.png)
![Create New App](./images/create-app-with-vault-plugin.png)

- Go inside the application and sync it. It would take some time to get synced.

![Sync App](./images/app_sync.png)
![Sync App](./images/sync-app.png)

![Sync App](./images/pod_sync.png)
![Sync App](./images/pod-sync.png)

- Navigate inside the pod

![Consumer Pod](./images/consumer-ui_pod.png)
![Consumer Pod](./images/pod-consumer-ui.png)
- Go to the logs tab

![Consumer connector logs](./images/logs.png)
![Consumer connector logs](./images/consumer-ui-logs.png)

If everything works fine then the application is deployed...

Expand All @@ -75,18 +80,20 @@ In the end, the frontend should be accessible at https://materialpass.int.demo.c

##### Login credentails:
- **Company Selection:** CX-Test-Access
- **User 1:** Role: OEM, user: company 1 user, Password: changeme
- **User 1:** Role: Dismantler, user: company 1 user, Password: changeme
- **User 2:** Role: Recycler, user: company 2 user, Password: changeme

#### Example Screenshots:

![Login Page](./images/cx_login.png)
![Company Selection Page](./images/company-selection.png)

![QR Code Scanner](./images/qr_code_scanner.png)
![Login Page](./images/login.png)

![Dashboard](./images/dashboard.png)
![QR Code Scanner](./images/qr-code-scanner.png)

![Battery Passport](./images/battery_pass.png)
![Dashboard](./images/battery-pass-dashboard.png)

![Battery Passport](./images/battery-pass.png)

<br />

Expand Down
Binary file removed deployment/images/app_sync.png
Binary file not shown.
Binary file added deployment/images/battery-pass-dashboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added deployment/images/battery-pass.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed deployment/images/battery_pass.png
Binary file not shown.
Binary file added deployment/images/company-selection.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added deployment/images/consumer-ui-logs.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed deployment/images/consumer-ui_pod.png
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file removed deployment/images/cx_login.png
Binary file not shown.
Binary file removed deployment/images/dashboard.png
Binary file not shown.
Binary file added deployment/images/login.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed deployment/images/logs.png
Binary file not shown.
Binary file added deployment/images/pod-consumer-ui.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added deployment/images/pod-sync.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed deployment/images/pod_sync.png
Binary file not shown.
Binary file added deployment/images/qr-code-scanner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed deployment/images/qr_code_scanner.png
Binary file not shown.
Binary file added deployment/images/sync-app.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@

## Release an application

The application is released through [GitHub Releases page](https://github.com/catenax-ng/product-battery-passport-consumer-app/releases) by creating a new release and tag. Follow the [Semantic Versioning Scheme](https://semver.org/spec/v2.0.0.html) while creating a new tag.
The application is released through [GitHub Releases page](https://github.com/eclipse-tractusx/digital-product-pass/releases) by creating a new release and tag. Follow the [Semantic Versioning Scheme](https://semver.org/spec/v2.0.0.html) while creating a new tag.


The changelog must also be updated from [CHANGELOG.md](../CHANGELOG.md) file, showing the changes in release using [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format.
Expand Down
15 changes: 10 additions & 5 deletions docs/RELEASE_USER.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,21 +16,26 @@

# Release Notes Digital Product Pass Application

**February 28 (initial release, version 0.4.5)**

**March 01 2023 (Version 0.4.6)**
*01.03.2023*

### Updated
Updated documentation issues, fixing incorrect structure.

**February 28 2023 (Version 0.4.5)**
*28.02.2023*

## Security Issues
### Security Issues
Updated security issues related with a library.

**February 27 (initial release, version 0.4.4)**
**February 27 2023 (Initial Release, Version 0.4.4)**
*27.02.2023*

Welcome to the inital release of the **Product Pass App**. Here is an overview on the applications features.

Here is what's new in **Version 0.4.4:**

- [Added](#added)

## Added

### Request product information
Expand Down
Loading