Oasis

SemApps instance for the Coopérative Oasis

Getting started

Requirements

• Node 18+
• Docker (with compose plugin)

Triple store

Launch the Jena Fuseki triplestore on port 3030:

docker-compose up -d fuseki

Mailcatcher

If you don't have a mail provider, you can use MailCatcher to see the emails sent. They will be available at http://localhost:1080

docker-compose up -d mailcatcher

Middleware

Launch the middleware on port 3000:

cd middleware
yarn install
yarn run dev

This will launch Moleculer in REPL mode, allowing you to call actions directly.

Initialize the data

Run these commands on Moleculer REPL:

call importers.types.freshImport
call importers.groups.freshImport
call importers.status.freshImport
call initialization.createAdmin --email youremail@domain.com
call webacl.resource.refreshContainersRights

The initialization.createAdmin command will send an email to the given address. Go to http://localhost:1080 if you launched MailCatcher. This will allow you to set a password and connect to the backoffice.

Backoffice

Launch the backoffice on port 4000:

cd backoffice
yarn install
yarn start

Frontoffice

Launch the frontoffice on port 5000:

cd frontoffice
yarn install
yarn start

Linking to SemApps packages

To modify packages on the SemApps repository and see the changes before they are published, we recommend to use yarn link.

Linking middleware packages

cd /SEMAPPS_REPO/src/middleware
yarn run link-all
cd /OASIS_REPO/middleware
yarn run link-semapps-packages

Linking frontend packages

cd /SEMAPPS_REPO/src/frontend
yarn run link-all
cd /OASIS_REPO/backoffice
yarn run link-semapps-packages
cd /OASIS_REPO/frontoffice
yarn run link-semapps-packages

Additionally, frontend packages need to be rebuilt, or your changes will not be taken into account. You can use yarn run build to build a package once, or yarn run dev to rebuild a package on every change.