Skip to main content

14.11 Version Control

TDengine IDMP has a built-in Git-based version control system that persists all asset model metadata (elements, templates, dashboards, panels, analyses, connections, libraries, etc.) as JSON files in a Git repository, enabling users to track, review, and roll back every change.

Why Version Control?

In industrial scenarios (such as pharmaceuticals and energy), changes to asset models require strict process control:

  • Change Traceability: Who changed what attribute, when, and why?
  • Approval Workflow: Critical changes must be reviewed before taking effect.
  • Rollback Capability: Quickly restore to any historical version after misoperation.
  • Compliance Requirements: Meet FDA 21 CFR Part 11, EU Annex 11, and other regulatory requirements.

IDMP chose Git as its version control engine because it natively provides complete history, diff comparison, branch management, and merge capabilities — the industry's most mature version control solution.

Feature Overview

FeatureDescription
Change TrackingBadge in the top-right corner shows uncommitted change count in real time; one-click opens the change list
Check-InSubmit changes with a reason to create a Git commit
UndoRevert uncommitted changes to the previous version
Diff ComparisonView differences between HEAD and working tree for any change
Personal WorkspaceAutomatically creates personal branches in review modes to isolate unreviewed changes
Pull Request ReviewIn Review Required mode, changes must pass MR/PR review
Electronic SignatureSupports GPG key signing for commits
Version PublishingManage published versions with auto-publish and manual publish options

Edit Modes

IDMP supports three edit modes to meet compliance requirements across industries:

  • Version Track: All users share the main branch; changes are committed directly
  • Review Required: Changes must pass MR/PR review before merging
  • E-Signature: Adds GPG electronic signature on top of Review Required

Publish Modes

  • Auto-Push: Automatically updates the running system after merge
  • Manual: Administrator decides when to publish which version

Contents