{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "return-merchandise-inspection", "title": "Return Merchandise Inspection", "type": "registry:block", "files": [ { "path": "packages/registry-react/blocks/return-merchandise-inspection/ReturnMerchandiseInspection.tsx", "content": "'use client'\n\nimport * as React from 'react'\nimport {\n AlertTriangle,\n ArrowRight,\n Barcode,\n Box,\n CheckCircle2,\n Clock,\n CornerDownLeft,\n CreditCard,\n Download,\n FileCheck,\n Gift,\n Package,\n PackageCheck,\n Printer,\n Radio,\n RotateCcw,\n ScanLine,\n Tag,\n UserCheck,\n Warehouse,\n} from 'lucide-react'\nimport { cn } from '@/lib/utils'\nimport { Badge } from '@/components/ui/badge'\nimport { Button } from '@/components/ui/button'\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '@/components/ui/card'\nimport { Checkbox } from '@/components/ui/checkbox'\nimport { RadioGroup, RadioGroupItem } from '@/components/ui/radio-group'\nimport { Separator } from '@/components/ui/separator'\nimport { Textarea } from '@/components/ui/textarea'\n\nexport type ConditionGrade = 'grade-a' | 'grade-b' | 'grade-c' | 'grade-d'\nexport type RefundAction = 'full-refund' | 'store-credit' | 'restock-fee'\n\nexport interface InspectionChecklist {\n tagsAttached: boolean\n originalBox: boolean\n allAccessories: boolean\n odorStainFree: boolean\n}\n\nexport interface ReturnInspectionData {\n rmaNumber: string\n stationId: string\n inspectorName: string\n returnReason: string\n item: {\n name: string\n variant: string\n msrp: number\n sku: string\n upc: string\n verified: boolean\n }\n grade: ConditionGrade\n checklist: InspectionChecklist\n refundAction: RefundAction\n qcNotes: string\n dispositionOutcome: {\n route: string\n destinationBin: string\n lpnCode: string\n priority: string\n }\n}\n\nexport interface ReturnMerchandiseInspectionProps {\n initialRma?: string\n initialGrade?: ConditionGrade\n initialRefundAction?: RefundAction\n initialSubmitted?: boolean\n inspectorName?: string\n stationName?: string\n className?: string\n onComplete?: (data: ReturnInspectionData) => void\n}\n\nconst itemData = {\n name: 'Aero Minimalist Runner · Size 10.5 · Matte Black',\n variant: 'Matte Black / US 10.5 M',\n sku: 'AMR-BLK-105',\n upc: 'UPC-018249',\n msrp: 145.0,\n orderRef: '#ORD-98421',\n carrier: 'FedEx Return Express',\n trackingNumber: '7946 1102 9842',\n returnReason: 'Customer reported wrong size ordered',\n}\n\nconst gradeDefinitions: Record<\n ConditionGrade,\n {\n id: ConditionGrade\n code: string\n title: string\n conditionLabel: string\n summary: string\n route: string\n targetBin: string\n lpnCode: string\n priority: string\n badgeClasses: string\n activeBorderBg: string\n indicatorColor: string\n statusText: string\n }\n> = {\n 'grade-a': {\n id: 'grade-a',\n code: 'Grade A',\n title: 'Grade A: Brand New / Unopened',\n conditionLabel: 'Brand New / Pristine',\n summary: 'Original tags & packaging intact',\n route: 'Restock to Primary Inventory',\n targetBin: 'Aisle 04-B · Bin #04-B-12',\n lpnCode: 'LPN-849201-RESTOCK-A',\n priority: 'High · Inventory Replenishment',\n badgeClasses: 'border-success/30 bg-success/10 text-success font-semibold',\n activeBorderBg: 'border-success/40 bg-success/5 shadow-xs ring-1 ring-success/20',\n indicatorColor: 'bg-success',\n statusText: 'Primary Inventory Restock Approved',\n },\n 'grade-b': {\n id: 'grade-b',\n code: 'Grade B',\n title: 'Grade B: Open Box / Minor Cosmetic',\n conditionLabel: 'Open Box / Inspected',\n summary: 'No functional damage, packaging opened',\n route: 'Route to Outlet / Refurbished Store',\n targetBin: 'Secondary Channel · Pallet #03',\n lpnCode: 'LPN-849201-OUTLET-B',\n priority: 'Standard · Secondary Routing',\n badgeClasses: 'border-warning/30 bg-warning/10 text-warning font-semibold',\n activeBorderBg: 'border-warning/40 bg-warning/5 shadow-xs ring-1 ring-warning/20',\n indicatorColor: 'bg-warning',\n statusText: 'Secondary Channel Re-routing',\n },\n 'grade-c': {\n id: 'grade-c',\n code: 'Grade C',\n title: 'Grade C: Worn / Used',\n conditionLabel: 'Worn / Blemished',\n summary: 'Minor wear on soles, visible creasing',\n route: 'Liquidation Batch #LQ-409',\n targetBin: 'Bulk Liquidation Pallet #C-88',\n lpnCode: 'LPN-849201-LIQUIDATE-C',\n priority: 'Batch Weekly Dispatch',\n badgeClasses: 'border-orange-500/30 bg-orange-500/10 text-orange-700 dark:text-orange-400 font-semibold',\n activeBorderBg: 'border-orange-500/40 bg-orange-500/5 dark:bg-orange-950/20 shadow-xs ring-1 ring-orange-500/20',\n indicatorColor: 'bg-orange-500',\n statusText: 'Wholesale Liquidation Staging',\n },\n 'grade-d': {\n id: 'grade-d',\n code: 'Grade D',\n title: 'Grade D: Damaged / Defective',\n conditionLabel: 'Defective / Damaged',\n summary: 'Torn fabric, seam defect, structural flaw',\n route: 'Quarantine / Return to Vendor (RTV)',\n targetBin: 'Quarantine Bay Q-08 (Vendor Claims)',\n lpnCode: 'LPN-849201-QUARANTINE-D',\n priority: 'Urgent · Vendor RTV Credit Hold',\n badgeClasses: 'border-destructive/30 bg-destructive/10 text-destructive font-semibold',\n activeBorderBg: 'border-destructive/40 bg-destructive/5 shadow-xs ring-1 ring-destructive/20',\n indicatorColor: 'bg-destructive',\n statusText: 'Quarantine Hold & Vendor Credit Claim',\n },\n}\n\nfunction formatCurrency(val: number) {\n return new Intl.NumberFormat('en-US', {\n style: 'currency',\n currency: 'USD',\n minimumFractionDigits: 2,\n }).format(val)\n}\n\nexport function ReturnMerchandiseInspection({\n initialRma = '#RMA-849201',\n initialGrade = 'grade-a',\n initialRefundAction = 'full-refund',\n initialSubmitted = false,\n inspectorName = 'Alex Rivera · QC Lead',\n stationName = 'Warehouse Returns Intake & Grading Station #02',\n className,\n onComplete,\n}: ReturnMerchandiseInspectionProps) {\n const [rmaNumber, setRmaNumber] = React.useState(initialRma)\n const [selectedGrade, setSelectedGrade] = React.useState(initialGrade)\n const [selectedRefundAction, setSelectedRefundAction] = React.useState(initialRefundAction)\n const [submitted, setSubmitted] = React.useState(initialSubmitted)\n const [qcNotes, setQcNotes] = React.useState(\n 'Outer packaging opened by customer. All interior packaging materials, extra shoelaces, and brand care card verified in pristine condition. Zero sole wear detected.',\n )\n\n const [checklist, setChecklist] = React.useState({\n tagsAttached: true,\n originalBox: true,\n allAccessories: true,\n odorStainFree: true,\n })\n\n React.useEffect(() => {\n setSelectedGrade(initialGrade)\n }, [initialGrade])\n\n React.useEffect(() => {\n setSelectedRefundAction(initialRefundAction)\n }, [initialRefundAction])\n\n React.useEffect(() => {\n setSubmitted(initialSubmitted)\n }, [initialSubmitted])\n\n const currentGrade = gradeDefinitions[selectedGrade]\n\n const totalChecklistCount = 4\n const checkedChecklistCount = React.useMemo(() => {\n let count = 0\n if (checklist.tagsAttached) count++\n if (checklist.originalBox) count++\n if (checklist.allAccessories) count++\n if (checklist.odorStainFree) count++\n return count\n }, [checklist])\n\n const allChecksPassed = checkedChecklistCount === totalChecklistCount\n\n const refundCalculations = React.useMemo(() => {\n const msrp = itemData.msrp\n if (selectedRefundAction === 'store-credit') {\n const bonus = msrp * 0.1\n return {\n subtotal: msrp,\n adjustmentLabel: 'Store Credit Bonus (+10%)',\n adjustmentAmount: bonus,\n isBonus: true,\n totalRefund: msrp + bonus,\n methodLabel: 'Digital Gift Card (sarah.c@example.com)',\n payoutSpeed: 'Instant email delivery upon grading',\n }\n }\n\n if (selectedRefundAction === 'restock-fee') {\n const fee = 15.0\n return {\n subtotal: msrp,\n adjustmentLabel: 'Restocking & Repacking Fee',\n adjustmentAmount: fee,\n isBonus: false,\n totalRefund: msrp - fee,\n methodLabel: 'Net Credit to Visa •••• 4242',\n payoutSpeed: '3–5 business days to card',\n }\n }\n\n return {\n subtotal: msrp,\n adjustmentLabel: 'Restocking Fee Waived',\n adjustmentAmount: 0,\n isBonus: false,\n totalRefund: msrp,\n methodLabel: 'Full Refund to Visa •••• 4242',\n payoutSpeed: '3–5 business days to card',\n }\n }, [selectedRefundAction])\n\n const selectAllChecklist = (pass: boolean) => {\n setChecklist({\n tagsAttached: pass,\n originalBox: pass,\n allAccessories: pass,\n odorStainFree: pass,\n })\n }\n\n const applyPresetNote = (note: string) => {\n if (!qcNotes.includes(note)) {\n setQcNotes(qcNotes ? `${qcNotes} ${note}` : note)\n }\n }\n\n const handleCompleteInspection = () => {\n setSubmitted(true)\n onComplete?.({\n rmaNumber,\n stationId: 'STATION-02-B',\n inspectorName,\n returnReason: itemData.returnReason,\n item: {\n name: itemData.name,\n variant: itemData.variant,\n msrp: itemData.msrp,\n sku: itemData.sku,\n upc: itemData.upc,\n verified: true,\n },\n grade: selectedGrade,\n checklist: { ...checklist },\n refundAction: selectedRefundAction,\n qcNotes,\n dispositionOutcome: {\n route: currentGrade.route,\n destinationBin: currentGrade.targetBin,\n lpnCode: currentGrade.lpnCode,\n priority: currentGrade.priority,\n },\n })\n }\n\n const handleReset = () => {\n setSubmitted(false)\n setSelectedGrade('grade-a')\n setSelectedRefundAction('full-refund')\n selectAllChecklist(true)\n setQcNotes(\n 'Outer packaging opened by customer. All interior packaging materials, extra shoelaces, and brand care card verified in pristine condition. Zero sole wear detected.',\n )\n }\n\n return (\n \n {/* ================================================================= */}\n {/* POST-SUBMISSION CONFIRMATION RECEIPT VIEW */}\n {/* ================================================================= */}\n {submitted ? (\n
\n \n \n
\n \n \n {selectedGrade !== 'grade-d' ? (\n \n ) : (\n \n )}\n \n
\n\n \n RMA Disposition Manifest Dispatched\n \n\n

\n {selectedGrade === 'grade-d'\n ? 'RMA Inspection Flagged · Quarantine RTV Initiated'\n : 'Inspection Complete · Automated Routing Logged'}\n

\n

\n Disposition for {itemData.name} has been recorded.\n Warehouse routing slip and automated customer refund authorization have been queued.\n

\n\n
\n RMA Reference:\n {rmaNumber}\n LPN:\n {currentGrade.lpnCode}\n
\n
\n\n \n {/* Disposition Summary Meta Grid */}\n
\n
\n Condition Grade\n {currentGrade.title}\n {currentGrade.summary}\n
\n\n
\n Warehouse Destination\n {currentGrade.targetBin}\n {currentGrade.route}\n
\n\n
\n Customer Resolution\n \n {formatCurrency(refundCalculations.totalRefund)}\n \n {refundCalculations.methodLabel}\n
\n\n
\n QC Inspector\n {inspectorName}\n Station #02 · Timestamped\n
\n
\n\n {/* LPN Barcode & Routing Pass Box */}\n
\n
\n
\n \n \n Pallet / Tote License Plate Number (LPN)\n \n
\n \n READY FOR PUTAWAY\n \n
\n\n
\n {/* Barcode SVG visualization */}\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n {currentGrade.lpnCode}\n {currentGrade.targetBin}\n
\n
\n\n {/* Inspector Notes Display */}\n {qcNotes && (\n
\n Logged Inspector Notes:\n

\n “{qcNotes}”\n

\n
\n )}\n
\n\n {/* Actions Strip */}\n
\n \n\n
\n \n \n
\n
\n \n \n \n ) : (\n /* ================================================================= */\n /* ACTIVE INSPECTION WORKBENCH VIEW */\n /* ================================================================= */\n
\n {/* Top Station Header Card */}\n \n \n
\n
\n
\n \n \n Station #02 · Returns Intake & Grading\n \n \n \n {rmaNumber}\n \n \n \n Scanner Online\n \n
\n\n
\n \n Warehouse Returns Intake & Grading Station #02\n \n \n RMA intake verification, physical condition evaluation, restock/quarantine disposition routing,\n and customer refund action.\n \n
\n
\n\n {/* Primary Header CTA */}\n
\n \n \n Complete Inspection & Disposition\n \n
\n
\n \n\n {/* Metadata Ribbon Bar */}\n \n
\n
\n
\n \n RMA Reference\n
\n

{rmaNumber}

\n

Order: {itemData.orderRef}

\n
\n\n
\n
\n \n Inspector / Station\n
\n

{inspectorName}

\n

Terminal Station #02

\n
\n\n
\n
\n \n Customer Return Reason\n
\n

{itemData.returnReason}

\n

Carrier: {itemData.carrier}

\n
\n\n
\n
\n \n Intake Status\n
\n

In Progress · Pending Disposition

\n

{itemData.trackingNumber}

\n
\n
\n \n \n\n {/* =============================================================== */}\n {/* 2-COLUMN INSPECTION WORKBENCH */}\n {/* =============================================================== */}\n
\n {/* LEFT COLUMN: Item Verification & Condition Grading (7 Cols) */}\n
\n {/* 1. Scanned Item Verification Card */}\n \n \n
\n
\n \n Intake Item Scanned\n
\n \n \n Match Verified\n \n
\n \n\n \n
\n
\n \n
\n\n
\n
\n
\n

{itemData.name}

\n

\n {itemData.variant} · SKU: {itemData.sku}\n

\n
\n
\n \n {formatCurrency(itemData.msrp)}\n \n MSRP\n
\n
\n\n
\n
\n \n {itemData.upc}\n \n UPC OK\n \n
\n \n Order: {itemData.orderRef}\n
\n
\n
\n \n \n\n {/* 2. Condition Grading Radio Cards */}\n \n \n
\n
\n Condition Grading Assessment\n \n Select physical grading level to trigger automated warehouse routing rules.\n \n
\n {currentGrade.code}\n
\n \n\n \n setSelectedGrade(val as ConditionGrade)}\n className=\"grid grid-cols-1 gap-2.5\"\n >\n {/* Grade A */}\n setSelectedGrade('grade-a')}\n >\n \n
\n
\n \n Grade A: Brand New / Unopened\n \n \n Primary Restock\n \n
\n

\n Original factory tags & packaging intact. No cosmetic or functional flaws.\n

\n
\n \n \n Target:{' '}\n \n Restock to Primary Inventory (Aisle 04-B)\n \n \n
\n
\n
\n\n {/* Grade B */}\n setSelectedGrade('grade-b')}\n >\n \n
\n
\n \n Grade B: Open Box / Minor Cosmetic\n \n \n Outlet Store\n \n
\n

\n Box opened or minor package scuffs, but product is 100% unworn and fully functional.\n

\n
\n \n \n Target:{' '}\n Route to Outlet / Refurbished Store\n \n
\n
\n
\n\n {/* Grade C */}\n setSelectedGrade('grade-c')}\n >\n \n
\n
\n \n Grade C: Worn / Used\n \n \n Liquidation\n \n
\n

