riadvice / bbbeasy

Easy Multi-purpose Rooms Manager for BigBlueButton, with fine-grained and fully customisable configuration

BBBEasy

BBBEasy is an open-source multipurpose meeting rooms manager for BigBlueButton.

Features

• Smooth installation experience.

• User friendly UI.

• Manage different configuration presets and assign them to rooms.

• Rooms management.

• Users management.

Components

The web-application is split in two parts:

• A server API.

• A modern front-end.

🪴 Project Activity

Development

• To launch the backend in the development mode, follow these steps :

         1- Start a Command Prompt as an Administrator.

         2- Run cd /path/to/cloned/project/.

         3- Run vagrant up && vagrant ssh and wait until the end of the process.

         4- Run cp /app/bbbeasy-backend/app/config/config-development.sample.ini /app/bbbeasy-backend/app/config/config-development.ini.

• To launch the frontend in the development mode, follow these steps :

         1- Run cd /app/bbbeasy-frontend.

         2- Run cp /app/tools/bbbeasy /app/bbbeasy-frontend/bbbeasy.

         3- Run sed -i -e 's/\r$//' bbbeasy.

         4- Run sed -i -e 's/"bbbeasy /".\/bbbeasy /g' package.json.

         5- Run yarn start-dev-installer to enable the installer app or yarn start-dev to enable the web app.

Contributing

Security

Testing

Backend test:

• From the browser: http://bbbeasy.test/api?statera or http://bbbeasy.test/api?statera=withCoverage

Frontend test:

• To start testing with Cypress, follow these steps :

         1- Enable the installer app as described in Development heading.

         2- Run yarn cypress.

         3- When the Command Prompt displays Wait 30 seconds until enabling web app (manually), terminate the running installer app.

         4- Run yarn start-dev within 30 seconds.

Technologies

Node.js

React JS

Redis

Percona Distribution for PostgreSQL

TypeSCript

Cypress

NGINX

Vagrant