# Salon_Assistant (Lumina)

Docker-based **NemoClaw + Hermes** personal ops assistant for a salon/spa owner-operator.

This directory is the **product seed** for the Gitea repository `Ty_Tech/Salon_Assistant`.

## Status

| Artifact | Location |
|----------|----------|
| Design plan (SSOT) | [`design/DESIGN_PLAN.md`](design/DESIGN_PLAN.md) |
| Use cases (SSOT) | [`design/use-cases.md`](design/use-cases.md) |
| Scenarios | [`design/scenarios.md`](design/scenarios.md) |
| Resolved decisions | [`design/DECISIONS.md`](design/DECISIONS.md) |
| Operator runbooks | [`docs/`](docs/) |
| Implementation | **Not started** until explicit **build** / **implement** |

## Product planes

| Plane | Role |
|-------|------|
| Scheduling | Owner Vagaro and/or Square |
| Books | Owner QuickBooks Online (read-heavy) |
| Owner messaging | WhatsApp, Email, Telegram |
| Client / social drafts | Draft only; owner sends/posts |
| Social craft | Owner photos/video + vision aux |
| Setup / ops | Install, connect SaaS, automatic updates (on by default) |

## Doc placement

| Folder | Purpose |
|--------|---------|
| **`design/`** | Product design SSOT — plan, use cases, scenarios, decisions, MCP strategy, update lifecycle |
| **`docs/`** | Operator/user manuals — install, upgrade, providers, ops |

## Platform-first rule

All sandbox, policy, credential, channel, and inference mutations go through **`nemohermes` / `openshell`**. Product scripts (when built) wrap those CLIs. No parallel control API.

## Layout (scaffolds)

Code under `skills/`, `scripts/`, `services/`, `policy/`, etc. is **scaffold only** until **build**. See each area’s `README.md`.

## Remote

- Gitea: `Ty_Tech/Salon_Assistant` (public)
- Git MCP for this product: **`gitea_vps`** only