\n Visible wear on soles, minor creasing or cosmetic stains. Not suitable for retail shelves.\n

\n
\n \n \n Target:{' '}\n \n Liquidation Batch #LQ-409 (Wholesale Lot)\n \n \n
\n
\n
\n\n {/* Grade D */}\n setSelectedGrade('grade-d')}\n >\n \n
\n
\n \n Grade D: Damaged / Defective\n \n \n Quarantine RTV\n \n
\n

\n Torn fabric, broken seam, outsole separation, or manufacturing defect.\n

\n
\n \n \n Target:{' '}\n \n Quarantine Bay Q-08 / Return to Vendor (RTV)\n \n \n
\n
\n \n \n \n \n\n {/* 3. Physical Inspection Checklist */}\n \n \n
\n
\n Physical Inspection Checklist\n \n Verify all physical criteria before approving final warehouse putaway.\n \n
\n
\n \n {checkedChecklistCount}/{totalChecklistCount} Passed\n \n selectAllChecklist(!allChecksPassed)}\n >\n {allChecksPassed ? 'Uncheck All' : 'Pass All'}\n \n
\n
\n \n\n \n {/* Item 1: Tags Attached */}\n \n setChecklist((prev) => ({ ...prev, tagsAttached: Boolean(val) }))}\n className=\"mt-0.5\"\n />\n
\n \n Tags attached\n \n

