🚀 Alpha Platform LTS Release Notes – 25.09-19.0.0.0-lts

Neutrinos Platform Product Release Notes
, ,
1

Release Date: September 19, 2025

Before you do helm upgrade, please run the configuration migration script

Configuration Migrations

  • Environment Variables Migration
    Environment variables have been moved from nested secret.environment to service-level environment for improved configuration management. Use the provided migration script:

    # Navigate to the environment migrator
cd scripts/environment-migrator

# Preview changes (recommended first step)
node move-env-to-service-level.js ../../alpha-application/values-dev.yaml --dry-run

# Apply migration with automatic backup
node move-env-to-service-level.js ../../alpha-application/values-dev.yaml

  • Namespace Configuration Update (FYI)
    Helm templates now use {{ .Release.Namespace }} instead of {{ .Values.namespace }} for better Kubernetes integration.

:new_button: New Features

  • Pull Tasks Directly (APS-2376)
    Empowers users to pull tasks directly, select groups, specify task count, and ensures transparency and efficiency.
    Learn more about this feature here: https://documentation.neutrinos.com/articles/#!alpha-platform/pull-task

  • Task Check-In/Check-Out Configuration (APS-2308)
    Added configuration option to control task check-in and check-out behavior. Users can now open case details without auto check-in and perform manual check-in/check-out from case details page with feature flag support.
    See our docs for more details: https://documentation.neutrinos.com/articles/#!alpha-platform/claim-and-release-tasks

  • Dev Mode UI Banner (APS-2506)
    Added UI indication banner for development mode in Case Manager UI and Workflow Studio to prevent accidental enablement in non-dev environments.

  • Enhanced Master Data Configuration (APS-2585)
    Reels master data configuration from Workflow Studio now supports tags instead of just Entity IDs, allowing users to fetch master data based on Version or Tag selection.

:hammer_and_wrench: Improvements

  • Project Import Validation (APS-2494)
    Enhanced project import process to validate tenant existence during import for fresh database installations.

  • Display Value Configuration (APS-2661)
    Added configuration for dropdown and radio button display values in view-only mode, allowing choice between label and value display.

  • Column Translation Support (APS-2694)
    Fixed column name translations in customize column popup to show correct language values.

:lady_beetle: Bug Fixes

  • Trigger Loading Issue (APS-2551)
    Fixed Case Manager continuous loading issue when adding HTTP or Reels triggers to components. Enhanced header security by preventing override of system/computed headers.

  • Enquiry Filter Persistence (APS-2582)
    Resolved issue where filter name would disappear from update filter name field after page refresh.

  • Dependency Dropdown Validation (APS-2516)
    Fixed dependency dropdown validation issues in sections with conditionally mandatory fields.

  • User Bandwidth Updates (APS-2565)
    Fixed bandwidth calculation not updating correctly after task check-in and check-out operations.

Thanks everyone for reporting the issues and suggestions! :tada:

:counterclockwise_arrows_button: Migrations

Database Migrations

  • Alpha Admin Service: 25.09-19.0.0-lts/migration.sql

    • Added task_lock table for task management
    • Created indexes for improved performance

  • Alpha Case Service: 25.09-19.0.0-lts/migration.sql

    • Renamed task_metadata table to task_check_in_tracker
    • Added audit log entities for task distribution
    • Created task_distribution_audit_logs and execution_audit_logs tables

API Migrations

Case Assignment Type Sync:

  • Endpoint: POST /caseservice/case/recovery/sync-case-assinmentTypes
  • Purpose: Synchronizes case assignment types from case-service to enquiry-service to ensure data consistency between services
  • Authentication: Requires bearer token authentication (via @ApiBearerAuth())
  • Request Body: CaseAssignmentTypeDto containing:
    • projectId (string): The project identifier
    • batchSize (number): The batch size to populate the enquiry recovery data (example: 100)
    • batchProcessDelay (number): The batch process delay in milliseconds (example: 1000)

How to use

  • Execute the API:
curl -X POST \
  'https://[DOMAIN]/caseservice/case/recovery/sync-case-assinmentTypes' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "projectId": "project-123",
    "batchSize": 100,
    "batchProcessDelay": 1000
  }'
  • Monitor the process:
    SELECT * FROM enquiry_schema_v2.recovery_batch_audit WHERE "batchId" = '<batchId In the response of the sync-case-assinmentTypes API>';

:wrench: Environment Variables

New Environment Variables

