Motiv-Buy @MotivBuyRoBot

Digital marketplace for motivated traffic across Telegram. Built with NestJS, TypeScript, PostgreSQL, Redis & NATS. Multi-provider payments, real-time rates, scalable microservices architecture.

Author

@nmime - t.me/nmime

Technology Stack

• Backend Framework: NestJS 11.x + Fastify 5.x
• Language: TypeScript 5.9 (strict mode)
• Database: PostgreSQL with MikroORM 6.x
• Cache: Redis (ioredis 5.x)
• Message Queue: NATS 2.x
• Bot Platform: grammY 1.x
• Payment Providers: CryptoBot, Heleket, YooKassa
• Rate Providers (Crypto): CoinGecko, Binance, CryptoCompare, Kraken, CoinCodex, Huobi, OKX
• Rate Providers (Fiat): ExchangeRate API, Frankfurter, FreeCurrency API, Coinbase, OpenExchangeRates
• Build Tool: Nx 22.x Monorepo
• Package Manager: pnpm 10.x
• Containerization: Docker & Docker Compose

Project Structure

motiv-buy/
├── apps/
│   ├── api/          # REST API application
│   ├── bot/          # Telegram bot application
│   └── migration/    # Database migration CLI
├── libs/
│   ├── common/       # Cross-cutting concerns
│   │   ├── exception/     # Exception handling
│   │   ├── health/        # Health checks
│   │   ├── intl/          # Internationalization
│   │   ├── logger/        # Logging utilities
│   │   ├── nats/          # NATS messaging
│   │   ├── redis/         # Redis utilities
│   │   ├── response/      # Response formatting
│   │   ├── shared/        # Common utilities
│   │   └── validation/    # Validation pipes
│   ├── database/     # Database entities & repositories
│   └── feature/      # Domain-specific modules
│       ├── auth/          # Authentication & authorization
│       ├── balance/       # User balance management
│       ├── bot/           # Bot-specific features
│       ├── currency/      # Currency management
│       ├── notification/  # Notifications
│       ├── payment/       # Payment processing
│       ├── statistic/     # Statistics & analytics
│       ├── traffic/       # Traffic tracking
│       └── user/          # User management
├── config/           # Configuration files
├── docs/            # Project documentation
└── scripts/         # Utility scripts

Applications

API (apps/api)

REST API backend providing HTTP endpoints for web clients and external integrations.

Features:

• User authentication & authorization
• Payment processing
• Balance management
• Statistics & analytics
• Health checks & monitoring

Bot (apps/bot)

Telegram bot interface for user interactions.

Features:

• Telegram Bot API integration
• Interactive commands
• Payment notifications
• User management
• Bot-specific business logic

Migration (apps/migration)

Database migration CLI tool for managing schema changes.

Features:

• Create migrations
• Run/revert migrations
• Check migration status
• Fresh database setup

Development

Prerequisites

• Node.js 20+
• pnpm 9+
• PostgreSQL 15+
• Redis 7+
• Docker & Docker Compose (optional)

Installation

# Install dependencies
pnpm install

# Build all projects
pnpm run build

# Run tests
pnpm run test

Development Commands

# Start all services in development mode
pnpm run dev

# Start specific app
pnpm run dev:api       # Start API server
pnpm run dev:bot       # Start Telegram bot
pnpm run dev:migration # Start migration CLI

# Build specific app
pnpm run build:api
pnpm run build:bot
pnpm run build:migration

# Run tests
pnpm run test              # Run all tests
pnpm run test:watch        # Watch mode
pnpm run test:coverage     # With coverage
pnpm run test:affected     # Only affected tests

# Code quality
pnpm run lint              # Lint code
pnpm run lint:fix          # Fix lint issues
pnpm run format            # Format code
pnpm run format:check      # Check formatting

# Database migrations
pnpm run migration:run     # Run pending migrations
pnpm run migration:revert  # Revert last migration
pnpm run migration:status  # Check migration status
pnpm run migration:create  # Create new migration
pnpm run migration:fresh   # Fresh database (⚠️ DROPS ALL TABLES!)

Deployment

Quick Start - Deploy from Scratch

→ docs/DEPLOY.md - Single guide with everything you need

This guide covers:

• Server setup
• GitHub secrets (what to fill and where)
• Deploying to staging
• Deploying to production

GitHub Actions Workflows

• CI: Automated testing, linting, and Docker builds (runs on push/PR)
• Deploy: Manual deployment to staging (any branch except master) or production (master only)
• Update SSL: Automatically update SSL certificates
• CodeQL: Security analysis
• Run Migrations: Manual database migration execution

How to Deploy

Staging:

# 1. Push your branch
git push origin feature/my-feature

# 2. Go to GitHub → Actions → Deploy
# 3. Select your branch and staging environment
# 4. Click "Run workflow"

Production:

# 1. Merge to master
git checkout master
git merge feature/my-feature
git push origin master

# 2. Go to GitHub → Actions → Deploy
# 3. Select master branch and production environment
# 4. Click "Run workflow"

Documentation

API Documentation (Production)

• External API (HTML) - External API documentation (HTML)
• External API (JSON) - External API documentation (OpenAPI JSON)
• Public API - Public API documentation
• Private API - Private/Internal API documentation

Project Documentation

• CLAUDE.md - Code standards and development guidelines
• docs/DEPLOY.md - Deploy from scratch
• docs/ - All documentation

License

MIT License - Free to use, modify, and distribute.