3D Digital Twin Feasibility

Выбранный стек

three
@react-three/fiber
@react-three/drei (OrbitControls, Html labels)
Без @react-three/rapier на первом этапе

Почему

R3F хорошо ложится на текущий React UI.
Простые box/cylinder геометрии достаточны для digital twin.
Drei нужен только для камеры и коротких labels.
Physics engine в браузере добавляет wasm, непредсказуемость и риск лагов на защите.

Physics engine

Не подключается.

Анимация: keyframe / state-machine interpolation по machineState + elapsedInStateMs.

Архитектура готова к physics позже:

позиции товара и actuator вычисляются в itemMotion.ts;
статические меши сцены отделены от motion layer;
можно заменить motion layer на kinematic/dynamic bodies без смены domain logic.

Риски

Риск	Митигация
Bundle size	lazy-load 3D, простые геометрии
Нет WebGL	2D `SorterScene` fallback
Mobile FPS	simplified 3D или auto-2D при width < 640
Непредсказуемая физика	не используем rapier

Fallback

WebGL unavailable → 2D.
User toggle «2D fallback».
Mobile narrow screen → default 2D (можно вручную включить 3D).

Сообщение: «3D недоступен, включён 2D fallback. Логика симуляции та же.»

Performance budget

Без shadows / postprocessing / textures.
< ~50 mesh-объектов.
FPS overlay в capability check.
Target: стабильный interactive FPS на desktop.

Integration point

ProductDemoSection: toggle 3D Digital Twin / 2D fallback. Props из SimulationState: item, machineState, scenario, classification, sensors, actuators, metrics, gate.

Definition of Done

Build/test/Docker OK
3D показывает A → conveyor → CV → gate → B/C/D
State machine двигает товар предсказуемо
ROUTE_TO_* виден цветом и стрелкой
2D fallback работает
min dimensions 10×10×10, conveyor 1.00 m/s
Нет horizontal scroll

Decision log

Physics (@react-three/rapier) не установлен: для хакатона важнее предсказуемый route, чем dynamic collisions. Motion layer — itemMotion.ts (PHYSICS_ENGINE_ENABLED = false).

2.6 KiB Raw Blame History Unescape Escape