\n Factory hangtags, barcode UPC stickers, and care labels intact.\n

\n
\n \n\n {/* Item 2: Original Box Present */}\n \n setChecklist((prev) => ({ ...prev, originalBox: Boolean(val) }))}\n className=\"mt-0.5\"\n />\n
\n \n Original box present\n \n

\n Manufacturer shoebox present with readable SKU and size label.\n

\n
\n \n\n {/* Item 3: Accessories in Box */}\n \n setChecklist((prev) => ({ ...prev, allAccessories: Boolean(val) }))}\n className=\"mt-0.5\"\n />\n
\n \n All accessories in box\n \n

\n Extra pair of laces, dust bag, and product manual verified.\n

\n
\n \n\n {/* Item 4: Odor and Stain Free */}\n \n setChecklist((prev) => ({ ...prev, odorStainFree: Boolean(val) }))}\n className=\"mt-0.5\"\n />\n
\n \n Odor & stain free\n \n

\n Free from perfume scent, tobacco smoke, pet hair, dirt, or cosmetic scuffs.\n

\n
\n \n \n \n \n\n {/* RIGHT COLUMN: Disposition & Customer Refund Action Card (5 Cols) */}\n
\n {/* 1. Selected Automated Warehouse Disposition Card */}\n \n \n
\n
\n \n Warehouse Routing Outcome\n
\n {currentGrade.code}\n
\n \n\n \n {/* Active Outcome Card Banner */}\n
\n
\n
\n \n
\n
\n
\n {currentGrade.route}\n
\n

