https://github.com/kjaisingh/microrandom

An intelligent group generator web application intended to promote diversity in a typically 'random' process.
https://github.com/kjaisingh/microrandom

Last synced: 22 days ago
JSON representation

An intelligent group generator web application intended to promote diversity in a typically 'random' process.

• Host: GitHub
• URL: https://github.com/kjaisingh/microrandom
• Owner: kjaisingh
• Created: 2020-06-30T18:26:57.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-12-13T06:20:29.000Z (about 2 years ago)
• Last Synced: 2023-08-02T07:22:15.445Z (over 1 year ago)
• Language: JavaScript
• Homepage:
• Size: 3.27 MB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 8
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Microrandom

### Optimizing the randomization process.

Microrandom is an intelligent group generator web application intended to promote diversity in a typically 'random' process. 

It is targeted to be used by teachers and professors in a classroom environment - after registering their class members through a custom link provided to each student, should they wish to conduct a group activity or project for their class, they can simply input the desired grouping details (such as the number of groups) into the app and receive a recommended list of groupings.

The web application is built using Bootstrap, Node and MongoDB, and is hosted here: https://powerful-ocean-44279.herokuapp.com/.

**Features**

* Allows for users to create groups and provide a custom group link from which new members can join.

* Provides a short survey to new members, asking for basic demographic details which are stored securely.

* Utilizes a genetic algorithm to determine optimal groupings that demonstrate the highest degree of diversity.

* Employs secure user and password authentication via Passport.

* Utilizes MongoDB Atlas for cloud database storage and Heroku for hosting.

**Build Instructions for Local Execution**

After cloning the repository, cd into it and install the node modules as:

~~~~

npm install

~~~~~~~~ 

Execute the app via nodemon as:

~~~~

nodemon app.js

~~~~~~~~ 

Launch it in your browser by typing in: http://localhost:8000/.

**App Interface**