101 lines
3.6 KiB
Markdown
101 lines
3.6 KiB
Markdown
# Resolved design decisions — Lumina / Salon_Assistant
|
||
|
||
Record of decisions from the planning session. Supersedes chat-only memory.
|
||
|
||
---
|
||
|
||
## Product
|
||
|
||
| ID | Decision |
|
||
|----|----------|
|
||
| D-01 | Product name working title **Lumina**; repo **Salon_Assistant** under **Ty_Tech** |
|
||
| D-02 | Demo persona Claire Bennett (fixtures only); real owner set at intro |
|
||
| D-03 | Hermes under NemoClaw; not OpenClaw-first |
|
||
| D-04 | No agent payments / bill-pay / refunds |
|
||
| D-05 | Client outbound and social: **draft only**; owner sends/posts |
|
||
| D-06 | Social media is a **first-class plane** (incl. owner photo/video craft) |
|
||
|
||
---
|
||
|
||
## Channels
|
||
|
||
| ID | Decision |
|
||
|----|----------|
|
||
| D-10 | Owner MVP channels: **WhatsApp, Email, Telegram** |
|
||
| D-11 | Hermes dashboard secondary |
|
||
| D-12 | **iMessage** not a supported bot channel |
|
||
| D-13 | Channels via Hermes/NemoClaw messaging — not IDE MCPs |
|
||
|
||
---
|
||
|
||
## SaaS and MCP
|
||
|
||
| ID | Decision |
|
||
|----|----------|
|
||
| D-20 | Scheduling: **Vagaro and/or Square** + fixtures |
|
||
| D-21 | Books: **QuickBooks Online** + fixtures |
|
||
| D-22 | Agent↔SaaS: **MCP when possible**; scripts/CI use **REST/fixtures** |
|
||
| D-23 | **Remote MCP preferred**; local MCP only if necessary |
|
||
| D-24 | **Square:** remote MCP; allow bookings/customers/catalog/inventory reads; deny pay tools |
|
||
| D-25 | **QBO:** local MCP on same Docker network as Hermes; read tools; deny payment tools; write/update/delete off for MVP |
|
||
| D-26 | **Vagaro:** no public MCP → REST + webhooks |
|
||
| D-27 | Setup teaches connecting **the owner’s** accounts, not demo tenants only |
|
||
|
||
---
|
||
|
||
## Platform / install
|
||
|
||
| ID | Decision |
|
||
|----|----------|
|
||
| D-30 | **Docker-first** runtime; bootstrap installs Docker if missing |
|
||
| D-31 | Model OpenAI-compatible endpoint **may be outside** containers |
|
||
| D-32 | Host scripts outside containers; some automation in-container — documented split |
|
||
| D-33 | **No bespoke control API**; all mutations via `nemohermes` / `openshell` + product scripts |
|
||
| D-34 | Hermes write-safety stays on; config via sealed host commands |
|
||
| D-35 | Owner never receives terminal/nano/docker instructions |
|
||
| D-36 | One Hermes profile MVP; **intro name = profile/sandbox name** |
|
||
| D-37 | Multimodal: **aux vision required** for media social; other aux default to base/main |
|
||
| D-38 | Prefer platform-native ops; bespoke last resort |
|
||
|
||
---
|
||
|
||
## Memory / learning
|
||
|
||
| ID | Decision |
|
||
|----|----------|
|
||
| D-40 | Base memory: profile, style pack, structured notes, skills |
|
||
| D-41 | Confirm-to-learn / forget; no silent finetune |
|
||
| D-42 | No holographic memory MVP |
|
||
| D-43 | Optional curated wiki later |
|
||
|
||
---
|
||
|
||
## Updates / observability
|
||
|
||
| ID | Decision |
|
||
|----|----------|
|
||
| D-50 | Automatic updates **ON by default** |
|
||
| D-51 | Owner-transparent (no upgrade chat) |
|
||
| D-52 | `upgrade.sh` parent process; pins, volumes, migrations, rollback |
|
||
| D-53 | Suppress Hermes interactive update during product upgrade |
|
||
| D-54 | Log levels: production (default), debug, trace |
|
||
| D-55 | Optional external trace UIs not MVP |
|
||
|
||
---
|
||
|
||
## Documentation process
|
||
|
||
| ID | Decision |
|
||
|----|----------|
|
||
| D-60 | Use-case SSOT: `design/use-cases.md` (this tree) |
|
||
| D-61 | Scenarios: `design/scenarios.md` |
|
||
| D-62 | Full architecture plan: `design/DESIGN_PLAN.md` (not under `docs/`) |
|
||
| D-63 | Workspace seed = repo root content for Gitea check-in |
|
||
| D-64 | Plan approval ≠ build authorization |
|
||
|
||
---
|
||
|
||
## Queues absorbed (historical labels)
|
||
|
||
Q1 Setup UX · Q2 Educational setup/degrade/identity · Q3 Learning · Q4 Base memory · Q5 Channels MVP · Q6 Media social · Q7 UC SSOT · Q8 Minimal Hermes · Q9 Observability · P1–P6 packages · Docker/MCP/profile/update decisions above.
|