Name: vms
Owner: Systers Open Source
Description: Volunteer Management System
Created: 2014-04-22 14:13:57.0
Updated: 2018-01-02 09:03:25.0
Pushed: 2018-01-18 06:37:35.0
Homepage: null
Size: 2727
Language: Python
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Systers has many volunteers that offer their skills, time, and commitment to our vision and projects. The Volunteer Management System (VMS) will be useful for volunteer coordinators, volunteer sign-up, tracking hours, and reporting.
This project is under active development.
VMS is live here.
If you are an Outreachy Applicant, start with reading this.
The VMS will be developed in phases. The initial implementation will track volunteers' contact information, enable administrators to track volunteer hours, and allow reporting of useful information.
The requirements document gives additional detail on the project's scope.
The VMS project uses the Django web framework and Python.
To get started, read the Installation Guide.
If you face some issues while installing and making VMS up in your local, have a look at issues labelled as While Setting up VMS.
If you wish to view a sneak peek of the Systers VMS, you may use Docker to preview the VMS. Note: The following Docker configuration is not intended to be run in production at the moment. It may be configured to do so in the future.
git clone git@github.com:systers/vms.git
to clone the Systers
VMS repository. After the clone is done, change directory (cd) to the
vms
directory.docker-compose build
. This pulls the Docker images required to run the
project and installs the necessary dependencies.docker run -e SECRET_KEY=foobarbaz vms
docker-compose run web python vms/manage.py migrate
.docker-compose run web python vms/manage.py cities_light
for downloading and importing data for django-cities-light.docker-compose run web python vms/manage.py createsuperuser
if you wish to create a superuser to access the admin panel.docker-compose up
to start the webserver for the Django Systers VMS
project.http://0.0.0.0:8000
in your browser.http://192.168.59.103:8000/
in your browser. If this IP address
doesn't work, run boot2docker ip
from the command line and replace
the previous IP address in the HTTP request with the IP returned by
boot2docker.Issue Tracker: vms/issues
Source Code: vms
Linking pull request to an issue
When you create a pull request, use closes #id_of_issue or fixes #id_of_issue. It will link the issue with your pull request. It also automatically closes the issue if your pull request gets merged.
User and developer documentation for Systers Portal VMS project is generated using Markdown and available online for convenient reading at VMS Website.
We are pleased to participate in the Google Summer of Code and are grateful for the contributions from our GSoC developers.
If you are having issues, please let us know. We have a mailing list located at: systers-dev@systers.org
The best way to connect with the maintainers is through GitHub comments. Feel free to discuss more about an issue by commenting on it or asking questions. We also have Systers Slack channel, you can request an invite here. If there is something you want to discuss privately with the maintainer and you are being hesitant to discuss it on above mediums, then drop an email. For Systers VMS join #vms on Slack.
The project is licensed under the GNU GENERAL PUBLIC LICENSE.
A heartfelt thank you to all wonderful contributors of software, guidance, and encouragement.