Improved build and deployment scripts

Author: benvangameren

.github/workflows/deploy-pages.yml

@@ -21,7 +21,7 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  build:
+  build-docs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -36,27 +36,40 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Build OpenAPI Modules
-        run: npm run build:ocpi:2.2.1 && npm run build:ocpi:2.3.0
+      - name: Build OCPI 2.2.1
+        run: npm run build:ocpi:2.2.1
 
-      - name: Build OpenAPI Roles
-        run: npm run build:ocpi:cpo:2.2.1 && npm run build:ocpi:msp:2.2.1 && npm run build:ocpi:hub:2.2.1 && npm run build:ocpi:cpo:2.3.0 && npm run build:ocpi:msp:2.3.0 && npm run build:ocpi:hub:2.3.0
+      - name: Build OCPI 2.3.0
+        run: npm run build:ocpi:2.3.0
 
-      - name: Copy index page
-        run: mkdir -p dist/ocpi/2.2.1 dist/ocpi/2.3.0 && cp ocpi/2.2.1/index.html dist/ocpi/2.2.1/index.html && cp ocpi/2.3.0/index.html dist/ocpi/2.3.0/index.html
-
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v4
         with:
+          name: docs-artifact
           path: dist
+          if-no-files-found: error
 
   deploy:
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
-    needs: build
+    needs: [build-docs]
     steps:
+      - name: Download docs artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: docs-artifact
+          path: dist
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

docs/OCPI-2.3.0.pdf

@@ -0,0 +1,81 @@
+{
+  "modules": {
+    "credentials": {
+      "label": "Credentials",
+      "description": "Credential exchange and registration.",
+      "interfaces": ["interface"]
+    },
+    "versions": {
+      "label": "Versions",
+      "description": "Version discovery and information.",
+      "interfaces": ["interface"]
+    },
+    "cdrs": {
+      "label": "CDRs",
+      "description": "Charge Detail Records.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    },
+    "chargingprofiles": {
+      "label": "ChargingProfiles",
+      "description": "Smart charging profiles.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    },
+    "commands": {
+      "label": "Commands",
+      "description": "Remote start/stop, reservations, unlock, etc.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    },
+    "hubclientinfo": {
+      "label": "HubClientInfo",
+      "description": "Hub connectivity information.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    },
+    "locations": {
+      "label": "Locations",
+      "description": "Locations, EVSEs and connectors.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    },
+    "sessions": {
+      "label": "Sessions",
+      "description": "Sessions and charging preferences.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    },
+    "tariffs": {
+      "label": "Tariffs",
+      "description": "Tariffs and price components.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    },
+    "tokens": {
+      "label": "Tokens",
+      "description": "Tokens and real-time authorization.",
+      "interfaces": ["sender-interface", "receiver-interface"]
+    }
+  },
+  "roles": {
+    "cpo": [
+      "credentials/interface",
+      "versions/interface",
+      "locations/sender-interface",
+      "sessions/sender-interface",
+      "cdrs/sender-interface",
+      "tariffs/sender-interface",
+      "tokens/receiver-interface",
+      "commands/receiver-interface",
+      "chargingprofiles/receiver-interface"
+    ],
+    "msp": [
+      "credentials/interface",
+      "versions/interface",
+      "locations/receiver-interface",
+      "sessions/receiver-interface",
+      "cdrs/receiver-interface",
+      "tariffs/receiver-interface",
+      "tokens/sender-interface",
+      "commands/sender-interface",
+      "chargingprofiles/sender-interface"
+    ],
+    "hub": [
+      "hubclientinfo/sender-interface"
+    ]
+  }
+}