Merge pull request #317 from Benalex8797/feat/257

documentation

Author: Junirezz

.github/workflows/backend-governance.yml

@@ -33,4 +33,13 @@ jobs:
         run: npm ci
 
       - name: Run governance checks
-        run: npm run ci:governance
+        run: npm run ci:governance
+
+      - name: Verify OpenAPI documentation
+        run: |
+          npm run generate:openapi
+          if [ -n "$(git status --porcelain openapi.json)" ]; then
+            echo "❌ openapi.json is out of date. Run 'npm run generate:openapi' locally and commit the changes."
+            git diff openapi.json
+            exit 1
+          fi