✨ Workflow - retrieve configuration for applications (#2507)

Resolves: #2288 
Resolves: https://issues.redhat.com/browse/MTA-5248

🔧 Add Retrieve Configuration Wizard for Applications

Summary
This PR introduces a new Retrieve Configuration Wizard that enables
users to retrieve runtime configurations from source platforms for
selected applications. The wizard provides a streamlined two-step
process for selecting applications and reviewing configuration retrieval
tasks.

🚀 Features Added
New Retrieve Configuration Wizard

Two-step wizard flow: Application selection → Review & Submit

Bulk application selection for configuration retrieval

Source platform integration: Automatically connects to application
source platforms

Task management using configuration discovery taskgroups

UI/UX Enhancements
Added new "Retrieve configurations" action to applications table bulk
actions

Added individual application menu item for configuration retrieval

Comprehensive form validation with Yup schema

Responsive table layout with checkbox selection

Clear progress indicators and status messages

Internationalization
Full translation support for the new wizard

Added translation keys for:

Actions

Dialogs

Wizard steps

Contextual help text and descriptions

🔧 Technical Implementation
New Components Created
RetrieveConfigWizard – Main wizard container with form management

SetApplications – Application selection step with table interface

Review – Configuration review step before submission

TaskGroupContext – Context provider for taskgroup state management

Integration Points
Extended ApplicationsTable component with wizard integration

Used existing taskgroup infrastructure for task management

Follows wizard patterns established by the analysis wizard

Integrated with existing error handling and notification systems

Validation & Error Handling
Ensures at least one application is selected via form validation

Graceful error handling for:

Taskgroup operations

Applications without source platforms

User-friendly error messages and notifications

📁 Files Added/Modified
New Files
retrieve-config-wizard/retrieve-config-wizard.tsx

retrieve-config-wizard/set-applications.tsx

retrieve-config-wizard/review.tsx

retrieve-config-wizard/schema.ts

retrieve-config-wizard/components/TaskGroupContext.tsx

retrieve-config-wizard/index.ts

Modified Files
applications-table.tsx

translation.json

🎯 Usage
Navigate to the Applications table

Select one or more applications (via bulk or individual action)

Click "Retrieve configurations" from the actions menu

Walk through the wizard: select → review → submit

✅ Testing Considerations
Wizard launches correctly from both bulk and individual actions

Application selection and deselection works as expected

Taskgroup is created and submitted properly

Error handling works for:

Taskgroup failures

Applications lacking source platforms

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Added the ability to retrieve runtime configurations for one or
multiple applications via a new modal wizard.
* Enhanced action menus with a "Retrieve Configurations" option and
improved dropdown organization.
* Introduced a review step to preview selected applications before
retrieving configurations.
* Added detailed results display for configuration retrieval tasks
showing successes and failures.

* **User Interface**
* Added new tooltips, dialog messages, and error notifications related
to configuration retrieval.
* Improved feedback and guidance during the configuration retrieval
workflow.
* Included localization support for all new UI elements in the
configuration retrieval process.

* **Bug Fixes**
* Resolved duplicate localization entries and improved error messaging
for configuration retrieval failures.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Signed-off-by: Liat Berkovich <[email protected]>
Signed-off-by: Scott J Dickerson <[email protected]>
Co-authored-by: Scott J Dickerson <[email protected]>

Author: liatb-rh

client/public/locales/en/translation.json

@@ -51,8 +51,11 @@
     "override": "Override",
     "reset": "Reset",
     "review": "Review",
+    "retrieve": "Retrieve",
+    "retrieveConfigurations": "Retrieve configurations",
     "save": "Save",
     "saveAndReview": "Save and review",
+    "selectAll": "Select all",
     "saveAsDraft": "Save as draft",
     "selectAll_one": "Select all ({{count}} item)",
     "selectAll_other": "Select all ({{count}} items)",
@@ -69,7 +72,6 @@
     "view": "View",
     "viewErrorReport": "View error report",
     "viewArchetypes": "View archetypes",
-    "retrieveConfigurations": "Retrieve configurations",
     "changeSourcePlatform": "Change source platform",
     "generateAssets": "Generate assets"
   },
@@ -119,6 +121,7 @@
   },
   "dialog": {
     "message": {
+      "retrieveConfigurations": "Retrieve runtime configurations from source platforms for the selected applications.",
       "applicationsBulkDelete": "The selected application(s) will be deleted.",
       "TasksBulkCancel": "The selected task(s) will be canceled.",
       "delete": "This action cannot be undone.",
@@ -163,6 +166,7 @@
       "newStakeholderGroup": "New stakeholder group",
       "newTag": "New Tag",
       "newTagCategory": "New tag category",
+      "retrieveConfigurations": "Retrieve configurations",
       "update": "Update {{what}}",
       "updateArchetype": "Update archetype",
       "updateApplication": "Update application",
@@ -207,6 +211,8 @@
     "copyAssessmentQuestion": "Copy assessment?",
     "couldNotFetchBody": "Resource doesn't exists or you don't have access to it",
     "couldNotFetchTitle": "Not available",
+    "configDiscoveryTaskgroupCreationFailed": "Configuration discovery taskgroup creation failed",
+    "configDiscoveryTaskgroupSubmitFailed": "Configuration discovery taskgroup submit failed",
     "duplicateTag": "A tag with this name already exists. Use a different name.",
     "duplicateWave": "The migration wave could not be created due to a conflict with an existing wave. Make sure the name and start/end dates are unique and try again.",
     "importErrorCheckDocumentation": "For status Error imports, check the documentation to ensure your file is structured correctly.",
@@ -440,6 +446,7 @@
     "name": "Name",
     "new": "New",
     "none": "None",
+    "noDescription": "No description available",
     "northboundDependencies": "Northbound dependencies",
     "notAvailable": "Not available",
     "notConnected": "Not connected",
@@ -660,6 +667,30 @@
       "advancedAnalysisDetails": "Enable enhanced analysis details to get more information about the analysis."
     }
   },
