JumentiX

Application foundation for REST and Realtime Node.JS micro service applications

Read docs at: https://web2solutions.github.io/Jumentix/ - Outdated

Pre requisites

• MongoDB
• RabbitMQ and RabbitMQ - Management plugin
• Redis
• Node.js 10, 11
• Elastic optional
• Apache Cassandra optional
• Apache Kafka optional
• PostgreSQL, MySQL, SQL Server optional

Notes

In order to use Node 12 or greater, need to update gulp.

How to install

    $ cd /home/apps

    $ git clone https://github.com/web2solutions/Jumentix.git

    $ cd Jumentix

    $ npm install

    $ npm start

Setup new RabbitMQ account for production

Rabbitmq provides a "guest" account when it is setup. Do not use use "guest" account in production. Change it on mq configuration and a related new account to rabbitmq

mq configuration

You migh use the Management Plugin, or the terminal:

Create account:

rabbitmqctl add_user ACCOUNTNAMEGOESHERE YOURPASSWORDGOESHERE

Set admnistrator tag

rabbitmqctl set_user_tags ACCOUNTNAMEGOESHERE administrator

Set read / write permission to all resources

rabbitmqctl set_permissions -p / ACCOUNTNAMEGOESHERE ".\*" ".\*" ".\*"

How to see JumentiX and JumentiX Vue UI in action

1. Install JumentiX

# install dependencies
npm install

# serve with hot reload at localhost:3001
npm start

2. Install JumentiX Vue UI

# install dependencies
npm install

# serve with hot reload at localhost:8080
npm run dev

3. Reach and Setup the REST API on browser:

http://localhost:3001/application/setup

4. Reach UI on browser:

http://localhost:8080/

5. Do login.

User: admin@admin.com Password: 123

It is going to ask you to change your password.

6. Swagger based CRUD screen - JQWidget implementation

http://localhost:8080/#/human

7. Swagger based CRUD screen - Vuetify implementation

http://localhost:8080/#/surveys

Testing

Build mode

$ npm run test

Dev mode

1 - Start the application

$ npm start

2 - Run test suite

$ npm run _test

Commands

Start app on development mode

$ npm start

Stop app

$ npm run start

Run ESlint fixing code

$ npm run eslint-fix

Run ESlint to check code issues

$ npm run lint

Build code to production

$ npm run build

Run app on dev mode using nodemon

$ npm run nodemon

Run app on dev mode as cluster

$ npm run dev-cluster

Run app on dev mode as single fork

$ npm run dev-simple

Deploy to production Git + SSH

$ npm run deploy-production

Deploy to test Git + SSH

$ npm run deploy-test

Build app and run on simple single thread

$ npm run simple

Build app and run on simple single thread

$ npm run cluster

pm2 Update

$ npm run update

Setup Sequelize migrations

$ npm run update