Transactions

Overview

A transaction is a record of an individual change or group of related changes made to the file system within a branch. Every file operation performed through the Version Control System - including file creation, upload, rename, move, deletion, and folder operations - is captured as a transaction. Transactions are the atomic units of change tracking in the Version Control System and form the foundation of the project's audit trail.

Each transaction records the following metadata:

• Description - A summary of the operation performed (e.g., "Added file main.py", "Renamed folder config to settings").
• Timestamp - The date and time the operation was performed.
• Performing user - The email address of the authenticated user who executed the operation.
• Transaction hash - A unique identifier for the transaction.

Transaction Grouping

Related transactions are grouped by description and date, providing a structured view of changes. For example, if multiple files are uploaded in a single batch operation, the resulting transactions are grouped under a single description and timestamp, making it straightforward to identify which changes belong to the same logical operation. This grouping is visible in the version history interface and simplifies review of complex multi-file changes.

Auditability

The transaction log provides a complete, tamper-evident history of every modification made to the project's files. Because each transaction is attributed to a specific user and timestamped, the Version Control System enables full traceability of who changed what and when. This audit trail is maintained automatically - no additional configuration or manual logging is required.

In industrial automation environments, this level of traceability is frequently required for compliance with safety standards, quality management systems, and regulatory frameworks that mandate change control documentation for software deployed to operational technology systems.

INFO

Transactions are recorded automatically for every file operation. No manual action is required to track changes - the Version Control System captures all modifications as they occur.