grokbot_ty
8d757283d7
Replay local tip onto origin/docs/refactor-v2. Keeps remote UX-DESIGN wireframes. Adds signed UX, browser matrix (phone+PC), and UAT-PRACTICE.
55 lines
3.1 KiB
Markdown
55 lines
3.1 KiB
Markdown
# SlabUploader
|
||
|
||
Phone app for listing one-of-a-one wood slabs on the Whidbey Wood Store.
|
||
|
||
You photograph a slab, confirm the cut and the numbers on the phone, review the listing, and create the WooCommerce product. The phone does the measuring and crop. The server stores the draft, talks to the store, and (later) runs vision.
|
||
|
||
Owner: Ty (Whidbey). Store: www.whidbeywoodstore.com. Runs in Docker Compose behind Caddy on a host you inventory first (`APP_HOSTNAME`).
|
||
|
||
## Where we are
|
||
|
||
Docs freeze signed 2026-08-31. The current docs branch is `docs/refactor-v2`. Read `AGENTS.md` before writing code. If an old PRD line fights TECH-SPEC, ARCHITECTURE, or AGENTS, ignore the PRD. The old PRD is in `docs/archive/`.
|
||
|
||
The bar for this first version: a real slab, photographed on a phone, listed on the real store. Practice listings are WooCommerce **drafts** with SKUs that start `SLAB-UAT-`. After Ty looks, one real SKU goes **live**. Online only for now. Offline capture waits.
|
||
|
||
Build order is in `docs/IMPL-PLAN.md`. Empty app on the real host first, then the first draft listing, then vision.
|
||
|
||
## Documentation
|
||
|
||
| File | What |
|
||
|---|---|
|
||
| `AGENTS.md` | Hard rules. Read first. |
|
||
| `docs/ARCHITECTURE.md` | What runs on the phone vs the server |
|
||
| `docs/TECH-SPEC-PIPELINE.md` | Math, image pipeline, test vectors |
|
||
| `docs/DATA-MODEL.md` | SQLite tables and slab statuses |
|
||
| `docs/OPENAPI.md` | Phone to server API |
|
||
| `docs/CONTENT-WOO.md` | Titles, descriptions, store payload |
|
||
| `docs/PROMPTS.md` | Vision and copy prompts (server files) |
|
||
| `docs/DEPLOYMENT.md` | Compose, Caddy, backup |
|
||
| `docs/UAT-PRACTICE.md` | Walkable practice UAT: host check → App Password → one `SLAB-UAT-*` prove |
|
||
| `deploy/INVENTORY.md` | Host worksheet before you bind ports |
|
||
| `docs/IMPL-PLAN.md` | Phases and exit gates |
|
||
| `docs/archive/PRD-2026-08.txt` | Frozen history. Not a source for new work. |
|
||
|
||
## Short map
|
||
|
||
- Phone: mask knobs, square feet, board feet, 3:4 PNG. Server: store, WooCommerce, vision proxy. Server matting ("Try harder") is not in this first listing.
|
||
- Board feet = square feet × thickness in inches. No divide-by-12. Test vectors TV-1 through TV-10 run on the phone.
|
||
- Secrets never sit in the browser. Encrypted on the server. Store login is a WordPress application password on a low-privilege user, not WooCommerce consumer keys.
|
||
- Practice SKUs `SLAB-UAT-*` are always drafts, even if Settings say publish.
|
||
- Vision stays off until the first draft listing works. Species suggestion and Generate text come after that, still in this project.
|
||
- Two containers (`frontend`, `fastapi`) plus Caddy. One SQLite, image volumes.
|
||
- Not in v1: versioning, staff roles, bulk publish, analytics, editing an existing SKU.
|
||
|
||
## Repo
|
||
|
||
Source of truth: Gitea `Ty_Tech/SlabUploader` on gitea-atd
|
||
(`https://gitea.vps1.afterthedemo.com/Ty_Tech/SlabUploader`). TrueNAS and GitHub copies are not the source of truth for this work.
|
||
|
||
## Getting started
|
||
|
||
1. Read `AGENTS.md` and Phase 0 in `docs/IMPL-PLAN.md`.
|
||
2. Build the phone math modules and a thin FastAPI health/settings app. Do not put measuring on the server.
|
||
3. Ty signs each phase. Do not skip that.
|
||
4. Do not implement from `docs/archive/PRD-2026-08.txt`.
|