ozone-tech_owl_prime/docs/PERFORMANCE_AND_B_RECEIVER_FIX_REPORT.md

PERFORMANCE & B RECEIVER FIX REPORT

Дата: 2026-07-09
Ветка: dan_branch
Production: https://arhipovdan.ru/

---

1. Что тормозило (root cause)

Production audit (docs/performance_physics_fix_screenshots/before/):

Причина	Детали
53+ useFrame на роликах	Каждый Roller имел собственный useFrame с покадровым вращением → десятки хуков на кадр.
Shadow overhead	directionalLight castShadow + castShadow/receiveShadow на mesh при Canvas shadows={false} — лишняя работа GPU.
6 belt stripes + тяжёлые эффекты	PointCloud (12 sphere mesh), ScanLine, MotionTrail, cinematic camera — все на каждом кадре.
До 10 historical STL items	До 10 одновременных PhysicalPlaybackItem с STL/fallback.
STL wireframe overlay	Ранее per-item EdgesGeometry (убрано ранее в PhysicalPlaybackItem).
React setPlayback ~20 Hz	App.tsx обновляет playback каждые 50 ms — допустимо, но усиливалось перерисовкой тяжёлой сцены.

Console (before): 0 errors, 0 spam logs. Только browser warnings: THREE.Clock deprecated, GPU stall ReadPixels (Playwright screenshots, не наш код).

---

2. Какие логи убраны

grep по src/: runtime console.log отсутствуют.

Оставлено (допустимо):

• console.error в ThreeErrorBoundary, MainPage, ProductDemoSection — только при падении Canvas.
• STLModel.tsx console.warn → только в DEV (import.meta.env.DEV).

Критерий после фикса: 0 errors, 0 spam logs (after_console.json).

---

3. Что оптимизировано

Изменение	Файл
Ролики статические (без useFrame)	SorterDigitalTwinContinuous.tsx
Убраны castShadow / shadow maps	SorterDigitalTwinContinuous.tsx
Belt stripes: 4 desktop / 3 mobile	ConveyorBelt
Ролики: шаг x2 в simplified mode	ConveyorBelt
MAX_VISIBLE_ITEMS = 8	SorterDigitalTwinContinuous.tsx
PointCloud / ScanLine / MotionTrail / cinematic cam off в simplified	ContinuousScene
PhysicalPlaybackItem обёрнут в React.memo	PhysicalPlaybackItem.tsx
STL: shared geometry via useLoader, без wireframe overlay	PhysicalPlaybackItem.tsx
LaserBeam: static, без useFrame	SorterDigitalTwinContinuous.tsx
Canvas: shadows={false}, dpr capped, powerPreference: high-performance	уже было

---

4. B receiving bin / tray

Добавлена физическая BReceiverBin (открытый лоток на полу):

• центр (4.4, 0, 0), размер 1.0 × 0.8 m, стены 0.4 m;
• дно на floorY = 0.08 m (как C/D cage floor);
• 4 ноги до пола, не висит в воздухе;
• transfer deck на высоте ленты (1.5 → 3.6 m) + drop chute в bin;
• зелёный акцент B (#16a34a), отличается от C/D.

---

5. Как B товар попадает и остаётся в B

conveyorNetwork path (B):

main_belt → inspection_station → routing_junction → b_transfer → chute_b → b_receiver_floor

physicalItemMotion (исправлен тайминг):

• routing phase (6400–8900 ms): transfer (55%) → chute (45%);
• с exit phase (8900 ms+): surface = b_receiver_floor, поза внутри bounds;
• B item не исчезает, не на активной ленте после exit;
• settled фиксирован при увеличении времени.

Тесты:

• B final pose inside b_receiver_floor bounds
• settled B NOT on active belt
• settled B y < 0.35 m (ниже ленты 0.7 m)
• settled at elapsedMs >= 9000
• C/D containment — без регрессий

---

6. C/D не сломаны

Пути C/D без изменений. Тесты c_cage_floor / d_cage_floor bounds — pass.
Roll-cage с внутренним полом сохранён.

---

7. Тесты

npm run test → 13 files, 137 tests passed (добавлен тест B bin floor height).

---

8. Screenshots

docs/performance_physics_fix_screenshots/before/
docs/performance_physics_fix_screenshots/after/

Файл	Содержание
01_home_idle.png	idle
02_play_running_smooth.png	play running
03_b_item_enters_b_receiver.png	B routing / chute
04_b_item_settled_in_b_bin.png	B case exit/clear (bin на полу виден)
05_c_item_settled_in_c_cage.png	C cage
06_d_item_settled_in_d_cage.png	D cage + plate STL
07_all_receivers_b_c_d.png	все зоны
08_no_overlay_overlap.png	overlay
09_mobile.png	mobile, no h-scroll
10_details.png	/details

Примечание: auto-cam следует за текущим кейсом; для кадра «B в корзине» надёжнее смотреть фазу exit/clear case 1/8 или unit-тесты позы. Физика позы доказана тестом y < 0.35 at 9200 ms.

---

9. Остаточные риски

• Browser warnings THREE.Clock deprecated — из three.js/r3f, не наш runtime log.
• GPU stall ReadPixels — артефакт Playwright screenshot в headless, не воспроизводится у пользователя без capture.
• Auto-cam может скрывать settled items в дальних зонах при смене кейса.
• 2 fallback кейса (small_item_c, low_confidence) — тяжёлые исходные STL.

---

10. Verdict

ГОТОВО для демо-защиты по performance + B physics.

• Лаги снижены (убраны 50+ useFrame на роликах, shadows, lite simplified mode).
• Console чистая (0 errors, 0 spam).
• B имеет физический bin на полу + путь transfer → chute → floor.
• B товар по модели в bin с exit phase, не на ленте (тесты).
• C/D containment сохранён.
• build/test/docker/production — OK.

---

Build / deploy

npm run build   → OK
npm run test    → 137 passed
docker compose -p owl -f docker-compose.server.yml up -d --build → OK
curl -I arhipovdan.ru / details / ai-shorts.ru → 200