Автоматическое покрытие Legacy-кода тестами: Golden Master и моки

[Combinatorial Input Matrix Generator (AI Fuzzer)]
                                     │
                                     ▼
                ┌────────────────────────────────────────┐
                │  Seam & Proxy Isolation Layer          │
                │  - Virtual System Clock (Fixed time()) │
                │  - PRNG Seed (Fixed mt_rand())         │
                │  - Global State Capture ($GLOBALS)     │
                └────────────────────────────────────────┘
                                     │
                                     ▼
                      [Legacy SUT (System Under Test)]
                                     │
                                     ▼
                      [Output Interceptor (STDOUT, DB)]
                                     │
                                     ▼
                      [Golden Master Snapshot Store]
                      (Canonical JSON / State Hashes)
                                     │
                   (Refactoring / Porting phase)
                                     │
                                     ▼
                     [Equivalence Regression Engine]
               Assert: Output(Refactored) === GoldenMaster

<?php
// Legacy-код с критическими антипаттернами тестируемости
class TaxCalculator {
    public function compute($amount, $regionCode, $isB2B) {
        global $wpdb;
        
        // Антипаттерн 1: Недетерминированное системное время
        $currentHour = (int)date('H');
        
        // Антипаттерн 2: Жесткая зависимость от синглтона
        $config = LegacyRegistry::getInstance()->get('tax_rules');
        
        // Антипаттерн 3: Прямой SQL-запрос к глобальной базе данных
        $row = $wpdb->get_row("SELECT surcharge FROM region_taxes WHERE code = '" . addslashes($regionCode) . "'");
        $surcharge = $row ? (float)$row->surcharge : 0.05;

        $rate = 0.20; // 20% базовая ставка
        
        if ($isB2B) {
            $rate = 0.0; // B2B реверс
        } else {
            // Ночная наценка между 23:00 и 06:00
            if ($currentHour >= 23 || $currentHour < 6) {
                $rate += 0.02;
            }
            $rate += $surcharge;
        }

        $taxAmount = round($amount * $rate, 2);
        
        // Сайд-эффект: запись в глобальный массив аудита
        $GLOBALS['AUDIT_LOG'][] = [
            'region' => $regionCode,
            'tax' => $taxAmount,
            'timestamp' => time()
        ];

        return $taxAmount;
    }
}

<?php
declare(strict_types=1);

/**
 * Подкласс-шпион (Subclass to Test / Seam Pattern).
 * Позволяет подменять системные вызовы без модификации продакшен-логики.
 */
class TestableTaxCalculator extends TaxCalculator {
    private int $frozenHour = 12;
    private array $mockDbRows = [];

    public function setFrozenHour(int $hour): void {
        $this->frozenHour = $hour;
    }

    public function setMockRegionSurcharge(string $region, float $surcharge): void {
        $this->mockDbRows[$region] = (object)['surcharge' => $surcharge];
    }

    /**
     * Переопределение точки замера времени (Time Seam)
     */
    protected function getCurrentHour(): int {
        return $this->frozenHour;
    }
}

import { z } from 'zod';

// Схема декартова произведения входных данных
export const TestCaseSchema = z.object({
  amount: z.number(),
  regionCode: z.string(),
  isB2B: z.boolean(),
  mockHour: z.number().int().min(0).max(23),
  mockSurcharge: z.number(),
});

export type TestCase = z.infer<typeof TestCaseSchema>;

export function generateCombinatorialMatrix(): TestCase[] {
  // Граничные значения для каждого измерения
  const amounts = [0, 0.01, 100, 999.99, 1000000];
  const regions = ['EU', 'US', 'DEFAULT', 'INVALID_EMPTY'];
  const b2bOptions = [true, false];
  const hours = [3, 12, 23]; // Ночь, день, пограничный час
  const surcharges = [0.0, 0.05, 0.15];

  const matrix: TestCase[] = [];

  for (const amount of amounts) {
    for (const regionCode of regions) {
      for (const isB2B of b2bOptions) {
        for (const mockHour of hours) {
          for (const mockSurcharge of surcharges) {
            matrix.push({
              amount,
              regionCode,
              isB2B,
              mockHour,
              mockSurcharge,
            });
          }
        }
      }
    }
  }

  // Сгенерировано 5 * 4 * 2 * 3 * 3 = 360 уникальных комбинаций
  return matrix;
}

import { describe, it, expect } from 'vitest';
import { generateCombinatorialMatrix } from '@/scripts/generate-golden-matrix';

// Имитация детерминированного вызова портированного модуля
import { computeTaxSafe } from '@/lib/tax-engine';

describe('Golden Master: Tax Calculation Regression Suite', () => {
  const cases = generateCombinatorialMatrix();

  it('полностью совпадает с эталонными снимками Golden Master на 360 сценариях', () => {
    const results = cases.map((testCase) => {
      // Инициализация чистого контекста аудита
      const auditLog: Array<{ region: string; tax: number }> = [];

      const result = computeTaxSafe({
        amount: testCase.amount,
        regionCode: testCase.regionCode,
        isB2B: testCase.isB2B,
        currentHour: testCase.mockHour,
        surcharge: testCase.mockSurcharge,
        onAudit: (entry) => auditLog.push(entry),
      });

      return {
        input: testCase,
        output: result,
        auditState: auditLog,
      };
    });

    // Сравнение всего массива состояний со снепшотом Vitest
    expect(results).toMatchSnapshot();
  });
});