• FastAPI app with OAuth2 authentication
• MySQL database via SQLAlchemy
• Alembic for migrations
• Environment variables managed by python-dotenv
• Local development with Docker Compose and hot reloading
• Unit, integration, and end-to-end tests
• Tasks management using MongoDB
• User profile image using AWS S3
• Caching
• ELK application log
• CI/CD
• User password reset
• Tasks search using elastic search
• Kibana dashboard
• Queue/celery for elastic indexing for tasks
• Deployment
• Kubernetes deployment to GCP
• Monitoring using Prometheus and Grafana
• Stress testing using k6
• Benchmarking

• Python 3.11+
• Create a virtual environment: python3 -m venv .venv
• Activate it: source .venv/bin/activate
• Install dependencies: pip install -r requirements.txt

• Copy .env.example to .env and update values as needed.
• Start services: docker-compose up --build
• App runs at http://localhost:8000
• MySQL runs at localhost:3306

• Ensure your MySQL server is running and matches the credentials in your .env file.
• Activate your virtual environment: source .venv/bin/activate
• Install dependencies: pip install -r requirements.txt
• Run the app with hot reload:

  uvicorn app.main:app --reload

• The app will be available at http://localhost:8000

• Run migrations: PYTHONPATH=. alembic upgrade head
• Create migrations: PYTHONPATH=. alembic revision --autogenerate -m 'MESSAGE'
  Adding PYTHONPATH=. ensures the app module is found

• Run all tests: pytest
• Or use the Makefile for full test automation (including MySQL in Docker):

  make test

The Makefile provides convenient commands for development and testing:

• make venv — Create and install dependencies in a virtual environment
• make run — Run the FastAPI app locally with hot reload
• make up — Start the app and MySQL using Docker Compose
• make down — Stop and remove Docker Compose containers
• make migrate — Run Alembic migrations
• make test — Spin up a MySQL Docker container, run tests, and clean up
• make coverage — Run tests with coverage and generate an HTML report in htmlcov/
• make docker-clean — Remove all Docker containers and volumes

• Make (install via brew install make on macOS or your package manager)
• Docker and Docker Compose (for Docker-based commands)

To run tests with MySQL in Docker:

make test

To run the app locally (without Docker):

make venv
make run

• app/ - FastAPI application code
• tests/ - All test code
• alembic/ - Alembic migrations

• docker-compose up --build - Start app and DB
• alembic revision --autogenerate -m "message" - Create migration
• alembic upgrade head - Apply migrations
• pytest - Run tests

• MongoDB is used for all task management features (create, edit, delete, list, complete/uncomplete).
• MongoDB runs as a service in Docker Compose (see docker-compose.yml).
• The default database is fastapi_tasks on port 27017.
• Make sure MongoDB is running (via Docker or your own instance) before using task endpoints.

• Endpoints for creating, editing, deleting, listing (with pagination), and marking tasks as completed/uncompleted are available under /tasks.
• Task fields: id, user_id, created_at, updated_at, deleted_at, title, description, completed_at.
• Indexes: user_id, created_at, updated_at, deleted_at, completed_at.

For more details, see each folder's README or docstrings.