21e83be26e
Add cleaned RealSense/OpenCV CV under cv/ with secret-free example config, MQTT disabled by default, and canonical README coverage for web + CV relationship without claiming production integration. Co-authored-by: Cursor <cursoragent@cursor.com>
3.8 KiB
3.8 KiB
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 roadmap (not completed)
- Surface-velocity belt at 1 m/s with visual loop.
- Contact-validated CAD diverter deflection for all playlist SKUs.
- Calibrated per-SKU mass, COM, friction, damping.
- Receiver capture verification under dynamic drops.
CCD for light/thin items exists in runtime/sim; that alone is not full contact validation.
Compliance evidence rules
- Prefer present official files under
input_info/andofficial_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.
Соответствие подтверждённым требованиям
Grounded only in present sources + current main code/tests (not a full official scorecard):
| Area | Official source present | Current implementation | Evidence | Status |
|---|---|---|---|---|
| B/C/D bounds & roundness | official_sources/doc-1783095831.pdf |
web classifier.ts, CV cv/classify.py |
unit tests | PARTIAL (PDF not re-parsed each pass) |
| Digital twin demo | workspace PDFs in input_info/ |
/ + /documentation |
e2e smoke/routes, production | PASS (demo present) |
| CAD conveyor | author pack / STL references | 3d_models/, conveyor-clean.glb |
checksums in README | PASS (assets present) |
| Real measurement CV | Track 3 camera intent in briefs | cv/ RealSense+OpenCV |
cv/README.md, test_classify.py |
PARTIAL (prototype, not live web) |
| Physical industrial line | scoring/workspace PDFs | web physics + optional MQTT CV | code; contact not fully validated | PARTIAL |
| Presentation / video | platform rules | cloud links | README §17 | NOT_VERIFIED (links missing) |
Real CV prototype
Path cv/ — OpenCV + RealSense D415 depth pipeline. Same B/C/D domain as the web twin. Not consumed by https://arhipovdan.ru. Details: cv/README.md.
Layout drawing
docs/engineering/work-area-layout-source.png — workspace layout provenance image retained for engineering reference.