💻Contributing

High-Level Architecture of the Main Framework Used in the Application

The MEDomics platform architecture

The map below illustrates the organization of files, modules, databases, and the Frontend-Backend connection within the MEDomics platform. This visual guide is designed to support new contributors in understanding the application’s structure, streamlining the integration of new features, and aiding efficient navigation through the codebase.

the MEDomics platform detailed architecture

Set up from the ground up 🌱

Go visit our GitHub development branch!

1. Installation of MongoDB Community Edition

Follow the installation instructions depending on your OS for MongoDB Installation.

Windows

Install MongoDB on Windows

• Do not install MongoDB as a service.

• You do not have to install MongoDB Compass.

• You do not have to install mongosh.

• Do not forget to add MongoDB binaries to the System PATH.

Linux

Mac

2. Installation of MongoDB database tools

Follow the installation instructions depending on your OS for MongoDB Database Tools Installation.

Windows

Install MongoDB Database Tools on Windows

• Install with the MSI Installer.

Linux

Mac

1. Installation of Nvm

• NVM for Windows

• NVM for Ubuntu

2. Installation of npm/node.js

nvm install lts
nvm use lts

3. Clone the repository

We are currently using develop as our integration branch.

HTTPS

git clone -b develop https://github.com/MEDomics-UdeS/MEDomicsLab.git

SSH

4. Set up server-side (Go)

4.1 Installation of Go

1. Download the latest stable release of Go from the official website: https://golang.org/dl/

2. Follow the installation instructions for your operating system.

4.2 Setup of environment

Windows

Execute these commands in a CMD prompt:

setx GOPATH %USERPROFILE%\go
setx PATH "%PATH%;C:\Go\bin"

Linux and Mac

After, close all your terminals because these commands will take effect on the initialization of any terminal

4.3 Verify installation

1. Open a new terminal

2. Run the command go version

3. If Go is installed correctly, you should see the version number printed to the console.

4.4 Setup for the application

1. Open a new command prompt and go to the <repo path>/go_server directory.

2. Run the command go run main.go (on first time, it should download the required libraries and launch the server)

3. You can terminate the process by pressing CTRL + C

4. Finally, build the app by running go build main.go (It should create an executable file -> that file will be run by the client-side JavaScript, so modifications to .go files must be followed by a rebuild. Congratulations, you're now ready to start developing Go applications!

5. Init submodules

cd <.../MEDomicsLab/>
git checkout dev_lab
cd ../MEDprofiles
git checkout fusion_MEDomicsLab

6. Start the electron app!

cd <.../MEDomicsLab>
npm install
npm run dev

On Windows, if you encounter error messages when running npm install, follow the steps here to solve the issue: https://github.com/nodejs/node-gyp#on-windows.

• You will need to install the Visual Studio Build Tools (select the C++ build environment)

• Install Python 3.11 from here

• Use node version v18.16.1. Run:

  • nvm install v18.16.1

  • nvm use v18.16.1

• Set the Python3.11 :

  • $Env:npm_config_python="C:\path\to\python.exe" # PowerShell

• Run npm install -g node-gyp

• Run again npm install

MongoDB configuration

The MEDomicsLab platform uses port 54017 as the default MongoDB connection port. For database visualization and management, we recommend using MongoDB Compass, the official GUI client from MongoDB.

Key Details:

• Default Port: 54017

• Recommended Client: MongoDB Compass

• Connection String Format: mongodb://localhost:54017/

Modify startup settings

1. Go to file medomics.dev.js

2. Here is a description of the Object:

const config = {
  // If true, the server will be run automatically when the app is launched
  runServerAutomatically: true,
  // If true, use the React dev tools
  useReactDevTools: false,
  // the default port to use for the server, be sure that no programs use it by default
  defaultPort: 5000,
  // Either "FIX" or "AVAILABLE" (case sensitive)
  // FIX 		-­> if defaultPort is used, force terminate and use defaultPort
  // AVAILABLE 	-> if defaultPort is used, iterate to find next available port
  portFindingMethod: PORT_FINDING_METHOD.FIX
}

To Test the Production Build

Build the Electron app and run the built version

Windows

npm run build:win                            # build and package the application 
.\build\dist\win-unpacked\MEDomicsLab.exe    # Run the executable of the built version

Linux

Mac

The built app will be located in the build/dist folder