Add onboardin steps improvements

frontend/src/api/services/index.ts

@@ -11,6 +11,7 @@ import { DataService } from './data.service';
 import { TrainingService } from './training.service';
 import { ForecastingService } from './forecasting.service';
 import { NotificationService } from './notification.service';
+import { OnboardingService } from './onboarding.service';
 
 // Create service instances
 export const authService = new AuthService();
@@ -19,9 +20,10 @@ export const dataService = new DataService();
 export const trainingService = new TrainingService();
 export const forecastingService = new ForecastingService();
 export const notificationService = new NotificationService();
+export const onboardingService = new OnboardingService();
 
 // Export the classes as well
-export { AuthService, TenantService, DataService, TrainingService, ForecastingService, NotificationService };
+export { AuthService, TenantService, DataService, TrainingService, ForecastingService, NotificationService, OnboardingService };
 
 // Import base client
 export { apiClient } from '../client';
@@ -37,6 +39,7 @@ export const api = {
   training: trainingService,
   forecasting: forecastingService,
   notification: notificationService,
+  onboarding: onboardingService,
 } as const;
 
 // Service status checking

frontend/src/api/services/onboarding.service.ts

@@ -0,0 +1,92 @@
+// frontend/src/api/services/onboarding.service.ts
+/**
+ * Onboarding Service
+ * Handles user progress tracking and onboarding flow management
+ */
+
+import { apiClient } from '../client';
+
+export interface OnboardingStepStatus {
+  step_name: string;
+  completed: boolean;
+  completed_at?: string;
+  data?: Record<string, any>;
+}
+
+export interface UserProgress {
+  user_id: string;
+  steps: OnboardingStepStatus[];
+  current_step: string;
+  next_step?: string;
+  completion_percentage: number;
+  fully_completed: boolean;
+  last_updated: string;
+}
+
+export interface UpdateStepRequest {
+  step_name: string;
+  completed: boolean;
+  data?: Record<string, any>;
+}
+
+export class OnboardingService {
+  private baseEndpoint = '/users/me/onboarding';
+
+  /**
+   * Get user's current onboarding progress
+   */
+  async getUserProgress(): Promise<UserProgress> {
+    return apiClient.get(`${this.baseEndpoint}/progress`);
+  }
+
+  /**
+   * Update a specific onboarding step
+   */
+  async updateStep(data: UpdateStepRequest): Promise<UserProgress> {
+    return apiClient.put(`${this.baseEndpoint}/step`, data);
+  }
+
+  /**
+   * Mark step as completed with optional data
+   */
+  async completeStep(stepName: string, data?: Record<string, any>): Promise<UserProgress> {
+    return this.updateStep({
+      step_name: stepName,
+      completed: true,
+      data
+    });
+  }
+
+  /**
+   * Reset a step (mark as incomplete)
+   */
+  async resetStep(stepName: string): Promise<UserProgress> {
+    return this.updateStep({
+      step_name: stepName,
+      completed: false
+    });
+  }
+
+  /**
+   * Get next required step for user
+   */
+  async getNextStep(): Promise<{ step: string; data?: Record<string, any> }> {
+    return apiClient.get(`${this.baseEndpoint}/next-step`);
+  }
+
+  /**
+   * Complete entire onboarding process
+   */
+  async completeOnboarding(): Promise<{ success: boolean; message: string }> {
+    return apiClient.post(`${this.baseEndpoint}/complete`);
+  }
+
+  /**
+   * Check if user can access a specific step
+   */
+  async canAccessStep(stepName: string): Promise<{ can_access: boolean; reason?: string }> {
+    return apiClient.get(`${this.baseEndpoint}/can-access/${stepName}`);
+  }
+}
+
+export const onboardingService = new OnboardingService();