\n Destination Bin:{' '}\n {currentGrade.targetBin}\n

\n

\n Priority: {currentGrade.priority}\n

\n
\n
\n\n
\n LPN: {currentGrade.lpnCode}\n \n READY FOR SCAN\n \n
\n
\n \n \n\n {/* 2. Customer Refund Action Card */}\n \n \n
\n
\n Customer Refund Action\n \n Choose financial settlement for RMA {rmaNumber}.\n \n
\n \n
\n \n\n \n setSelectedRefundAction(val as RefundAction)}\n className=\"grid grid-cols-1 gap-2.5\"\n >\n {/* Option 1: Full Refund */}\n setSelectedRefundAction('full-refund')}\n >\n \n
\n
\n \n \n {formatCurrency(itemData.msrp)}\n \n
\n

\n 100% refund to Visa •••• 4242. 3–5\n business days.\n

\n
\n
\n\n {/* Option 2: Store Credit (+10% Bonus) */}\n setSelectedRefundAction('store-credit')}\n >\n \n
\n
\n
\n \n \n Issue Store Credit (+10%)\n \n
\n \n {formatCurrency(itemData.msrp * 1.1)}\n \n
\n

\n Includes{' '}\n +{formatCurrency(itemData.msrp * 0.1)}{' '}\n bonus credit. Delivered instantly by email.\n

