kartoza/ford3

Iteration 3 of the Ford Foundation funded project to further uptake of tertiary education in South Africa # FORD3 A django app for creating publishing open education program data for South Africa. View a running instance at ford3.kartoza.com Note that whilst usable, Ford3 is under continual development and not yet feature complete. The latest source code is available at github.com. * **Developers:** See our developer guide * **For production:** See our deployment guide ## Key features * An clean, easy to use API for discovering courses, institutions etc. from educational facilities in South Africa * A backend administration system for educational institutions to maintain their own data ## Project activity * Current test status master: and * Current test status develop: and * Test coverage ## Quick Installation Guide For deployment we use docker so you need to have docker running on the host. Ford3 is a django app so it will help if you have some knowledge of running a django site. ### Clone ``` git clone git://github.com cd ford3 ``` - We will use Makefile script available under deployment folder. - Any `make` commands should be run under deployment folder. ### Build ``` cd deployment cp btsync-db.env.EXAMPLE btsync-db.env cp btsync-media.env.EXAMPLE btsync-media.env make build make permissions ``` ### Docker ``` cd deployment/ansible/development/group_vars cp all.sample.yml all.yml ``` - edit `all.yml` line 4 (*use_pycharm*), line 6 (*remote_user*), 8 (*remote_group*), and 10 (*project_path*) in all.yml accordingly - make sure that *remote_user* is equal to your local user - *remote_group* is likely stay the same if using linux and macOS - *project_path* is equal to `/home/web/ford3` ``` cd deployment/ansible mkdir tmp cd .. make setup-ansible ``` Choose your pycharm version from the list or hit Enter if you don't use pycharm. ``` make up ``` Wait 30 seconds for the database to be started. ``` make migrate make collectstatic ``` ### Add superuser ``` make superuser ``` ### Add initial da …