refactor: improve code formatting, type hints, and remove unused files/settings

- Remove `pytest.ini` (options moved to `pyproject.toml`)
- Update type hints to use `|` syntax (requires Python 3.10+)
- Ensure consistent indentation, formatting, and imports across files
- Remove unused or redundant configurations in `.env`
- Simplify and consolidate optional and dev dependencies in `uv.lock` and `pyproject.toml`

Author: Pdzly

.github/workflows/test-backend.yml

@@ -41,7 +41,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v4
         with:
-          version: "latest"
+          version: "0.5.16"
 
       - name: Install dependencies
         run: uv sync --extra test --extra migrations

Taskfile.yml

@@ -2,24 +2,127 @@
 
 version: '3'
 
+vars:
+  COMPOSE_DEV: docker compose
+  COMPOSE_PROD: docker compose -f docker-compose.prod.yml
+
 tasks:
-  dev:frontend:
-    env:
-      APP_DEBUG: true
-    cmd: docker compose --profile dev_frontend up -d --build
+  # ====================
+  # Development
+  # ====================
+  dev:up:
+    desc: Start all development services
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_frontend --profile dev_backend up -d --build"
+
   dev:backend:
+    desc: Start backend only (with database)
     env:
-      APP_DEBUG: true
-    cmd: docker compose --profile dev_backend up -d --build
+      APP_DEBUG: "true"
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_backend up -d --build"
+
+  dev:frontend:
+    desc: Start frontend only
+    env:
+      APP_DEBUG: "true"
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_frontend up -d --build"
+
   dev:down:
+    desc: Stop all development services
     cmds:
-      - docker compose --profile dev_frontend down
-      - docker compose --profile dev_backend down
-      - docker compose --profile dev_db down
+      - "{{.COMPOSE_DEV}} --profile dev_frontend --profile dev_backend down"
+
   dev:reset:
+    desc: Reset development environment (removes volumes)
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_frontend --profile dev_backend down --volumes"
+      - "{{.COMPOSE_DEV}} --profile dev_frontend --profile dev_backend up -d --build"
+
+  dev:logs:
+    desc: Tail logs from all development services
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_frontend --profile dev_backend logs -f"
+
+  dev:logs:backend:
+    desc: Tail backend logs only
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_backend logs -f devbin"
+
+  # ====================
+  # Production
+  # ====================
+  prod:up:
+    desc: Start production services
+    cmds:
+      - "{{.COMPOSE_PROD}} up -d"
+
+  prod:down:
+    desc: Stop production services
+    cmds:
+      - "{{.COMPOSE_PROD}} down"
+
+  prod:logs:
+    desc: Tail production logs
+    cmds:
+      - "{{.COMPOSE_PROD}} logs -f"
+
+  # ====================
+  # Database
+  # ====================
+  db:migrate:
+    desc: Run pending database migrations
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_backend run --rm devbin uv run alembic upgrade head"
+
+  db:migrate:new:
+    desc: "Create new migration (usage: task db:migrate:new -- 'description')"
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_backend run --rm devbin uv run alembic revision --autogenerate -m '{{.CLI_ARGS}}'"
+
+  db:shell:
+    desc: Open PostgreSQL shell
+    cmds:
+      - "{{.COMPOSE_DEV}} exec devbin_db psql -U postgres -d devbin"
+
+  # ====================
+  # Testing
+  # ====================
+  test:
+    desc: Run all backend tests
+    dir: backend
+    cmds:
+      - uv run pytest
+
+  test:unit:
+    desc: Run unit tests only
+    dir: backend
+    cmds:
+      - uv run pytest tests/unit
+
+  test:integration:
+    desc: Run integration tests only
+    dir: backend
+    cmds:
+      - uv run pytest tests/integration
+
+  test:cov:
+    desc: Run tests with coverage report
+    dir: backend
+    cmds:
+      - uv run pytest --cov=app --cov-report=term-missing
+
+  # ====================
+  # Utilities
+  # ====================
+  build:
+    desc: Build all containers
+    cmds:
+      - "{{.COMPOSE_DEV}} --profile dev_frontend --profile dev_backend build"
+
+  clean:
+    desc: Remove all containers and volumes
     cmds:
-      - docker compose --profile dev_frontend down
-      - docker compose --profile dev_backend down --volumes
-      - docker compose --profile dev_db down --volumes
-      - docker compose --profile dev_frontend up -d --build
-      - docker compose --profile dev_backend up -d --build
+      - "{{.COMPOSE_DEV}} --profile dev_frontend --profile dev_backend down --volumes --remove-orphans"
+      - "{{.COMPOSE_PROD}} down --volumes --remove-orphans 2>/dev/null || true"

backend/.env.example

