{"id":20471595,"url":"https://github.com/backbase/boat-bay","last_synced_at":"2025-04-13T11:08:08.547Z","repository":{"id":43339598,"uuid":"323276205","full_name":"Backbase/boat-bay","owner":"Backbase","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-02T22:56:08.000Z","size":4064,"stargazers_count":4,"open_issues_count":3,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-13T11:08:03.396Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Backbase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-21T08:33:31.000Z","updated_at":"2025-01-02T22:56:12.000Z","dependencies_parsed_at":"2022-09-10T08:11:15.237Z","dependency_job_id":null,"html_url":"https://github.com/Backbase/boat-bay","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Backbase%2Fboat-bay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Backbase%2Fboat-bay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Backbase%2Fboat-bay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Backbase%2Fboat-bay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Backbase","download_url":"https://codeload.github.com/Backbase/boat-bay/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248703198,"owners_count":21148118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-15T14:16:40.765Z","updated_at":"2025-04-13T11:08:08.510Z","avatar_url":"https://github.com/Backbase.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Boat Bay\n\n---\n\n## Using and running Boat Bay\n\n### Intro\n\nBoat Bay allows for the management of products specs. This documentation will explain how to\nconfigure the application and how to use it effectively.\n### Bootstrap file\n\nThe bootstrap file loads the configured sources when you run the application. It specifies the following:\n- The sources your specs come from.\n- How to search the sources for specs.\n- How to process the specs.\n- Portal definitions.\n- Portal rule configurations.\n\nStart by creating a `bootstrap.yaml` file. This will\nmost likely be located in a with the specifications\nthat are to be used with Boat Bay.\n\nThe following example shows a typical `bootstrap.yaml` configuration, with definitions for `portals`, `sources`, `dashboard` \nand `specTypes`:\n```yaml\nportals:\n  - key: \"repo\"\n    name: \"repo.example.com\"\n    lintRules:\n      - ruleId: 150\n      - ruleId: B001\n      - ruleId: B002\n      - ruleId: B003\n      - ruleId: B004\n      - ruleId: B005\n      - ruleId: B006\n      - ruleId: B007\n      - ruleId: B008\n      - ruleId: B009\n      - ruleId: B010\n      - ruleId: M0012\nsources:\n  - name: repo.example.com - PetStore\n    baseUrl: https://repo.example.com/\n    type: FILESYSTEM\n    active: true\n    filterArtifactsName: \"*.yaml\"\n    sourcePaths:\n      - name:  /petstore/\n    username: {username}\n    password: {password}\n    cronExpression: 0 0 13 * * *\n    capabilityKeySpEL: sourcePath.substring(0, sourcePath.indexOf('/'))\n    capabilityNameSpEL: sourcePath.substring(0, sourcePath.indexOf('/'))\n    serviceKeySpEL: sourceName.substring(0, sourceName.lastIndexOf('-')).replaceAll('-([a-z]*?)-api', '').replaceAll('-integration([-a-z]*)', '')\n    serviceNameSpEL: sourceName.substring(0, sourceName.lastIndexOf('-')).replaceAll('-([a-z]*?)-api', '').replaceAll('-integration([-a-z]*)', '')\n    specKeySpEL: sourceName.substring(0, sourceName.lastIndexOf('-'))\n    specFilterSpEL: sourcePath.contains('common-types') || sourcePath.substring(1, sourcePath.indexOf('/', 1)).contains('integration') ||  sourcePath.substring(1, sourcePath.indexOf('/', 1)).contains('persistence')\n    productReleaseKeySpEL: info.name.replaceAll('-api.zip', '')\n    productReleaseVersionSpEL: info.name.replaceAll('banking-services-bom-', '').replaceAll('-api.zip', '')\n    productReleaseNameSpEL: info.name.replaceAll('-api.zip', '')\n    overwriteChanges: false\n    runOnStartup: true\n    itemLimit: 5\n    portal:\n      key: \"repo\"\n    product:\n      key: \"pet-store\"\n      name: \"Pet Store\"\n      jiraProjectId: 23098\ndashboard:\n  name: OpenAPI Quality Dashboard\n  defaultPortal:\n    key: \"repo\"\n\nspecTypes:\n  - name: Client API\n    matchSpEL: sourceName.contains('client-api')\n    icon: public\n  - name: Service API\n    matchSpEL: sourceName.contains('service-api')\n    icon: public_off\n  - name: Integration Inbound\n    matchSpEL: sourceName.contains('inbound')\n    icon: input\n  - name: Integration Outbound\n    matchSpEL: sourceName.contains('outbound')\n    icon: outbound\n  - name: Integration Pull\n    matchSpEL: sourceName.contains('pull')\n    icon: swap_vert\n  - name: Integration\n    matchSpEL: sourceName.contains('integration-api')\n    icon: import_export\n  - name: Persistence\n    matchSpEL: sourceName.contains('persistence') || sourceName.contains('pandp')\n    icon: storage\n\n\n\n```\nReplace `{username}` and `{password}` with your own repo credentials.\n\nThe fields in the source section are as follows:\n\n  - `name`:\n        the name of your source\n  - `baseUrl`:\n        the base URL that will be used for your specs\n  - `type`:\n        describes where your source comes from: file system, jfrog, or Boat Maven plugin\n  - `active`:\n        boolean indicating state of activity\n  - `filterArtifactsName`:\n        filters the artifacts you wish to scan for specs, for example, what type of file ending, yaml, json, yml\n  -`sourcePaths`:\n        a list of the parent directories for each capability under the product defined in this source\n  - `name`:\n        /{capability_name}/\n  - `username`:\n        the username of the user accessing the repo. This can change depending on the repo configured for this source.\n  - `password`:\n        the password of the user accessing the repo. This is the password/key you use to access the repo configured in \n        the source. Typically encrypted.\n  - `cronExpression`:\n        schedule for scanning the source for updates and changes\n  - `capabilityKeySpEL`:\n        Spring Expression Language (SpEL) expression to generate capability names\n  - `capabilityNameSpEL`:\n        SpEL expression to generate the capability names\n  - `serviceKeySpEL`:\n        SpEL expression to generate the service keys\n  - `serviceNameSpEL`:\n        SpEL expression to generate the service names\n  - `specFilterSpEL`:\n        SpEL expression to filtering specifications\n  - `specKeySpEL`:\n        SpEL expression to generating the spec keys\n  - `overwriteChanges`:\n        `boolean`,if set to `true` then overwrites changes to existing specs, if `false` a new spec is created\n  - `runOnStartup`:\n        `boolean`, if set to `true` then specs are scanned from this source upon starting the application\n  - `portal`:\n       - `key`:\n            key for this source's portal\n       - `name`:\n            name for this source's portal\n  - `product`\n       - `key`:\n            key for this product\n       - `name`:\n            name for this product\n\nDefine the `portals` used in the sources where indicated in the example.\n\n### Building\n\nRun `mvn clean install` in project root.\nIt is likely that some heap space issues will arise, in this case increase memory size.\n\n### Running locally\n\nTo run the application add the following parameters to your run configuration :\n\n- name: `backbase.bootstrap.file` value: location of the bootstrap.yaml file described in [Bootstrap File](#bootstrap-file).\n- name: `boat.scheduler.source.scanner.enabled value`: `true`\n\nTo find out how to run front end go to [boat-bay-frontend](boat-bay-frontend/README.md).\n#### Resetting database\n\nAdd the following properties to your run configuration:\n- spring.liquibase.clear-checksums\n- spring.liquibase.drop-first\n\nSet both to `true` and select them during run when you wish to reset the database.\n\n### Using\n\n#### Uploading a spec\n\nA spec can be uploaded through [boat-maven-plugin](https://github.com/Backbase/backbase-openapi-tools).  \nBefore a spec can be uploaded a source must be set-up. This\ncan be done as shown in the [Bootstrap](#bootstrap-file) file section.\nThe plugin configuration will look like example below:\n\n```xml\n    \u003cbuild\u003e\n        \u003cplugins\u003e\n            \u003cplugin\u003e\n                \u003cgroupId\u003ecom.backbase.oss\u003c/groupId\u003e\n                \u003cartifactId\u003eboat-maven-plugin\u003c/artifactId\u003e\n                \u003cexecutions\u003e\n                    \u003cexecution\u003e\n                        \u003cid\u003elint\u003c/id\u003e\n                        \u003cphase\u003evalidate\u003c/phase\u003e\n                        \u003cgoals\u003e\n                            \u003cgoal\u003elint\u003c/goal\u003e\n                        \u003c/goals\u003e\n                        \u003cconfiguration\u003e\n                            \u003cboatBayServerUrl\u003e${url}\u003c/boatBayServerUrl\u003e\n                            \u003cinputSpec\u003e${project.basedir}/src/main/resources/petstore.yaml\u003c/inputSpec\u003e\n                            \u003coutput\u003e${project.basedir}/src/main/resources/output\u003c/output\u003e\n                            \u003csourceKey\u003esourceKey\u003c/sourceKey\u003e\n                        \u003c/configuration\u003e\n                    \u003c/execution\u003e\n                \u003c/executions\u003e\n            \u003c/plugin\u003e\n        \u003c/plugins\u003e\n    \u003c/build\u003e\n```\nFor the spec to be uploaded to Boat Bay configuration of the Boat Bay's server URL is required.\nTo configure the URL, either:\n- configure it in the plugin as shown above\n- set it as the environment variable BOAT_BAY_SERVER_URL by running export BOAT_BAY_SERVER_URL={boat-bay-url}.\nThe URL must be configured in some way for the specs to be uploaded by boat-bay, if not then the spec will only be linted. \nThe input spec should be the path of the spec or directory containing the specs you wish to upload.\nThe output is the location the lint reports get written to. \nThe `sourceKey` refers to the source the spec/s should be uploaded to.\n\nThe other option is to send the upload request through a http request file like below:\n\n```http request\n ###\nPOST http://localhost:8080/api/boat/boat-maven-plugin/repo-petstore/upload\nContent-Type: application/json\n\n{\n  \"specs\": [\n    {\n      \"key\": \"renditionservice-client-api\",\n      \"name\": \"renditionservice-client-api-v1.2.0.yaml\",\n      \"openApi\": \"openapi: 3.0.3\\r\\ninfo:\\r\\n  title: Rendition Client API\\r\\n  version: 1.2.0\\r\\nservers:\\r\\n  - url: 'http:\\/\\/localhost:4010'\\r\\n    description: Prism mock server\\r\\ntags:\\r\\n  - name: rendition service\\r\\npaths:\\r\\n  '\\/content\\/{renditionId}':\\r\\n    summary: Content stream by rendition ID or stream id\\r\\n    description: 'Gets content stream of a document rendition by the rendition ID, or by it''s  stream id, in case id begins with \\\"sid\\\"'\\r\\n    get:\\r\\n      tags:\\r\\n        - client-api\\r\\n      summary: 'Gets the content stream of the specified rendition, no rendition properties.'\\r\\n      description: 'Gets the content stream of the specified rendition, no rendition properties.'\\r\\n      operationId: renderContent\\r\\n      parameters:\\r\\n        - $ref: '#\\/components\\/parameters\\/renditionId'\\r\\n      responses:\\r\\n        '200':\\r\\n          description: Content stream data.\\r\\n          content:\\r\\n            '*\\/*':\\r\\n              schema:\\r\\n                type: string\\r\\n                format: binary\\r\\n        '400':\\r\\n          description: Could not read content stream.\\r\\n        '404':\\r\\n          description: The rendition is not found.\\r\\ncomponents:\\r\\n  parameters:\\r\\n    renditionId:\\r\\n      name: renditionId\\r\\n      in: path\\r\\n      description: renditionId\\r\\n      required: true\\r\\n      schema:\\r\\n        type: string\\r\\n\",\n      \"filename\": \"renditionservice-client-api-v1.2.0.yaml\"\n    }\n  ],\n  \"location\": \"/Users/sophiej/Documents/Projects/opensauce/boat-bay/boat-bay-data\",\n  \"projectId\": \"com.backbase.oss.boat.renditionservice\",\n  \"artifactId\": \"renditionservice-spec\",\n  \"version\": \"1.2.0\"\n}\n```\n\nThe `projectId` and `artifactId` should be that of the project where the specs are coming from.\n\n---\n## About the project\n\n### What is Boat Bay\n\nBoat Bay is a software tool that allows you to create portals for viewing Api Quality and Backwards Compatibility. It \nlints specs using a centralized repository of rules. These rules can be configured per portal, making it easy for teams to \ncustomize linting for their purposes. It also creates reports on the quality, highlighting sections of the spec that \ncontain violations or could be improved, and a diff report showing the changes between your api versions, helping \nsupport backwards compatibility.\n### Generated code\n\nThe base of this project is generated by [JHipster](#boat-bay-jhipster).\nMost of the custom code resides in `boat-bay-server`, to make it easier to distinguish between generated code and manually\nwritten code this module's `src` directory has been split into two directories:\n- [backbase](boat-bay-server/src/backbase) contains custom code\n- [main](boat-bay-server/src/backbase) contains generated code.\n\nBoat Bay generates controller interfaces and models from the API specs in [boat-bay-api](boat-bay-api). \nThey are generated using the [BOAT maven plugin](https://github.com/Backbase/backbase-openapi-tools). \n\n\n---\n## Upcoming features\n\n###Implementing Boat Bay in Your Development Process \n\nIn the future, we plan to make Boat Bay accessible through BOAT as described in [Uploading a spec](#uploading-a-spec) this will be through \nan extended feature of the linting goal. This will allow a developer to upload a spec to Boat Bay through the build process.\nYou can upload the same spec multiple times, while uploading from a project with a snapshot version the spec will be \nupdated, otherwise a new spec will be created.\n---\n\n# Boat-Bay-jhipster\n\nThis application was generated using [JHipster 6.10.5](https://www.jhipster.tech/documentation-archive/v6.10.5).\n\n## Development\n\nBefore you can build this project, you must install and configure the following dependencies on your machine:\n\n1. [Node.js][]: We use Node to run a development web server and build the project.\n   Depending on your system, you can install Node either from source or as a pre-packaged bundle.\n\nAfter installing Node, you should be able to run the following command to install development tools.\nYou will only need to run this command when dependencies change in [package.json](boat-bay-server/package.json).\n\n```\nnpm install\n```\n\nWe use npm scripts and [Webpack][] as our build system.\n\nRun the following commands in two separate terminals to create a blissful development experience where your browser\nauto-refreshes when files change on your hard drive.\n\n```\n\n./mvnw\n\n\nnpm start\n```\n\nNpm is also used to manage CSS and JavaScript dependencies used in this application. You can upgrade dependencies by\nspecifying a newer version in [package.json](boat-bay-server/package.json). You can also run `npm update` and `npm install` to manage dependencies.\nAdd the `help` flag on any command to see how you can use it. For example, `npm help update`.\n\nThe `npm run` command will list all of the scripts available to run for this project.\n\n### PWA Support\n\nJHipster ships with PWA (Progressive Web App) support, and it's turned off by default. One of the main components of a PWA is a service worker.\n\nThe service worker initialization code is commented out by default. To enable it, uncomment the following code in `src/main/webapp/index.html`:\n\n```html\n\u003cscript\u003e\n  if ('serviceWorker' in navigator) {\n    navigator.serviceWorker.register('./service-worker.js').then(function () {\n      console.log('Service Worker Registered');\n    });\n  }\n\u003c/script\u003e\n```\n\nNote: [Workbox](https://developers.google.com/web/tools/workbox/) powers JHipster's service worker. It dynamically generates the `service-worker.js` file.\n\n### Managing dependencies\n\nFor example, to add [Leaflet][] library as a runtime dependency of your application, you would run following command:\n\n```\nnpm install --save --save-exact leaflet\n```\n\nTo benefit from TypeScript type definitions from [DefinitelyTyped][] repository in development, you would run following command:\n\n```\nnpm install --save-dev --save-exact @types/leaflet\n```\n\nThen you would import the JS and CSS files specified in library's installation instructions so that [Webpack][] knows about them:\nEdit [src/main/webapp/app/vendor.ts](boat-bay-server/src/main/webapp/app/vendor.ts) file:\n\n```\nimport 'leaflet/dist/leaflet.js';\n```\n\nEdit [src/main/webapp/content/scss/vendor.scss](boat-bay-server/src/main/webapp/content/scss/vendor.scss) file:\n\n```\n@import '~leaflet/dist/leaflet.css';\n```\n\nNote: There are still a few other things remaining to do for Leaflet that we won't detail here.\n\nFor further instructions on how to develop with JHipster, have a look at [Using JHipster in development][].\n\n### Using Angular CLI\n\nYou can also use [Angular CLI][] to generate some custom client code.\n\nFor example, the following command:\n\n```\nng generate component my-component\n```\n\nwill generate few files:\n\n```\ncreate src/main/webapp/app/my-component/my-component.component.html\ncreate src/main/webapp/app/my-component/my-component.component.ts\nupdate src/main/webapp/app/app.module.ts\n```\n\n## Building for production\n\n### Packaging as jar\n\nTo build the final jar and optimize the Boat Bay application for production, run:\n\n```\n\n./mvnw -Pprod clean verify\n\n\n```\n\nThis will concatenate and minify the client CSS and JavaScript files. It will also modify `index.html` so it references these new files.\nTo ensure everything worked, run:\n\n```\n\njava -jar target/*.jar\n\n\n```\n\nThen navigate to [http://localhost:8080](http://localhost:8080) in your browser.\n\nRefer to [Using JHipster in production][] for more details.\n\n### Packaging as war\n\nTo package your application as a war in order to deploy it to an application server, run:\n\n```\n\n./mvnw -Pprod,war clean verify\n\n\n```\n\n## Testing\n\nTo launch your application's tests, run:\n\n```\n./mvnw verify\n```\n\n### Client tests\n\nUnit tests are run by [Jest][] and written with [Jasmine][]. They're located in [src/test/javascript/](src/test/javascript/) and can be run with:\n\n```\nnpm test\n```\n\nFor more information, refer to the [Running tests page][].\n\n### Code quality\n\nSonar is used to analyse code quality. You can start a local Sonar server (accessible on http://localhost:9001) with:\n\n```\ndocker-compose -f src/main/docker/sonar.yml up -d\n```\n\nYou can run a Sonar analysis with using the [sonar-scanner](https://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner) or by using the maven plugin.\n\nThen, run a Sonar analysis:\n\n```\n./mvnw -Pprod clean verify sonar:sonar\n```\n\nIf you need to re-run the Sonar phase, please be sure to specify at least the `initialize` phase since Sonar properties are loaded from the sonar-project.properties file.\n\n```\n./mvnw initialize sonar:sonar\n```\n\nFor more information, refer to the [Code quality page][].\n\n## Using Docker to simplify development (optional)\n\nYou can use Docker to improve your JHipster development experience. A number of docker-compose configuration are available in the [src/main/docker](boat-bay-server/src/main/docker) folder to launch required third party services.\n\nFor example, to start a mysql database in a docker container, run:\n\n```\ndocker-compose -f src/main/docker/mysql.yml up -d\n```\n\nTo stop it and remove the container, run:\n\n```\ndocker-compose -f src/main/docker/mysql.yml down\n```\n\nYou can also fully dockerize your application and all the services that it depends on.\nTo achieve this, first build a docker image of your app by running:\n\n```\n./mvnw -Pprod verify jib:dockerBuild\n```\n\nThen run:\n\n```\ndocker-compose -f src/main/docker/app.yml up -d\n```\n\nFor more information refer to [Using Docker and Docker-Compose][], this page also contains information on the docker-compose sub-generator (`jhipster docker-compose`), which is able to generate docker configurations for one or several JHipster applications.\n\n## Continuous Integration (optional)\n\nTo configure CI for your project, run the ci-cd sub-generator (`jhipster ci-cd`), this will let you generate configuration files for a number of Continuous Integration systems. Consult the [Setting up Continuous Integration][] page for more information.\n\n[jhipster homepage and latest documentation]: https://www.jhipster.tech\n[jhipster 6.10.5 archive]: https://www.jhipster.tech/documentation-archive/v6.10.5\n[using jhipster in development]: https://www.jhipster.tech/documentation-archive/v6.10.5/development/\n[using docker and docker-compose]: https://www.jhipster.tech/documentation-archive/v6.10.5/docker-compose\n[using jhipster in production]: https://www.jhipster.tech/documentation-archive/v6.10.5/production/\n[running tests page]: https://www.jhipster.tech/documentation-archive/v6.10.5/running-tests/\n[code quality page]: https://www.jhipster.tech/documentation-archive/v6.10.5/code-quality/\n[setting up continuous integration]: https://www.jhipster.tech/documentation-archive/v6.10.5/setting-up-ci/\n[node.js]: https://nodejs.org/\n[yarn]: https://yarnpkg.org/\n[webpack]: https://webpack.github.io/\n[angular cli]: https://cli.angular.io/\n[browsersync]: https://www.browsersync.io/\n[jest]: https://facebook.github.io/jest/\n[jasmine]: https://jasmine.github.io/2.0/introduction.html\n[protractor]: https://angular.github.io/protractor/\n[leaflet]: https://leafletjs.com/\n[definitelytyped]: https://definitelytyped.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackbase%2Fboat-bay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbackbase%2Fboat-bay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackbase%2Fboat-bay/lists"}