doc: Add agenda

Author: ArneLimburg

.github/workflows/build.yaml

@@ -3,8 +3,37 @@ on:
   push:
     branches: [ "**" ]
 jobs:
+  build-client:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: customer-client
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+          cache-dependency-path: customer-client/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check Prettier formatting
+        run: npm run format:check
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Build
+        run: npm run build
+
   build:
     runs-on: ubuntu-latest
+    needs: build-client
     steps:
       - name: Checkout
         uses: actions/checkout@v5
@@ -16,6 +45,21 @@ jobs:
           distribution: 'temurin'
           cache: maven
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+          cache-dependency-path: customer-client/package-lock.json
+
+      - name: Install customer-client dependencies
+        run: npm ci
+        working-directory: customer-client
+
+      - name: Build customer-client
+        run: npm run build
+        working-directory: customer-client
+
       - name: Build customer-service
         run: mvn clean package -f customer-service/pom.xml
 
@@ -34,5 +78,28 @@ jobs:
       - name: Start with Docker
         run: docker compose up -d
 
+      - name: Wait for customer-service
+        run: |
+          until curl -sf http://localhost:8181/customers/ > /dev/null; do
+            echo "Waiting for customer-service..."
+            sleep 2
+          done
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps chromium
+        working-directory: customer-client
+
+      - name: Run Playwright tests
+        run: npm run test
+        working-directory: customer-client
+
+      - name: Upload Playwright report
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: playwright-report
+          path: customer-client/playwright-report/
+
       - name: Stop Docker Containers
+        if: always()
         run: docker compose down

address-validation-service/Dockerfile

@@ -0,0 +1,17 @@
+FROM maven:3.9.9-eclipse-temurin-21 AS mvn
+
+WORKDIR /usr/src/online-shop
+COPY pom.xml ./
+RUN mvn package dependency:go-offline # cache dependencies
+COPY src ./src
+RUN mvn clean package meecrowave:bundle -Dservice.name=address-validation-service -Dmaven.test.skip=true -Dcheckstyle.skip=true
+
+FROM eclipse-temurin:21-jre
+
+RUN apt-get update -qq && apt-get install --no-install-recommends -qqy unzip && rm -rf /var/lib/apt/lists/*
+COPY --from=mvn /usr/src/online-shop/target/address-validation-service-meecrowave-distribution.zip /opt/address-validation-service.zip
+WORKDIR /opt
+RUN unzip address-validation-service.zip && rm address-validation-service.zip
+EXPOSE 8080
+
+ENTRYPOINT ["/opt/address-validation-service-distribution/bin/meecrowave.sh", "run"]

address-validation-service/pom.xml

@@ -40,9 +40,9 @@
             <scope>provided</scope>
         </dependency>
         <dependency>
-            <groupId>org.apache.geronimo.specs</groupId>
-            <artifactId>geronimo-validation_2.0_spec</artifactId>
-            <version>1.0</version>
+            <groupId>jakarta.validation</groupId>
+            <artifactId>jakarta.validation-api</artifactId>
+            <version>3.1.1</version>
         </dependency>
         <dependency>
             <groupId>org.eclipse.microprofile.config</groupId>

address-validation-service/src/main/java/de/openknowledge/sample/address/application/AddressResource.java

@@ -15,6 +15,9 @@
  */
 package de.openknowledge.sample.address.application;
 
+import static jakarta.ws.rs.core.HttpHeaders.ACCEPT_LANGUAGE;
+import static java.util.Locale.GERMANY;
+import static java.util.Optional.ofNullable;
 import static java.util.stream.Collectors.joining;
 
 import java.net.URI;

billing-service/Dockerfile

