Better fixtures for local development & Review Apps (#134)

* [docs] Update contributing guide for installing pip packages & i18n

* Install factory_boy

* Add UserFactory and ProjectFactory

* Install django-extensions, IPython

* Add factories

* Continue adding factories

* Add fuzziness to results

* Add more pages and environments to fixtures

* Fix RuntimeWarning due to timezones

Warning fixed: DateTimeField Audit.created_at received a naive datetime (2020-03-19 17:47:08.432696) while time zone support is active.

* Use new fixtures in docs & review apps

* Add doc section to reset DB data

Author: phacks

CONTRIBUTING.md

@@ -16,6 +16,11 @@ To edit a piece of documentation, you can click on the “Edit this page” link
 
 ![Edit this doc button](/docs/static/img/edit-docs.png)
 
+## Internationalization
+
+Falco uses [`react-intl`](https://github.com/formatjs/react-intl) under the hood to manage internationalization. It detects the language of the user’s browser and serves that locale if available, otherwise defaults to English.
+If you spot a mistake in one of the translations available, or would like to translate Falco to your language, please edit (or create) the appropriate JSON file in `frontend/translations` and submit a pull request.
+
 ## Local development on Falco
 
 This section will guide you through installing Falco on your development machine, so that you can work on your feature or bug fix locally before submitting a PR.
@@ -68,4 +73,44 @@ The project should now be running at [localhost:3000](http://localhost:3000). Yo
 To access both these interfaces, you can login using the following credentials:
 
 - username: `admin`
-- password: `admin`
+- password: `admin`
+
+### To reset the database to its original state (with fixtures)
+
+- Ensure that nothing is connected to your database (Django shell, Postgres GUI…)
+- Run `docker-compose exec backend ./manage.py reset_db`
+- Run `make fixtures/load`
+
+### Add a new pip package to Falco’s backend
+
+To add a Django package in Falco’s backend:
+
+- Start the backend:
+
+  ```sh
+  make backend/start
+  ```
+
+- Once the backend is up and running, install your package inside the docker container (this may take a few minutes):
+
+  ```sh
+  docker exec -it falco_backend_1 pipenv install <package_name>==<package_version>
+  ```
+
+  _This will install your package, then update Pipfile and Pipfile.lock files accordingly._
+
+- Once package is installed, stop backend using `Ctrl + C`
+
+- To make your package installation persistent, you have to rebuild all Django containers (this may also take a few minutes):
+
+  ```sh
+  docker-compose build --no-cache backend
+
+  docker-compose build --no-cache celery
+  ```
+
+- Relaunch backend and ensure you have no error:
+  ```sh
+  make backend/start
+  ```
+- Enjoy! 🎉

Makefile

@@ -22,7 +22,7 @@ db/connect:
 	docker exec -it falco_db_1 psql -Upostgres postgres
 
 fixtures/load:
-	docker-compose exec backend ./manage.py loaddata fixtures/fixtures.json
+	docker-compose exec backend ./manage.py load_fixtures
 
 frontend/install: frontend/.env
 	yarn --cwd frontend install

backend/Pipfile

@@ -20,6 +20,9 @@ django-fernet-fields = "==0.6"
 whitenoise = "==5.0.1"
 django-heroku = "==0.3.1"
 drf-yasg = "==1.17.0"
+factory-boy = "==2.12.0"
+django-extensions = "==2.2.8"
+ipython = "==7.9.0"
 
 [dev-packages]
 "flake8" = "==3.7.7"