How dtm-labs/dtm works
DTM is a distributed transaction manager with Go client libraries, a coordinating server, interchangeable persistence backends, and a Vue administration UI. The main workflow is a caller starting a transaction; the server dispatches branch operations, tracks status and retries, and persists transaction state. Documented transaction modes include Saga, TCC, XA, two-phase messages, and Workflow. The README documents the modes and workflow use; sampled server code shows branch dispatch and storage selection, but not every mode’s complete execution path.
Main entry points: registry.go Storage registry · workflow.go Workflow SDK · main.go Server startup · trans_status.go Status and dispatch
Components 23
Client SDKs
- Go transaction SDK
client/dtmcli/trans_saga.go - gRPC SDK
client/dtmgrpc/msg.go - Workflow SDK
client/workflow/workflow.go - Branch barriers
client/dtmcli/barrier.go
Transaction server
- Server startup
dtmsvr/entry/main.go - HTTP API
dtmsvr/api_http.go - Status and dispatch
dtmsvr/trans_status.go - Saga processing
dtmsvr/trans_type_saga.go - Other transaction modes
dtmsvr
Persistence
- Transaction records
dtmsvr/storage/trans.go - Storage registry
dtmsvr/storage/registry/registry.go - SQL store
dtmsvr/storage/sql/sql.go - Redis store
dtmsvr/storage/redis/redis.go - BoltDB store
dtmsvr/storage/boltdb/boltdb.go
Admin console
- Admin application
admin/src/App.vue - Admin layout
admin/src/layout/components/content.vue - Navigation sidebar
admin/src/layout/components/sidebar.vue - Global transactions
admin/src/views/Dashboard/GlobalTransactions/AllTransactions.vue - Transaction detail
admin/src/views/Dashboard/GlobalTransactions/DialogTransactionDetail.vue - Topic management
admin/src/views/Dashboard/KVPairs/Topics.vue - Live nodes
admin/src/views/Dashboard/Nodes/LivingNodes.vue
Other components
- Service caller
- Administrator
Connections 15
- Service caller → Go transaction SDK: starts transaction
- Service caller → Workflow SDK: executes workflow
- Workflow SDK → Workflow SDK: registers workflow
client/workflow/workflow.go - Server startup → Storage registry: waits for store
dtmsvr/entry/main.go - Server startup → HTTP API: starts server API
dtmsvr/entry/main.go - Status and dispatch → Saga processing: dispatches branches
- Status and dispatch → Transaction records: updates status
- HTTP API → Transaction records: uses storage
dtmsvr/api_http.go - Storage registry → SQL store: registers driver
dtmsvr/storage/registry/registry.go - Storage registry → Redis store: registers driver
dtmsvr/storage/registry/registry.go - Storage registry → BoltDB store: registers driver
dtmsvr/storage/registry/registry.go - Administrator → Admin application: opens console
- Admin application → Admin layout: renders layout
- Admin layout → Navigation sidebar: renders navigation
admin/src/layout/aside.vue - Global transactions → Transaction detail: opens detail
admin/src/views/Dashboard/GlobalTransactions/AllTransactions.vue