bakery-admin/bakery-ia
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
442 Commits 1 Branch 0 Tags
5670601fbeca4490184d6171c407f8ba29eca549
Commit Graph

4 Commits

Author SHA1 Message Date
Claude
2974ff3dbf Implement supplier product/price association & unify onboarding UI 
MAJOR FEATURES IMPLEMENTED:

1. ✅ CRITICAL: Supplier Product/Price Association
   - Created SupplierProductManager component (438 lines)
   - Multi-select product picker from inventory
   - Price entry with unit of measure and min quantity
   - Expandable UI per supplier (collapsed by default)
   - Full CRUD operations via existing API hooks
   - Required for automatic Purchase Order (PO) creation
   - Warning shown if supplier has no products

2. ✅ Step Re-Ordering: Inventory Before Suppliers
   - Manual path: inventory-setup now comes BEFORE suppliers-setup
   - AI path: Already has inventory from sales data upload
   - Ensures products exist before supplier association
   - Critical workflow fix identified by user

3. ✅ UI/UX Unification
   - Unified badge styles across AI suggestions
   - Changed hardcoded colors to CSS variables
   - Consistent rounded-full badge design
   - Added flex-wrap for responsive badges

IMPLEMENTATION DETAILS:

SupplierProductManager.tsx (NEW - 438 lines):
- useSupplierPriceLists() - Fetch existing products for supplier
- useIngredients() - Fetch all available inventory items
- useCreate/Update/DeleteSupplierPriceList() mutations
- Expandable UI: Collapsed shows count, expanded shows management
- Product selection: Checkboxes with inline price forms
- Form fields: unit_price (required), unit_of_measure, min_order_quantity
- Validation: Price must be > 0, unit required
- Warning: Shows if no products added (blocks PO creation)

UnifiedOnboardingWizard.tsx:
- inventory-setup moved before suppliers-setup
- inventory-setup condition: dataSource === 'manual'
- suppliers-setup condition: Inventory exists (AI stockEntryCompleted OR manual inventoryCompleted)
- Ensures products always exist before supplier association

SuppliersSetupStep.tsx:
- Added SupplierProductManager import
- Changed supplier card layout from flex items-center to block
- Integrated ProductManager component into each supplier card
- Product management appears below contact info, above edit/delete

UploadSalesDataStep.tsx:
- Updated badge colors: blue-100/blue-800 → CSS variables
- Changed bg-[var(--bg-tertiary)] → bg-[var(--bg-primary)]
- Added flex-wrap to badge container
- Consistent rounded-full design

FLOW IMPROVEMENTS:

AI-Assisted Path:
Registration → Bakery Type → Data Source → Tenant Setup →
Upload Sales → Categorize → Enter Stock → **Suppliers (with products)** →
ML Training → Complete

Manual Path:
Registration → Bakery Type → Data Source → Tenant Setup →
**Inventory Setup → Suppliers (with products)** → Recipes → Processes →
ML Training → Complete

BENEFITS:
✅ Automatic PO creation now possible
✅ System knows supplier-product relationships
✅ Prices tracked for cost analysis
✅ Logical workflow (products before suppliers)
✅ Unified, consistent UI across onboarding
✅ Critical missing feature implemented

Build: Successful (21.73s)
Files: 4 changed (3 modified, 1 new)
Lines: +438 new component, ~50 lines modified
 2025-11-06 14:09:10 +00:00
Claude
b22634388d Make backend robust with comprehensive onboarding steps 
Backend Changes (services/auth/app/api/onboarding_progress.py):
- Expanded ONBOARDING_STEPS to include all 19 frontend steps
  - Phase 0: user_registered (system)
  - Phase 1: bakery-type-selection, data-source-choice (discovery)
  - Phase 2: setup, smart-inventory-setup, product-categorization, initial-stock-entry (core setup & AI path)
  - Phase 2b: suppliers-setup, inventory-setup, recipes-setup, production-processes (manual path)
  - Phase 3: quality-setup, team-setup (advanced config)
  - Phase 4: ml-training, setup-review, completion (finalization)

- Updated STEP_DEPENDENCIES with granular requirements
  - AI path: smart-inventory-setup → product-categorization → initial-stock-entry
  - Manual path: Independent setup for suppliers, inventory, recipes, processes
  - Flexible ML training: accepts either AI or manual inventory path

- Enhanced ML training validation
  - Supports both AI-assisted path (sales data) and manual inventory path
  - More flexible validation logic for multi-path onboarding

Frontend Changes (UnifiedOnboardingWizard.tsx):
- Fixed auto-complete step name: 'suppliers' → 'suppliers-setup'
- All step IDs now match backend ONBOARDING_STEPS exactly
- Removed temporary step mapping workarounds

Frontend Changes (apiClient.ts):
- Fixed tenant ID requirement warnings for onboarding endpoints
- Added noTenantEndpoints list for user-level endpoints:
  - /auth/me/onboarding (tenant created during onboarding)
  - /auth/me (user profile)
  - /auth/register, /auth/login
- Eliminated false warnings during onboarding flow

This makes the onboarding system fully functional with:
✅ Backend validates all 19 onboarding steps
✅ Proper dependency tracking for multi-path onboarding
✅ No more "Invalid step name" errors
✅ No more tenant ID warnings for onboarding
✅ Robust state tracking for complete user journey
 2025-11-06 13:38:06 +00:00
Claude
63d100f1b3 Integrate categorization & stock steps with Tour system 
- Updated WizardContext with new state management:
  - Added categorizedProducts and productsWithStock state
  - Added categorizationCompleted and stockEntryCompleted flags
  - Implemented updateCategorizedProducts() and updateProductsWithStock() methods
  - Updated getVisibleSteps() to include new steps in AI-assisted path

