Boxwise

Boxwise is an open-source web-app, which makes it easy for organisations to source, store and distribute donated goods to people in need in a fair and dignified way.

This is a new version of the original Drop App used by Drop In The Ocean. The original app was limited to just managing a single organization. This is a rewrite to support multiple organizations on a centrally hosted system.

Check out our webpage for more information!

Contributing

We are always looking for help. Working on this project is an opportunity to use your skills to help thousands of refugees. Our contributing guide has more information.

Please also check out our Code of Conduct

Community

We have a Slack for discussing development and to get support. Join the #dev and #support channel.

Setting up development environment

1. Install odoo v11. Together with our partner humanilog, we created a general dev-setup. You have to have docker installed for this dev-setup.

2. Clone this folder into the addons folder of your setup. Please do NOT rename the repository!

   git clone https://github.com/boxwise/boxwise_wms.git

3. We recommend that you create your own database before you log in. There you can choose your own log in credentials and leave out the demo data of the default installation.

   • Open up odoo, e.g. localhost:8068
   • Click "Manage databases"
   • Click "Create Database"

4. Activate the developer mode! There two ways:

   1. add debug in the url --> localhost:8069/web?debug#.... or
   2. Go to settings and click the link hidden beneath the credentials on the far right!

5. Install the boxwise_wms module!

   • Go to the Apps menu!
   • Click in the left-hand menu Update Apps List!
   • Search for boxwise_wms! Remove the Apps filter from the search bar to see all custom modules available!
   • Click Install!

The following steps are required if Issue #13 and Issue #15 are not yet solved.

6. Check out the links above and enable the settings / user rights by hand.

Useful Links

We are using the open source ERP system odoo as the base for Boxwise. First, here are some links about odoo itself:

1. Dev doc: https://www.odoo.com/documentation/11.0/index.html Espeiall
2. Books: https://drive.google.com/drive/folders/1AB18OISimJ5jewCBXJuTi6EDVwd84lXW
3. odoo github https://github.com/odoo

And the odoo community:

1. OCA webpage https://odoo-community.org/
2. OCA Contributing Guidelines https://odoo-community.org/page/contributing
3. OCA github https://github.com/OCA
4. OCA maintainer tools https://github.com/OCA/maintainer-tools
5. OCA maintainer tools wiki https://github.com/OCA/maintainer-tools/wiki