alpha-caseservice
Env Variable Name Description Example
RMQ_URL RabbitMQ connection URL for Pull Task Execution 'amqp://rabbitmq:p%4055w0rd@52.172.0.171:5672/'
RMQ_CHANNEL_NAME RabbitMQ channel name for task processing 'pull-task-channel'
RMQ_QUEUE_NAME RabbitMQ queue name for task management 'pull-task-queue'
RMQ_CONSUMER_COUNT Number of RabbitMQ consumers '5'
RMQ_CONSUMER_PREFETCH Consumer prefetch count '1'
RMQ_CIRCUIT_TIMEOUT Circuit breaker timeout in milliseconds '5000'
RMQ_CIRCUIT_ERROR_THRESHOLD_PERCENTAGE Error threshold percentage for circuit breaker '50'
RMQ_CIRCUIT_RESET_TIMEOUT Circuit reset timeout in milliseconds '10000'
AUTOMATION Enable automation features 'true'
alpha-task-distributor
Env Variable Name Description Example
BANDWIDTH_SKIP_TASK_NAMES Task names to skip in bandwidth calculations '["Task11" , "Task12"]'
alpha-case-manager-ui
Env Variable Name Description Example
ALPHA_CASE_URL Case service backend URL 'https://{DOMAIN/caseservice'

:shield: Security Enhancements

  • Header Security Improvements
    Enhanced security by preventing override of system/computed headers. The following headers are now protected (case-insensitive) even when they are configured by enabling custom header env configuration.
    • Accept, accept-encoding, Authorization, Connection
    • content-length, content-type, Host, keep-alive
    • Origin, proxy-connection, Referer, Requestid
    • transfer-encoding, Trailer, sec-fetch-*, Upgrade
    • user-agent, x-api-path, and more

:memo: Breaking Changes

  • Environment Configuration Structure: Environment variables have been restructured from nested secret.environment to service-level environment. Use the provided migration script for seamless transition.

  • Namespace References: Helm templates now require {{ .Release.Namespace }} instead of {{ .Values.namespace }}.

:rabbit: RabbitMQ Setup (Required for Pull Task Feature)

IMPORTANT: RabbitMQ setup is REQUIRED for the Pull Task feature (APS-2376) to function properly.

Installation

# Install RabbitMQ using Helm
helm upgrade --install rabbitmq ./rabbit-mq -f ./rabbit-mq/values.yaml --namespace monitoring

Configuration

RabbitMQ is configured with:

  • Username: RMQ_USERNAME
  • Password: RMQ_PASSWORD
  • Clustering: Enabled for high availability
  • Persistence: 40Gi storage with managed-csi StorageClass
  • Access URL: <host_url>

Connection Details for Services

Update your services with the following RabbitMQ environment variables:

environment:
    RMQ_URL: 'amqp://${RMQ_USERNAME}$:${PASSWORD}@${RMQ_HOST}:${RMQ_PORT}/'
    RMQ_CHANNEL_NAME: 'pull-task-channel'
    RMQ_QUEUE_NAME: 'pull-task-queue'
    RMQ_CONSUMER_COUNT: '5'
    RMQ_CONSUMER_PREFETCH: '1'
    RMQ_CIRCUIT_TIMEOUT: '5000'
    RMQ_CIRCUIT_ERROR_THRESHOLD_PERCENTAGE: '50'
    RMQ_CIRCUIT_RESET_TIMEOUT: '10000'

For detailed setup instructions, refer to: RabbitMQ README

:books: Tools & Scripts

  • Environment Migrator: New automated tool for migrating environment variable configurations in Helm charts
    • Location: scripts/environment-migrator/
    • Features: Position-preserving migration, automatic backups, dry-run support
    • Documentation: Complete README with usage examples and troubleshooting

:camera_with_flash: Images

Service Name Image Name Image Version
alpha-admin-service neutrinos.azurecr.io/alpha/admin 25.9.1.0.31-3919bd12d-lts
alpha-admin-ui neutrinos.azurecr.io/alpha/alpha-admin-ui 25.9.1.0.31-3919bd12d-lts
alpha-auth-service neutrinos.azurecr.io/alpha/alpha-auth-service 25.9.1.0.31-3919bd12d-lts
alpha-case-manager-ui neutrinos.azurecr.io/alpha/alpha-case-manager-ui 25.9.1.0.32-3919bd12d-lts
alpha-config-service neutrinos.azurecr.io/alpha/alpha-config-service 25.9.1.0.32-3919bd12d-lts
alpha-enquiry-service neutrinos.azurecr.io/alpha/alpha-enquiry-service 25.3.0.0.25-42e3424c4-prod
alpha-workflow-studio neutrinos.azurecr.io/alpha/alpha-workflow-studio 25.9.1.0.30-3919bd12d-lts
alpha-modules-service neutrinos.azurecr.io/alpha/alpha-module-service 25.9.1.0.31-3919bd12d-lts
alpha-task-distributor neutrinos.azurecr.io/alpha/alpha-task-distributor 25.9.1.0.33-3919bd12d-lts
alpha-bpmservice neutrinos.azurecr.io/alpha/alpha-jbpm-service 25.9.1.0.31-3919bd12d-lts
alpha-caseservice neutrinos.azurecr.io/alpha/alpha-case-service 25.9.1.0.34-3919bd12d-lts
1 Like
2

Here is the Documentation links for the new features:

2 Likes