Финансовый модуль с использованием PHP

В этом разделе представлены расширенные примеры программного кода для бухгалтерского модуля на PHP. Каждый пример сопровождается выводом и пояснениями.

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

class AuditTrail {
    public static function log(PDO $pdo, $transactionId, $action, $details) {
        $stmt = $pdo->prepare('INSERT INTO audit (transaction_id, action, details, created_at) VALUES (?,?,?,NOW())');
        $stmt->execute([$transactionId, $action, $details]);
    }
}

function createTransactionWithAudit(PDO $pdo, $date, $description, array $entries) {
    $pdo->beginTransaction();
    try {
        // создание проводки (код из content)
        $stmt = $pdo->prepare('INSERT INTO transactions (date, description) VALUES (?,?)');
        $stmt->execute([$date, $description]);
        $transactionId = $pdo->lastInsertId();
        // ... вставка entries ...
        AuditTrail::log($pdo, $transactionId, 'CREATE', "Создана проводка: $description");
        $pdo->commit();
        return $transactionId;
    } catch (Exception $e) {
        $pdo->rollBack();
        AuditTrail::log($pdo, $transactionId ?? 0, 'FAILED', $e->getMessage());
        throw $e;
    }
}

Результат: в таблице audit появится запись с типом действия 'CREATE' или 'FAILED'.

Пояснение: добавлен класс AuditTrail, который записывает все изменения. Это необходимо для соответствия требованиям бухгалтерской отчетности (неизменность истории).

Пример 2. Генерация оборотно-сальдовой ведомости (ОСВ)

function trialBalance(PDO $pdo, $startDate, $endDate) {
    $stmt = $pdo->prepare('
        SELECT 
            a.code,
            a.name,
            COALESCE(SUM(CASE WHEN e.side='debit' THEN e.amount ELSE 0 END), 0) AS debit_total,
            COALESCE(SUM(CASE WHEN e.side='credit' THEN e.amount ELSE 0 END), 0) AS credit_total
        FROM accounts a
        LEFT JOIN entries e ON e.account_id = a.id
        LEFT JOIN transactions t ON t.id = e.transaction_id AND t.date BETWEEN ? AND ?
        GROUP BY a.id
        ORDER BY a.code
    ');
    $stmt->execute([$startDate, $endDate]);
    return $stmt->fetchAll(PDO::FETCH_ASSOC);
}

// Использование:
$report = trialBalance($pdo, '2025-01-01', '2025-03-31');
foreach ($report as $row) {
    echo "{$row['code']} {$row['name']}: Дт {$row['debit_total']}, Кт {$row['credit_total']}
";
}

Пример вывода:
10 Материалы: Дт 50000.00, Кт 30000.00
50 Касса: Дт 20000.00, Кт 10000.00
90 Продажи: Дт 0.00, Кт 70000.00

Пояснение: используется LEFT JOIN, чтобы показать счета с нулевыми оборотами. Фильтрация по дате происходит в условии соединения, а не в WHERE, иначе счета без проводок не попадут в отчет.

Пример 3. Работа с мультивалютностью

// Допустим, в таблице entries добавлено поле currency VARCHAR(3)
// Функция конвертации по курсу на дату
function getExchangeRate(PDO $pdo, $currency, $date) {
    $stmt = $pdo->prepare('SELECT rate FROM exchange_rates WHERE currency = ? AND date <= ? ORDER BY date DESC LIMIT 1');
    $stmt->execute([$currency, $date]);
    $row = $stmt->fetch();
    return $row ? $row['rate'] : 1;
}

// Создание проводки с разными валютами
$entries = [
    ['account_id' => 1, 'side' => 'debit', 'amount' => 100, 'currency' => 'USD'],
    ['account_id' => 2, 'side' => 'credit', 'amount' => 100, 'currency' => 'USD'],
];
// Альтернативно можно хранить сумму в базовой валюте и оригинальную сумму с валютой.

Результат: проводки сохраняются с указанием валюты. Для отчетности необходимо пересчитывать все в базовую валюту (например, RUB) по курсу на дату проводки.

Пояснение: сложность мультивалютности заключается в том, что дебет и кредит могут быть в разных валютах. Обычно используется два подхода: (1) все суммы хранятся в базовой валюте, а исходная валюта и сумма - в дополнительных полях; (2) каждая строка имеет свою валюту, а баланс проверяется с учетом пересчета по кросс-курсу. Второй подход сложнее, но точнее.

Пример 4. Обработка повторяющихся проводок (автоматические начисления)

function scheduleRecurringTransaction(PDO $pdo, $cronExpression, $description, array $entries) {
    // Сохраняем шаблон в таблицу recurring_transactions
    $stmt = $pdo->prepare('INSERT INTO recurring_transactions (cron, description, entries_json) VALUES (?,?,?)');
    $stmt->execute([$cronExpression, $description, json_encode($entries)]);
}

// Крон-скрипт, запускаемый каждый час:
$due = (new DateTime())->format('Y-m-d');
$stmt = $pdo->query("SELECT * FROM recurring_transactions");
foreach ($stmt as $row) {
    // Простейшая проверка: каждое первое число месяца
    if (date('j') == 1) {
        $entries = json_decode($row['entries_json'], true);
        createTransaction($pdo, $due, $row['description'], $entries);
    }
}

Результат: в первое число каждого месяца будет автоматически создаваться, например, проводка по амортизации.

Пояснение: для реальных проектов используйте библиотеку cron-выражений (например, mtdowling/cron-expression), чтобы корректно вычислять время выполнения.

Пример 5. Восстановление баланса после сбоя

function rebuildBalances(PDO $pdo) {
    $pdo->exec('TRUNCATE TABLE account_balances');
    $stmt = $pdo->query('
        INSERT INTO account_balances (account_id, balance)
        SELECT 
            e.account_id,
            SUM(CASE WHEN e.side='debit' THEN e.amount ELSE -e.amount END)
        FROM entries e
        JOIN transactions t ON t.id = e.transaction_id
        GROUP BY e.account_id
    ');
    echo "Балансы пересчитаны.";
}

Результат: таблица account_balances обновляется согласно всем проводкам.

Пояснение: периодический пересчет балансов полезен при обнаружении расхождений. В реальном приложении такой запуск следует блокировать, чтобы не допустить одновременного выполнения.