bakery-ia/docs/ROADMAP.md

⏺ Based on my analysis of your bakery project, here's a clear divide 
  and conquer strategy to transition from mock/demo data to real API
  connections:

  Current State Analysis

  ✅ What's Already Done:
  - Complete backend microservices architecture (17+ services)
  - Full API client setup with authentication & tenant management
  - Comprehensive service layer (auth, inventory, sales, forecasting,
  etc.)
  - Real-time SSE & WebSocket infrastructure

  🔍 What Needs Connection:
  - Mock data in auth store (mockLogin, mockRefreshToken)
  - Mock alerts in alerts store (mockAlerts, mockRules)
  - Various hardcoded arrays across hooks and utilities

  Divide & Conquer Strategy

  Phase 1: Authentication Foundation (Week 1)

  Priority: CRITICAL - Everything depends on this

  // IMMEDIATE ACTION: Replace mock auth
  1. Update auth.store.ts → Connect to real auth service
  2. Replace mockLogin() with authService.login()
  3. Replace mockRefreshToken() with authService.refreshToken()
  4. Test tenant switching and permission system

  Files to modify:
  - frontend/src/stores/auth.store.ts:46-88 (replace mock functions)
  - frontend/src/services/api/auth.service.ts (already done)

  Phase 2: Core Operations (Week 2)

  Priority: HIGH - Daily operations

  // Connect inventory management first (most used)
  1. Inventory Service → Real API calls
     - Replace mock data in components
     - Connect to /api/v1/inventory/* endpoints
     
  2. Production Service → Real API calls  
     - Connect batch management
     - Link to /api/v1/production/* endpoints
     
  3. Sales Service → Real API calls
     - Connect POS integration
     - Link to /api/v1/sales/* endpoints

  Files to modify:
  - All inventory components using mock data
  - Production scheduling hooks
  - Sales tracking components

  Phase 3: Analytics & Intelligence (Week 3)

  Priority: MEDIUM - Business insights

  // Connect AI-powered features
  1. Forecasting Service → Real ML predictions
     - Connect to /api/v1/forecasts/* endpoints
     - Enable real demand forecasting
     
  2. Training Service → Real model training
     - Connect WebSocket training progress
     - Enable /api/v1/training/* endpoints
     
  3. Analytics Service → Real business data
     - Connect charts and reports
     - Enable trend analysis

  Phase 4: Communication & Automation (Week 4)

  Priority: LOW - Enhancements

  // Replace mock alerts with real-time system
  1. Alerts Store → Real SSE connection
     - Connect to /api/v1/sse/alerts/stream/{tenant_id}
     - Replace mockAlerts with live data

  2. Notification Service → Real messaging
     - WhatsApp & Email integration
     - Connect to /api/v1/notifications/* endpoints
     
  3. External Data → Live feeds
     - Weather API (AEMET)
     - Traffic patterns
     - Market events

  Specific Next Steps

  STEP 1: Start with Authentication (Today)

  // 1. Replace frontend/src/stores/auth.store.ts
  // Remove lines 46-88 and replace with:

  const performLogin = async (email: string, password: string) => {
    const response = await authService.login({ email, password });
    if (!response.success) throw new Error(response.error || 'Login 
  failed');
    return response.data;
  };

  const performRefresh = async (refreshToken: string) => {
    const response = await authService.refreshToken(refreshToken);
    if (!response.success) throw new Error('Token refresh failed');
    return response.data;
  };

  STEP 2: Connect Inventory (Next)

  // 2. Update inventory components to use real API
  // Replace mock data arrays with:

  const { data: ingredients, isLoading } = useQuery({
    queryKey: ['ingredients', tenantId],
    queryFn: () => inventoryService.getIngredients(),
  });

  STEP 3: Enable Real-time Alerts (After)

  // 3. Connect SSE for real alerts
  // Replace alerts store mock data with:

  useEffect(() => {
    const eventSource = new
  EventSource(`/api/v1/sse/alerts/stream/${tenantId}`);

    eventSource.onmessage = (event) => {
      const alert = JSON.parse(event.data);
      createAlert(alert);
    };

    return () => eventSource.close();
  }, [tenantId]);

  Migration Checklist

  Immediate (This Week)

  - Replace auth mock functions with real API calls
  - Test login/logout/refresh flows
  - Verify tenant switching works
  - Test permission-based UI rendering

  Short-term (Next 2 Weeks)

  - Connect inventory service to real API
  - Enable production planning with real data
  - Connect sales tracking to POS systems
  - Test data consistency across services

  Medium-term (Next Month)

  - Enable ML forecasting with real models
  - Connect real-time alert system
  - Integrate external data sources (weather, traffic)
  - Test full end-to-end workflows

  Risk Mitigation

  1. Gradual Migration: Keep mock fallbacks during transition
  2. Environment Switching: Use env variables to toggle mock/real APIs
  3. Error Handling: Robust error handling for API failures
  4. Data Validation: Verify API responses match expected schemas
  5. User Testing: Test with real bakery workflows

  Ready to start? I recommend beginning with Step 1 (Authentication)
  today. The infrastructure is already there - you just need to connect
   the pipes!