Field Reporting Database for the Fahari care delivery projects.
In order to work out the environment variables you need to run this project,
please examine the main CI workflow file - .github/workflows/ci.yml. If a
variable is set there, you need it locally too.
Code quality checks are run via https://pre-commit.com/ . You'll have a better experience if you install Pre-Commit and set up the Git hook.
As a contributor, you need to sign your commits: https://docs.github.com/en/github/authenticating-to-github/managing-commit-signature-verification/signing-commits .
In order to serve static assets for local development, you need to set up an npm development server:
First, you need to install npm. We recommend nvm: https://github.com/nvm-sh/nvm .
> npm install
> npm run devThis project was bootstrapped with https://cookiecutter-django.readthedocs.io/en/latest/. The standard settings are documented at http://cookiecutter-django.readthedocs.io/en/latest/settings.html.
-
To create a normal user account, just go to Sign Up and fill out the form. Once you submit it, you'll see a "Verify Your E-mail Address" page. Go to your console to see a simulated email verification message. Copy the link into your browser. Now the user's email should be verified and ready to go.
-
To create an superuser account, use this command::
> python manage.py createsuperuserFor convenience, you can keep your normal user logged in on Chrome and your superuser logged in on Firefox (or similar), so that you can see how the site behaves for both kinds of users.
The Boostrap CSS is set up for live reloading and SASS compliation.
See:
- http://cookiecutter-django.readthedocs.io/en/latest/live-reloading-and-sass-compilation.html
- https://github.com/twbs/bootstrap/blob/v4-dev/scss/_variables.scss
In development, it is often nice to be able to see emails that are being sent from your application. For that reason local SMTP server https://github.com/mailhog/MailHog with a web interface is available as docker container.
Container mailhog will start automatically when you will run all docker containers. Please check https://cookiecutter-django.readthedocs.io/en/latest/ for more details how to start all containers.
With MailHog running, to view messages that are sent by your application, open
your browser and go to http://127.0.0.1:8025
This application is deployed via Google Cloud Build ( https://cloud.google.com/build ) to Google Cloud Run ( https://cloud.google.com/run ).
There's a cloudbuild.yaml file in the home folder. Secrets (e.g production settings) are managed with Google Secret Manager ( https://cloud.google.com/secret-manager ).