@@ -34,7 +34,8 @@ APP_ALLOW_CORS_WILDCARD=true
 # APP_CORS_DOMAINS=["https://devbin.example.com","https://app.devbin.example.com"]
 # APP_ALLOW_CORS_WILDCARD=false
 
-# Trusted Hosts (for X-Forwarded-For header)
+# Trusted Hosts (for X-Forwarded-For header) - supports CIDR notation
+# Examples: ["127.0.0.1", "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"]
 APP_TRUSTED_HOSTS=["127.0.0.1"]
 
 # Paste Configuration

backend/Dockerfile

@@ -39,17 +39,17 @@ COPY pyproject.toml uv.lock ./
 # Install dependencies
 # --frozen: Use exact versions from uv.lock (reproducible builds)
 # --no-dev: Exclude development dependencies
-# --extra migrations: Include migrations group (psycopg2-binary)
+# --extra production: Include any production related dependencies (redis, aiocache etc...)
 # --no-cache: Prevent uv cache bloat in image
-RUN uv sync --frozen --no-dev --extra migrations --no-cache
+RUN uv sync --frozen --no-default-groups --extra production --no-cache
 
 # ============================================
 # Stage 3: Runtime - Production Image
 # ============================================
 FROM base AS runtime
 
 # Copy uv for runtime execution
-COPY --from=ghcr.io/astral-sh/uv:0.5.16 /uv /uvx /usr/local/bin/
+COPY --from=ghcr.io/astral-sh/uv:0.9.18 /uv /uvx /usr/local/bin/
 
 # Copy installed dependencies from builder stage
 # This excludes build tools (gcc, g++, libpq-dev)

backend/TESTING.md

@@ -7,7 +7,7 @@ This guide explains how to run tests locally and in CI/CD.
 ### 1. Install Test Dependencies
 
 ```bash
-uv sync --extra test
+uv sync --group test
 ```
 
 ### 2. Start Test Database
@@ -52,7 +52,7 @@ tests/
 └── security/         # Security-focused tests
 ```
 
-## Local Development
+## Local Development on tests
 
 ### Managing Test Database
 

backend/alembic/env.py

@@ -1,9 +1,9 @@
 import os
 from logging.config import fileConfig
 
-from alembic import context
 from sqlalchemy import engine_from_config, pool
 
+from alembic import context
 from app.db.models import *
 
 # this is the Alembic Config object, which provides

backend/alembic/versions/08393764144d_add_delete_edit_tokens_and_deleted_at.py

@@ -1,20 +1,21 @@
-"""Add Delete, Edit tokens and deleted at 
+"""Add Delete, Edit tokens and deleted at
 
 Revision ID: 08393764144d
 Revises: 7c45e2617d61
 Create Date: 2025-12-17 22:00:02.736745
 
 """
-from typing import Sequence, Union
+from collections.abc import Sequence
 
 import sqlalchemy as sa
+
 from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '08393764144d'
-down_revision: Union[str, Sequence[str], None] = '7c45e2617d61'
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
+down_revision: str | Sequence[str] | None = '7c45e2617d61'
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
 
 
 def upgrade() -> None:

backend/alembic/versions/20251219_203917_hash_existing_tokens.py

@@ -6,17 +6,18 @@
 
 """
 
-from typing import Sequence, Union
+from collections.abc import Sequence
 
 import sqlalchemy as sa
-from alembic import op
 from argon2 import PasswordHasher
 
+from alembic import op
+
 # revision identifiers, used by Alembic.
 revision: str = "0ed6c1042110"
-down_revision: Union[str, Sequence[str], None] = "08393764144d"
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
+down_revision: str | Sequence[str] | None = "08393764144d"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
 
 # Configure Argon2 with same parameters as token_utils.py
 ph = PasswordHasher(

backend/alembic/versions/4e57d32ab2ac_add_paste_indexes.py

@@ -5,17 +5,15 @@
 Create Date: 2025-12-25 20:15:09.567249
 
 """
-from typing import Sequence, Union
+from collections.abc import Sequence
 
 from alembic import op
-import sqlalchemy as sa
-
 
 # revision identifiers, used by Alembic.
 revision: str = '4e57d32ab2ac'
-down_revision: Union[str, Sequence[str], None] = '6c5a2c764fb8'
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
+down_revision: str | Sequence[str] | None = '6c5a2c764fb8'
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
 
 
 def upgrade() -> None:

backend/alembic/versions/6c5a2c764fb8_add_compression_fields.py

@@ -5,17 +5,17 @@
 Create Date: 2025-12-25 13:23:44.911166
 
 """
-from typing import Sequence, Union
+from collections.abc import Sequence
 
-from alembic import op
 import sqlalchemy as sa
 
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '6c5a2c764fb8'
-down_revision: Union[str, Sequence[str], None] = '0ed6c1042110'
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
+down_revision: str | Sequence[str] | None = '0ed6c1042110'
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
 
 
 def upgrade() -> None: