Ticketing-Microservices

KO | EN

gitlite — search

#javascript #react #ai #typescript #rust #deep-learning #docker #macos #awesome #vue #awesome-list #security #mcp #openai

Ticketing-Microservices

(★ 25)

💳 💳💳The Ticket App Microservices Backend is an efficient Node.js and Typescript-based solution that uses microservices, NATS streaming, and Kubernetes deployment for ticketing apps.

Ticketing-Microservices Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Ticketing Project

## Status

![tests-auth](https://github.com/sRayen/Ticketing-Microservices/workflows/tests-auth/badge.svg)
![tests-payments](https://github.com/sRayen/Ticketing-Microservices/workflows/tests-payments/badge.svg)

### 📑 Table of Contents
- [📝 Introduction](#introduction)
- [📘 Description](#description)
- [🧩 Features](#features)
- [🚀 Environment Variables](#environment-varaibles)
- [🏗️ Architecture](#architecture)
- [⏹️ Development](#development)
- [🎬 Screenshots](#screenshots)

## 📘 Introduction <a name="introduction"></a>

**This is a web application that allows users to reserve and purchase tickets to events.**

## 📘 Description <a name="description"></a>

The Ticketing App Microservices Backend is a Node.js Typescript-based **Backend** (a very simple Next.js front-end is made just for demonstration and testing purposes) that leverages **microservices architecture** to provide a scalable and resilient user experience. It is composed of several microservices, each with a specific responsibility, including:

* ➡️ **Auth**: Handles authentication and authorization.
* ➡️ **Expiration**: Uses the Bull package to set expiration times for tickets and delay events by 15 minutes after order creation.
* ➡️ **Common**: A shared npm package that provides interfaces for events.
* ➡️ **Order**: Handles order creation and cancellation, and fires events to notify other services.
* ➡️ **Payment**: Handles payment processing using Stripe.
* ➡️ **Ticket**: Handles ticket creation and updates.
  
⭐ To facilitate communication between services, the Ticket App Microservices Backend uses **NATS Streaming Server**, a lightweight messaging service built on top of NATS.

🌟 The code is written in **Typescript**, which uses interfaces, classes, and generators to ensure a well-organized and maintainable codebase.

🌟 ☸ **Kubernetes** is used to create deployments for each service and its database, as well as to build ingress and set up the NATS Streaming service.

💥 The Ticketing App Microservices Backend is a reliable and efficient solution for ticket app needs. It leverages **Mongoose version numbers** to resolve **concurrency issues** between **services**.

## Features 🧩 <a name="features"></a>

This app has the following functionalities:

* ✔ Sign in/up
* ✔ Add a ticket to the marketplace (seller)
* ✔ Add ticket to cart (buyer) and mark it 'reserved' for 15 min
* ✔ Make an Order
* ✔ Checkout & pay for order

## Environment Variables 🔑  <a name="environment-varaibles"></a>

`JWT_KEY` : string, JSON web token secret <string> (Example: JwtKey)

`STRIPE_KEY`: your stripe API key to handle the payment

## Development	<a name="development"></a>

To manage all the Docker containers inside the Kubernetes cluster and simplify development workflow the project uses Skaffold.

To run the app in development environment, make sure Docker, Kubernetes and Skaffold are installed on your local machine.

Before running the app environment variables inside the Kubernetes cluster must be set. Execute commands below to set these environment variables:

```bash
# kubectl create secret generic stripe-secret --from-literal=STRIPE_KEY=<your_stripe_key>

# kubectl create secret generic jwt-secret --from-literal=JWT_KEY=<your_jwt_key>
```

Be sure to expose the ingress-nginx-controller with:

```bash
# kubectl expose deployment ingress-nginx-contoller --target-port=80 --type=NodePort -n kube-system
```

👉 Start the app with `skaffold dev`.

🔍 [Skaffold ](https://skaffold.dev/) handles the workflow for **building**, **pushing** and **deploying** your application, allowing you to focus on what matters most: **writing code**.

##  Architecture 🏗️🔨 <a name="architecture"></a>

![architecture](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/702adccc-3fb4-4410-acd1-957d639ef7f4)

##  Screenshots 🎬 <a name="screenshots"></a>

### <ins>Deployments</ins>:
![deployments](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/e8b5fb9e-c042-4a1b-ad27-354cd2e77792)

### <ins>SignUp</ins>:
![SignUp](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/24e87bba-7af6-49da-bcfd-84c78c3cdf25)

### <ins>Tickets</ins>:
![Tickets](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/3b187359-8ad3-4b51-8786-c83745abc58a)

### <ins>Purchase Ticket</ins>:
![Purchase Ticket](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/1ebc80eb-661e-429f-be4b-b4bfaa881f86)

### <ins>Orders</ins>:
![orders](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/a289bd53-fc73-4ea5-b71f-5fe10bb8ae93)

### <ins>Microservices logs</ins>:
![logs](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/3df3fc8e-d2d5-4d58-8ec6-eddb7ff97854)

### <ins>Stripe Payments</ins>:
![stripe_payments](https://github.com/SRayen/Ticketing-Microservices/assets/13922445/533b9e7c-ebd5-4c09-94f7-72f650dd04b5)

## Dedication

* 📌 I would like to express my deepest gratitude to [Stephen Grider](https://www.linkedin.com/in/stephengrider/) , the creator of the  [Microservices with Node JS and React](https://www.udemy.com/course/microservices-with-node-js-and-react/)  course on Udemy.
* 📌 It is thanks to Stephen's exceptional expertise and unwavering guidance that this project came to fruition and under his tutelage.
* 📌 This project is a testament to my growth as a Software Engineer and the invaluable lessons I have learned on this incredible learning journey.
* 📌 I am thrilled to share this project with you, and I hope it serves as a tribute to Stephen Grider's incredible teaching and mentorship.

Ticketing-Microservices

Ticketing-Microservices Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Ticketing-Microservices

Ticketing-Microservices Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README