Betting API

Backend сервис для интеграции с платформой ставок, управления пользователями, ставками и балансом.

Возможности

• JWT-аутентификация пользователей
• Размещение ставок, проверка выигрышей
• История ставок и транзакций, баланс
• Интеграция с внешней платформой ставок (API)
• Внутренние endpoint-ы для тестирования интеграции
• Swagger/OpenAPI документация
• Unit-тесты (Jest)
• Поддержка Docker/Docker Compose

---

Быстрый старт (Docker)

1. Клонирование репозитория и переход в директорию проекта

git clone https://github.com/noversez/api-integration-test.git
cd api-integration-test

2. Создание файла .env

Создайте .env на основе .env.example (или вручную пропишите переменные):

• DATABASE_URL=postgresql://postgres:postgres@db:5432/betting_db
• BET_API_URL=https://bets.tgapps.cloud/api
• SECRET_KEY=secretkey
• PORT=3000
• ADMIN_TOKEN=admintoken

3. Сборка и запуск через Docker-compose

docker-compose up --build

• Swagger-документация: http://localhost:3000/docs

• Сервер: http://localhost:3000

---

Быстрый старт (Локально)

1. Клонирование репозитория и установка зависимостей

git clone https://github.com/your-org/betting-api.git
cd betting-api
pnpm install

2. Инициализация .env (можно воспользоваться шаблоном .env.example)

• DATABASE_URL=postgresql://postgres:postgres@localhost:5432/betting_db
• BET_API_URL=https://bets.tgapps.cloud/api
• SECRET_KEY=secretkey
• PORT=3000
• ADMIN_TOKEN=admintoken

3. Миграции и сиды

npx prisma migrate dev --name init
npx prisma db seed

4. Запуск тестов

npx jest

5. Запуск проекта

pnpm run dev

6. Swagger/OpenAPI

• Интерактивная документация: http://localhost:3000/docs

---

Основные endpoint-ы

• POST /api/auth/login — получить JWT-токен по username
• POST /api/bets — разместить ставку (JWT обязателен)
• POST /api/win — получить результат ставки
• POST /api/balance — получить баланс
• GET /api/transactions — история транзакций
• GET /api/bets — история ставок пользователя
• GET /api/bets/:id — получить ставку по id
• GET /api/bets/recommended — рекомендуемая ставка
• /api/internal/ — внутренние endpoint-ы для интеграции/тестирования (JWT admin)

---

Структура проекта

.
├── src/
│   ├── controllers/      
│   ├── services/         
│   ├── routes/           
│   ├── middlewares/      
│   ├── externalApi/      
│   ├── prisma/           
│   └── test/             
├── openapi.yaml          
├── docker-compose.yml    
├── Dockerfile            
├── .env                  
└── README.md

---