+  "retrieveConfigWizard": {
+    "selectedCount": "{{count}} of {{total}} applications selected",
+    "noApplicationsWithSourcePlatforms": "No applications with source platforms selected.",
+    "noTasksSubmitted": "No tasks were submitted.",
+    "toast": {
+      "submittedOk": "Application manifest fetches submitted",
+      "submittedFailed": "Application manifest fetches failed"
+    },
+    "results": {
+      "title": "Configuration Retrieval Results",
+      "summary": "Summary of configuration retrieval task submissions.",
+      "noResults": "No results available.",
+      "failedSubmissions_one": "Failed Submission",
+      "failedSubmissions_other": "Failed Submissions ({{count}})",
+      "successSubmissions_one": "Success Submission",
+      "successSubmissions_other": "Success Submissions ({{count}})"
+    },
+    "review": {
+      "description_one": "This application is ready to retrieve configurations from its source platform. The application's platform coordinates will be used to connect to the platform and build the application's discovery manifest.",
+      "description_other": "These applications are ready to retrieve configurations from their source platforms. The applications' platform coordinates will be used to connect to the platform and build the applications' discovery manifests.",
+      "selectedApplications_one": "Selected application",
+      "selectedApplications_other": "Selected applications ({{count}})"
+    }
+  },
   "credentials": {
     "delete": {
       "application_one": "1 application",

client/src/app/api/models.ts

@@ -328,7 +328,7 @@ export type TaskState =
   | "Postponed"
   | "SucceededWithErrors"; // synthetic state for ease-of-use in UI;
 
-export interface Task {
+export interface Task<DataType = TaskData> {
   id: number;
   createUser?: string;
   updateUser?: string;
@@ -343,8 +343,9 @@ export interface Task {
   priority?: number;
   policy?: TaskPolicy;
   ttl?: TTL;
-  data?: TaskData;
+  data?: DataType;
   application: Ref;
+  platform?: Ref;
   bucket?: Ref;
   pod?: string;
   retries?: number;
@@ -356,6 +357,18 @@ export interface Task {
   attached?: TaskAttachment[];
 }
 
+export type EmptyTaskData = Record<string, never>;
+
+export interface ApplicationTask<DataType>
+  extends Omit<Task<DataType>, "application" | "platform"> {
+  application: Ref;
+}
+
+export interface PlatformTask<DataType>
+  extends Omit<Task<DataType>, "application" | "platform"> {
+  platform: Ref;
+}
+
 /** A smaller version of `Task` fetched from the report/dashboard endpoint. */
 export interface TaskDashboard {
   id: number;

client/src/app/api/rest.ts

@@ -381,9 +381,9 @@ export const getApplicationSummaryCSV = (id: string) => {
 // ---------------------------------------
 // Tasks
 //
-export function getTaskById(id: number): Promise<Task> {
+export function getTaskById(id: number) {
   return axios
-    .get(`${TASKS}/${id}`, {
+    .get<Task>(`${TASKS}/${id}`, {
       headers: { ...HEADERS.json },
       responseType: "json",
     })
@@ -461,8 +461,17 @@ export const getTaskQueue = (addon?: string): Promise<TaskQueue> =>
     .get<TaskQueue>(`${TASKS}/report/queue`, { params: { addon } })
     .then(({ data }) => data);
 
-export const updateTask = (task: Partial<Task> & { id: number }) =>
-  axios.patch<Task>(`${TASKS}/${task.id}`, task);
+export const createTask = <TaskData, TaskType extends Task<TaskData>>(
+  task: New<TaskType>
+) => axios.post<TaskType>(TASKS, task).then((response) => response.data);
+
+export const updateTask = <TaskData, TaskType extends Task<TaskData>>(
+  task: Partial<TaskType> & { id: number }
+) => axios.patch<TaskType>(`${TASKS}/${task.id}`, task);
+
+export const submitTask = <TaskData, TaskType extends Task<TaskData>>(
+  task: TaskType
+) => axios.put<void>(`${TASKS}/${task.id}/submit`, { id: task.id });
 
 // ---------------------------------------
 // Task Groups
@@ -472,7 +481,7 @@ export const createTaskgroup = (obj: New<Taskgroup>) =>
 
 export const submitTaskgroup = (obj: Taskgroup) =>
   axios
-    .put<Taskgroup>(`${TASKGROUPS}/${obj.id}/submit`, obj)
+    .put<void>(`${TASKGROUPS}/${obj.id}/submit`, obj)
     .then((response) => response.data);
 
 export const deleteTaskgroup = (id: number): AxiosPromise =>