Scalable Backend Bun API

Este é um projeto de API robusta e escalável desenvolvida com Bun e TypeScript, focada em alta performance e facilidade de manutenção. A aplicação utiliza Prisma ORM para interação com o banco de dados, Redis para otimização de performance e cache, e inclui uma suíte de testes de carga com k6.

🚀 Tecnologias Utilizadas

• Bun - Runtime JavaScript/TypeScript rápido e tudo-em-um.
• TypeScript - Superset de JavaScript com tipagem estática.
• Prisma - ORM (Object-Relational Mapping) moderno.
• Redis - Armazenamento de estrutura de dados in-memory.
• Dotenv - Gerenciamento de variáveis de ambiente.
• k6 - Ferramenta de teste de carga e performance.

📦 Instalação e Configuração

1. Clone o repositório:

   git clone https://github.com/seu-usuario/scalable-bun-prisma-redis-api.git
   cd scalable-bun-prisma-redis-api
   

2. Instale as dependências:

   bun install
   

3. Configuração do Ambiente: Crie um arquivo .env na raiz do projeto e configure a conexão com o banco de dados e outras variáveis necessárias:

   DATABASE_URL="mysql://usuario:senha@localhost:3306/nome_do_banco"
   REDIS_HOST="localhost"
   REDIS_PORT=6379
   

   Nota: O projeto está configurado para utilizar o Redis na porta padrão (6379) e não requer autenticação.

4. Migrações do Banco de Dados: Execute o Prisma para preparar o banco de dados:

   bunx prisma migrate dev
   

🛠️ Execução

Para rodar o servidor em ambiente de desenvolvimento:

bun dev

📊 Testes de Performance

O projeto conta com um script de teste de carga localizado em k6/performance-test.js. Ele simula múltiplos usuários simultâneos no endpoint de criação de produtos (POST /products).

Para executar os testes de performance:

k6 run k6/performance-test.js

Cenário de Teste:

• Rampa de subida: 50 usuários em 30 segundos.
• Manutenção de carga: 50 usuários por 1 minuto.
• Rampa de descida: Redução para 0 usuários em 30 segundos.
• Thresholds: Falha se mais de 5% das requisições errarem ou se o p(95) da duração for > 500ms.

💎 Interface de Dados

Você pode visualizar e gerenciar os dados facilmente utilizando o Prisma Studio:

npx prisma studio