update readme

Signed-off-by: Christoph Jerolimov <jerolimov+git@gmail.com>

Author: christoph-jerolimov

README.md

@@ -1,52 +1,64 @@
-# Some [RHDH](https://developers.redhat.com/rhdh) loadtest experiments 🧪
+# [RHDH](https://developers.redhat.com/rhdh) loadtests 🧪
 
-## Create instances with Helm
+This repository contains ArgoCD resources, Helm charts and other resources
+to setup different RHDH versions on Kubernetes with up to 200 dynamic (frontend) plugins
+and 50k catalog entities.
 
-To create all test instances at once (`rhdh-17`, `rhdh-18`, `rhdh-19`, `rhdh-110`, and `rhdh-next`) run
+Available versions: `rhdh-17`, `rhdh-18`, `rhdh-19`, `rhdh-110`, `rhdh-110-nfs`, and `rhdh-next`
+
+## Create test instances with Helm
+
+To create 1.9 and above:
 
 ```
 make install-all
 ```
 
+or for 1.7 up to 1.8:
+
+```
+make install-legacy
+```
+
 or for just one version use:
 
 ```
 cd helm/rhdh-110 && make install 
 ```
 
-## Create instances with Argo CD
+## Create test instances with Argo CD
 
-Start an OpenShift cluster with OpenShift GitOps operator.
-
-To create all test apps (currently 4) run:
+Start an OpenShift cluster with OpenShift GitOps operator. To create all test apps (currently 4) run:
 
 ```bash
 oc apply -f argocd/app-project.yaml
-oc apply -f argocd/app-of-apps.yaml
+oc apply -f argocd/app-of-default-apps.yaml   # for 1.9 and newer
+oc apply -f argocd/app-of-legacy-apps.yaml    # for 1.7 and 1.8
 ```
 
 or, without cloning:
 
 ```bash
 oc apply -f https://raw.githubusercontent.com/christoph-jerolimov/rhdh-loadtests/refs/heads/main/argocd/app-project.yaml
-oc apply -f https://raw.githubusercontent.com/christoph-jerolimov/rhdh-loadtests/refs/heads/main/argocd/app-of-apps.yaml
+oc apply -f https://raw.githubusercontent.com/christoph-jerolimov/rhdh-loadtests/refs/heads/main/argocd/app-of-default-apps.yaml
+oc apply -f https://raw.githubusercontent.com/christoph-jerolimov/rhdh-loadtests/refs/heads/main/argocd/app-of-legacy-apps.yaml
 ```
 
-Or apply just a single application (current available: `rhdh-17`, `rhdh-18`, `rhdh-19`, `rhdh-110`, and `rhdh-next`):
+Or create just a single application:
 
 ```bash
 oc apply -f argocd/app-project.yaml
-oc apply -f argocd/app-of-apps/rhdh-19.yaml
+oc apply -f argocd/default-apps/rhdh-110-nfs.yaml
 ```
 
 or, without cloning:
 
 ```bash
 oc apply -f https://raw.githubusercontent.com/christoph-jerolimov/rhdh-loadtests/refs/heads/main/argocd/app-project.yaml
-oc apply -f https://raw.githubusercontent.com/christoph-jerolimov/rhdh-loadtests/refs/heads/main/argocd/app-of-apps/rhdh-19.yaml
+oc apply -f https://raw.githubusercontent.com/christoph-jerolimov/rhdh-loadtests/refs/heads/main/argocd/default-apps/rhdh-110-nfs.yaml
 ```
 
-## Catalog entities
+## Test catalog entities
 
 Add and adjust the following catalog snippet into your `app-config.yaml`.
 
