Studio Notebook: vision, Phase 1 designs, and working prototype

- VISION.md: the full studio-backbone product vision (craft core, operations,
  selling, daily driver), Bonna's approved design decisions, and phasing
- design/: two clickable Phase 1 mockups (moonlit palette, CSS-only tabs)
- prototype/: zero-dependency local app (Node built-ins + SQLite) — Today with
  jot-first capture + subtask outliner, Clay & Glazes library, fill-and-go
  Firing Log with emoji unload ratings feeding evidence tables, Pieces with
  core line/tiles/one-of-a-kind + money card, Files with per-piece attachment,
  Sourcing with price ledger + live supplier search links (9 suppliers seeded)
- CLAUDE.md: access notes updated for the provisioned site + this repo's state

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Bonna
2026-08-06 21:46:54 -05:00
commit cd83fd61cb
11 changed files with 1916 additions and 0 deletions

73
prototype/README.md Normal file
View File

@@ -0,0 +1,73 @@
# Studio Notebook — Phase 1 prototype
A zero-dependency local prototype of the studio backbone's Phase 1 (see
[../VISION.md](../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:
```sh
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 g5 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.