SITCON Internal Tracking & Conference Operation Network
CSS Python HTML JavaScript
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
agenda Upgrade to Python3 and Django 1.9 Apr 16, 2016
api
core
docs
issues
notifications
tests/notifications
users
.gitignore
.python-version
.travis.yml
API.md
Procfile
README.md
__init__.py
fabfile.py
manage.py
requirements-dev.txt
requirements.txt
runtime.txt
setup.cfg

README.md

roboconf

travis coveralls

SITCON Internal Tracking & Conference Operation Network (Codename Roboconf) for Students' Information Technology CONference (SITCON). The website is used to operate though SITCON's administration process since 2014.

Proposed Functionalities

  • Document operations
  • Issue tracker
  • Time control
  • Staff management

Requirements

Python package dependency are enlisted in requirements file.

You could safely remove these packages if you’re not targeting PostgreSQL databases:

  • dj-database-url
  • psycopg2

Compass and Fabric powers site theming and automating respectively.

Development

It is recommended to use virtualenv.

cd roboconf
virtualenv venv
. venv/bin/activate # if you use bash

Install dependencies.

pip install -r requirements-dev.txt

Set debug

export DEBUG=1 # bash

Copy example settings

cp core/settings/local_settings.example.py core/settings/local_settings.py

...

Load database schema and initial data

python manage.py migrate
python manage.py loaddata */fixtures/*.json

Note: currently there are problems with loaddata on master branch, see commit 5d8436149cf22f0

Production Deployment

We recommend using PostgreSQL. Create a role and a database then grant all privileges to that role:

sudo -u postgres psql

CREATE ROLE roboconf WITH LOGIN PASSWORD 'foobar';
CREATE DATABASE roboconf;
GRANT ALL PRIVILEGES ON DATABASE roboconf to roboconf;

It is recommended to use virtualenv.

cd roboconf
virtualenv venv
. venv/bin/activate # if you use bash

Install dependencies.

pip install -r requirements.txt

Load database schema and initial data

python manage.py migrate
python manage.py loaddata */fixtures/*.json

Note: currently there are problems with loaddata on master branch, see commit 5d8436149cf22f0

python manage.py collectstatic

Make media folder

mkdir media
chmod www-data:www-data media

Compiling SCSS

Install relevant rubygems

gem install compass zurb-foundation

Compile SCSS to CSS:

compass compile --force --sass-dir core/scss/ --css-dir core/static/css/ --require zurb-foundation

Alternatively, you can use Fab to compile:

fab compass:compile

Naming

"Roboconf" pronounces familiar with 蘿蔔坑 (redish pit), from the Mandarin idiom "each redish has its own pit". Literally it stands for "robot-assisted conference" in English.

Developers

Contributing

We welcome issue report, pull requests, and/or friends willing to join SITCON's preparation. Find us at irc.freenode.net #sitcon channel, or send us a letter.

License

This project (Roboconf) is temporarily licensed under GNU AGPL-3.0 with one conditional statement:

If #Roboconf were used to operate a conference with: (a) 200 or more participants or (b) 50 or more staff, the conference organizer would need to either (a) help promote SITCON by putting SITCON logo on the conference website, or (b) support SITCON by either donation or becoming one of SITCON's sponsor.