# Seller surface map — `/seller` and related pages

A from-source map of the deployed TroveSnap **seller** web surface: the navigation chrome, every
seller route, and the features on each. Companion to [web-feature-breakdown](web-feature-breakdown.md)
(which scores each page for contract-readiness) and the [seller feature catalog](seller-feature-catalog.md)
(current + planned functionality end-to-end).

## Chrome — where "tabs" come from

No top tab bar; navigation is a persistent **left sidebar** (`SellerShell`). The root layout wraps
every route in a **zone-aware `AppChrome`** that picks a shell by path:

| Zone | Paths | Chrome |
|---|---|---|
| Marketing | `/`, `/for-sellers` (→ `/`) | Sticky TroveSnap header: brand · Docs · Trove Go preview · Sign in · **Open Dashboard** |
| **Seller** | `/seller`, `/trovesnap/*`, `/admin/*` | **`SellerShell`** dark-emerald sidebar |
| Buyer | everything else, **plus** `/trovesnap/hunt` & `/trovesnap/appraise` | Warm "Trove Go" header |

> `trovesnap.com` **is** the seller product; the buyer marketplace is **Trove Go** at `/go`.

### Seller sidebar (`SellerShell`)

| Group | Item → route |
|---|---|
| (main) | **Dashboard** → `/seller` · **Sales** → `/trovesnap` · **Inventory Review** → `/trovesnap/review-queue` · **Workflow Center** → `/trovesnap/workflow` · **Buyers & Demand** → `/trovesnap/demand` · **Analytics** → `/trovesnap/analytics` |
| Harness | **Connected Apps** → `/trovesnap/sources` · **Harness** → `/trovesnap/harness` |
| Platform Admin | **Sale Submissions** → `/admin/submissions` · **Import Audit** → `/admin/imports` |
| Account | **Alerts** `(badge 4)` → `/seller#alerts` · **Profile** → `/trovesnap/profile` · **Plans** → `/#plans` · **Docs** → `/docs` |

**Footer:** `🪙 Appraisal tokens: 87` · `Trust score: 92` · `Trove Go marketplace →`.

## Pages

### `/seller` — Seller Dashboard
1. **⚡ Action needed** — up to 4 seller-intelligence alert cards (gold left border for action items): title, time, body, action link.
2. **Sales dashboard** (embedded `TroveSnapDashboard`, see `/trovesnap`).
3. **Marketing & promotion** — 4 *Coming soon* cards (Boost this sale, Feature in local search, Highlight on map, Promote to tag watchers) — ship with payments. Footnote: keep your EstateSales.net/Facebook/HiBid links; Trove Go adds search/map/tag discovery.
4. **Seller notifications** — `NotificationList` + `NotificationSettingsPanel`.
5. **Shortcuts**: create sale · discount phases · analytics · public profile.

### `/trovesnap` — Sales hub
Header "TroveSnap" + **+ Create New Sale**; Supabase-setup/loading/error/empty states; **sale cards** (status badge · title · `City, State • dates` · chips `N items` / `N featured` / `N need review`) → workspace.

### `/trovesnap/review-queue` — Inventory Review & Appraisal Queue
Filter "tabs": **Appraisal Recommended · Better Photos Needed · High Buyer Demand · Exact Wishlist Matches · Suggested Copy · Ready to Publish**. Item-level approval gate.

### `/trovesnap/workflow` — Workflow Center (kanban)
Pipeline lane: **Imported → Needs Review → Needs Appraisal → Needs Photos → Ready → Published**.
Disposition lane: **Unsold · Review · Auction · Offers · Donation · Archived**.

### `/trovesnap/demand` — Buyers & Demand
Metric strip (buyers following tags · exact wishlist matches · saved searches · watchers); **Demand by treasure tag (25 mi)** bars with trend arrows; aside **Exact wishlist matches** (Feature / Notify matched buyers) + *Turn demand into turnout* tips. Identities stay anonymous.

### `/trovesnap/analytics` — Seller Analytics
Chip summary (sales · items cataloged · sell-through % · gross $ · followers); **Gross sales by month** (SVG bars) · **Follower growth** (SVG line) · **What buyers search for** (auto-tag priority bars).

### `/trovesnap/sources` — Connected Apps
Source connections (type e.g. `estatesales_net`, auth level `manual`), add-connection form, import runs.

### `/trovesnap/harness` — Estate Sale Harness
6-step pipeline **Capture → Import → Review → Enhance → Publish → Track**; connected sources with status chips (Connected/Syncing/Needs review/Paused/Error); activity; `HarnessSetupCard`.
- **`/trovesnap/harness/csv-import`** — CSV/Excel import wizard (EstateSales.net, AuctionNinja, HiBid, spreadsheets → reconciled inventory).

### Platform Admin
- **`/admin/submissions`** — review buyer-submitted garage sales; approve → canonical record + release token reward.
- **`/admin/imports`** — cross-source audit: pending candidates (creator + confidence + review_status), import runs, connections.

### `/trovesnap/profile` — Seller Profile (public face)
Name + ✓ Verified chip, tagline, service area/member-since/slug, **★ Subscribe (N followers)**, specialty chips, track record (sales hosted · items cataloged · sell-through · ★ rating), upcoming sales.

### Sale lifecycle
- **`/trovesnap/new`** — Create Sale form: title* · seller/company · city · state · postal · start/end date · start/end time · status · description.
- **`/trovesnap/sales/[id]`** — Sale Workspace: title+status; **Photos** (uploader); **Items** (grid + add, item editor); **Imports & review queue**; run enrichment / generate publish preview.
- **`/trovesnap/sales/[id]/edit`** — edit details.
- **`/trovesnap/sales/[id]/preview`** — Publish Preview (generate buyer-facing preview).
- **`/seller/sales/[id]/discounts`** — Discount Phases: add/remove phases (label, start, %, applies-to) with a **live buyer-facing preview** (current/next phase + urgency).
- Redirects: `/seller/sales/new`→`/trovesnap/new`; `/seller/sales/[id]`→workspace; `…/preview`→workspace preview.

## Cross-cutting
- **Stack:** Next 15 App Router · React 19 · CSS tokens (no Tailwind) · lucide-react.
- **Live vs demo:** Supabase-backed pages (Sales, Workspace, Sources, Preview, Discounts) show a setup alert + demo mode when unconfigured; Demand/Analytics/Profile/Admin render from demo fixtures.
- **Governance:** nothing becomes canonical inventory / publishes without seller approval (review queue is the gate); buyer anonymity in Demand; tokens + trust score in the sidebar; payments/promotion tiers not yet implemented.