Bonna-Moon-Studio/prototype/README.md

Studio Notebook — Phase 1 prototype

A zero-dependency local prototype of the studio backbone's Phase 1 (see ../VISION.md). Node's built-in http + node:sqlite — no npm install, no node_modules, total footprint a few hundred KB plus photos.

Run it: double-click Start Studio Notebook.command in the repo root, or:

node prototype/server.mjs

Then open http://localhost:6161. Data lives in prototype/data/ (gitignored): studio.db (SQLite) and photos/. Back that folder up = back up the notebook.

What works (v0.1)

• Today — jot box with "file it as…" chips (note / to-do / shopping / glaze idea), to-dos with subtasks, the one shopping list, kiln status, recent notes
• Keyboard-first capture — Enter saves and stays in the box; Shift+Enter adds subtask lines (first line = task, rest = its subtasks); multiline shopping jots become one item per line; Tab cycles the file-as chips; / focuses the jot box from anywhere; per-todo ＋ opens an inline subtask input (Enter saves, Esc closes)
• Clay & Glazes — one library, three kinds: glazes, casting slips, and clay bodies, each grouped under its own heading; clay bodies feed an autocomplete in the firing form so compatibility evidence never splits over spelling; cards with swatches; new glaze/slip form (name-only minimum, chips for cone/atmosphere/surface/source); detail page with recipe, batch scaling (500 g–5 kg), journal, photo uploads, and the "plays well with" table built exclusively from unload-day ratings (never hand-edited)
• Firing Log — fill-the-kiln-and-go start (type + cone, everything else optional); load items (piece + clay + glaze) addable any time incl. unload; unload day with 😍🙂😕💔 one-tap ratings that feed the glaze evidence
• Notes — the jot stream with tags
• Pieces — Bonna's "together but separate" product tracking: Core line (repeatable products with on-hand counts, − / ＋ / "sold one") vs Small batch & one of a kind (individual pieces with in progress → for sale → sold status). Each piece carries price + rough cost estimate.
• Money — sales recorded on one tap; the money card shows this-month revenue, all-time revenue, and estimated profit (sales − cost estimates). Real materials-based costing is a later phase.
• Sidebar navigation (FMB-style) on desktop; collapses to top chips on narrow screens.
• Piece pages (FMB recipe/listing-style) — click any piece name for its page: price/cost/stock or status controls, sales history, notes, photos, and attached files.
• Files — upload anything (STL master molds, foam form templates, cut files); tag as master molds / foam forms / prototypes / other; attach to a specific piece from its page, or keep in the general studio files area. Downloads preserve original filenames. Stored in prototype/data/files/.
• Sourcing — suppliers (online vs 🚗 drivable-with-distance, website, shipping notes) + a price ledger: log every buy or price-check (item, supplier, price, shipping). Entries group by item; each shows ▲/▼ trend vs that supplier's previous price, shipping-inclusive totals, and a "best 🏆" pill on the cheapest current source. Suppliers may carry a search-URL template (…?q={q}); the price-check box then opens any item's live search on every such supplier in one click. Fully-automated scraping is deliberately out (fragile, silently stale) — live-open links + the ledger habit instead; Claude can also be asked to browse suppliers and log price checks.

Deliberately not here yet

Stull chart (needs UMF chemistry data — Phase 1.5), molds/slip-casting screens, inventory, costs, calendar, market scanner, Glazy import, kiln control. See VISION.md phasing.

Status

Prototype for design validation + real daily use while the platform question (where the production code lives — Tony's call, see VISION.md "Open architecture questions") is pending. The schema here (typed recipes, evidence-only compatibility, firing lifecycle) is the reference for the production build.