Skip to content
forked from slinkp/fixcity

This is a Django based application that allows users to request bike racks location from the DOT

License

Notifications You must be signed in to change notification settings

openplans/fixcity

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FixCity aka BikeRaction aka BuildMeABikeRack
============================================

This is the code behind http://fixcity.org/ , a site that aims to help
get bike racks built in New York City, by allowing ordinary people to
combine efforts and get bulk orders submitted to the NYC Department of
Transportation.

It was built by OpenPlans, http://openplans.org.

The canonical source code is at http://github.com/openplans/fixcity

The project wiki is at https://projects.openplans.org/fixcity/wiki
and the bug tracker is at https://projects.openplans.org/fixcity/report

There is a #fixcity IRC channel on irc.freenode.net, although it's
not very active (as of December 2010).

What's In a Name?
-----------------

This project has been through several names already. Sorry :)

If you see "bmabr" in code, it's just an acronym for "Build Me A Bike
Rack", one of the older names. Don't worry about it...


License
=======


Released under the terms of the GNU Affero General Public License (GNU
AGPL). See COPYING.txt for details.


INSTALLATION
=============

Prerequisites
-------------

Things you will need.

On Ubuntu 9.04 - 9.10::

 sudo apt-get install \
  build-essential \
  libgeos-dev \
  libjpeg-dev \
  libpq-dev \
  libxml2-dev \
  libxslt1-dev \
  postgis \
  postgresql-8.3 \
  postgresql-server-dev-8.3 \
  proj \
  python \
  python-dev

postgresql-8.4 also should work.

I had some trouble on Ubuntu 9.10; I was able to proceed by installing
postgis from source according to the instructions here:
http://biodivertido.blogspot.com/2009/10/install-postgresql-84-and-postgis-140.html

Add info for other systems here...


Installation
------------

Given all the prerequisites above, just run ``python setup.py develop``,
preferably in a virtualenv to avoid installing stuff into your global
python site-packages.

(There is also a pip requirements file if you want to use pip to get a
known-working set of package versions.  Do ``pip install -r
pip-requirements.txt && python setup.py develop``)


Bootstrapping a Database
------------------------

This application requires a PostGIS database and some shape data. To
get started:

1) Copy the config.ini.in file to config.ini.  Edit database settings
   in config.ini as needed.  You MUST change the value of the
   'SECRET_KEY' setting.

2) Create your database::

    createdb -T template_postgis bmabr

   ... the last parameter should be the name of your database.  If you
   don't have a template_postgis database, Google will tell you how to
   create one ;)

3) Bootstrap the django models::

    cd fixcity
    ./manage.py syncdb
    ./manage.py migrate

4) (optional) Load the NYC data we use on fixcity.org. This can take a
   long time, several minutes at least::

   ./manage.py loaddata bmabr/fixtures/fixcity_org_nyc_data.json.gz
   ./manage.py loaddata bmabr/fixtures/fixcity_org_nyc_streets_data.json.gz

5) Visit the /admin/sites/site UI to change the domain name and
   display name of the website. These are used eg. in account
   confirmation email sent to users who register.


Testing
========

Just do::

  ./manage.py test bmabr

Exporting Bulk Orders
=====================

This feature is still in flux; as of 2010-12-15, there is a web UI
that isn't linked to from anywhere, and a command-line command you can
probably use more reliably/conveniently.  Just do ``manage.py
make_bulkorder <boroughname> <community board number>``.


Deployment
==========

If you want to deploy under mod_wsgi, there's an appropriate handler
script in fixcity/wsgi/.  Point your apache config at it, something
like this::


 <VirtualHost ...>
 ServerName ...
 
 <Directory /PATH/TO/fixcity/wsgi/>
    Order allow,deny
    Allow from all
 </Directory>
 
 WSGIScriptAlias / /PATH/TO/fixcity/wsgi/fixcity.wsgi
 
 </VirtualHost>


About

This is a Django based application that allows users to request bike racks location from the DOT

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 89.5%
  • JavaScript 10.5%