master -> legacy-production

.github/workflows/rspec.yml

@@ -0,0 +1,71 @@
+name: RSpec Tests
+
+on:
+  push:
+    branches: [ master, main, develop ]
+  pull_request:
+    branches: [ master, main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: gera_test
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=3
+        ports:
+          - 3306:3306
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Ruby 3.4
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.4.7
+        bundler-cache: true
+        cache-version: 2
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y mysql-client
+        bundle install --jobs 4 --retry 3
+
+    - name: Setup database
+      env:
+        RAILS_ENV: test
+        MYSQL_HOST: localhost
+        MYSQL_USER: root
+        MYSQL_PASSWORD: root
+        MYSQL_DATABASE: gera_test
+      run: |
+        cd spec/dummy
+        bundle exec rake db:create
+        bundle exec rake db:schema:load
+
+    - name: Run RSpec tests
+      env:
+        RAILS_ENV: test
+        MYSQL_HOST: localhost
+        MYSQL_USER: root
+        MYSQL_PASSWORD: root
+        MYSQL_DATABASE: gera_test
+      run: |
+        bundle exec rspec
+
+    - name: Upload coverage reports
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage/coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false

.gitignore

@@ -10,3 +10,4 @@ spec/dummy/tmp/
 *.log
 .yardoc/
 .byebug_history
+.claude/settings.local.json

.ruby-version

@@ -0,0 +1 @@
+3.4.7

CLAUDE.md

@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Gera is a Rails engine for generating and managing currency exchange rates for crypto changers and markets. It collects rates from external sources, builds currency rate matrices, and calculates final rates for payment systems with commissions.
+
+## Core Architecture
+
+### Rate Flow Hierarchy
+1. **ExternalRate** - Raw rates from external sources (EXMO, Bitfinex, Binance, CBR, etc.)
+2. **CurrencyRate** - Basic currency rates calculated from external rates using different modes (direct, inverse, cross)
+3. **DirectionRate** - Final rates for specific payment system pairs with commissions applied
+4. **ExchangeRate** - Configuration for commissions between payment systems
+
+### Key Models
+- **RateSource** - External rate providers with STI subclasses (RateSourceExmo, RateSourceBitfinex, etc.)
+- **PaymentSystem** - Payment systems with currencies and commissions
+- **CurrencyPair** - Utility class for currency pair operations
+- **Universe** - Central repository pattern for accessing rate data
+
+### Worker Architecture
+- **RatesWorker** concern for fetching external rates
+- Individual workers for each rate source (ExmoRatesWorker, BitfinexRatesWorker, etc.)
+- **CurrencyRatesWorker** - Builds currency rate matrix from external rates
+- **DirectionsRatesWorker** - Calculates final direction rates with commissions
+- **CreateHistory_intervalsWorker** - Aggregates historical data
+
+## Development Commands
+
+### Running Tests
+```bash
+# Run all tests
+bundle exec rake spec
+
+# Run specific test file
+bundle exec rspec spec/models/gera/currency_rate_spec.rb
+
+# Run with focus
+bundle exec rspec --tag focus
+```
+
+### Building and Development
+```bash
+# Install dependencies
+bundle install
+
+# Run dummy app for testing
+cd spec/dummy && rails server
+
+# Generate documentation
+bundle exec yard
+
+# Clean database between tests (uses DatabaseRewinder)
+```
+
+### Code Quality
+```bash
+# Lint code
+bundle exec rubocop
+
+# Auto-correct linting issues
+bundle exec rubocop -a
+```
+
+## Configuration
+
+Create `./config/initializers/gera.rb`:
+```ruby
+Gera.configure do |config|
+  config.cross_pairs = { kzt: :rub, eur: :rub }
+  config.default_cross_currency = :usd
+end
+```
+
+## Key Business Logic
+
+### Rate Calculation Modes
+- **direct** - Direct rate from external source
+- **inverse** - Inverted rate (1/rate)
+- **same** - Same currency (rate = 1)
+- **cross** - Calculated through intermediate currency
+
+### Supported Currencies
+RUB, USD, BTC, LTC, ETH, DSH, KZT, XRP, ETC, XMR, BCH, EUR, NEO, ZEC
+
+### External Rate Sources
+- EXMO, Bitfinex, Binance, GarantexIO
+- Russian Central Bank (CBR)
+- Manual rates and FF (fixed/float) sources
+
+## Testing Notes
+
+- Uses dummy Rails app in `spec/dummy/`
+- Factory Bot for test data in `factories/`
+- VCR for HTTP request mocking
+- Database Rewinder for fast test cleanup
+
+## File Organization
+
+- `app/models/gera/` - Core domain models
+- `app/workers/gera/` - Background job workers
+- `lib/gera/` - Core engine logic and utilities
+- `lib/builders/` - Rate calculation builders
+- `spec/` - Test suite with dummy app

Gemfile

@@ -6,7 +6,7 @@ git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 # development dependencies will be added by default to the :development group.
 gemspec
 
-gem 'rails', '~> 6.0.6'
+gem 'rails', '~> 8.0'
 gem 'dapi-archivable', '~> 0.1.2', require: 'archivable'
 gem 'active_link_to', github: 'BrandyMint/active_link_to'
 gem 'noty_flash', github: 'BrandyMint/noty_flash'