- ๐ Introduction
- ๐ Getting Started
- ๐ API Reference
- ๐๏ธ๐จ Architecture
- ๐ฅ Authors
- ๐ค Contributing
- โญ๏ธ Show Your Support
- ๐ญ Up Next
- ๐ Lessons Learned
The Ticket App Microservices Backend is a Node.js Typescript-based backend that utilizes microservices architecture to provide a seamless user experience. This backend is composed of several microservices including Auth, Expiration, Common, Order, Payment, and Ticket. Auth handles authentication and authorization, while Expiration uses the Bull package to set expiration time for tickets and delay events for 15 minutes after order creation. Common is an npm package that shares the code of events interfaces. Order handles order creation and cancellation with firing events, Payment handles payment using Stripe, and Ticket handles ticket creation and updates. To handle message streaming between services, this backend uses NATS streaming service built on top of NATS-streaming.
The code is written in Typescript, making use of interfaces, classes, and generators to ensure a well-organized and easily maintainable codebase. Kubernetes service and deployment were used to create a deployment for each service and its database and to build ingress and set up the NATS streaming service. This Ticket App Microservices Backend provides a reliable and efficient backend for your ticket app needs. The Ticket App Microservices Backend is a reliable and efficient solution for ticket app needs, with Mongoose version numbers utilized to solve concurrency issues between services.
To get a local copy up and running, follow these steps.
In order to run this project you need:
To run this project, you will need to add the following environment variables to your secrets.yaml file
JWT_KEY
: string, JSON web token secret (Example: JwtKey)
SALT_FACTORY
: number of rounds to create salt for hashing ( Example: 10 )
STRIPE_KEY
: your stripe API key to handle the payment
Note: All environment variables must be encoded in base64 format.
-
Setup Ingress-Nginx Controller, refer to the documentation for instructions. This will guide you through the process of setting it up correctly to handle incoming traffic.
-
Clone this repository to to your preferred directory:
cd my-folder
git clone https://github.com/ahmedeid6842/Tickets.git
Install this project with kubectl :
kubectl apply -f ./infra/k8s
After following the above instructions, the Kubernetes cluster should be up and running.
- To verify the health of all Kubernetes cluster components and ensure that they are in a ready state, you can run the following command in the terminal:
kubectl get all
- Alright, it's showtime! ๐ฅ Hit
ticketing.dev/api/users/currentuser
and BOOM! ๐ฅ You should see the microservices working like a charm. โจ๐งโโ๏ธ
Note: the reason you are receiving
{"currentUser":null}
is because you are not currently logged in. However, this indicates that the services are operational and functioning properly.
Here is the link to the Postman documentation for Tickets: Postman Docs - Tickets.
- Presented here is the general infrastructure diagram for the ticket cluster, illustrating the communication channels utilized by the distinct services to interoperate with one another.
Ahmed Eid ๐โโ๏ธ
- Github: @ahmedeid6842
- LinkedIn : Ahmed Eid
- Twitter: @ahmedeid2684
We're always looking to improve this project! ๐ If you notice any issues or have ideas for new features, please don't hesitate to submit a pull request ๐ or create a new issue ๐ก. Your contribution will help make this project even better! โค๏ธ ๐ช
If you find this project helpful, I would greatly appreciate it if you could leave a star! ๐ ๐
- Implement validation for incoming requests ๐ฆ
- Add automated testing for each microservice ๐งช
- Implement "Forgot Password" functionality ๐
-
Understanding of concurrency issues and techniques to mitigate them.
-
Development of a good interface and base classes using TypeScript to enhance code organization and reusability.
-
Configuration and use of a message broker to facilitate event sharing between microservices.
-
Creation of a robust architecture for the microservices cluster using Kubernetes.
-
There is always something new to learn ๐จโ๐ป.