AnitaB.org 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 is developed in phases. The initial implementation tracks volunteers' contact information, enables administrators to track volunteer hours, and allows reporting of useful information.
The VMS project uses the Django web framework and Python.
To get started, read the Installation Guide.
If you wish to view a sneak peek of the AnitaB.org 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.
- Install Docker.
Follow the installation steps for your specific operating system:
- Docker runs natively on a Linux-based system.
- For Windows and Mac OS X, you should follow instructions for installing boot2docker which also installs VirtualBox.
- Install docker-compose. Note: fig has been deprecated. Docker-compose replaces fig.
- Create a new directory on your local system.
- Enter
git clone git@github.com:anitab-org/vms.gitto clone the AnitaB.org VMS repository. After the clone is done, change directory (cd) to thevmsdirectory. - Run
docker-compose build. This pulls the Docker images required to run the project and installs the necessary dependencies. - Run
docker run -e SECRET_KEY=foobarbaz vms_web - Run
docker-compose run web python vms/manage.py migrate. - Run
docker-compose run web python vms/manage.py cities_lightfor downloading and importing data for django-cities-light. - Optional:
Run
docker-compose run web python vms/manage.py createsuperuserif you wish to create a superuser to access the admin panel. - Run
docker-compose upto start the webserver for the Django AnitaB.org VMS project. - AnitaB.org VMS should be running on port 8000.
- If you are on Linux, enter
http://0.0.0.0:8000in your browser. - If you are using boot2docker on Windows or Mac OS X, enter
http://192.168.59.103:8000/in your browser. If this IP address doesn't work, runboot2docker ipfrom the command line and replace the previous IP address in the HTTP request with the IP returned by boot2docker.
- If you are on Linux, enter
-
Please read our Contributing guidelines, Code of Conduct and Reporting Guidelines
-
Please follow our Commit Message Style Guide while sending PRs.
-
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.
The repository has the following permanent branches:
-
master This contains the code which has been released.
-
develop This contains the latest code. All the contributing PRs must be sent to this branch. When we want to release the next version of the app, this branch is merged into the
masterbranch. -
aws This is the branch through which the project is deployed.
User and developer documentation for AnitaB.org 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.
- Completed features during GSoC 2018
- Completed features during GSoC 2016 * Development * Testing
- Completed features during GSoC 2015
- Completed features during GSoC 2014
The best way to connect with the maintainers is through Github comments. Communicate with our community on AnitaB.org Open Source Zulip. For queries regarding VMS Project join, #vms.
The project is licensed under the GNU GENERAL PUBLIC LICENSE.
A heartfelt thank you to all wonderful contributors of software, guidance, and encouragement.