ozone-tech_owl_prime/docs/ENGINEERING.md

Engineering notes (canonical)

Companion to README.md and /documentation. Not a stage changelog.

Coordinate conventions

• World units: 1 unit = 1 meter.
• Belt travel primarily along +X; belt top Y ≈ 0.70 m.
• Lateral: +Z = physical LEFT (category C), −Z = physical RIGHT (category D).
• Sorter CAD module origin X = 0; camera module −2.01; clean module −4.02.
• Longitudinal plane S for diverter timing is world X along the sorter module.

Canonical constants (code)

Symbol	Value	File
DIVERTER_LEFT_SIGNED_DEG	−45	src/domain/pusherMotion.ts
DIVERTER_RIGHT_SIGNED_DEG	+45	same
rotationDurationSec()	0.50	same (45° / 90°/s)
OPENING_SAFETY_MARGIN_SEC	0.15	same
Contact / clear planes	≈1.0538 / 1.6000	buildDiverterPlanes + mount hinge
Classifier min/max	exclusive 10³ / 450×320×320	src/domain/classifier.ts
Roundness	K > 0.8	same
CONVEYOR_CAD_URL	/models/sorter/conveyor-clean.glb	ConveyorCadModel.tsx

Active source tree (runtime)

src/main.tsx
src/App.tsx
src/pages/{MainPage,DocumentationPage}.tsx
src/components/{AppNav,SorterScene,CVInspectionOverlay,BuildIdentityBadge}.tsx
src/components/ThreeD/* (active twin only)
src/domain/* (classifier, playback, layout, diverter, physics helpers)
src/data/{items,modelAssets,resolveItem,productionStatusSummary,demoPlaylist,scenarios}.ts
src/styles.css

Asset provenance

Role	Path
Author CAD	3d_models/conveer.FCStd
Runtime conveyor	public/models/sorter/conveyor-clean.glb
Products	public/models/*.stl from official STL ZIP
Classifier PDF	official_sources/doc-1783095831.pdf
Workspace / scoring PDFs	input_info/doc-1783009942.pdf, doc-1783011400.pdf

Physics status (ENGINEERING-DERIVED PHYSICAL VALIDATION)

Implemented and covered by src/domain/junctionContactPhysics.ts (+ tests):

1. Fixed timestep 1/120 s, max 4 substeps, gravity [0, −9.81, 0].
2. Belt target speed 1.0 m/s via supported-body velocity coupling (stationary belt collider).
3. Single dynamic product body through junction; temporary scripted handoff removed.
4. LEFT/RIGHT diverter colliders: kinematicPositionBased, cuboid half-extents [0.375, 0.05, 0.02], same pivot/yaw as CAD.
5. C/D change direction only by physical contact; B uses the open neutral corridor.
6. Receiver volumes are sensors for completion; they do not translate the body.
7. Deterministic matrix 45/45 correct receiver entries (3 profiles × 5 runs × B/C/D).

Still not production-certified:

• Per-SKU mass / COM / friction calibration against real hardware
• Visual full belt loop mesh with true surface velocity
• Owner visual review of contact behavior

Compliance evidence rules

• Prefer present official files under input_info/ and official_sources/doc-1783095831.pdf.
• Missing: input_info/extracted/Постановка_Задача_3_сжато_2.pdf — never claim it is available.
• Internal engineering criteria are not automatic Ozon pass/fail.

Layout drawing

docs/engineering/work-area-layout-source.png — workspace layout provenance image retained for engineering reference.