Skip to content

crispinamuriel/encompass

 
 

Repository files navigation

ENCOMPASS

Twitter Follow code style: prettierNode VersionNPM Version

ENCOMPASS is a web application designed to facilitate the process of learning from and providing feedback on student work, for both individual teachers and for collaborative and professional development purposes.

License

  • For non-commercial uses, this application is licensed under the AGPL license.
  • Any use of EnCOMPASS for commercial purposes is subject to and requires a special license to be negotiated with Mathematical Thinking.
  • See EnCOMPASS license details

Installation

This application uses a combination of:

Instructions for getting started with this setup, are located Github Repo

Local Development Environment Setup

In its current state, EnCOMPASS is tightly linked with VMT. When a user signs up with EnCOMPASS, they also receive a VMT account which has the same username (and vice versa). If a user is logged in to one app, they will also be logged in to the other app. As a result, you must also be running mt-sso and VMT for user registration and login to work properly. If you do not need signup functionality while developing, then you do not need to be running VMT. If you are having a 500 or 401 error trying to log into EnCoMPASS, you may have to start up MTSSO, VMT, and ENC by running the script npm run dev-all to be able to log in properly.

If you wish to run EnCOMPASS separately, then you just need to remove the existing auth routes (server/datasource/api/auth) and middleware (server/datasource/middleware) and put in your own system. In addition, you may want to remove the components used for importing VMT work and strip out the workspace features/logic that are specific to viewing VMT replays within EnCOMPASS.

  1. Fork this repo (instructions)
  2. Install node version 8+
  3. Install MongoDB version 3.4.10
  • Run mongod in terminal to start the mongo daemon
  1. npm install -g:
  • grunt
  • grunt-cli
  • chai
  1. npm install for the rest of the dependencies
  2. Setting up .env file
  • follow instructions from the .env.example file to create a new .env file
  • edit values as given to you from cohort.
  1. From root directory run grunt

Issues

We are using Github for issues http://github.com/mathematicalthinking/encompass/issues

The wiki is also a good place to look for notes on the project http://github.com/mathematicalthinking/encompass/wiki

Contributions and Git Rebase Workflow

  1. git checkout master
  2. git pull --rebase upstream master
  3. git push origin master
  4. git checkout -b feature-branch
  5. git add/git commit (on feature branch)
    • To close an issue, add 'closed #[github issue number]' to commit message
  6. git pull --rebase upstream master (on feature branch)
  7. git push origin feature-branch
  8. Submit pull request (your feature branch to upstream master)

More Work to do (Pull Request not accepted)

  • Go to Step 5 in Git Rebase flow.

Pull Request Accepted?

  1. git checkout master
  2. git pull --rebase upstream master
  3. git push origin master

Totally done

  1. git checkout master
  2. git branch -d feature-branch

Troubleshooting

  • git remote -v to see remote origins
  • git remote add upstream https://github.com/mathematicalthinking/encompass.git
  • if existing upstream git remote rm upstream

Styleguide

We use Prettier Add the VS code extension and configure it to format on save.

Design Docs

Please visit our design documentation for styling information.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 83.3%
  • Handlebars 8.8%
  • SCSS 5.9%
  • CSS 1.5%
  • Hack 0.2%
  • PHP 0.1%
  • Other 0.2%