FastAPI Task Manager — Backend with JWT and health checks

Project overview

This is a REST API for managing tasks, implemented with FastAPI. Users register, log in, get a JWT token, and work with their personal task list. The project also includes health checks and API documentation.

🔐 JWT authentication: registration, login and protected routes.
🧾 Tasks: create, read, update, delete for the current user.
🩺 Health endpoints: /health/live, /health/ready.
📚 Swagger documentation at /api-docs.
🌍 (Optionally) multi-language responses via headers or query params.

View GitHub repository

Tech stack

FastAPI, Pydantic
PostgreSQL, SQLAlchemy
Alembic (migrations)
Uvicorn
Docker / docker-compose
JWT library for tokens

Goal of the project

To show experience with FastAPI, typed endpoints, health checks, and a production-oriented backend setup.

Type: pet project / learning project
Role: backend developer (solo)

My responsibilities

Designed application structure (routers, schemas, services).
Implemented JWT authentication and protected routes.
Configured PostgreSQL and migrations with Alembic.
Added health endpoints and basic service observability.
Set up Docker to run the service together with the database.

Key endpoints

POST /auth/register — register a new user.
POST /auth/login — login and receive JWT token.
GET /tasks/ — list of tasks for the current user.
POST /tasks/ — create a task.
PATCH /tasks/{id} — update a task.
DELETE /tasks/{id} — delete a task.
GET /health/live, /health/ready — service status.

Quick start (Docker)

# 1. Clone the repository
git clone <repository-url>
cd fastapi-task-manager

# 2. Create and configure environment file
cp .env.example .env
# (set DATABASE_URL, JWT_SECRET, etc.)

# 3. Start the service
docker compose up --build

# API:   http://localhost:8000
# Docs:  http://localhost:8000/api-docs