Secure User Management API

A production-style FastAPI backend for secure user management, JWT authentication, role-based access control and PostgreSQL persistence.

Live Demo

JWT backend deployed on Render:

• Root Endpoint
• Health Check
• Readiness Check
• Swagger API Docs

Current Status

Area	Status	Area	Status
FastAPI backend	✅ Complete	Docker support	✅ Complete
PostgreSQL database	✅ Connected	Render deployment	✅ Live
SQLAlchemy ORM	✅ Complete	Swagger API documentation	✅ Available
JWT authentication	✅ Working	Backend tests	✅ Basic coverage added
Password hashing	✅ Working	Backend CI	✅ Passing
Role-based access control	✅ Working	Docker CI	✅ Passing

Features

• JWT authentication
• Role-based access control
• Protected user and administrator endpoints
• PostgreSQL persistence
• SQLAlchemy ORM
• Docker Compose development environment
• Automated testing with pytest
• Continuous integration with GitHub Actions

Tech Stack

Area	Technologies
Backend	Python, FastAPI, SQLAlchemy, Uvicorn
Database	PostgreSQL
Authentication	JWT, OAuth2, bcrypt password hashing
Testing	pytest
DevOps / Tooling	Docker, Docker Compose, GitHub Actions, Render, Git, GitHub

Screenshots

Swagger API Docs	GitHub Actions CI	Render Deployment

Quick Start

Clone the repository:

git clone https://github.com/Iris408/secure-user-management-api
cd secure-user-management-api

Run with Docker Compose:

docker compose up --build

Local API:

http://127.0.0.1:8002

Swagger Docs:

http://127.0.0.1:8002/docs

Run tests:

docker compose exec api pytest

Documentation

For more detailed project documentation this is available in the docs/ folder.

Document	Description
Setup Guide	Environment variables, Docker setup, manual setup, and test commands
API Reference	Main API endpoints and route notes
Auth Flow	JWT authentication, protected routes, and admin-only access
Project Details	Architecture, limitations, future improvements, and learning notes
CI/CD Notes	Backend CI and Docker CI workflow notes

Project Summary

Secure User Management API is a backend portfolio project built to practise real API development skills: user authentication, JWT token handling, role-based access control, PostgreSQL persistence, Dockerized development, health checks, testing, deployment, and CI/CD validation.

License

This project is licensed under the terms in MIT LICENSE file for details.

Author

Built by Iris408