@@ -80,22 +92,24 @@ upstream:
               - allow: [Template]
 ```
 
-## Plugins
+## RBAC
+
+TODO
+
+## Dynamic Plugins (Example container images for different RHDH versions)
 
 The `plugins` folder contains multiple Backstage workspaces for different Backstage versions (1.42, 1.45 and 1.48).
 Each workspace contains currently two plugins.
 One that adds a new page to the main navigation and one that adds a new tab to the catalog details page.
 
-The script **TODO/WIP** build these plugin 100 times with indepenend `pluginIds` to integrate these plugins multiple times into RHDH.
+The scripts folder contains scripts to build these plugins 100 times with indepenend `pluginIds` to integrate these plugins multiple times into RHDH.
 
 They are published as one container image under [quay.io/jerolimov/rhdh-loadtest-plugins](https://quay.io/repository/jerolimov/rhdh-loadtest-plugins?tab=tags) with a tag for each combinaton. For example:
 
 * `quay.io/jerolimov/rhdh-loadtest-plugins:bs_1.42_page-n`
 * `quay.io/jerolimov/rhdh-loadtest-plugins:bs_1.42_catalog-tab-n`
 
-The Backstage version can be replaced with `bs_1.42`, `bs_1.45` or `bs_1.45`.
-
-**TODO/WIP**: The `-n` can be replaced with a 1 to 100.
+The Backstage version can be replaced with `bs_1.42`, `bs_1.45` or `bs_1.45` and the `-n` can be replaced with a 1 to 100 so that up to 200 dynamic (frontend) plugins can be loaded for each RHDH release.
 
 To integrate these into your local setup apply these RHDH dynamic plugin configurations:
 
@@ -154,6 +168,57 @@ global:
 
 You can pick up a complete example in [helm/rhdh-18/values.yaml](helm/rhdh-18/values.yaml).
 
-## RBAC
+## Load Generator
 
-TODO
+The `load-generator` directory contains a Playwright-based load generator that simulates user interactions with RHDH.
+
+It is not a replacement for dedicated performance testing — the goal is to produce reproducible, lightweight load tests that can run on smaller test environments.
+
+The test scenario (`guest-login-home-catalog.spec.ts`) runs a configurable number of loops (default: 100), each performing these steps:
+
+1. **Login** — Opens the RHDH instance and waits for the guest "Enter" button
+2. **Home** — Clicks "Enter" and verifies the home page loads (Welcome, Get started, Explore cards)
+3. **Catalog** — Navigates to the Catalog page and verifies all 1000 components are listed
+4. **Component** — Opens "Component 1" and verifies its details (About, Group 1, System 1, Catalog Tab 1)
+5. **Catalog Tab** — Clicks the "Catalog Tab 1" tab and verifies the plugin content loads
+6. **Page Plugin** — Navigates to "Page 1" via the sidebar and verifies the plugin page loads
+
+After the test completes, an analysis script (`scripts/analyse.mts`) parses the Playwright JSON report and prints per-step statistics (count, avg, p95, min, max).
+
+Example output:
+
+```
+Step                      Count        Avg        P95        Min        Max
+---------------------------------------------------------------------------
+login                       100     6661ms     7387ms     6194ms     8564ms
+home                        100     1419ms     1905ms     1087ms     1997ms
+catalog                     100     1361ms     1454ms     1011ms     1861ms
+component                   100      689ms      776ms      543ms     1214ms
+catalog-tab-n               100      982ms     1071ms      425ms     2054ms
+page-n                      100      982ms     1424ms      881ms     1916ms
+all                         100    12126ms    13590ms    10686ms    14515ms
+```
+
+### Run locally
+
+```shell
+cd load-generator
+npm install
+npm run install-browser
+export RHDH_URL=https://your-rhdh-instance.example.com
+npm test
+```
+
+### Run as a container
+
+```shell
+cd load-generator
+podman build . --tag load-generator
+podman run -e RHDH_URL=https://your-rhdh-instance.example.com load-generator
+```
+
+### Configuration
+
+| Environment variable | Description |
+|---|---|
+| `RHDH_URL` (or `PLAYWRIGHT_BASEURL`) | Base URL of the RHDH instance to test |