How erickpulido/enterprise-transaction-engine works
This is a Laravel application skeleton with a concrete transaction-engine subsystem: it hashes instructions for idempotency, locks and validates accounts, updates balances and records ledger entries, then queues a ClickHouse projection after commit. The shown files do not expose a transaction-facing route or controller, so the graph starts at the engine rather than inventing a user-to-result path. The README describes Laravel generally, not additional application capabilities; unsampled schema details and runtime wiring are represented only where the tree or excerpts support them.
Main entry points: DatabaseTransactionEngine.php Database Engine · ProjectTransactionToClickHouseJob.php ClickHouse Projection Job · AppServiceProvider.php Service Binding · TransactionEngineInterface.php Engine Contract
Components 14
Laravel Runtime
- HTTP Runtime
public/index.php - App Bootstrap
bootstrap/app.php - Service Binding
app/Providers/AppServiceProvider.php
Transaction Processing
- Engine Contract
app/Contracts/TransactionEngineInterface.php - Transaction Instruction
app/DTO/TransactionInstructionDTO.php - Database Engine
app/Services/DatabaseTransactionEngine.php - Transaction Exceptions
app/Exceptions
Persistence
- Account Records
database/migrations/2026_10_01_230102_create_accounts_table.php - Idempotency Records
database/migrations/2026_10_01_225840_create_idempotency_keys_table.php - Ledger Entries
database/migrations/2026_10_01_230250_create_ledger_entries_table.php - User Model
app/Models/User.php
Analytics Projection
- ClickHouse Projection Job
app/Jobs/ProjectTransactionToClickHouseJob.php - Laravel Queue
- ClickHouse
Connections 12
- HTTP Runtime → App Bootstrap: loads app
public/index.php - Service Binding → Engine Contract: binds contract
app/Providers/AppServiceProvider.php - Service Binding → Database Engine: selects implementation
app/Providers/AppServiceProvider.php - Database Engine → Transaction Instruction: accepts instruction
app/Services/DatabaseTransactionEngine.php - Database Engine → Engine Contract: implements contract
app/Services/DatabaseTransactionEngine.php - Database Engine → Idempotency Records: checks and records
app/Services/DatabaseTransactionEngine.php - Database Engine → Account Records: locks and updates
app/Services/DatabaseTransactionEngine.php - Database Engine → Ledger Entries: inserts entry
app/Services/DatabaseTransactionEngine.php - Database Engine → Transaction Exceptions: throws on invalid
app/Services/DatabaseTransactionEngine.php - Database Engine → ClickHouse Projection Job: dispatches after commit
app/Services/DatabaseTransactionEngine.php - ClickHouse Projection Job → Laravel Queue: runs asynchronously
app/Jobs/ProjectTransactionToClickHouseJob.php - ClickHouse Projection Job → ClickHouse: posts event
app/Jobs/ProjectTransactionToClickHouseJob.php