🪾 Alpha Platform Release - Change Tracking - 26.01.20.0.0-lts

Neutrinos Platform Product Release Notes
,
1

Release Date: January 20, 2026
Release Channel: LTS
Version: 26.01.20.0.0-lts

:warning: Before Helm Upgrade

[!IMPORTANT]
Run SQL migrations before deploying. Execute in the exact order specified below.

Migration Order

Step Type What Service
1 SQL Change Tracking schema config-service DB
2 SQL BPM Config Version schema config-service DB
3 SQL Editor Lock branch scoping config-service DB
4 SQL Case Definition branch isolation case-service DB
5 API BPM Config Versioning migration alpha-config-service
6 API Change Tracking initialization alpha-delta-service

:new_button: New Features

:shuffle_tracks_button: Config Change Tracking

Git-like versioning for configuration management with full audit capabilities.

Features:

  • Branch Management - Create, switch, and delete branches for isolated configuration development
  • Branch/Tag Comparison - View diff between branches, tags, or commits
  • Semantic Diff - Human-readable diff for all config types
  • Pull Requests & Reviews - Create PRs with descriptions, request reviews, and add comments
  • Merge - Merge branches with automatic conflict detection (conflict resolution UI coming soon)
  • Commit History - Full commit log with author, timestamp, and change details
  • Audit Trail - Comprehensive audit view of all change tracking operations
  • Tag Support - Create tags to mark release points or milestones
  • Branch-specific Preview - Preview configurations as they exist on any branch in Case Manager and Admin UI
New Tables (alpha_config_service schema)
  • change_tracking_audit - Audit log for all change tracking operations
  • change_tracking_branches - Branch metadata (name, head commit, timestamps)
  • change_tracking_commits - Commit records with parent references and snapshots
  • change_tracking_config_type_metadata - Config type versioning metadata
  • change_tracking_pr_reviews - Pull request review records
  • change_tracking_pull_requests - PR metadata (source/target branches, status)
  • change_tracking_snapshots - Point-in-time configuration snapshots
  • change_tracking_snapshot_contents - Snapshot-to-config mappings
  • change_tracking_commit_tag - Tag-to-commit associations

:clipboard: Process Config Versioning

Process task definition versioning per project, enabling version tracking for BPM configurations.

Database Changes (alpha_config_service schema)

New Tables:

  • bpm_config - BPM configuration versions per project
  • bpm_config_current_version - Current active BPM version per project

Modified Tables:

  • config_project_tags - Added bpmConfigVersion, bpm_config_id columns
  • process_definition - Added bpm_config_id foreign key

:locked_with_key: Branch-scoped Editor Locks

Users on different branches can edit the same configuration independently. Editor locks are scoped to the branch context when change tracking is enabled.

Database Changes
  • track-editor-locks - Added branchName column (default: ‘main’)

:herb: Case Definition Branch Isolation

Case definitions can be isolated by branch when CHANGE_TRACKING is enabled. The same caseType can exist on different branches with different configurations.

Database Changes (case_service_schema)
  • case_definition - Added branch column (default: ‘main’), changed unique constraint from (case_type) to (case_type, branch)

:counterclockwise_arrows_button: Database Migrations

SQL Migrations

Steps 1-3: Config Service (config-service DB)

Apply: dbscripts/26.01.20.0.0-lts/alpha-config-service/migration.sql

Key changes:

  • Creates Change Tracking tables with indexes
  • Creates BPM Config versioning tables
  • Adds branchName column to track-editor-locks

Step 4: Case Service (case-service DB)

Apply: dbscripts/26.01.20.0.0-lts/alpha-case-service/migration.sql

Key changes:

  • Adds branch column to case_definition table
  • Replaces unique constraint (case_type) with (case_type, branch)
  • Creates index on branch column

API Migrations

Step 5: BPM Config Versioning (alpha-config-service)

# Check status
POST /configservice/migration-module/bpm-config-versioning/status

# Dry run
POST /configservice/migration-module/bpm-config-versioning/up
Body: { "dryRun": true }

# Execute
POST /configservice/migration-module/bpm-config-versioning/up
Body: { "batchSize": 50, "batchDelayMs": 1000 }

Step 6: Change Tracking Init (alpha-delta-service)

# Dry run
POST /deltaservice/admin/change-tracking/init
Body: { "dryRun": true }

# Execute
POST /deltaservice/admin/change-tracking/init
Body: {}

:wrench: Environment Variables

New Environment Variables

alpha-config-service

Env Variable Name Description Example
FEATURE_FLAGS Feature flags array (add entries) See note

Note: Add "CHANGE_TRACKING" and "BPM_CONFIG_VERSION" to existing FEATURE_FLAGS array:

FEATURE_FLAGS: '["ADMIN_FILTERS","PULL_TASK", "CHANGE_TRACKING", "BPM_CONFIG_VERSION"]'

alpha-caseservice

Env Variable Name Description Example
FEATURE_FLAGS Feature flags array (add entries) See note

Note: Add "CHANGE_TRACKING" to existing FEATURE_FLAGS array:

