Logo
NeoArc Studio

Version History and Lifecycle Management

Create named version snapshots, manage entity lifecycles with active, planned, and deprecated states, and track architectural evolution across diagrams, graph diagrams, and documentation pages.

Built-in version history and lifecycle management are available for standard diagrams, graph diagrams, and Content Foundry pages. Version snapshots record the state of a document at a specific point in time. Lifecycle tagging marks individual elements as active, planned, or deprecated, giving teams a clear view of what exists today, what is coming next, and what is being retired.

Version Snapshots

Stamp a named version at any milestone to create a permanent record of the document state. Version snapshots are available for standard diagrams, graph diagrams, and Content Foundry pages.

Named Versions
Each version has a user-provided name, optional rich-text description, and automatic timestamp. Versions are numbered sequentially.
Auto-Generated Change Explanations
When stamping a version, the system generates a human-readable summary of changes: elements added, removed, moved, or resized.
Navigate to Any Version
Browse the version history and view any previous version in read-only mode. Exit version view to return to the current live state.
Restore Previous Versions
Restore any previous version to make it the current state. The restored content becomes the new live document.

Lifecycle Tagging

Every node in a diagram or model can carry a lifecycle status. This provides a clear, visual indication of architectural intent across the entire project.

StatusMeaningVisual Indicator
ActiveThe element is live and in production todayDefault styling, fully opaque
PlannedThe element is approved but not yet implementedDashed border or muted styling
DeprecatedThe element is being phased out and should not be used for new workStrikethrough or faded styling

Lifecycle status is stored directly on each node in the model or diagram file. It is queryable, filterable, and propagates through derived views (ERD views, graph views, search views) automatically.

Succession Tracking

When an element is deprecated, NeoArc tracks where it goes next. Two edge types link deprecated elements to their successors:

Repoint Wizard

When deprecating an element, downstream references (schemas, diagrams, pages, endpoints) may still point to the old element. The Repoint Wizard migrates these references to the replacement.

Deprecation Reporting

Two reports help manage the deprecation lifecycle:

Deprecation Impact
Shows all deprecated elements with their inbound reference counts. Identifies which deprecated elements are still actively referenced and by whom.
Safe to Delete
Identifies deprecated elements with zero remaining references. These elements can be safely removed without breaking any downstream consumers.

Page Versioning

Use Cases

Architecture Evolution Documentation
Record how the architecture changes over time with named versions at each milestone. Reviewers browse the history to understand why specific decisions were made.
Migration Planning
Mark legacy components as deprecated, new components as planned, and track the migration by updating lifecycle states as each phase completes.
Compliance Change Tracking
Stamp versions before and after compliance-related changes. The auto-generated change explanation provides an audit trail of what was modified.
Controlled Retirement
Use deprecation impact reports to understand downstream effects before removing elements. The safe-to-delete report confirms when removal is risk-free.