Link Tracker

Production-ready FastAPI backend for tracking updates from resources (GitHub repositories, Stack Overflow questions, RSS feeds, blogs, docs pages, and generic websites) with pluggable providers and notification channels.

Features

• Secure registration/login with JWT access + refresh tokens
• Role-based authorization
• Full CRUD for tracked links
• URL validation + automatic provider detection
• Periodic background checks with configurable intervals
• Efficient update detection using ETag / Last-Modified / content digest fallback
• Retry + rate limit safeguards for external calls
• Update history + deduplicated notifications
• Extensible notification channels and provider architecture
• Search/filter/sort/pagination for links
• Consistent API response envelope
• Alembic migrations
• Structured logging
• Unit + integration tests
• Docker + Docker Compose for local development

Quickstart

1. Copy environment:

cp .env.example .env

2. Start services:

docker compose up --build

3. API docs:

• http://localhost:8000/docs

Local (without Docker)

python -m venv .venv
source .venv/bin/activate  # or .venv\\Scripts\\activate on Windows
pip install -e .[dev]
alembic upgrade head
uvicorn app.main:app --reload

Tests

pytest

Architecture

• app/services/providers/*: provider detection and update extraction logic
• app/services/notifiers/*: channel strategy implementations
• app/services/checker.py: periodic link check orchestration
• app/api/v1/endpoints/*: REST endpoints
• app/models/*: SQLAlchemy models
• app/schemas/*: Pydantic request/response models