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

**URL:** https://community.neutrinos.com/t/alpha-platform-lts-release-notes-25-09-19-0-0-0-lts/1379
**Category:** Product Release Notes
**Tags:** neutrinos-platform, neutrinos-alpha, alpha-release-notes
**Created:** [September 19, 2025, 7:09pm UTC](https://community.neutrinos.com/t/alpha-platform-lts-release-notes-25-09-19-0-0-0-lts/1379 "2025-09-19T19:09:43Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![doomedCode](https://community.neutrinos.com/user_avatar/community.neutrinos.com/doomedcode/32/49_2.png) [@doomedCode](https://community.neutrinos.com/u/doomedCode)
#### Post date: [September 19, 2025, 7:09pm UTC](https://community.neutrinos.com/t/alpha-platform-lts-release-notes-25-09-19-0-0-0-lts/1379/1 "2025-09-19T19:09:43Z")

</div>

**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:

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

### 🆕 New Features

- **Pull Tasks Directly** ([APS-2376](https://jatahworx.atlassian.net/browse/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](https://documentation.neutrinos.com/articles/#!alpha-platform/pull-task)

- **Task Check-In/Check-Out Configuration** ([APS-2308](https://jatahworx.atlassian.net/browse/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](https://documentation.neutrinos.com/articles/#!alpha-platform/claim-and-release-tasks)

- **Dev Mode UI Banner** ([APS-2506](https://jatahworx.atlassian.net/browse/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](https://jatahworx.atlassian.net/browse/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.

### 🛠 Improvements

- **Project Import Validation** ([APS-2494](https://jatahworx.atlassian.net/browse/APS-2494))  
Enhanced project import process to validate tenant existence during import for fresh database installations.

- **Display Value Configuration** ([APS-2661](https://jatahworx.atlassian.net/browse/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](https://jatahworx.atlassian.net/browse/APS-2694))  
Fixed column name translations in customize column popup to show correct language values.

### 🐞 Bug Fixes

- **Trigger Loading Issue** ([APS-2551](https://jatahworx.atlassian.net/browse/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](https://jatahworx.atlassian.net/browse/APS-2582))  
Resolved issue where filter name would disappear from update filter name field after page refresh.

- **Dependency Dropdown Validation** ([APS-2516](https://jatahworx.atlassian.net/browse/APS-2516))  
Fixed dependency dropdown validation issues in sections with conditionally mandatory fields.

- **User Bandwidth Updates** ([APS-2565](https://jatahworx.atlassian.net/browse/APS-2565))  
Fixed bandwidth calculation not updating correctly after task check-in and check-out operations.

**Thanks everyone for reporting the issues and suggestions! 🎉**

### 🔄 Migrations

#### Database Migrations

- **Alpha Admin Service** : [25.09-19.0.0-lts/migration.sql](https://bitbucket.org/bhivedevs/alpha-helm-charts/src/master/dbscripts/alpha-admin-service/25.09-19.0.0-lts/migration.sql)

- **Alpha Case Service** : [25.09-19.0.0-lts/migration.sql](https://bitbucket.org/bhivedevs/alpha-helm-charts/src/master/dbscripts/alpha-case-service/25.09-19.0.0-lts/migration.sql)

#### 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:

```bash
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:

```sql
SELECT * FROM enquiry_schema_v2.recovery_batch_audit WHERE "batchId" = '<batchId In the response of the sync-case-assinmentTypes API>';

```

### 🔧 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'` |

### 🛡 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

### 📝 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 }}`.

### 🐇 RabbitMQ Setup (Required for Pull Task Feature)

**IMPORTANT** : RabbitMQ setup is **REQUIRED** for the Pull Task feature ([APS-2376](https://jatahworx.atlassian.net/browse/APS-2376)) to function properly.

#### Installation

```bash
# 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:

```yaml
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](https://bitbucket.org/bhivedevs/alpha-helm-charts/src/master/rabbit-mq/README.md)

### 📚 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

### 📸 Images

| Service Name | Image Name | Image Version |
| --- | --- | --- |
| alpha-admin-service | [neutrinos.azurecr.io/alpha/admin](http://neutrinos.azurecr.io/alpha/admin) | 25.9.1.0.31-3919bd12d-lts |
| alpha-admin-ui | [neutrinos.azurecr.io/alpha/alpha-admin-ui](http://neutrinos.azurecr.io/alpha/alpha-admin-ui) | 25.9.1.0.31-3919bd12d-lts |
| alpha-auth-service | [neutrinos.azurecr.io/alpha/alpha-auth-service](http://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](http://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](http://neutrinos.azurecr.io/alpha/alpha-config-service) | 25.9.1.0.32-3919bd12d-lts |
| alpha-enquiry-service | [neutrinos.azurecr.io/alpha/alpha-enquiry-service](http://neutrinos.azurecr.io/alpha/alpha-enquiry-service) | 25.3.0.0.25-42e3424c4-prod |
| alpha-workflow-studio | [neutrinos.azurecr.io/alpha/alpha-workflow-studio](http://neutrinos.azurecr.io/alpha/alpha-workflow-studio) | 25.9.1.0.30-3919bd12d-lts |
| alpha-modules-service | [neutrinos.azurecr.io/alpha/alpha-module-service](http://neutrinos.azurecr.io/alpha/alpha-module-service) | 25.9.1.0.31-3919bd12d-lts |
| alpha-task-distributor | [neutrinos.azurecr.io/alpha/alpha-task-distributor](http://neutrinos.azurecr.io/alpha/alpha-task-distributor) | 25.9.1.0.33-3919bd12d-lts |
| alpha-bpmservice | [neutrinos.azurecr.io/alpha/alpha-jbpm-service](http://neutrinos.azurecr.io/alpha/alpha-jbpm-service) | 25.9.1.0.31-3919bd12d-lts |
| alpha-caseservice | [neutrinos.azurecr.io/alpha/alpha-case-service](http://neutrinos.azurecr.io/alpha/alpha-case-service) | 25.9.1.0.34-3919bd12d-lts |

---

<div class="post-metadata">

### Author: ![doomedCode](https://community.neutrinos.com/user_avatar/community.neutrinos.com/doomedcode/32/49_2.png) [@doomedCode](https://community.neutrinos.com/u/doomedCode)
#### Post date: [October 1, 2025, 6:24pm UTC](https://community.neutrinos.com/t/alpha-platform-lts-release-notes-25-09-19-0-0-0-lts/1379/2 "2025-10-01T18:24:24Z")

</div>

Here is the Documentation links for the new features:

- **Claim/Release A (CheckIn-CheckOut) Task** - [https://documentation.neutrinos.com/articles/#!alpha-platform/claim-and-release-tasks](https://documentation.neutrinos.com/articles/#!alpha-platform/claim-and-release-tasks)
- **Pull Task** - [https://documentation.neutrinos.com/articles/#!alpha-platform/pull-task](https://documentation.neutrinos.com/articles/#!alpha-platform/pull-task)
