From f4c1d6ca9426dadc157299313d030f44582ac0f6 Mon Sep 17 00:00:00 2001 From: Bonna Date: Thu, 6 Aug 2026 21:56:51 -0500 Subject: [PATCH] VISION: record settled architecture decisions (repo home, two decoupled apps, kiln parked, assisted-search scanner) Co-Authored-By: Claude Fable 5 --- VISION.md | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/VISION.md b/VISION.md index 782814f..745ab59 100644 --- a/VISION.md +++ b/VISION.md @@ -81,19 +81,24 @@ be the "solid organizational net" under her return: she should be able to jump back in and trust that recipes, firings, notes, and tasks are held somewhere that isn't her head. Design for re-entry: low friction, forgiving, encouraging. -## Open architecture questions (for Tony + Bonna) +## Architecture decisions (settled with Tony, 2026-08-06) -1. **Where does the code live?** Platform templates live in the platform monorepo - with a build chain (per CLAUDE.md, authoring a new template = days). Options: - new `bms-backbone` template in the monorepo (FMB convention), or app code in - this repo with its own build. FMB convention suggests the former. -2. **One app or two?** Backbone (admin/ops) + existing `site` storefront, like - FMB + fullmoonbakehouse.poweredbyotm.com. Probably: keep them separate, - integrate inventory → shop later. -3. **Kiln controller interface** — what protocol/API will Tony's controller - expose? Drives how "fire my kiln" lands in the app. -4. **Market scanner data source** — scraping? manual seed list + assisted search? - This one needs a feasibility pass; deadlines/fees aren't in any clean API. +1. **Code lives here.** This repo (Bonna-Moon-Studio on Gitea) IS the backbone's + repo — vision, designs, prototype, and eventually production code. Follows + the FMB own-repo convention; only shared templates live in the platform + monorepo. When Phase 1 is worth hosting, a `bms-backbone` template entry + points at this repo and builds from it. Until then the laptop prototype + serves Bonna. (Tony is new to git — Claude drives commits/pushes; Tony reads + history on Gitea's web UI.) +2. **Two apps, either without the other.** Site storefront and backbone stay + separate services (own containers/DBs/hostnames), like FMB + its site. Any + future site↔backbone integration (shop inventory) is an optional bridge with + graceful fallback — decoupled by design, connected by choice. +3. **Kiln controller — parked.** Tony: "don't worry about this yet." Revisit + when the hardware project has a shape; Phase 5 stays last regardless. +4. **Market scanner = assisted search + manual seed list.** No scraping + infrastructure. Claude does periodic hunts for local markets/fairs + (deadlines, fees, distance) and logs findings; Bonna seeds/curates the list. ## Prototype (built 2026-08-06)