Modern Python backend built with FastAPI 2.0, SQLAlchemy 2.0, and PostgreSQL.

• FastAPI 2.0 with async/await support
• SQLAlchemy 2.0 with async database operations
• PostgreSQL database with Alembic migrations
• JWT Authentication with Authlib
• Pydantic 2.0 for data validation
• Comprehensive testing with pytest
• Code quality tools (Black, isort, flake8)
• Health checks and monitoring endpoints
• CORS and security middleware

1. Copy environment variables:

cp .env.example .env

2. Fill in the required environment variables in .env

3. Start with Docker Compose:

docker compose up --build

1. Create and activate virtual environment:

cd backend
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install dependencies:

pip install -r requirements.txt

3. Copy environment variables:

cp .env.example .env

4. Fill in the required environment variables in .env

5. Run database migrations:

alembic upgrade head

6. Start the development server:

uvicorn main:app --reload --host 0.0.0.0 --port 8000

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc
• Health Check: http://localhost:8000/health

# Create a new migration
alembic revision --autogenerate -m "Description of changes"

# Apply migrations
alembic upgrade head

# Rollback last migration
alembic downgrade -1

Uncomment this line in main.py if you don't want to use migrations:

user_models.Base.metadata.create_all(bind=engine)

# Run all tests
pytest

# Run with coverage
pytest --cov=.

# Run specific test file
pytest test/test_users.py -v

backend/
├── alembic/           # Database migrations
├── users/            # User management module
│   ├── models.py     # SQLAlchemy models
│   ├── schemas.py    # Pydantic schemas
│   └── routers.py    # API routes
├── utils/            # Utility functions
│   ├── auth.py       # Authentication utilities
│   └── logger.py     # Logging configuration
├── test/             # Test files
├── main.py           # FastAPI application
├── database.py       # Database configuration
└── requirements.txt  # Dependencies

# Create virtual environment
python -m venv .venv

# Activate virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Deactivate virtual environment
deactivate

# Install dependencies
pip install -r requirements.txt

# Update requirements.txt
pip freeze > requirements.txt

# Format code
black .

# Sort imports
isort .

# Lint code
flake8 .

• DATABASE_URL: PostgreSQL connection string
• ALLOWED_ORIGINS: Comma-separated list of allowed CORS origins
• JWT_SECRET_KEY: Secret key for JWT tokens
• JWT_ALGORITHM: JWT algorithm (default: HS256)

• Alembic migrations
• Testing guide