@@ -0,0 +1,17 @@
+FROM maven:3.9.9-eclipse-temurin-21 AS mvn
+
+WORKDIR /usr/src/online-shop
+COPY pom.xml ./
+RUN mvn package dependency:go-offline # cache dependencies
+COPY src ./src
+RUN mvn clean package meecrowave:bundle -Dservice.name=billing-service -Dmaven.test.skip=true -Dcheckstyle.skip=true
+
+FROM eclipse-temurin:21-jre
+
+RUN apt-get update -qq && apt-get install --no-install-recommends -qqy unzip && rm -rf /var/lib/apt/lists/*
+COPY --from=mvn /usr/src/online-shop/target/billing-service-meecrowave-distribution.zip /opt/billing-service.zip
+WORKDIR /opt
+RUN unzip billing-service.zip && rm billing-service.zip
+EXPOSE 8080
+
+ENTRYPOINT ["/opt/billing-service-distribution/bin/meecrowave.sh", "run"]

customer-client/.gitignore

@@ -0,0 +1,28 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Playwright
+playwright-report
+test-results
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

customer-client/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2
+}

customer-client/Dockerfile

@@ -0,0 +1,41 @@
+# Build Stage
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source code
+COPY . .
+
+# Build argument for API URL (can be overridden at build time)
+ARG VITE_API_URL=http://localhost:8181
+ENV VITE_API_URL=$VITE_API_URL
+
+# Build the application
+RUN npm run build
+
+# Production Stage
+FROM nginx:alpine
+
+# Copy built assets from builder stage
+COPY --from=builder /app/dist /usr/share/nginx/html
+
+# Copy nginx configuration for SPA routing
+RUN echo 'server { \
+    listen 80; \
+    server_name localhost; \
+    root /usr/share/nginx/html; \
+    index index.html; \
+    location / { \
+        try_files $uri $uri/ /index.html; \
+    } \
+}' > /etc/nginx/conf.d/default.conf
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]

customer-client/README-APP.md

@@ -0,0 +1,77 @@
+# Kundenpflege App
+
+Eine React-basierte Web-Applikation zur Kundenverwaltung mit Master-Detail-Ansicht.
+
+## Tech Stack
+
+- **React 19** - UI Framework
+- **TypeScript** - Type Safety
+- **Vite** - Build Tool
+- **Tanstack Query** - Server State Management
+- **Tanstack Table** - Tabellen-Komponente
+- **Tanstack Forms** - Formular-Management
+- **Zod** - Schema-Validierung
+- **React Router** - Client-seitiges Routing
+
+## Features
+
+- **Kundenliste (Master-Ansicht)**: Übersicht aller Kunden mit Sortierung
+- **Kundendetails (Detail-Ansicht)**: Detailansicht eines einzelnen Kunden
+- **Kunde anlegen**: Formular zum Erstellen neuer Kunden
+- **Adressen bearbeiten**: Rechnungs- und Lieferadresse hinzufügen/bearbeiten
+- **Validierung**: Client-seitige Validierung mit Zod
+
+## Voraussetzungen
+
+Das Backend (customer-service) muss auf `http://localhost:8080` laufen.
+
+## Installation & Start
+
+```bash
+# Dependencies installieren
+npm install
+
+# Entwicklungsserver starten
+npm run dev
+
+# Build für Produktion
+npm run build
+
+# Build-Preview
+npm run preview
+```
+
+## Umgebungsvariablen
+
+`.env` Datei:
+
+```
+VITE_API_URL=http://localhost:8080/api
+```
+
+## API-Endpunkte
+
+Die App nutzt folgende Backend-Endpunkte:
+
+- `GET /api/customers/` - Alle Kunden abrufen
+- `POST /api/customers/` - Neuen Kunden erstellen
+- `GET /api/customers/{customerNumber}` - Einzelnen Kunden abrufen
+- `PUT /api/customers/{customerNumber}/billing-address` - Rechnungsadresse aktualisieren
+- `PUT /api/customers/{customerNumber}/delivery-address` - Lieferadresse aktualisieren
+
+## Projektstruktur
+
+```
+src/
+├── api/              # API-Client und React Query Hooks
+├── components/       # Wiederverwendbare Komponenten (Formulare)
+├── pages/            # Seiten-Komponenten (Routen)
+├── types/            # TypeScript-Typen und Zod-Schemas
+├── App.tsx           # Haupt-App-Komponente mit Routing
+├── App.css           # Globale Styles
+└── main.tsx          # Entry Point
+```
+
+## Entwickelt mit
+
+Claude Code - AI-gestützte Entwicklung

customer-client/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+]);
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x';
+import reactDom from 'eslint-plugin-react-dom';
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+]);
+```