TECH-131: New frontend generator and update redocly docs

.github/workflows/build.yml

@@ -0,0 +1,10 @@
+name: Maven Build Artifact
+
+on:
+  pull_request:
+    branches:
+      - '*'
+
+jobs:
+  build:
+    uses: valitydev/base-workflow/.github/workflows/maven-swag-build.yml@v1

.github/workflows/deploy.yml

@@ -0,0 +1,18 @@
+name: Maven Deploy Artifact
+
+on:
+  push:
+    branches:
+      - 'master'
+      - 'main'
+
+jobs:
+  deploy:
+    uses: valitydev/base-workflow/.github/workflows/maven-swag-deploy.yml@v1
+    secrets:
+      server-username: ${{ secrets.OSSRH_USERNAME }}
+      server-password: ${{ secrets.OSSRH_TOKEN }}
+      deploy-secret-key: ${{ secrets.OSSRH_GPG_SECRET_KEY }}
+      deploy-secret-key-password: ${{ secrets.OSSRH_GPG_SECRET_KEY_PASSWORD }}
+      github-token: ${{ secrets.GITHUB_TOKEN }}
+      mm-webhook-url: ${{ secrets.MATTERMOST_WEBHOOK_URL }}

.github/workflows/frontend-pr.yml

@@ -0,0 +1,22 @@
+name: 'Frontend: PR'
+
+on:
+  pull_request:
+    branches: ['*']
+
+jobs:
+  configured:
+    uses: valitydev/action-frontend/.github/workflows/[email protected]
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    needs: configured
+    if: needs.configured.outputs.exists == 'true'
+    steps:
+      - uses: actions/checkout@v3
+      - uses: valitydev/action-frontend/[email protected]
+      - run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Codegen
+        run: npm run codegen

.github/workflows/frontend-publish.yml

@@ -0,0 +1,26 @@
+name: 'Frontend: Publish'
+
+on:
+  push:
+    branches: ['master', 'main']
+
+jobs:
+  configured:
+    uses: valitydev/action-frontend/.github/workflows/[email protected]
+  publish:
+    name: Publish
+    runs-on: ubuntu-latest
+    needs: configured
+    if: needs.configured.outputs.exists == 'true'
+    steps:
+      - uses: actions/checkout@v3
+      - uses: valitydev/action-frontend/[email protected]
+      - run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Codegen
+        run: npm run codegen
+      - uses: valitydev/action-frontend/[email protected]
+        with:
+          npm-token: ${{ secrets.NPM_TOKEN }}
+          directory: ./lib

.github/workflows/gh-pages.yml

@@ -0,0 +1,19 @@
+name: Github Pages
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+      - run: npm install
+      - run: npm run build
+      - name: Publish Redocly on Github Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./web_deploy

.gitignore

@@ -58,3 +58,8 @@ web_deploy/
 # Gradle:
 .idea/gradle.xml
 .idea/libraries
+
+# Frontend
+/lib
+/vality-openapi
+openapitools.json

.redocly.yaml

@@ -1,18 +1,7 @@
-# See https://docs.redoc.ly/cli/configuration/ for more information.
-apiDefinitions:
-  core: "openapi/openapi.yaml"
-lint:
-  plugins:
-    - './plugins/local.js'
-  extends:
-    - recommended
-  rules:
-    tag-description: off
-  preprocessors:
-    local/merge-schemas: on
-referenceDocs:
-  showConsole: true
-  layout:
-    scope: section
-  routingStrategy: browser
-  htmlTemplate: ./web/index.html
+# See https://redocly.com/docs/cli/configuration/ for more information.
+apis:
+  core:
+    root: openapi/openapi.yaml
+
+extends:
+  - ./node_modules/@vality/redocly-utils/lib/config.yaml

openapi/components/schemas/Organization.yaml

@@ -26,8 +26,7 @@ properties:
       - $ref: './UserId.yaml'
   party:
     description: |
-      Идентификатор [участника](https://developer.rbk.money/api/#tag/Parties), которым заведует
-      данная организация
+      Идентификатор участника, которым заведует данная организация
     type: string
     minLength: 1
     maxLength: 40

openapi/components/schemas/RoleId.yaml

@@ -1,7 +1,5 @@
-description: Идентификатор роли
+description: |
+  Идентификатор роли. 
+  Актуальный список идентификаторов [здесь](https://github.com/valitydev/bouncer-policies/blob/master/policies/service/authz/roles/data.yaml)
 type: string
-enum:
-  - Administrator
-  - Accountant
-  - Integrator
-  - Manager
+example: Manager

openapi/components/security-schemes/Bearer.yaml

@@ -10,5 +10,4 @@ description: >
   ```
 
   Запросы к данному API авторизуются сессионным токеном доступа,
-  который вы получаете в результате аутентификации в личном кабинете
-  по адресу https://dashboard.rbk.money/.
+  который вы получаете в результате аутентификации в личном кабинете.

openapi/docs/api.md

@@ -1,4 +1,4 @@
-RBKmoney Organizations API является интерфейсом для управления различными
+Organizations API является интерфейсом для управления различными
 аспектами вашей организации. Все изменения состояния организации, будь то
 приглашение новых сотрудников, добавление ролей уже существующим сотрудникам
 или настройка области их ответственности осуществляются с помощью вызовов

openapi/openapi.yaml

@@ -1,14 +1,9 @@
 openapi: 3.0.3
 info:
   version: 1.0.0
-  title: RBKmoney Organizations API
+  title: Organizations API
   description:
     $ref: './docs/api.md'
-  termsOfService: 'https://rbk.money/'
-  contact:
-    name: RBKmoney Support Team
-    email: [email protected]
-    url: 'https://developer.rbk.money'
   license:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
@@ -54,8 +49,6 @@ paths:
     $ref: ./paths/invitations.yaml
   /orgs/{orgId}/invitations/{invitationId}:
     $ref: ./paths/invitation.yaml
-servers:
-  - url: 'https://api.rbk.money/org/v1'
 components:
   securitySchemes:
     bearer:

openapi/paths/membership.yaml

@@ -47,7 +47,7 @@ post:
           schema:
             type: string
             format: uri
-            example: 'https://api.rbk.money/org/v1/user/membership/or_af9e76uc5b47h8b154.19b8xa61dc94'
+            example: '/org/v1/user/membership/or_af9e76uc5b47h8b154.19b8xa61dc94'
     '422':
       description: Невозможно совершить операцию
       content: