Ty_Tech/SlabUploader
6
0
Fork 0
Code Issues 15 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: restore Milestone 1 user/app use case

Browse Source
This commit is contained in:
Ty
2026-09-11 15:14:00 +00:00
parent 92c4f81640
commit 74bd8b2863
1 changed files with 20 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/CAPTURE.md
+20
View File
@@ -17,6 +17,26 @@ Photograph the slab on a green or black sheet.
The app expects that sheet. Background removal keys green or black. Other backgrounds are out of Milestone 1.
## Use case
If a device draft exists:
- App opens Resume.
- User chooses Continue or Start fresh.
- Continue: app restores the last approved state.
- Start fresh: app discards the draft and opens Add photo.
Otherwise the app opens Add photo.
1. User adds one photo taken under Setup.
2. App decodes the photo and opens Mask. App keys green or black and shows an overlay: slab stays the photograph; removed pixels are a light gray checkerboard.
3. User sets sheet Auto / Green / Black and sensitivity 0–100 (slider or minus / plus). App updates the control immediately. App recomputes the overlay 2.0 seconds after the last sensitivity change. User adjusts until only the slab remains, then approves. App blocks approve if the mask has no slab pixels; user retakes. The approved mask is the footprint for every later step.
4. App draws the minimum-area bounding rectangle of the mask and the length axis on the long side of that rectangle. User rotates the axis if it does not follow the slab length, then approves the axis.
5. User enters length `L` in inches (1/8 in steps) and thickness (1/8 in steps).
6. App sets `scale = longest_axis_px / L`.
7. App computes widths, sqft, and bdft from the mask, and writes the inventory PNG.
8. User sees the PNG and the numbers. Milestone 1 stops here.
## Browsers
Phone: iOS Safari, Android Chrome.