Animals Healthcare Application

A healthcare data management application for pet owners and carers.

The application provides an extensive notebook that offers:

• A clear timeline filtered by tags and note types.
• Manage your pet's profile, ownership and authorization.
• Share notes between users and animals.
• Registration of biometric measurement data.
• Managing a diet plan with the option of setting reminder notifications via e-mail or Discord.
• Archiving notes from visits to medical facilities.

---

Functionality:

ADR

---

Screenshots

Click on the image to view full-size

Animal profile	Full timeline of notes
Diet note details	User registration

---

Plans for further development:

• Interactive charts for biometric records
• A book of medical facilities and medical personnel
• Databases for medicines and food products
• An SMS gateway, and Messenger chatbots for notifications
• A fixed light-themed frontend, currently blocked in the base.html tag

---

Requirements:

• Python 3.12.2
• Docker & Docker Compose
• PostgreSQL 15 (instance for volumes)
• Apache CouchDB 3.3.3 (instance for volumes)
• Packages
• pico-1.5.10

---

Deploy steps:

1. Download repository.
2. Set .env file based on template.
3. Install Docker Desktop.
4. Run containters:

   docker-compose up -d --build
   

---

Dev-instance steps:

1. Download repository.
2. Set .env file based on the template.
3. Install Python, Docker Desktop, PostgreSQL and CouchDB as in Requirements.
4. Install pipenv:

   pipenv install
   

5. Deploy vevn and synch requirements:

   pipenv install --dev
   

6. Install precommit hooks:

   pre-commit install
   

7. Run containters:

   docker-compose up -d --build
   

---

Kubernetes Deploy steps (alternative deploy):

1. Download repository.

2. Set secret.yaml files based on templates.

   • Configure the secret.yaml files based on the templates provided in the kubernetes directory (5 files).

3. Install Docker Desktop.

4. Build Docker images:

   • Build the Docker images for web, CouchDB, PostgreSQL, and Celery services,
   • Example commands:

     docker-compose build
     docker image save -o ahc_app-web.tar ahc_app-web:latest
     docker image save -o ahc_app-queue.tar ahc_app-queue:latest
     docker image save -o ahc_app-couch_db.tar ahc_app-couch_db:latest
     docker image save -o postgres.tar postgres:15-alpine
     

5. Push Docker images to a registry:

   • Push the Docker images to a container registry,
   • Example using Minikube:

     minikube image load ahc_app-web.tar
     minikube image load ahc_app-queue.tar
     minikube image load ahc_app-couch_db.tar
     minikube image load postgres.tar
     

6. Deploy to Kubernetes using kustom files:

   • Deploy the application to Kubernetes using the kustomization files,
   • Example command:

     kubectl apply -k kubernetes/
     

7. Verify deployment:

   • Verify the deployment using a tool like K8s Lens,
   • Alternatively, check the status with the following command:

     kubectl get pods,svc,deploy,ing
     

---

Test running:

• by now tests are only reachable by terminal in main container's terminal (container_name: web)
• simply run command "python manage.py test" or use with needed flags

---

Sources:

• Styles:
  • https://picocss.com/
  • https://uicookies.com/horizontal-timeline/
• Graphics:
  • https://www.flaticon.com/authors/futuer
  • https://www.flaticon.com/authors/pixel-perfect
  • https://www.flaticon.com/authors/riajulislam
  • https://www.midjourney.com/
  • https://pixabay.com/
• Knowledge:
  • https://www.devs-mentoring.pl/

To all the people upper mentioned and not only there, thank You for your work and positive influence on my motivation! Keep still doing your best!