Add Python Implementation of Bracket Application

[codegen-sh]

Python Implementation of NCAA Tournament Bracket

This PR adds a modern Python implementation of the Bracket application using FastAPI and SQLAlchemy for rapid development and excellent developer experience.

🐍 Key Features

• FastAPI framework with automatic OpenAPI documentation
• SQLAlchemy 2.0 with async support and comprehensive type hints
• Pydantic v2 for fast data validation and serialization
• JWT authentication with bcrypt password hashing
• Multi-database support (PostgreSQL, SQLite)
• Async/await throughout for high performance I/O operations
• Automatic API documentation with Swagger UI and ReDoc
• Docker support with health checks and multi-stage builds
• Comprehensive testing framework with pytest

🏗️ Architecture

python-bracket/
├── app/
│   ├── models/          # SQLAlchemy models
│   ├── routers/         # API route handlers
│   ├── core/           # Core configuration & database
│   ├── auth/           # Authentication utilities
│   ├── tournament/     # Tournament business logic
│   └── main.py         # FastAPI application
├── tests/              # Test suite
└── docker/            # Docker configuration

🚀 Developer Experience

• Automatic API documentation at /docs (Swagger UI) and /redoc
• Hot reload during development with uvicorn
• Rich error messages with detailed validation feedback
• IDE support with full type checking and autocompletion
• Interactive testing with built-in API documentation
• Modern Python features with type hints throughout

⚡ Performance Benefits

• Async database operations for better concurrency
• Pydantic serialization optimized in Rust
• FastAPI performance comparable to Node.js and Go
• Efficient JSON handling with orjson support
• Connection pooling with SQLAlchemy

🔒 Security Features

• JWT-based authentication with configurable expiration
• Password hashing with bcrypt and salt
• SQL injection prevention with SQLAlchemy ORM
• Input validation with Pydantic models
• CORS configuration for cross-origin requests

📦 Quick Start

# Using Docker Compose
docker-compose up -d

# Or manual setup
pip install -r requirements.txt
python -m uvicorn app.main:app --reload

📚 API Documentation

FastAPI automatically generates comprehensive documentation:

• Swagger UI: Available at /docs
• ReDoc: Available at /redoc
• OpenAPI JSON: Available at /openapi.json

🧪 Testing & Quality

• Comprehensive test suite with pytest
• Type checking with mypy
• Code formatting with black and isort
• Async testing support with pytest-asyncio

🌐 API Compatibility

Maintains full API compatibility with the original Perl implementation:

• All authentication endpoints
• Tournament bracket management
• Player pick functionality
• Admin game result updates
• Leaderboard calculations

This implementation demonstrates Python's capabilities for building high-performance, well-documented APIs while maintaining modern development practices and excellent developer experience.

---

💻 View my work • 🚫 Ban all checks • 👤 Initiated by @mateu • About Codegen