https://github.com/vsantos1711/elysia-transaction-validator

🐬 Two microservices using bun and elysia to validate financial transactions, built on an event-driven architecture
https://github.com/vsantos1711/elysia-transaction-validator

bun drizzle elysia kafka microsservices typescript

Last synced: 6 days ago
JSON representation

🐬 Two microservices using bun and elysia to validate financial transactions, built on an event-driven architecture

• Host: GitHub
• URL: https://github.com/vsantos1711/elysia-transaction-validator
• Owner: vsantos1711
• Created: 2024-02-17T21:16:04.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2024-06-23T20:48:33.000Z (6 months ago)
• Last Synced: 2024-06-24T07:57:42.908Z (6 months ago)
• Topics: bun, drizzle, elysia, kafka, microsservices, typescript
• Language: TypeScript
• Homepage:
• Size: 1.43 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 🐬 Building event-driven systems with Kafka and ElysiaJS

_⚠️ This repository was created with the idea to practice using Kafka._

![Frame](https://raw.githubusercontent.com/vsantos1711/elysia-transaction-validator/main/assets/tech.png)

## Problem

Every time a financial transaction is created it must be validated by our anti-fraud microservice and then the same service sends a message back to update the transaction status. For now, we have only three transaction statuses:

- pending

- approved

- rejected

Every transaction with a value greater than **1000** should be rejected.

![Frame](https://raw.githubusercontent.com/vsantos1711/elysia-transaction-validator/main/assets/diagram.png)

## Technologies Used

- **[Bun:](https://bun.sh/)** A fast JavaScript runtime that is used for running the `anti-fraud` and `transaction` services.

- **[Elysia:](https://elysiajs.com/)** A framework used for building the application's web services.

- **[Apache Kafka:](https://kafka.apache.org/)** The event streaming platform used to handle messaging between services.

- **[Drizzle:](https://orm.drizzle.team/)** An ORM (Object-Relational Mapping) tool used for interacting with the database.

- **[PostgreSQL:](https://www.postgresql.org/)** The relational database used for storing transaction data.

## How to run

 Pre-requisites  


To be able to start development the application make sure that you have the following pre-requisites installed:

  

- Bun

  ```bash

  curl -fsSL https://bun.sh/install | bash

  ```

- Docker and Docker Compose installed

- [K6 (optional)](https://k6.io/docs/get-started/installation/)

---

 Running the app  


To be able to start development the application make sure that you have the following pre-requisites installed:

1. Clone repository:

   ```bash

   git clone https://github.com/vsantos1711/elysia-transaction-validate.git && cd elysia-transaction-validate

   ```

2. Start the Kafka using Docker Compose:

   ```bash

   docker compose up

   ```

3. Run the `anti-fraud` service:

   ```bash

   cd anti-fraud && bun install && bun run dev

   ```

4. Run the `transaction` service:

   ```bash

   cd transaction && bun install && bun run dev

   ```

## API Endpoint

### Create Transaction

- **URL:** `/transaction`

- **Method:** `POST`

- **Request Body:**

  ```json

  {

    "accountExternalIdDebit": "string",

    "accountExternalIdCredit": "string",

    "tranferTypeId": 1,

    "value": 1

  }

  ```

## Run k6 test

```bash

k6 run scripts/k6.js

```