chore: project setup

Author: satyam-seth

.env

@@ -0,0 +1 @@
+MANAGE_PY_PATH=manage.py

.githooks/pre-push

@@ -0,0 +1,19 @@
+#!/bin/bash
+
+echo "Running tests with coverage..."
+
+coverage run manage.py test
+status=$?
+
+if [ $status -ne 0 ]; then
+  echo "❌ Tests failed. Push aborted."
+  exit 1
+fi
+
+coverage report --fail-under=85  # set your threshold
+if [ $? -ne 0 ]; then
+  echo "❌ Coverage is below threshold. Push aborted."
+  exit 1
+fi
+
+echo "✅ Tests passed and coverage is acceptable. Proceeding with push."

.github/workflows/basic-checks.yaml

@@ -0,0 +1,42 @@
+name: 🚦 Basic Checks
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  quality-checks:
+    name: Quality Checks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🐍 Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: 📦 Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: 🎨 Run black (formatting)
+        run: black --check .
+
+      - name: 🧹 Run isort (import sorting)
+        run: isort --check-only .
+
+      - name: 🧐 Run mypy (type checking)
+        run: mypy .
+
+      - name: 🔍 Run pylint (linting)
+        run: pylint **/*.py
+
+      - name: 🧪 Run tests with coverage
+        run: coverage run manage.py test
+
+      - name: 📊 Generate coverage report (fail if <85%)
+        run: coverage report --fail-under=85

.gitignore

@@ -0,0 +1,5 @@
+.venv
+__pycache__/
+*sqlite3
+.coverage
+htmlcov

.pre-commit-config.yaml

@@ -0,0 +1,52 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v2.3.0
+    hooks:
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/psf/black
+    rev: 25.1.0
+    hooks:
+      - id: black
+        name: black to format python code
+
+  - repo: https://github.com/pycqa/isort
+    rev: 6.0.1
+    hooks:
+      - id: isort
+        name: isort to sort imports
+        args:
+          - --profile
+          - black
+          - --verbose
+          - --skip-glob
+          - "**/migrations/*.py"
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.17.0
+    hooks:
+      - id: mypy
+        name: mypy to check types
+        additional_dependencies:
+          - django-jazzmin==3.0.1
+          - django-stubs==5.2.2
+          - djangorestframework==3.16.0
+          - djangorestframework-stubs==3.16.1
+        args: ["--config-file=mypy.ini"]
+
+  - repo: https://github.com/pycqa/pylint
+    rev: v3.3.7
+    hooks:
+      - id: pylint
+        name: pylint to check code quality
+        entry: pylint
+        language: python
+        types: [python]
+        args: ["--rcfile=.pylintrc"]
+        additional_dependencies:
+          - django-jazzmin==3.0.1
+          - Django==5.2.4
+          - pylint-django==2.6.1
+          - djangorestframework==3.16.0