101 lines
5.0 KiB
Markdown
101 lines
5.0 KiB
Markdown
# Overview
|
|
|
|
Wise Mapping is the web mind mapping open source tool that leverages the power of Mind Maps mixing open standards technologies such as SVG and React.
|
|
WiseMapping is based on the same code product supporting [http://www.wisemapping.com].
|
|
|
|
## Compiling and Running
|
|
|
|
### Prerequisites
|
|
|
|
The following products must be installed:
|
|
|
|
* OpenJDK 17 or higher
|
|
* Maven 3.x or higher ([http://maven.apache.org/])
|
|
* npm 6 or higher ([https://www.npmjs.com/package/npm?activeTab=versions])
|
|
|
|
### Compiling
|
|
|
|
WiseMapping uses Maven as packaging and project management. It's composed of 5 maven sub-modules:
|
|
|
|
* wise-ui: React font-end fetcher
|
|
* wise-webapp: J2EE web application
|
|
|
|
The full compilation of the project can be performed executing within <project-dir>:
|
|
|
|
`mvn clean install`
|
|
|
|
Once this command is executed, the file <project-dir>/wise-webapp/target/wisemapping*.war will be generated.
|
|
|
|
### Local Development
|
|
The previously generated war can be deployed locally executing within the directory <project-dir>/wise-webapp the following command:
|
|
|
|
`cd wise-webapp;mvn jetty:run-war`
|
|
|
|
This will start the application on the URL: [http://localhost:8080/] using file based database.
|
|
|
|
User: test@wisemapping.org
|
|
Password: test
|
|
|
|
### Local Development + UI Integration
|
|
|
|
In order to reduce the life-cycle to develop UI backend testing, you can do the following hack:
|
|
|
|
* Clone [wisemapping-open-source](https://bitbucket.org/wisemapping/wisemapping-open-source/) and [wisemapping-frontend](https://bitbucket.org/wisemapping/wisemapping-frontend/) at the same top level directory
|
|
* Compile `wisemapping-frontend`. Details for compilation can be found in the `wisemapping-frontend` readme.
|
|
* Compile `wisemapping-open-source`
|
|
|
|
A quick and dirty solution to share changes in the UI is to manually compile the dist. This will make the loader file available without the need to publish:
|
|
|
|
`yarn --cwd wisemapping-frontend build;cp -r wisemapping-frontend/packages/mindplot/dist/* wisemapping-open-source/wise-ui/target/wisemapping-mindplot/package/dist;cp -r wisemapping-frontend/packages/webapp/dist/* wisemapping-open-source/wise-ui/target/wisemapping-webapp/package/dist`
|
|
|
|
|
|
### Compiling and running with docker-compose
|
|
|
|
Check out the [docker section](./docker/README.)
|
|
|
|
### Test reports
|
|
|
|
Individual test result reports can be found in wisemapping-open-source/wise-webapp/target/failsafe-reports/index.html
|
|
Test coverage report of unit and integration test can be found in wisemapping-open-source/wise-webapp/target/site/jacoco and wisemapping-open-source/wise-webapp/target/site/jacoco-it folders. Coverage report is generated in the verify phase of [lifecicle](https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#introduction-to-the-build-lifecyclea) using [jacoco](https://www.jacoco.org/jacoco/trunk/doc/maven.html)
|
|
|
|
|
|
## Google authorization
|
|
|
|
You must configure the following wisemapping properties (app.properties) in order to get google authorization working
|
|
* `security.oauth2.google.callbackUrl`: url where google will redirect after user authentication, tipically {frontendBaseUrl}/c/registration-google. Also, this url must be defined in google app configuration
|
|
* `security.oauth2.google.clientId`: client id from google app
|
|
* `security.oauth2.google.clientSecret`: client secret from google app
|
|
|
|
You must create a Google Application in [Google Cloud](https://console.cloud.google.com) and complete all the information required by Google. Here are the most important properties.
|
|
|
|
Oauth consent screen
|
|
* Authorized domains: wisemapping domain (ex: wisemapping.com), and you can add domains of other environments if needed
|
|
* Permissions
|
|
* `https://www.googleapis.com/auth/userinfo.profile`
|
|
* `https://www.googleapis.com/auth/userinfo.email`
|
|
* Test users: emails for testing, those can be used before the application is validated by Google
|
|
|
|
After that, in Credentials, you must create an `Oauth Client Id` credential
|
|
* Authorized JavaScript origins: list of authorized domains from which to redirect to Google. Ex: `https://wisemaping.com`, `https://wisemapping-testing.com:8080`
|
|
* Authorized redirect URIs: list of allowed urls to which google will redirect after authenticating . Ex: `https://wisemaping.com/c/registration-google`, `https://wisemapping-testing.com:8080/c/registration-google`
|
|
|
|
After credential was created, Google will show you the clientId and clientSecret to configure your application. For productive applications, you must **publish** your application, this is a validation process with Google.
|
|
|
|
## Members
|
|
|
|
### Founders
|
|
|
|
* Paulo Veiga <pveiga@wisemapping.com>
|
|
* Pablo Luna <pablo@wisemapping.com>
|
|
|
|
### Past Individual Contributors
|
|
|
|
* Ignacio Manzano
|
|
* Ezequiel Bergamaschi <ezequielbergamaschi@gmail.com>
|
|
|
|
## License
|
|
|
|
The source code is Licensed under the WiseMapping Open License, Version 1.0 (the “License”);
|
|
You may obtain a copy of the License at: [https://bitbucket.org/wisemapping/wisemapping-open-source/src/develop/license.md](https://bitbucket.org/wisemapping/wisemapping-open-source/src/develop/license.md)
|
|
|