https://github.com/degisew/event_ticketing_fastapi
An advanced Online Event Ticketing System that enables users to seamlessly browse, book, and manage event tickets. Designed for organizers to create and manage events, and for attendees to easily purchase tickets and track their bookings.
https://github.com/degisew/event_ticketing_fastapi
alembic docker docker-compose fastapi python3 sqlalchemy
Last synced: 2 months ago
JSON representation
An advanced Online Event Ticketing System that enables users to seamlessly browse, book, and manage event tickets. Designed for organizers to create and manage events, and for attendees to easily purchase tickets and track their bookings.
- Host: GitHub
- URL: https://github.com/degisew/event_ticketing_fastapi
- Owner: degisew
- License: mit
- Created: 2025-04-01T09:35:26.000Z (about 1 year ago)
- Default Branch: development
- Last Pushed: 2025-06-15T19:22:53.000Z (about 1 year ago)
- Last Synced: 2025-06-15T21:01:59.168Z (about 1 year ago)
- Topics: alembic, docker, docker-compose, fastapi, python3, sqlalchemy
- Language: Python
- Homepage:
- Size: 89.8 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Event Ticket Reservation
**A scalable event ticket booking platform built with modern backend technologies**
[](LICENSE)
[](https://python.org)
[](https://fastapi.tiangolo.com)
[](https://docker.com)
**Contact**: [degisew.mengist21@gmail.com](mailto:degisew.mengist21@gmail.com) | [LinkedIn](https://linkedin.com/in/degisew-mengist)
## Overview
An advanced Online Event Ticketing System that enables users to seamlessly browse, book, and manage event tickets. Designed for organizers to create and manage events, and for attendees to easily purchase tickets and track their bookings.
**Key Features**:
- Secure JWT authentication and role-based access control.
- Containerized deployment with Docker.
- Background task processing with FastAPI BackgroundTask.
- QR code ticket generation and sending them through email.
- Ticket booking before payment with expiration time.
## Table of Contents
- [Overview](#overview)
- [Quick Start](#quick-start)
- [Project Structure](#project-structure)
- [Setup](#setup)
- [API Reference](#api-reference)
- [Architecture](#architecture)
- [Deployment](#deployment)
## Quick Start
```bash
# Clone the repo
git clone https://github.com/degisew/event_ticketing_fastapi.git
cd event_ticketing_fastapi
# Run with Docker
docker-compose up --build
# OR run locally
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements/dev.txt
fastapi dev main.py
```
**Access**: [http://localhost:8000](http://localhost:8000) for API, [http://localhost:8000/docs](http://localhost:8000/docs) for API docs.
## Project Structure
```bash
├── alembic/ # Alembic migrations Configurations
├── docker
│ └── dev/
│ └── Dockerfile # FastAPI API Dockerfile for development environment
├── src/ # Custom Apps collection
├── docs/ # Documentation files
├── scripts/ # Custom scripts
├── .env # Environment variables (you will create this)
├── compose.yaml # Docker Compose configuration file
└── README.md # This README file
```
## Setup
Show Setup Details
### Prerequisites
- Python 3.10+
- Docker 20.10+ & Docker Compose 1.29+
- PostgreSQL 14+ (for local setup)
- Git 2.30+
### Instructions
1. **Clone the Repository**:
```bash
git clone https://github.com/degisew/event_ticketing_fastapi.git
cd event_ticketing_fastapi
```
2. **Configure Environment**:
```bash
Create a .env file with-in your root project directory and store secure values.
```
Example `.env`:
```bash
# Database
POSTGRES_USER=your_db_user
POSTGRES_PASSWORD=your_db_password
POSTGRES_DB=your_db_name
# FastAPI
SECRET_KEY=your_secret_key
ALGORITHM=HS256
# Optional: pgAdmin
PGADMIN_DEFAULT_EMAIL=admin@example.com
PGADMIN_DEFAULT_PASSWORD=your_pgadmin_password
```
3. **Run the Application**:
- **Docker (Recommended)**:
```bash
docker-compose up --build
```
- **Local Development**:
```bash
python -m venv venv
source venv/bin/activate
pip install -r requirements/dev.txt
fastapi dev main.py
```
4. **Access Services**:
- API: [http://localhost:8000](http://localhost:8000)
- API Docs: [http://localhost:8000/docs](http://localhost:8000/docs)
- pgAdmin (if included): [http://localhost:8001](http://localhost:8001)
## API Reference
Show API Reference
| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/v1/account/users` | POST | Register a new user |
| `/api/v1/account/users/profile/edit` | PATCH | Update current user profile |
| `/api/v1/events` | GET | List all events |
| `/api/v1/events` | POST | Create a new event |
| `/api/v1/events/{id}/reservations` | POST | Reserve a ticket for a specific event |
| `/api/v1/reservations/{id}/payments` | POST | Create Payment for a current user reservations|
| `/api/v1/reservations/me` | GET | Get all reservations for a current user|
| `/api/v1/event/{id}/ticket_types` | GET | List all available ticket types for a specific event |
**Full Docs**: [http://localhost:8000/docs](http://localhost:8000/docs)
## Architecture
**Tech Stack**:
- **Backend**: FastAPI for RESTful APIs
- **Database**: PostgreSQL
- **DevOps**: Docker, Docker-compose
## Deployment
Show Deployment Details
### Production
```bash
# Run with Docker Compose
docker-compose -f compose.prod.yaml up -d
```
### Environment Variables
```bash
DATABASE_URL=postgresql://user:pass@host:5432/db
REDIS_URL=redis://host:6379/0
SECRET_KEY=your-secret-key
ALLOWED_HOSTS=your-domain.com
```
## License
MIT License. See [LICENSE](LICENSE).
**⭐ Star this repo if you found it useful!**
Built by [Degisew Mengist](https://github.com/degisew)
[⬆ Back to Top](#event-ticket-reservation)