Start integrating the onboarding flow with backend 6

2025-09-05 17:49:48 +02:00
parent 236c3a32ae
commit 069954981a
131 changed files with 5217 additions and 22838 deletions
--- a/frontend/src/api/hooks/onboarding.ts
+++ b/frontend/src/api/hooks/onboarding.ts
@@ -0,0 +1,128 @@
+/**
+ * Onboarding React Query hooks
+ */
+import { useMutation, useQuery, useQueryClient, UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { onboardingService } from '../services/onboarding';
+import { UserProgress, UpdateStepRequest } from '../types/onboarding';
+import { ApiError } from '../client';
+
+// Query Keys
+export const onboardingKeys = {
+  all: ['onboarding'] as const,
+  progress: (userId: string) => [...onboardingKeys.all, 'progress', userId] as const,
+  steps: () => [...onboardingKeys.all, 'steps'] as const,
+  stepDetail: (stepName: string) => [...onboardingKeys.steps(), stepName] as const,
+} as const;
+
+// Queries
+export const useUserProgress = (
+  userId: string,
+  options?: Omit<UseQueryOptions<UserProgress, ApiError>, 'queryKey' | 'queryFn'>
+) => {
+  return useQuery<UserProgress, ApiError>({
+    queryKey: onboardingKeys.progress(userId),
+    queryFn: () => onboardingService.getUserProgress(userId),
+    enabled: !!userId,
+    staleTime: 30 * 1000, // 30 seconds
+    ...options,
+  });
+};
+
+export const useAllSteps = (
+  options?: Omit<UseQueryOptions<Array<{
+    name: string;
+    description: string;
+    dependencies: string[];
+    estimated_time_minutes: number;
+  }>, ApiError>, 'queryKey' | 'queryFn'>
+) => {
+  return useQuery<Array<{
+    name: string;
+    description: string;
+    dependencies: string[];
+    estimated_time_minutes: number;
+  }>, ApiError>({
+    queryKey: onboardingKeys.steps(),
+    queryFn: () => onboardingService.getAllSteps(),
+    staleTime: 10 * 60 * 1000, // 10 minutes
+    ...options,
+  });
+};
+
+export const useStepDetails = (
+  stepName: string,
+  options?: Omit<UseQueryOptions<{
+    name: string;
+    description: string;
+    dependencies: string[];
+    estimated_time_minutes: number;
+  }, ApiError>, 'queryKey' | 'queryFn'>
+) => {
+  return useQuery<{
+    name: string;
+    description: string;
+    dependencies: string[];
+    estimated_time_minutes: number;
+  }, ApiError>({
+    queryKey: onboardingKeys.stepDetail(stepName),
+    queryFn: () => onboardingService.getStepDetails(stepName),
+    enabled: !!stepName,
+    staleTime: 10 * 60 * 1000, // 10 minutes
+    ...options,
+  });
+};
+
+// Mutations
+export const useUpdateStep = (
+  options?: UseMutationOptions<UserProgress, ApiError, { userId: string; stepData: UpdateStepRequest }>
+) => {
+  const queryClient = useQueryClient();
+  
+  return useMutation<UserProgress, ApiError, { userId: string; stepData: UpdateStepRequest }>({
+    mutationFn: ({ userId, stepData }) => onboardingService.updateStep(userId, stepData),
+    onSuccess: (data, { userId }) => {
+      // Update progress cache
+      queryClient.setQueryData(onboardingKeys.progress(userId), data);
+    },
+    ...options,
+  });
+};
+
+export const useMarkStepCompleted = (
+  options?: UseMutationOptions<
+    UserProgress, 
+    ApiError, 
+    { userId: string; stepName: string; data?: Record<string, any> }
+  >
+) => {
+  const queryClient = useQueryClient();
+  
+  return useMutation<
+    UserProgress, 
+    ApiError, 
+    { userId: string; stepName: string; data?: Record<string, any> }
+  >({
+    mutationFn: ({ userId, stepName, data }) => 
+      onboardingService.markStepCompleted(userId, stepName, data),
+    onSuccess: (data, { userId }) => {
+      // Update progress cache
+      queryClient.setQueryData(onboardingKeys.progress(userId), data);
+    },
+    ...options,
+  });
+};
+
+export const useResetProgress = (
+  options?: UseMutationOptions<UserProgress, ApiError, string>
+) => {
+  const queryClient = useQueryClient();
+  
+  return useMutation<UserProgress, ApiError, string>({
+    mutationFn: (userId: string) => onboardingService.resetProgress(userId),
+    onSuccess: (data, userId) => {
+      // Update progress cache
+      queryClient.setQueryData(onboardingKeys.progress(userId), data);
+    },
+    ...options,
+  });
+};