Gathering Our Voices

Welcome, this is the whole source for the GOV 2016 Website.

Why this site?

The BCAAFC needed a clean, simple, user friendly event management software for the Gathering Our Voices Youth Conference.

It was decided at the start of the project, back in September 2012 to develop the project in the open, encouraging people to utilize our techniques for dealing with troubles, as well as letting them inspect how it works.

What does it use?

This website is written entirely in Javascript, Handlebars (a templating language), and CSS. It uses the Postgres database to store attendee data.

How to Use

This application follows the 12 Factor App style of configuration and is primarily configured through environment variables.

git clone git@github.com:BCAAFC/Gathering-Our-Voices.git
cd Gathering-Our-Voices
npm install
./node_modules/bower/bin/bower install
grunt build
Setup your environment. See config/ for various knobs to tweak.
./node_modules/sequelize-cli/bin/sequelize db:migrate
node_modules/sequelize-cli/bin/sequelize db:seed:all
Run start.js with the desired settings.

Example:

SECRET="test" PG_URL="postgres://localhost/gov" REDIS_URL="localhost" ADMINS="andrew@hoverbear.org" ./start.js

Backing Up and Restoring

There is a backups folder containing two scripts which should make backing up and restoring easier.

To backup, creating a backups/$DATE.tar.gz file:

./backups/backup.sh

To restore given a backups/$DATE.tar.gz:

./backups/restore.sh backups/$DATE.tar.gz

How to Deploy

In order to deploy on Funtoo this script is used in /etc/init.d/gov2016:

#!/sbin/runscript

# Do NOT "set -e"

# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="gov2016"
NAME=gov2016
DIR_ROOT=$FIXME
GROUP=$FIXME
USER=$FIXME
DAEMON=/usr/bin/node
DAEMON_ARGS="index.js"
LOGFILE=/var/log/gov2016
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
# Exports for node
export NODE_ENV=production
export PORT=$FIXME
export SECRET=$FIXME
export ADMINS=$FIXME
export PG_URL=$FIXME
export UPLOAD_DIR=$FIXME
export MANDRILL_APIKEY=$FIXME
export TWILIO_ACCOUNT_SID=$FIXME
export TWILIO_AUTH_TOKEN=$FIXME

extra_commands="firstrun"
#
source /lib64/rc/sh/functions.sh

depend() {
  use logger dns
  need net redis postgresql  
}

start() {
  ebegin "Starting ${DESC}"
  start-stop-daemon --start --quiet \
    --user $USER:$GROUP --chdir $DIR_ROOT --background \
    --stdout $LOGFILE --stderr $LOGFILE \
    --make-pidfile --pidfile $PIDFILE --exec $DAEMON -- $DAEMON_ARGS
  eend $?
}

#
# Function that stops the daemon/service
#
stop() {
  ebegin "Stopping ${DESC}"
  start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 \
    --pidfile $PIDFILE --exec $DAEMON
  eend $?
}

firstrun() {
  ebegin "Doing FIRSTRUN for ${DESC}"
  export FIRSTRUN=true
  start-stop-daemon --start --quiet \
    --user $USER:$GROUP --chdir $DIR_ROOT --background \
    --stdout $LOGFILE --stderr $LOGFILE \
    --make-pidfile --pidfile $PIDFILE --exec $DAEMON -- $DAEMON_ARGS

  eend $? "failed"
}

Contributors

The lead developer, Andrew Hobden (@Hoverbear), is a dedicated believer in the Free/Open-Source software movement. If you're interested in technology, cyber law, or 'hacking' sub-culture, you're encouraged to read Coding Freedom by Gabriella Coleman or The Future of Ideas by Lawrence Lessig. You're encouraged to share your insights and opinions into these books on our issues page, if you so desire.

Special thanks to those who put up with all the mistakes, bugs, and ill-planned ideas but still managed to totally rock and constantly help improve the application:

Our heroic Youth Conference Coordinator, Della Preston, has helped immensely with development efforts, her time, insights, and constant critical eye have helped drive the quality of the product from beginning to start. Though she has not contributed code her specifications and knowledge of the event have touched virtually every part of the codebase.

The 2016 Youth Conference Coordinators Agnes Wisden, Keana Zamardi, Jennifer Ambers, Holly Brinkman, Julie Robertson, and Shawna Johnson.

The 2015 Youth Conference Coordinators Kathryn Lacerte, Rosy Hartman, Gregory Forsberg, and Tara Skobel.

The 2014 Youth Conference Coordinators, Gregory Forsberg and Nik Richardson.

The 2013 Youth Conference Coordinators, Siku Allooloo and Vanessa Sloan-Morgan.

BCAAFC / Gathering-Our-Voices

readme