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 11 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 :

mvn clean install

Once this command is executed, the file /wise-webapp/target/wisemapping*.war will be generated.

Local Development

The previously generated war can be deployed locally executing within the directory /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 and 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

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 using jacoco

Google authorization

You must configure the following properties (app.properties) in order to get google authorization working

• google.oauth2.callbackUrl: url where google will redirect after user authentication, tipically {frontendBaseUrl}/c/registration-google. Also, this url must be defined in google app configuration
• google.oauth2.clientId: client id from google app
• google.oauth2.clientSecret: client secret from google app

Be sure your google app has the following scopes allowed:

• https://www.googleapis.com/auth/userinfo.profile
• https://www.googleapis.com/auth/userinfo.email

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://wisemapping.atlassian.net/wiki/display/WS/License]