Task Manager API

Production-ready REST API for managing users and tasks with role-based access control, built with async FastAPI and PostgreSQL.

Features

• JWT authentication (access + refresh tokens)
• Role-based access control (admin / worker)
• Task assignment, filtering by status, search by title
• Task and user statistics
• Password change
• Database migrations with Alembic
• Fully containerized with Docker Compose
• Unit & integration tests with Pytest

Tech Stack

Layer	Technology
Framework	FastAPI (async)
Database	PostgreSQL + SQLAlchemy 2.0 ORM
Migrations	Alembic
Auth	JWT (PyJWT) + bcrypt
Validation	Pydantic v2
Architecture	Clean Architecture, Repository + Service pattern, Unit of Work
Infrastructure	Docker, Docker Compose
Testing	Pytest

Project Structure

├── app/          # FastAPI routers
├── service/      # Business logic
├── repository/   # Database queries
├── models/       # SQLAlchemy models
├── schemas/      # Pydantic schemas
├── core/         # Config, enums, exceptions
├── database/     # Session, Unit of Work
├── utils/        # JWT, dependencies
└── alembic/      # Migrations

API Endpoints

Auth

Method	URL	Auth	Description
POST	/auth/register	🔓	Register new user
POST	/auth/user_login	🔓	Login, get tokens
GET	/auth/me	🔒	Get current user
POST	/auth/refresh	🔓	Refresh access token
PATCH	/auth/change_password	🔒	Change password

Users

Method	URL	Auth	Description