A simple app manage (CRUD) debtors, their bank account data (IBAN) and invoices.
The models.txt file and the api.txt file contains all the models and the APIs that we have in the app, respectively.
Both of the models and the APIs are built upon the wireframe file
yarn install
virtualenv venv
call venv\Scripts\activate
pip install -r requirements_dev.txt
python manage.py migrate
python manage.py runserver
From another tab in the same directory:
yarn serve
- Before running
yarn serve, you will need to write .env file with GOOGLE_OAUTH_CLIENT_ID and runyarn buildto bake in your Google client id for development.
The Vuejs application will be served from localhost:8080 and the Django Api
and static files will be served from localhost:8000.
To run the app using Docker just add 127.0.0.1 debtor.admin into your hosts file (in system32/drivers/etc folder).
After that, add your .env file similar to sample.env file
Then you're ready to launch your development containers:
docker-compose -f docker-compose-dev.yml up -d
For staging containers:
docker-compose -f docker-compose.yml -f docker-compose-staging.yml up -d
You will find the app on http://debtor.admin
For full guide about deployment and management in your own server, please refer to this guide from Dorm Portal project (which has very similar setup to this one).
You can use the "one-click deploy" button below to try it out on Heroku, but you would still to do the following:
- Add admin user
Simply by running these commands, you will get an admin account with "admin" password.
DONT FORGET TO CHANGE PASSWORD LATER
heroku git-remote -a YOUR_APP_NAME
heroku run python manage.py shell
from django.contrib.auth.models import User
User.objects.create_superuser('admin', 'admin@example.com', 'admin')
- Adding Social App
You need to add your Google OAuth credentials to the app through the Django admin.
- ENJOY!
