Taskground is a workforce management tool for mobile teams. It helps your team schedule tasks on a map and assign them to your team members.
All tasks are synched in Real-Time and made available to your team members instantly via websockets.
Download the Vagrantfile and provision.sh files from the git repository
-
Install VirtualBox
-
Install Vagrant
-
Add the precise64 box to Vagrant
vagrant box add precise64 http://files.vagrantup.com/precise64.box -
Start Vagrant
vagrant up -
ssh into the virtual machine
vagrant ssh
The /vagrant folder is shared with the host
-
Set the git global settings
git config --global user.name "Your Name" git config --global user.email you@example.com -
Init the repository
git init -
Add the remote repository
git remote add origin https://example.com -
Copy the remote repository in your local one
git fetch --all git reset --hard origin/master
The dependencies are managed with npm and are not added to the git repository. to install them just run npm install.
npm install
The first step is running the vagrant virtual machine:
vagrant up
And the using ssh to log in to the virtual server:
vagrant ssh
Once logged in, the project files will be in the /vagrant directory.
To start the server, by default it starts on port 3100:
npm start
Tests can also be run using ntpm:
npm test
The server in production is started using forever
forever start taskground.js
To restart the server:
forever restart #
Where # is the number of the forever task. To get a list of forever running tasks we can use the list option.
forever list
Nginx is used in front of taskground with this configuration:
# the IP(s) on which your node server is running. I chose port 3000.
upstream app_geographics {
server 127.0.0.1:3100;
}
# the nginx server instance
server {
listen 0.0.0.0:80;
server_name taskground.com;
access_log /var/log/nginx/geographics.log;
# pass the request to the node.js server with the correct headers and much more can be added, see nginx config options
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_set_header X-NginX-Proxy true;
proxy_pass http://app_geographics/;
proxy_redirect off;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
We use Mocha to write our tests, to run them just use:
npm test
This will run the tests in the test/ folder with mocha.
The application will run in development mode if the development.lock file exists, otherwise it will run in production mode.
- init markers - initialize tasks, users and settings
- settings - update current user data
- add user - add a new user
- edit user - edit an existing user
- delete user - delete an existing user
- add task - add a new task
- edit task - edit an existing task
- delete task - delete an existing task
- task done - mark a task as done
- task todo - mark a task as todo
- task pending - mark a task as pending