\n
\n \n\n {/* Option 3: Charge Restocking Fee */}\n setSelectedRefundAction('restock-fee')}\n >\n \n
\n
\n \n \n {formatCurrency(itemData.msrp - 15)}\n \n
\n

\n $15.00 repackaging & inspection deduction. Net to{' '}\n Visa •••• 4242.\n

\n
\n \n \n\n {/* Settlement Calculation Summary Box */}\n
\n
\n Item MSRP\n \n {formatCurrency(refundCalculations.subtotal)}\n \n
\n {selectedRefundAction === 'store-credit' ? (\n
\n {refundCalculations.adjustmentLabel}\n \n +{formatCurrency(refundCalculations.adjustmentAmount)}\n \n
\n ) : selectedRefundAction === 'restock-fee' ? (\n
\n {refundCalculations.adjustmentLabel}\n \n -{formatCurrency(refundCalculations.adjustmentAmount)}\n \n
\n ) : null}\n
\n Authorized Net Settlement\n \n {formatCurrency(refundCalculations.totalRefund)}\n \n
\n
\n \n \n\n {/* 3. Internal QC Inspection Notes */}\n \n \n
\n
\n Internal QC Inspection Notes\n \n Station audit log appended to inventory history.\n \n
\n
\n \n\n \n \n\n {/* Quick Tag Helpers */}\n
\n Quick Preset Tags:\n
\n applyPresetNote('Pristine unworn condition.')}\n >\n + Pristine Condition\n \n applyPresetNote('Minor outer box scuff; shoes mint.')}\n >\n + Box Scuffed\n \n applyPresetNote('Slight sole friction detected.')}\n >\n + Sole Friction\n \n applyPresetNote('Factory seam defect identified - Flagged RTV.')}\n >\n + Flagged RTV\n \n
\n
\n \n\n \n \n Audit sign-off: {inspectorName}\n \n \n \n \n \n \n \n )}\n \n )\n}\n", "type": "registry:block", "target": "~/components/blocks/ReturnMerchandiseInspection.tsx" } ], "dependencies": [ "lucide-react" ], "devDependencies": [], "registryDependencies": [ "https://uipkge.dev/r/react/badge.json", "https://uipkge.dev/r/react/button.json", "https://uipkge.dev/r/react/card.json", "https://uipkge.dev/r/react/checkbox.json", "https://uipkge.dev/r/react/radio-group.json", "https://uipkge.dev/r/react/separator.json", "https://uipkge.dev/r/react/textarea.json" ], "description": "Warehouse returns intake inspection station, RMA condition grading, and restock vs quarantine disposition workbench.", "categories": [ "logistics", "ecommerce", "app" ] }