A web based database for managing BSAC branch clubs. It looks after membership details, training records, known sites and club trips.
You can find information about demo instances of the application here: http://xsacdb.wjdp.uk/demo/.
- Linux OS, tested on Ubuntu and Debian
- Python 2.7
xSACdb is a Python web application, it is built on the Django web framework. For production use the only supported deployment method is via Dokku/Docker. See section below.
Install within a virtualenv container, this isolates the dependencies of xSACdb from the rest of your server. If you know what you're doing this'll get you up and running quickly (config needs doing first):
bower install pip install -r requirements.txt src/manage.py migrate src/manage.py reset_fake_db src/manage.py runserver
You'll also need to run some background task workers with
src/manage.py rqworker and a scheduler
The application is distributed without any qualifications, lessons or SDCs. I've not fully looked into this but I'm guessing BSAC has copyright on that data. You'll have to put this in yourself.
The only supported deployment method is within a predefined Docker container running on a Dokku server. See http://dokku.viewdocs.io/dokku/ for details about setting up a Dokku server. Run the following on the remote.
You will need to make a copy of
conf/local_settings.py and define your environment settings and club localisation options.
dokku apps:create xsacdb dokku plugin:install https://github.com/dokku/dokku-postgres.git dokku postgres:create xsacdb dokku postgres:link xsacdb xsacdb dokku plugin:install https://github.com/dokku/dokku-redis.git redis dokku redis:create xsacdb dokku redis:link xsacdb xsacdb mkdir -p /storage/xsacdb/conf /storage/xsacdb/media dokku storage:mount xsacdb /storage/xsacdb/conf/:/app/conf/ dokku storage:mount xsacdb /storage/xsacdb/media/:/app/media/
Now on your local machine: obtain the code, add your dokku server as a git remote, and push to deploy.
git clone email@example.com:wjdp/xsacdb.git cd xsacdb git checkout master git remote add deploy dokku@YOUR_DOKKU_SERVER:xsacdb git push deploy master