How jiaxiantao/3d-express-warehouse works
This is a browser-based 3D warehouse/WMS demo. The main workflow opens the warehouse console, seeds slot inventory, applies URL state or a SKU scan, and presents interactive 3D slots with status filters, statistics, and a detail/action panel. The scene also supports robot movement and camera views. The graph preserves documented QR, deep-link, screenshot/fullscreen, and slot-management capabilities. Some feature wiring is documented or indexed but not excerpted; those edges cite the README or are omitted where ownership is unclear.
Main entry points: page.tsx Warehouse page · warehouse-scene.tsx Interactive 3D scene · warehouse-data.ts Slot state and actions · warehouse-robot.tsx Robot model
Components 24
Warehouse console
- Warehouse page
src/app/warehouse/page.tsx - URL state
src/lib/use-warehouse-url-state.ts - QR scanner
src/components/warehouse-qr-scanner.tsx - Quick actions
src/components/warehouse-quick-actions.tsx - Slot panel
src/components/warehouse-slot-panel.tsx - Statistics and filters
src/components/warehouse-stats-bar.tsx - Robot pad
src/components/warehouse-robot-pad.tsx
Inventory and slot data
- SKU scan resolver
src/lib/warehouse-scan.ts - Slot state and actions
src/lib/warehouse-data.ts - Warehouse domain types
src/lib/warehouse-types.ts - Rack categories
src/lib/warehouse-rack-category.ts
3D warehouse scene
- Interactive 3D scene
src/components/warehouse-scene.tsx - Warehouse environment
src/components/warehouse-environment.tsx - Rack and slot geometry
src/lib/warehouse-layout.ts - Status colors
src/lib/warehouse-colors.ts - Slot animations
src/lib/warehouse-animations.ts
Robot navigation
- Robot model
src/components/warehouse-robot.tsx - Robot controls
src/components/warehouse-robot-controls.tsx - Walk navigation
src/lib/warehouse-robot-navigation.ts - Drive state
src/lib/warehouse-robot-drive.ts - Robot configuration
src/lib/warehouse-robot-config.ts - Robot animation rig
src/lib/warehouse-robot-animation.ts - Robot animator
src/components/warehouse-robot-animator.tsx
Other components
- Warehouse user
Connections 31
- Warehouse user → Warehouse page: opens console
README.md - Warehouse page → Slot state and actions: seeds slots
src/app/warehouse/page.tsx - Warehouse page → URL state: reads URL state
src/app/warehouse/page.tsx - Warehouse page → SKU scan resolver: resolves SKU
src/app/warehouse/page.tsx - Warehouse page → QR scanner: opens scanner
src/app/warehouse/page.tsx - Warehouse page → Quick actions: renders actions
src/app/warehouse/page.tsx - Warehouse page → Slot panel: renders details
src/app/warehouse/page.tsx - Warehouse page → Statistics and filters: renders statistics
src/app/warehouse/page.tsx - Warehouse page → Interactive 3D scene: renders scene
src/app/warehouse/page.tsx - Warehouse page → Robot pad: renders controls
src/app/warehouse/page.tsx - SKU scan resolver → Slot state and actions: looks up slots
src/lib/warehouse-scan.ts - Slot state and actions → Rack categories: selects products
src/lib/warehouse-data.ts - Warehouse page → Slot state and actions: applies slot actions
README.md - Interactive 3D scene → Slot state and actions: displays slot state
README.md - Interactive 3D scene → Rack and slot geometry: positions slots
src/components/warehouse-scene.tsx - Interactive 3D scene → Status colors: colors status
src/components/warehouse-scene.tsx - Interactive 3D scene → Slot animations: animates slot actions
src/components/warehouse-scene.tsx - Interactive 3D scene → Warehouse environment: renders environment
src/components/warehouse-scene.tsx - Interactive 3D scene → Robot model: renders robot
src/components/warehouse-scene.tsx - Interactive 3D scene → Robot controls: attaches controls
src/components/warehouse-scene.tsx - Robot controls → Walk navigation: steps toward targets
src/components/warehouse-robot-controls.tsx - Robot controls → Drive state: reads drive state
src/components/warehouse-robot-controls.tsx - Walk navigation → Rack and slot geometry: uses aisle bounds
src/lib/warehouse-robot-navigation.ts - Robot model → Robot animation rig: sets up animation
src/components/warehouse-robot.tsx - Robot model → Robot animator: renders animator
src/components/warehouse-robot.tsx - Slot state and actions → Warehouse domain types: uses domain types
src/lib/warehouse-data.ts - Statistics and filters → Status colors: uses status colors
src/components/warehouse-stats-bar.tsx - Slot panel → Status colors: uses status colors
src/components/warehouse-slot-panel.tsx - Warehouse user → QR scanner: scans SKU
README.md - Warehouse user → Interactive 3D scene: filters and views
README.md - Warehouse user → Slot panel: manages slots
README.md