Legacy -> master

.gitignore

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

.ruby-version

@@ -0,0 +1 @@
+2.7.8

CLAUDE.md

@@ -0,0 +1,210 @@
+# 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
+- Sidekiq testing inline enabled
+
+### Запуск изолированных тестов автокурсов
+
+Для тестов автокурсов (PositionAware, Legacy калькуляторы) используются изолированные тесты,
+которые не загружают Rails и spec_helper. Это позволяет быстро тестировать логику без полной
+загрузки приложения.
+
+```bash
+# Переименовать .rspec чтобы не загружался spec_helper
+mv .rspec .rspec.bak
+
+# Запустить изолированные тесты
+mise exec -- bundle exec rspec spec/services/gera/autorate_calculators/isolated_spec.rb --no-color
+
+# Вернуть .rspec обратно
+mv .rspec.bak .rspec
+```
+
+Или используйте Makefile (требует БД):
+```bash
+make test  # запускает isolated_spec.rb и exchange_rate_spec.rb
+```
+
+**Важно:** Файл `isolated_spec.rb` самодостаточен и содержит все необходимые стабы для Gera модуля.
+
+## 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
+
+
+## Серверы и логи
+
+### Stage сервер
+
+На stage сервере логи находятся тут:
+
+```bash
+scp kassa@89.248.193.193:/home/kassa/admin.kassa.cc/current/log/* .
+```
+
+### Production сервер
+
+```bash
+ssh kassa@185.132.176.44
+cd /home/kassa/admin.kassa.cc/current/log
+```
+
+## Логи калькулятора PositionAware
+
+Калькулятор `PositionAwareCalculator` логирует с тегом `[PositionAware]` на уровне WARN.
+
+### Команды для анализа логов
+
+```bash
+# SSH на production
+ssh kassa@185.132.176.44
+cd /home/kassa/admin.kassa.cc/current/log
+
+# Все логи PositionAware (последние записи)
+grep -i 'PositionAware' production.log | tail -100
+
+# Финальные результаты расчётов
+grep 'FINAL RESULT' production.log | grep PositionAware | tail -50
+
+# Пустые target rates (edge case когда мало курсов)
+grep 'Target position rates.*\[\]' production.log
+
+# Случаи когда не найден rate_above
+grep 'NO rate_above found' production.log | tail -50
+
+# Полный контекст одного расчёта (10 строк до и после FINAL)
+grep -B10 -A2 'FINAL RESULT' production.log | grep PositionAware | tail -100
+```
+
+### Структура логов калькулятора
+
+```
+[PositionAware] START position_from=X position_to=Y        # Начало расчёта
+[PositionAware] autorate_from=A autorate_to=B              # Границы авторейта
+[PositionAware] Filtered rates count: N, our_exchanger_id: 522
+[PositionAware] Target position rates [X..Y]: [...]        # Курсы на целевых позициях
+[PositionAware] Target rate: Z                              # Целевой курс
+[PositionAware] calculate_adaptive_gap: ...                 # Расчёт GAP
+[PositionAware] adjust_for_position_above: ...              # Корректировка
+[PositionAware] FINAL RESULT: X.XXXX                       # Финальный результат
+```
+
+### Особенности интерпретации
+
+- **Отрицательные комиссии** (FINAL RESULT: -0.888) - это нормально
+- **find_non_anomalous_rate_above: result = nil** - часто встречается, не аномалия
+- **Пустые Target position rates []** - когда настроенная позиция > количества курсов
+
+### Ключевые файлы калькулятора
+
+```bash
+# Поиск по имени класса
+grep -r "PositionAware" --include="*.rb" .
+
+# Калькулятор вызывается из:
+# gera/app/models/gera/exchange_rate.rb:162 - метод rate_comission_calculator
+```
+
+# Requirements Management
+
+- **spreadsheet_id:** 1bY_cH5XpuO47qnPsYEdxjkQpwvPNYXHAms_ohkca15A
+- **spreadsheet_url:** https://docs.google.com/spreadsheets/d/1bY_cH5XpuO47qnPsYEdxjkQpwvPNYXHAms_ohkca15A

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', '~> 5.2.2.1'
+gem 'rails', '~> 6.0.6'
 gem 'dapi-archivable', '~> 0.1.2', require: 'archivable'
 gem 'active_link_to', github: 'BrandyMint/active_link_to'
 gem 'noty_flash', github: 'BrandyMint/noty_flash'