Fix review & put to docs (#31)

* Fix review & put to docs

* Copy be dex methods

* Regenerate oepn api

Author: dronbas

.github/workflows/openapi.yml

@@ -0,0 +1,25 @@
+name: OpenAPI drift guard
+
+on:
+  push:
+    branches:
+      - dev
+  pull_request:
+
+jobs:
+  drift:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - name: Regenerate openapi.yaml from Rust source
+        run: cargo run --quiet -p dodex-api --bin gen-openapi -- --out /tmp/openapi.yaml
+      - name: Diff against committed docs/openapi.yaml
+        run: |
+          if ! diff -u docs/openapi.yaml /tmp/openapi.yaml; then
+            echo
+            echo "docs/openapi.yaml is out of sync with services/api."
+            echo "Run openapi/generate.sh and commit the result."
+            exit 1
+          fi

.github/workflows/pages.yml

@@ -5,7 +5,7 @@ on:
     branches:
       - dev
     paths:
-      - 'openapi/**'
+      - 'docs/**'
       - '.github/workflows/pages.yml'
   workflow_dispatch:
 
@@ -32,6 +32,6 @@ jobs:
       - uses: actions/configure-pages@v5
       - uses: actions/upload-pages-artifact@v3
         with:
-          path: openapi
+          path: docs
       - id: deployment
         uses: actions/deploy-pages@v4