2013-05-25 15:03:31 +02:00
FoodSoft
=========
2013-09-18 23:34:55 +02:00
[![Build Status ](https://travis-ci.org/foodcoops/foodsoft.png )](https://travis-ci.org/foodcoops/foodsoft)
2013-06-17 02:59:36 +02:00
[![Code Climate ](https://codeclimate.com/github/foodcoops/foodsoft.png )](https://codeclimate.com/github/foodcoops/foodsoft)
[![Dependency Status ](https://gemnasium.com/foodcoops/foodsoft.png )](https://gemnasium.com/foodcoops/foodsoft)
2013-09-20 18:24:40 +02:00
[![Bitdeli Badge ](https://d2weczhvl823v0.cloudfront.net/foodcoops/foodsoft/trend.png )](https://bitdeli.com/free "Bitdeli Badge")
2009-01-06 11:49:19 +01:00
Web-based software to manage a non-profit food coop (product catalog, ordering, accounting, job scheduling).
2013-05-25 15:03:31 +02:00
More information about using this software and contributing can be found on the [wiki ](https://github.com/foodcoops/foodsoft/wiki ).
2009-01-20 15:59:06 +01:00
2013-10-28 16:26:44 +01:00
System requirements
-------------------
* [RVM ](https://rvm.io/rvm/install )
* [Ruby 1.9.3 ](https://www.ruby-lang.org/en/downloads/ )
* [Bundler ](http://bundler.io/ )
Getting started
---------------
1. Install RVM (if you have not done so before):
\curl -L https://get.rvm.io | bash
2. Clone the repository from GitHub:
git clone https://github.com/foodcoops/foodsoft.git
3. Install Ruby dependencies:
bundle install
4. Setup your development environment:
rake foodsoft:setup_development
This will interactively prompt with several questions relating to your
required environment.
5. Start rails by running:
bundle exec rails s
6. Open your favorite browser and open the web application at:
http://localhost:3000/
You might want to watch a
[kitten video ](https://www.youtube.com/watch?v=9Iq5yCoHp4o )
while it's loading.
7. Login using the default credentials: `admin/secret`
8. Change the admin password, just in case.
9. Have phun!
Developing
----------
2009-01-20 15:59:06 +01:00
2013-10-28 15:47:47 +01:00
Have a look at [DEVELOPMENT.md ](https://github.com/foodcoops/foodsoft/blob/master/doc/DEVELOPMENT.md ) (outdated) and the (more recent) [Developing Guidelines ](https://github.com/foodcoops/foodsoft/wiki/Developing-Guidelines ) page on the wiki.
2012-08-25 12:26:20 +02:00
2013-10-28 16:36:04 +01:00
Deploying
---------
As you might have noticed, documentation is scarce and insufficient. If you
intend to deploy foodsoft in production, we would love to guide you through
the process. We can be contacted through the
[developers@foodcoop.nl ](mailto:developers@foodcoop.nl ) or
[foodsoft@foodcoops.net ](mailto:foodsoft@foodcoops.net ).
2013-05-25 15:03:31 +02:00
License
-------
2009-01-06 11:49:19 +01:00
FoodSoft - a webbased foodcoop management software
2011-05-06 20:38:39 +02:00
Copyright (C) 2011 Benni and Lasse
2009-01-06 11:49:19 +01:00
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
2013-06-17 02:59:36 +02:00
(See file LICENSE for the full text of the GPL)