Activity Tracker

A web application for tracking physical activity, sharing posts, and generating activity statistics. Django, PostgreSQL for storing user data and Bootstrap for simple frontend. Plotly used for interactive graphs of user data inside app. Tested using GH Actions and Selenium

Project Files

|-- pyproject.toml
|-- uv.lock
|-- .env.example
|-- .github/workflows/django.yml        # CI pipeline
|-- activityTracker/                    # Django configuration
|-- main/
|   |-- admin.py
|   |-- apps.py
|   |-- forms.py # Django forms
|   |-- models.py # database models
|   |-- urls.py # app URL routes
|   |-- views.py # request handlers
|   |-- migrations/
|   `-- templates/
|       |-- main/                       # templates for app pages
|       `-- registration/               # login/register pages
|-- tests/                              # automated tests
|-- manage.py

Features

• User registration and authentication (including Google OAuth via django-allauth)
• Activity tracking by category and duration
• Social feed with posts, comments, follow/unfollow
• CSV import/export for activities
• Activity reports with Plotly charts
• Profile privacy and account settings

Use Cases

• As a user, I track my physical activity by creating entries with category and duration.
• As a user, I review my progress by generating charts and activity reports.
• As a user, I share updates by publishing posts and adding comments.
• As a user, I discover other people by searching profiles and following accounts.
• As a user, I keep my data portable by exporting and importing activities via CSV.

Tech Stack

• Python 3.10 language
• Django 5 main framework
• PostgreSQL storing user data
• Plotly, Pandas interactive charts
• Bootstrap simple frontend
• Selenium for automated project testing
• GH Actions for CI/CD development/testing

How to install

1. Clone the repository

2. Create PostgreSQL database (name must match DB_NAME in .env):

CREATE DATABASE activityDB;

1. Create .env with your local PostgreSQL credentials. Look at .env.example

2. Install dependencies and run server

uv sync
uv run python manage.py migrate
uv run python manage.py runserver

Showcase

User can register on the register page.

User can add new activities with a name, category, and time. All validations are included

User can view and generate charts based on his activities. He can download them and upload from csv.

License

MIT License. See LICENSE. This project is for educational purposes. It was built to practice Django web development, PostgreSQL integration, authentication flows, and basic product design patterns.