terrameijar / invoices

A Django based invoicing app

Vuyisile Ndlovu

I help build reliability into software and operations. I do DevOps and Automation Engineering, developing CI/CD and data pipelines to improve reliability.

About Me

• Software Development
• Cloud
• Automation
• Testing
• Technical Writing

Technologies

• AWS
• Azure
• Python
• PowerShell
• Docker
• Nginx
• Docker
• CI/CD
• Ansible
• CloudFormation
• Kubernetes

Featured Projects

• PyPICache
• DevOps Portfolio
• Database Replication
• Deploying Django + Nginx app to a VPS using ansible

Recent Blog Posts:

🤝Let's Connect

Visitor Count

invoices's Issues

Prepare code for deployment

The code isn't deployment-ready. The following needs to be done:

• Refactor Ansible tasks to NOT contain hard-coded paths
• create and use a prod DB
• remove secret key and other sensitive data from public code. See #6, #4
• Setup CD. #7

Specify supported python version

Add supported python versions on README file

Add a database to the project

Related to #2 and #18

Simplify invoice creation

Reduce the number of form fields in invoice create view

Create an ansible role to setup TLS certs when provisioning the server

Use ansible to setup TLS certs

Optimise gunicorn workers

Split settings file into separate settings for dev and production environment

Separating settings allows for easy handling of configurations based on the environment e.g. SQLite database connection in development and Postgres in production.

Look into Invoice Save logic

Invoice and InvoiceItem save functionality can be improved. Look into best practices for handling post save actions involving one to many relationships.

Unable to build docker image

Running docker-compose build gives the error below:

Unable to run docker compose run

docker compose run is not running after the build, it requires another argument.

Failing to run nginx container

Since the last merge i'm failing to run nginx container using the command docker compose up. I'm getting the following error which seems to be a permission issue.

Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error mounting "/etc/ssl/private" to rootfs at "/etc/nginx/ssl/private": mkdir /var/lib/docker/overlay2/e76a3092d8af6016d28654e23ca504077fc2d7e2690a05f3e7a85e5a31564063/merged/etc/nginx/ssl/private: operation not permitted: unknown

Improve UI on invoice & client pages

The look and feel of the client and invoice edit and creation pages can be improved. Switch the following to Django forms styled with Bootstrap or vanilla CSS:

• New Client Page
• Edit Client Page
• New Invoice Page
• Edit Invoice Page

I want to go from this:

to something like this:

Remove sensitive information from the settings file

The project settings file shouldn't contain any sensitive info like secret keys, credentials and env variables

Dockerise Invoices project

Dockerise the Invoices project and break it up into 3 containers:

• Postgres DB
• Django Application + WSGI server
• Webserver i.e Apache or NGINX

Add ability to edit one's profile

Users can't edit their profiles. We should add functionality to allow them to change information such as their names, passwords, logos and addresses.

The CustomUser model in the Users app has most of the fields to save a user's data. We need a Django view that will allow editing this information.

Add success and error messages to forms

Add success and error messages to all Create and Update views.

Highlight Weasyprint as a project dependency

To make the project installation beginner-friendly, let's add on to the README that weasyprint is a dependency and add a link on how to install it. Users running directly on docker will not have any issues but those trying to run the project on their local machine might have a challenge with installing weasyprint via pip, as it has a plethora of dependencies as well.

Create an ansible role to setup nginx

Use ansible to install and configure nginx.

Create code of conduct and contributing docs

Create CI/CD pipeline for project

• Create a CI pipeline to build and run tests using GitHub actions
• Create a CD pipeline to deploy the project. Deployment platform to be decided.