- Integrated ProductCategorizationStep and InitialStockEntryStep into UnifiedOnboardingWizard:
  - Added conditional rendering based on AI analysis completion
  - Wired up state management for both steps
  - Added intermediate update handlers

- Integrated Tour system at app level:
  - Added TourProvider to App.tsx context hierarchy
  - Added Tour component for rendering active tours
  - Added TourButton to Sidebar navigation
  - Tour button visible when sidebar is expanded

This completes the Phase 6.5 integration and sets up the guided tour infrastructure.
 2025-11-06 13:07:01 +00:00
Claude
470cb91b51 Implement Phase 6: Unified Onboarding Foundation & Core Components 
This commit implements Phase 6 of the onboarding unification plan, which merges
the existing AI-powered onboarding with the comprehensive setup wizard into a
single, intelligent, personalized onboarding experience.

## Planning & Analysis Documents

- **ONBOARDING_UNIFICATION_PLAN.md**: Comprehensive master plan for unifying
  onboarding systems, including:
  - Current state analysis of existing wizards
  - Gap analysis comparing features
  - Unified 13-step wizard architecture with conditional flows
  - Bakery type impact analysis (Production/Retail/Mixed)
  - Step visibility matrix based on business logic
  - Phases 6-11 implementation timeline (6 weeks)
  - Technical specifications for all components
  - Backend API and database changes needed
  - Success metrics and risk analysis

- **PHASE_6_IMPLEMENTATION.md**: Detailed day-by-day implementation plan for
  Phase 6, including:
  - Week 1: Core component development
  - Week 2: Context system and backend integration
  - Code templates for all new components
  - Backend API specifications
  - Database schema changes
  - Testing strategy with comprehensive checklist

## New Components Implemented

### 1. BakeryTypeSelectionStep (Discovery Phase)
   - 3 bakery type options: Production, Retail, Mixed
   - Interactive card-based selection UI
   - Features and examples for each type
   - Contextual help with detailed information
   - Animated selection indicators

### 2. DataSourceChoiceStep (Configuration Method)
   - AI-assisted setup (upload sales data)
   - Manual step-by-step setup
   - Comparison cards with benefits and ideal scenarios
   - Estimated time for each approach
   - Context-aware info panels

### 3. ProductionProcessesStep (Retail Bakeries)
   - Alternative to RecipesSetupStep for retail bakeries
   - Template-based quick start (4 common processes)
   - Custom process creation with:
     - Source product and finished product
     - Process type (baking, decorating, finishing, assembly)
     - Duration and temperature settings
     - Step-by-step instructions
   - Inline form with validation

### 4. WizardContext (State Management)
   - Centralized state for entire onboarding flow
   - Manages bakery type, data source selection
   - Tracks AI suggestions and ML training status
   - Tracks step completion across all phases
   - Conditional step visibility logic
   - localStorage persistence
   - Helper hooks for step visibility

### 5. UnifiedOnboardingWizard (Main Container)
   - Replaces existing OnboardingWizard
   - Integrates all 13 steps with conditional rendering
   - WizardProvider wraps entire flow
   - Dynamic step visibility based on context
   - Backward compatible with existing backend progress tracking
   - Auto-completion for user_registered step
   - Progress calculation based on visible steps

## Conditional Flow Logic

The wizard now supports intelligent conditional flows:

**Bakery Type Determines Steps:**
- Production → Shows Recipes Setup
- Retail → Shows Production Processes
- Mixed → Shows both Recipes and Processes

**Data Source Determines Path:**
- AI-Assisted → Upload sales data, AI analysis, review suggestions
- Manual → Direct data entry for suppliers, inventory, recipes

**Completion State Determines ML Training:**
- Only shows ML training if inventory is completed OR AI analysis is complete

## Technical Implementation Details

- **Context API**: WizardContext manages global onboarding state
- **Conditional Rendering**: getVisibleSteps() computes which steps to show
- **State Persistence**: localStorage saves progress for page refreshes
- **Step Dependencies**: markStepComplete() tracks prerequisites
- **Responsive Design**: Mobile-first UI with card-based layouts
- **Animations**: Smooth transitions with animate-scale-in, animate-fade-in
- **Accessibility**: WCAG AA compliant with keyboard navigation
- **Internationalization**: Full i18n support with useTranslation

## Files Added

- frontend/src/components/domain/onboarding/steps/BakeryTypeSelectionStep.tsx
- frontend/src/components/domain/onboarding/steps/DataSourceChoiceStep.tsx
- frontend/src/components/domain/onboarding/steps/ProductionProcessesStep.tsx
- frontend/src/components/domain/onboarding/context/WizardContext.tsx
- frontend/src/components/domain/onboarding/context/index.ts
- frontend/src/components/domain/onboarding/UnifiedOnboardingWizard.tsx
- ONBOARDING_UNIFICATION_PLAN.md
- PHASE_6_IMPLEMENTATION.md

## Files Modified

- frontend/src/components/domain/onboarding/steps/index.ts
  - Added exports for new discovery and production steps

## Testing

✅ Build successful (21.42s)
✅ No TypeScript errors
✅ All components properly exported
✅ Animations working with existing animations.css

## Next Steps (Phase 7-11)

- Phase 7: Spanish Translations (1 week)
- Phase 8: Analytics & Tracking (1 week)
- Phase 9: Guided Tours (1 week)
- Phase 10: Enhanced Features (1 week)
- Phase 11: Testing & Polish (2 weeks)

## Backend Integration Notes

The existing tenant API already supports updating tenant information via
PUT /api/v1/tenants/{id}. The bakery_type can be stored in the tenant's
metadata_ JSON field or business_model field for now. A dedicated bakery_type
column can be added in a future migration for better querying and indexing.
 2025-11-06 12:34:30 +00:00