feat: Add JTBD-driven Unified Add Wizard system

Implemented a comprehensive unified wizard system to consolidate all "add new content"
actions into a single, intuitive, step-by-step guided experience based on Jobs To Be Done
(JTBD) methodology.

## What's New

### Core Components
- **UnifiedAddWizard**: Main orchestrator component that routes to specific wizards
- **ItemTypeSelector**: Beautiful visual card-based selection for 9 content types
- **9 Individual Wizards**: Step-by-step flows for each content type

### Priority Implementations (P0)
1. **SalesEntryWizard**  (MOST CRITICAL)
   - Manual entry with dynamic product lists and auto-calculated totals
   - File upload placeholder for CSV/Excel bulk import
   - Critical for small bakeries without POS systems

2. **InventoryWizard**
   - Type selection (ingredient vs finished product)
   - Context-aware forms based on inventory type
   - Optional initial lot entry

### Placeholder Wizards (P1/P2)
- Customer Order, Supplier, Recipe, Customer, Quality Template, Equipment, Team Member
- Proper structure in place for incremental enhancement

### Dashboard Integration
- Added prominent "Agregar" button in dashboard header
- Opens wizard modal with visual type selection
- Auto-refreshes dashboard after wizard completion

### Design Highlights
- Mobile-first responsive design (full-screen on mobile, modal on desktop)
- Touch-friendly with 44px+ touch targets
- Follows existing color system and design tokens
- Progressive disclosure to reduce cognitive load
- Accessibility-compliant (WCAG AA)

## Documentation

Created comprehensive documentation:
- `JTBD_UNIFIED_ADD_WIZARD.md` - Full JTBD analysis and research
- `WIZARD_ARCHITECTURE_DESIGN.md` - Technical design and specifications
- `UNIFIED_WIZARD_IMPLEMENTATION_SUMMARY.md` - Implementation guide

## Files Changed

- New: `frontend/src/components/domain/unified-wizard/` (15 new files)
- Modified: `frontend/src/pages/app/DashboardPage.tsx` (added wizard integration)

## Next Steps

- [ ] Connect wizards to real API endpoints (currently mock/placeholder)
- [ ] Implement full CSV upload for sales entry
- [ ] Add comprehensive form validation
- [ ] Enhance P1 priority wizards based on user feedback

## JTBD Alignment

Main Job: "When I need to expand or update my bakery operations, I want to quickly add
new resources to my management system, so I can keep my business running smoothly."

Key insights applied:
- Prioritized sales entry (most bakeries lack POS)
- Mobile-first (bakery owners are on their feet)
- Progressive disclosure (reduce overwhelm)
- Forgiving interactions (can go back, save drafts)
This commit is contained in:
Claude
2025-11-09 08:40:01 +00:00
parent cbe19a3cd1
commit 1eacfc8e64
16 changed files with 3134 additions and 15 deletions

View File

@@ -0,0 +1,134 @@
import React, { useState, useCallback } from 'react';
import { Sparkles } from 'lucide-react';
import { WizardModal, WizardStep } from '../../ui/WizardModal/WizardModal';
import { ItemTypeSelector, ItemType } from './ItemTypeSelector';
// Import specific wizards
import { InventoryWizardSteps } from './wizards/InventoryWizard';
import { SupplierWizardSteps } from './wizards/SupplierWizard';
import { RecipeWizardSteps } from './wizards/RecipeWizard';
import { EquipmentWizardSteps } from './wizards/EquipmentWizard';
import { QualityTemplateWizardSteps } from './wizards/QualityTemplateWizard';
import { CustomerOrderWizardSteps } from './wizards/CustomerOrderWizard';
import { CustomerWizardSteps } from './wizards/CustomerWizard';
import { TeamMemberWizardSteps } from './wizards/TeamMemberWizard';
import { SalesEntryWizardSteps } from './wizards/SalesEntryWizard';
interface UnifiedAddWizardProps {
isOpen: boolean;
onClose: () => void;
onComplete?: (itemType: ItemType, data?: any) => void;
// Optional: Start with a specific item type (when opened from individual page buttons)
initialItemType?: ItemType;
}
export const UnifiedAddWizard: React.FC<UnifiedAddWizardProps> = ({
isOpen,
onClose,
onComplete,
initialItemType,
}) => {
const [selectedItemType, setSelectedItemType] = useState<ItemType | null>(
initialItemType || null
);
const [wizardData, setWizardData] = useState<Record<string, any>>({});
// Reset state when modal closes
const handleClose = useCallback(() => {
setSelectedItemType(initialItemType || null);
setWizardData({});
onClose();
}, [onClose, initialItemType]);
// Handle item type selection from step 0
const handleItemTypeSelect = useCallback((itemType: ItemType) => {
setSelectedItemType(itemType);
}, []);
// Handle wizard completion
const handleWizardComplete = useCallback(
(data?: any) => {
if (selectedItemType) {
onComplete?.(selectedItemType, data);
}
handleClose();
},
[selectedItemType, onComplete, handleClose]
);
// Get wizard steps based on selected item type
const getWizardSteps = (): WizardStep[] => {
if (!selectedItemType) {
// Step 0: Item Type Selection
return [
{
id: 'item-type-selection',
title: 'Seleccionar tipo',
description: 'Elige qué deseas agregar',
component: (props) => (
<ItemTypeSelector onSelect={handleItemTypeSelect} />
),
},
];
}
// Return specific wizard steps based on selected type
switch (selectedItemType) {
case 'inventory':
return InventoryWizardSteps(wizardData, setWizardData);
case 'supplier':
return SupplierWizardSteps(wizardData, setWizardData);
case 'recipe':
return RecipeWizardSteps(wizardData, setWizardData);
case 'equipment':
return EquipmentWizardSteps(wizardData, setWizardData);
case 'quality-template':
return QualityTemplateWizardSteps(wizardData, setWizardData);
case 'customer-order':
return CustomerOrderWizardSteps(wizardData, setWizardData);
case 'customer':
return CustomerWizardSteps(wizardData, setWizardData);
case 'team-member':
return TeamMemberWizardSteps(wizardData, setWizardData);
case 'sales-entry':
return SalesEntryWizardSteps(wizardData, setWizardData);
default:
return [];
}
};
// Get wizard title based on selected item type
const getWizardTitle = (): string => {
if (!selectedItemType) {
return 'Agregar Contenido';
}
const titleMap: Record<ItemType, string> = {
'inventory': 'Agregar Inventario',
'supplier': 'Agregar Proveedor',
'recipe': 'Agregar Receta',
'equipment': 'Agregar Equipo',
'quality-template': 'Agregar Plantilla de Calidad',
'customer-order': 'Agregar Pedido',
'customer': 'Agregar Cliente',
'team-member': 'Agregar Miembro del Equipo',
'sales-entry': 'Registrar Ventas',
};
return titleMap[selectedItemType] || 'Agregar Contenido';
};
return (
<WizardModal
isOpen={isOpen}
onClose={handleClose}
onComplete={handleWizardComplete}
title={getWizardTitle()}
steps={getWizardSteps()}
icon={<Sparkles className="w-6 h-6" />}
size="xl"
/>
);
};
export default UnifiedAddWizard;