FEATURE_FLAGS: '["PULL_TASK","ADMIN_FILTERS","INBOX_PROJECTION", "CHANGE_TRACKING"]'

alpha-workflow-studio

Env Variable Name Description Example
ALPHA_UI_DELTA_SERVICE_URL Delta service URL https://{DOMAIN}/deltaservice
ALPHA_DELTA_UI_BASE_URL Change tracking UI base URL https://{DOMAIN}/change-tracking
FEATURE_FLAGS Feature flags array '[...,"CHANGE_TRACKING"]'

alpha-admin-ui

Env Variable Name Description Example
ALPHA_UI_DELTA_SERVICE_URL Delta service URL https://{DOMAIN}/deltaservice
ALPHA_SERVICES Enabled Alpha services list '["ALPHA_CONFIG_URL", "ALPHA_CASE_URL", "ALPHA_DASHBOARD_URL", "ALPHA_MODULES_URL"]'
FEATURE_FLAGS Feature flags (add entry) '[...,"CHANGE_TRACKING"]'

alpha-case-manager-ui

Env Variable Name Description Example
ALPHA_UI_DELTA_SERVICE_URL Delta service URL https://{DOMAIN}/deltaservice
FEATURE_FLAGS Feature flags (add) '[...,"CHANGE_TRACKING"]'

alpha-delta-service (service)

Env Variable Name Description Example
ALPHA_ADMIN_SERVICE_URL Admin service URL https://{DOMAIN}/adminservice

alpha-delta-ui (ui)

Env Variable Name Description Example
ALPHA_UI_MAKE_REQUEST_URL Version endpoint URL https://{DOMAIN}/version
ALPHA_UI_DELTA_SERVICE_URL Delta service URL https://{DOMAIN}/deltaservice
ALPHA_UI_BASE_HREF Base href for UI routing '/change-tracking/'

Removed Environment Variables

Service Removed Variable
alpha-admin-service ALPHA_DASHBOARD_URL
alpha-auth-service AUTH_DB_SESSION_TABLE
alpha-case-manager-ui ENQUIRY_MERGE_CASE_BY_TASKS
alpha-delta-service ENABLE_SWAGGER_STATS
alpha-delta-ui ALPHA_UI_VERSION_SERVICE_URL, SKIP_ALPHA_AUTH, ALPHA_SERVICES, BASE_PATH, ALPHA_MAKE_REQUEST_URL

Renamed Environment Variables (alpha-delta-ui)

Old Name New Name
ALPHA_UI_VERSION_SERVICE_URL ALPHA_UI_DELTA_SERVICE_URL
ALPHA_MAKE_REQUEST_URL ALPHA_UI_MAKE_REQUEST_URL
BASE_PATH ALPHA_UI_BASE_HREF

:camera_with_flash: Docker Images

Service Name Image Repository Image Version
alpha-admin-service neutrinos.azurecr.io/alpha/admin 26.1.1.0.54-312ce97ad6-neutrino
alpha-admin-ui neutrinos.azurecr.io/alpha/alpha-admin-ui 26.1.1.0.72-312ce97ad6-neutrino
alpha-auth-service neutrinos.azurecr.io/alpha/alpha-auth-service 26.1.1.0.52-312ce97ad6-neutrino
alpha-bpm neutrinos.azurecr.io/alpha/neutrinos-cm-bpm 1.0.0
alpha-bpmservice neutrinos.azurecr.io/alpha/alpha-jbpm-service 26.1.1.0.54-312ce97ad6-neutrino
alpha-case-manager-ui neutrinos.azurecr.io/alpha/alpha-case-manager-ui 26.1.1.0.85-312ce97ad6-neutrino
alpha-caseservice neutrinos.azurecr.io/alpha/alpha-case-service 26.1.1.0.73-312ce97ad6-neutrino
alpha-config-service neutrinos.azurecr.io/alpha/alpha-config-service 26.1.1.0.98-312ce97ad6-neutrino
alpha-delta-service neutrinos.azurecr.io/alpha/alpha-delta-service 26.1.0.0.56-312ce97ad6-neutrino
alpha-delta-ui neutrinos.azurecr.io/alpha/alpha-delta-ui 26.1.0.0.74-312ce97ad6-neutrino
alpha-enquiry-service neutrinos.azurecr.io/alpha/alpha-enquiry-service 25.3.0.0.25-42e3424c4-prod
alpha-modules-server neutrinos.azurecr.io/alpha/alpha-module-service 26.1.1.0.62-312ce97ad6-neutrino
alpha-task-distributor neutrinos.azurecr.io/alpha/alpha-task-distributor 26.1.1.0.54-312ce97ad6-neutrino
alpha-workflow-studio neutrinos.azurecr.io/alpha/alpha-workflow-studio 26.1.1.0.83-312ce97ad6-neutrino
gts neutrinos.azurecr.io/alpha/gts 26.1.1.0.45-312ce97ad6-neutrino

:books: Support & Resources

2 Likes
🚀 Alpha Platform Release Notes – 26.02.0.0.2-lts